@mtkruto/node 0.1.132 → 0.1.133

package/esm/types/1_message_reaction.js

@@ -0,0 +1,22 @@
+import { UNREACHABLE } from "../1_utilities.js";
+import { peerToChatId, types } from "../2_tl.js";
+import { constructReaction } from "./0_reaction.js";
+export function constructMessageReaction(reaction_, recentReactions) {
+    const choosers = recentReactions
+        .filter((v) => {
+        if (reaction_.reaction instanceof types.ReactionEmoji) {
+            return v.reaction instanceof types.ReactionEmoji && v.reaction.emoticon == reaction_.reaction.emoticon;
+        }
+        else if (reaction_.reaction instanceof types.ReactionCustomEmoji) {
+            return v.reaction instanceof types.ReactionCustomEmoji && v.reaction.document_id == reaction_.reaction.document_id;
+        }
+        else {
+            UNREACHABLE();
+        }
+    })
+        .map((v) => peerToChatId(v.peer_id));
+    const reaction = constructReaction(reaction_.reaction);
+    const count = reaction_.count;
+    const chosen = reaction_.chosen_order !== undefined ? true : false;
+    return { reaction, count, choosers, chosen };
+}

package/esm/types/1_user.d.ts

@@ -1,5 +1,5 @@
 import { types } from "../2_tl.js";
-import { ChatPhoto } from "./0_chat_photo.js";
+import { ChatPhotoUser } from "./0_chat_photo.js";
 /** This object represents a Telegram user or bot. */
 export interface User {
     /** Unique identifier for this user or bot */
@@ -17,7 +17,7 @@ export interface User {
     /** Additional usernames */
     also?: string[];
     /** The user's photo. */
-    photo?: ChatPhoto.User;
+    photo?: ChatPhotoUser;
     /** [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) of the user's language */
     languageCode?: string;
     /** True, if the user is a scam user */

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

@@ -2,44 +2,51 @@ import { enums } from "../2_tl.js";
 import { LoginUrl } from "./0_login_url.js";
 import { WebAppInfo } from "./0_web_app_info.js";
 import { UsernameResolver } from "./1__getters.js";
-export declare namespace InlineKeyboardButton {
-    interface Base {
-        /** Label text on the button */
-        text: string;
-    }
-    interface URL extends Base {
-        /** HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
-        url: string;
-    }
-    interface Callback extends Base {
-        /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
-        callbackData: string;
-    }
-    interface WebApp extends Base {
-        /** Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
-        webApp: WebAppInfo;
-    }
-    interface Login extends Base {
-        /** An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
-        loginUrl: LoginUrl;
-    }
-    interface SwitchInline extends Base {
-        /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
-        switchInlineQuery: string;
-    }
-    interface SwitchInlineCurrent extends Base {
-        /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
-        switchInlineQueryCurrentChat: string;
-    }
-    interface Game extends Base {
-        callbackGame: Record<never, never>;
-    }
-    interface Pay extends Base {
-        /** Specify True to send a Pay button */
-        pay: boolean;
-    }
+/** @unlisted */
+export interface InlineKeyboardButtonBase {
+    /** Label text on the button */
+    text: string;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonURL extends InlineKeyboardButtonBase {
+    /** HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
+    url: string;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonCallback extends InlineKeyboardButtonBase {
+    /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
+    callbackData: string;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonWebApp extends InlineKeyboardButtonBase {
+    /** Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
+    webApp: WebAppInfo;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonLogin extends InlineKeyboardButtonBase {
+    /** An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
+    loginUrl: LoginUrl;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonSwitchInline extends InlineKeyboardButtonBase {
+    /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
+    switchInlineQuery: string;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonSwitchInlineCurrent extends InlineKeyboardButtonBase {
+    /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
+    switchInlineQueryCurrentChat: string;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonGame extends InlineKeyboardButtonBase {
+    callbackGame: Record<never, never>;
+}
+/** @unlisted */
+export interface InlineKeyboardButtonPay extends InlineKeyboardButtonBase {
+    /** Specify True to send a Pay button */
+    pay: boolean;
 }
 /** This object represents one button of an inline keyboard. You **must** use exactly one of the optional fields. */
-export type InlineKeyboardButton = InlineKeyboardButton.URL | InlineKeyboardButton.Callback | InlineKeyboardButton.WebApp | InlineKeyboardButton.Login | InlineKeyboardButton.SwitchInline | InlineKeyboardButton.SwitchInlineCurrent | InlineKeyboardButton.Game | InlineKeyboardButton.Pay;
+export type InlineKeyboardButton = InlineKeyboardButtonURL | InlineKeyboardButtonCallback | InlineKeyboardButtonWebApp | InlineKeyboardButtonLogin | InlineKeyboardButtonSwitchInline | InlineKeyboardButtonSwitchInlineCurrent | InlineKeyboardButtonGame | InlineKeyboardButtonPay;
 export declare function constructInlineKeyboardButton(button_: enums.KeyboardButton): InlineKeyboardButton;
 export declare function inlineKeyboardButtonToTlObject(button: InlineKeyboardButton, usernameResolver: UsernameResolver): Promise<import("../tl/2_types.js").KeyboardButtonUrl_ | import("../tl/2_types.js").KeyboardButtonCallback_ | import("../tl/2_types.js").KeyboardButtonSwitchInline_ | import("../tl/2_types.js").KeyboardButtonBuy_ | import("../tl/2_types.js").InputKeyboardButtonUrlAuth_ | import("../tl/2_types.js").KeyboardButtonWebView_>;

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

@@ -11,172 +11,229 @@ import { Venue } from "./0_venue.js";
 import { Voice } from "./0_voice.js";
 import { EntityGetter } from "./1__getters.js";
 import { Animation } from "./1_animation.js";
-import { ReplyQuote } from "./1_reply_quote.js";
 import { ChatP } from "./1_chat_p.js";
 import { Document } from "./1_document.js";
+import { ReplyQuote } from "./1_reply_quote.js";
 import { Photo } from "./1_photo.js";
 import { Poll } from "./1_poll.js";
 import { Sticker, StickerSetNameGetter } from "./1_sticker.js";
 import { User } from "./1_user.js";
 import { VideoNote } from "./1_video_note.js";
 import { Video } from "./1_video.js";
+import { MessageReaction } from "./1_message_reaction.js";
+import { Giveaway } from "./1_giveaway.js";
 import { Game } from "./2_game.js";
 import { ReplyKeyboardMarkup } from "./2_reply_keyboard_markup.js";
 import { InlineKeyboardMarkup } from "./3_inline_keyboard_markup.js";
-/** This object represents a message. */
-export interface Message {
-    /** Whether the message is outgoing */
+/** Properties shared between all message types. */
+export interface MessageBase {
     out: boolean;
-    /** Unique message identifier inside this chat */
     id: number;
-    /** Unique identifier of a message thread to which the message belongs; for supergroups only */
     threadId?: number;
-    /** Sender of the message; empty for messages sent to channels. For backward compatibility, the field contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. */
     from?: User;
-    /** Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. */
     senderChat?: ChatP;
-    /** Date the message was sent in Unix time */
     date: Date;
-    /** Conversation the message belongs to */
     chat: ChatP;
-    /** A link to the message */
     link?: string;
-    /** For forwarded messages, sender of the original message */
     forwardFrom?: User;
-    /** For messages forwarded from channels or from anonymous administrators, information about the original sender chat */
     forwardFromChat?: ChatP;
-    /** For messages forwarded from channels, identifier of the original message in the channel */
     forwardId?: number;
-    /** For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present */
     forwardSignature?: string;
-    /** Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages */
     forwardSenderName?: string;
-    /** For forwarded messages, date the original message was sent in Unix time */
     forwardDate?: Date;
-    /** True, if the message is sent to a forum topic */
     isTopicMessage: boolean;
-    /** True, if the message is a channel post that was automatically forwarded to the connected discussion group */
     isAutomaticForward?: boolean;
-    /** For replies, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. */
-    replyToMessage?: Omit<Message, "replyToMessage">;
+    replyToMessage?: Message;
     replyToMessageId?: number;
+    reactions?: MessageReaction[];
     replyQuote?: ReplyQuote;
-    /** Bot through which the message was sent */
     viaBot?: User;
-    /** Date the message was last edited in Unix time */
     editDate?: Date;
-    /** True, if the message can't be forwarded */
     hasProtectedContent?: boolean;
-    /** The unique identifier of a media message group this message belongs to */
     mediaGroupId?: string;
-    /** Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */
     authorSignature?: string;
-    /** For text messages, the actual UTF-8 text of the message */
-    text?: string;
-    /** For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text */
-    entities?: MessageEntity[];
-    /** Caption for the animation, audio, document, photo, video or voice */
+    views?: number;
+    replyMarkup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+}
+/** Properties shared between media message types. */
+export interface MessageMediaBase extends MessageBase {
     caption?: string;
-    /** For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption */
     captionEntities?: MessageEntity[];
-    /** True, if the message media is covered by a spoiler animation */
     hasMediaSpoiler?: boolean;
-    /** View count for channel posts */
-    views?: number;
-    /** Inline keyboard attached to the message. `login_url` buttons are represented as ordinary `url` buttons. */
-    replyMarkup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
-    /** Message is a photo, available sizes of the photo */
-    photo?: Photo;
-    /** Message is a general file, information about the file */
-    document?: Document;
-    /** Message is a video, information about the video */
-    video?: Video;
-    /** Message is a sticker, information about the sticker */
-    sticker?: Sticker;
-    /** Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set */
-    animation?: Animation;
-    /** Message is a voice message, information about the file */
-    voice?: Voice;
-    /** Message is an audio file, information about the file */
-    audio?: Audio;
-    /** Message is a dice with random value */
-    dice?: Dice;
-    /** Message is a [video note](https://telegram.org/blog/video-messages-and-telescope), information about the video message */
-    videoNote?: VideoNote;
-    /** Message is a shared contact, information about the contact */
-    contact?: Contact;
-    /** Message is a game, information about the game. */
-    game?: Game;
-    /** New poll state. Bots receive only updates about stopped polls and polls, which were sent by the bot. */
-    poll?: Poll;
-    /** Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set */
-    venue?: Venue;
-    /** Message is a shared location, information about the location */
-    location?: Location;
-    /** New members that were added to the group or supergroup and information about them (the bot itself may be one of these members) */
-    newChatMembers?: User[];
-    /** A member was removed from the group, information about them (this member may be the bot itself) */
-    leftChatMember?: User;
-    /** A chat title was changed to this value */
-    newChatTitle?: string;
-    /** A chat photo was change to this value */
-    newChatPhoto?: Photo;
-    /** Service message: the chat photo was deleted */
-    deletedChatPhoto?: true;
-    /** Service message: the group has been created */
-    groupCreated?: true;
-    /** Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup. */
-    supergroupCreated?: true;
-    /** Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel. */
-    channelCreated?: true;
-    /** Service message: auto-delete timer settings changed in the chat */
-    messageAutoDeleteTimerChanged?: {
-        messageAutoDeleteTime: number;
-    };
-    /** The group has been migrated to a supergroup with the specified identifier */
-    chatMigratedTo?: number;
-    /** The supergroup has been migrated from a group with the specified identifier */
-    chatMigratedFrom?: number;
-    /** Specified message was pinned. Note that the Message object in this field will not contain further reply_to_message fields even if it is itself a reply. */
-    pinnedMessage?: Message;
-    /** Service message: a user was shared with the bot */
-    userShared?: {
+}
+export interface MessageText extends MessageBase {
+    text: string;
+    entities: MessageEntity[];
+}
+export interface MessagePhoto extends MessageMediaBase {
+    photo: Photo;
+}
+export interface MessageDocument extends MessageMediaBase {
+    document: Document;
+}
+export interface MessageVideo extends MessageMediaBase {
+    video: Video;
+}
+export interface MessageSticker extends MessageBase {
+    sticker: Sticker;
+}
+export interface MessageAnimation extends MessageMediaBase {
+    animation: Animation;
+}
+export interface MessageVoice extends MessageMediaBase {
+    voice: Voice;
+}
+export interface MessageAudio extends MessageMediaBase {
+    audio: Audio;
+}
+export interface MessageDice extends MessageBase {
+    dice: Dice;
+}
+export interface MessageVideoNote extends MessageBase {
+    videoNote: VideoNote;
+}
+export interface MessageContact extends MessageBase {
+    contact: Contact;
+}
+export interface MessageGame extends MessageBase {
+    game: Game;
+}
+export interface MessagePoll extends MessageBase {
+    poll: Poll;
+}
+export interface MessageVenue extends MessageBase {
+    venue: Venue;
+}
+export interface MessageLocation extends MessageBase {
+    location: Location;
+}
+export interface MessageNewChatMembers extends MessageBase {
+    newChatMembers: User[];
+}
+export interface MessageLeftChatMember extends MessageBase {
+    leftChatMember: User;
+}
+export interface MessageNewChatTitle extends MessageBase {
+    newChatTitle: string;
+}
+export interface MessageNewChatPhoto extends MessageBase {
+    newChatPhoto: Photo;
+}
+export interface MessageDeletedChatPhoto extends MessageBase {
+    deletedChatPhoto: true;
+}
+export interface MessageGroupCreated extends MessageBase {
+    groupCreated: true;
+    newChatMembers: User[];
+}
+export interface MessageSupergroupCreated extends MessageBase {
+    supergroupCreated: true;
+}
+export interface MessageChannelCreated extends MessageBase {
+    channelCreated: true;
+}
+export interface MessageAutoDeleteTimerChanged extends MessageBase {
+    newAutoDeleteTime: number;
+}
+export interface MessageChatMigratedTo extends MessageBase {
+    chatMigratedTo: number;
+}
+export interface MessageChatMigratedFrom extends MessageBase {
+    chatMigratedFrom: number;
+}
+export interface MessagePinnedMessage extends MessageBase {
+    pinnedMessage: Message;
+}
+export interface MessageUserShared extends MessageBase {
+    userShared: {
         requestId: number;
         userId: number;
     };
-    /** Service message: the user allowed the bot added to the attachment menu to write messages */
-    writeAccessAllowed?: {
+}
+export interface MessageWriteAccessAllowed extends MessageBase {
+    writeAccessAllowed: {
         webAppName?: string;
     };
-    /** Service message: forum topic created */
-    forumTopicCreated?: {
+}
+export interface MessageForumTopicCreated extends MessageBase {
+    forumTopicCreated: {
         name: string;
         iconColor: string;
         iconCutsomEmojiId?: string;
     };
-    /** Service message: forum topic edited */
-    forumTopicEdited?: {
-        name?: string;
+}
+export interface MessageForumTopicEdited extends MessageBase {
+    forumTopicEdited: {
+        name: string;
         iconCutsomEmojiId?: string;
     };
-    /** Service message: forum topic closed */
-    forumTopicClosed?: Record<never, never>;
-    /** Service message: forum topic reopened */
-    forumTopicReopened?: Record<never, never>;
-    /** Service message: video chat scheduled */
-    videoChatScheduled?: {
+}
+export interface MessageForumTopicClosed extends MessageBase {
+    forumTopicClosed: true;
+}
+export interface MessageForumTopicReopened extends MessageBase {
+    forumTopicReopened: true;
+}
+export interface MessageVideoChatScheduled extends MessageBase {
+    videoChatScheduled: {
         startDate: Date;
     };
-    /** Service message: video chat started */
-    videoChatStarted?: Record<never, never>;
-    /** Service message: video chat ended */
-    videoChatEnded?: {
+}
+export interface MessageVideoChatStarted extends MessageBase {
+    videoChatStarted: true;
+}
+export interface MessageVideoChatEnded extends MessageBase {
+    videoChatEnded: {
         duration: number;
     };
 }
-export interface MessageGetter<O extends keyof Message | null = null> {
-    (chatId: number, messageId: number): MaybePromise<(O extends keyof Message ? Omit<Message, O> : Message) | null>;
+export interface MessageGiveaway extends MessageBase {
+    giveaway: Giveaway;
+}
+export interface MessageTypes {
+    text: MessageText;
+    photo: MessagePhoto;
+    document: MessageDocument;
+    video: MessageVideo;
+    sticker: MessageSticker;
+    animation: MessageAnimation;
+    voice: MessageVoice;
+    audio: MessageAudio;
+    dice: MessageDice;
+    videoNote: MessageVideoNote;
+    contact: MessageContact;
+    game: MessageGame;
+    poll: MessagePoll;
+    venue: MessageVenue;
+    location: MessageLocation;
+    newChatMembers: MessageNewChatMembers;
+    leftChatMember: MessageLeftChatMember;
+    newChatTitle: MessageNewChatTitle;
+    newChatPhoto: MessageNewChatPhoto;
+    deletedChatPhoto: MessageDeletedChatPhoto;
+    groupCreated: MessageGroupCreated;
+    supergroupCreated: MessageSupergroupCreated;
+    channelCreated: MessageChannelCreated;
+    newAutoDeleteTime: MessageAutoDeleteTimerChanged;
+    chatMigratedTo: MessageChatMigratedTo;
+    chatMigratedFrom: MessageChatMigratedFrom;
+    pinnedMessage: MessagePinnedMessage;
+    userShared: MessageUserShared;
+    writeAccessAllowed: MessageWriteAccessAllowed;
+    forumTopicCreated: MessageForumTopicCreated;
+    forumTopicEdited: MessageForumTopicEdited;
+    forumTopicClosed: MessageForumTopicClosed;
+    forumTopicReopened: MessageForumTopicReopened;
+    videoChatScheduled: MessageVideoChatScheduled;
+    videoChatStarted: MessageVideoChatStarted;
+    videoChatEnded: MessageVideoChatEnded;
+    giveaway: MessageGiveaway;
+}
+export declare function assertMessageType<T extends keyof MessageTypes>(message: Message, type: T): MessageTypes[T];
+export type Message = MessageText | MessagePhoto | MessageDocument | MessageVideo | MessageSticker | MessageAnimation | MessageVoice | MessageAudio | MessageDice | MessageVideoNote | MessageContact | MessageGame | MessagePoll | MessageVenue | MessageLocation | MessageNewChatMembers | MessageLeftChatMember | MessageNewChatTitle | MessageNewChatPhoto | MessageDeletedChatPhoto | MessageGroupCreated | MessageSupergroupCreated | MessageChannelCreated | MessageAutoDeleteTimerChanged | MessageChatMigratedTo | MessageChatMigratedFrom | MessagePinnedMessage | MessageUserShared | MessageWriteAccessAllowed | MessageForumTopicCreated | MessageForumTopicEdited | MessageForumTopicClosed | MessageForumTopicReopened | MessageVideoChatScheduled | MessageVideoChatStarted | MessageVideoChatEnded | MessageGiveaway;
+export interface MessageGetter {
+    (chatId: number, messageId: number): MaybePromise<Message | null>;
 }
-type Message_MessageGetter = MessageGetter<"replyToMessage"> | null;
+type Message_MessageGetter = MessageGetter | null;
 export declare function constructMessage(message_: enums.Message, getEntity: EntityGetter, getMessage: Message_MessageGetter, getStickerSetName: StickerSetNameGetter, getReply_?: boolean): Promise<Message>;
 export {};