telegram-bot-api-nodejs 1.0.0 → 1.0.2

package/index.d.ts

@@ -5,10 +5,11 @@ export type DocumentMimeType = "application/pdf" | "application/zip";
 export type MessageType = "text" | "animation" | "audio" | "channel_chat_created" | "contact" | "delete_chat_photo" | "document" | "game" | "group_chat_created" | "invoice" | "left_chat_member" | "location" | "migrate_from_chat_id" | "migrate_to_chat_id" | "new_chat_members" | "new_chat_photo" | "new_chat_title" | "passport_data" | "photo" | "pinned_message" | "sticker" | "successful_payment" | "supergroup_chat_created" | "video" | "video_note" | "voice";
 type MessageEntityType = "mention" | "hashtag" | "bot_command" | "url" | "email" | "bold" | "italic" | "code" | "pre" | "text_link" | "text_mention";
 type ParseMode = "Markdown" | "MarkdownV2" | "HTML";
+export type AllowedUpdates = keyof (Omit<Update, "update_id">);
 export interface SetWebHookOptions {
-    url?: string;
+    url: string;
     max_connections?: number;
-    allowed_updates?: string[];
+    allowed_updates?: AllowedUpdates[];
 }
 interface SendBasicOptions {
     chat_id: number | string;
@@ -37,12 +38,6 @@ interface SendDocumentOptions extends SendBasicOptions {
     parse_mode?: ParseMode;
     caption?: string;
 }
-interface SendDocumentStreamOptions extends SendBasicOptions {
-    document: Blob;
-    documentName: string;
-    parse_mode?: ParseMode;
-    caption?: string;
-}
 export interface AnswerCallbackQueryOptions {
     callback_query_id: string;
     text?: string;
@@ -50,9 +45,6 @@ export interface AnswerCallbackQueryOptions {
     url?: string;
     cache_time?: number;
 }
-export interface GetChatOptions {
-    chat_id: string;
-}
 interface SetMyCommandsOptions {
     commands: BotCommand[];
 }
@@ -68,11 +60,6 @@ interface EditMessageReplyMarkupOptions {
     message_id?: number | string;
     inline_message_id?: string;
 }
-export interface GetUserProfilePhotosOptions {
-    user_id: number | string;
-    offset?: number;
-    limit?: number;
-}
 interface PassportFile {
     file_id: string;
     file_size: number;
@@ -105,6 +92,8 @@ export interface Update {
     edited_message?: Message;
     channel_post?: Message;
     edited_channel_post?: Message;
+    message_reaction?: MessageReactionUpdated;
+    message_reaction_count?: MessageReactionCountUpdated;
     inline_query?: InlineQuery;
     chosen_inline_result?: ChosenInlineResult;
     callback_query?: CallbackQuery;
@@ -118,7 +107,7 @@ export interface WebhookInfo {
     last_error_date?: number;
     last_error_message?: string;
     max_connections?: number;
-    allowed_updates?: string[];
+    allowed_updates?: AllowedUpdates[];
 }
 export interface User {
     id: string;
@@ -196,6 +185,49 @@ export interface Message {
     reply_markup?: InlineKeyboardMarkup;
     sender_chat?: Chat;
 }
+export interface MessageReactionUpdated {
+    chat: Chat;
+    message_id: number;
+    user?: User;
+    actor_chat?: Chat;
+    date: number;
+    old_reaction: ReactionType[];
+    new_reaction: ReactionType[];
+}
+/**
+ * @see https://core.telegram.org/bots/api#reactiontype
+ */
+export type ReactionType = ReactionTypeEmoji | ReactionTypeCustomEmoji;
+/**
+ * @see https://core.telegram.org/bots/api#reactiontypeemoji
+ */
+export interface ReactionTypeEmoji {
+    type: "emoji";
+    emoji: string;
+}
+/**
+ * @see https://core.telegram.org/bots/api#reactiontypecustomemoji
+ */
+export interface ReactionTypeCustomEmoji {
+    type: "custom_emoji";
+    custom_emoji_id: string;
+}
+/**
+ * @see https://core.telegram.org/bots/api#messagereactioncountupdated
+ */
+export interface MessageReactionCountUpdated {
+    chat: Chat;
+    message_id: number;
+    date: number;
+    reactions: ReactionCount[];
+}
+/**
+ * @see https://core.telegram.org/bots/api#reactioncount
+ */
+export interface ReactionCount {
+    type: ReactionType;
+    total_count: number;
+}
 export interface MessageEntity {
     type: MessageEntityType;
     offset: number;
@@ -461,32 +493,45 @@ interface BotCommand {
 /**
  * Methods
  */
-export declare function setWebhook(token: string, body: SetWebHookOptions, signal: any): Promise<any>;
-export declare function deleteWebhook(token: string, signal: any): Promise<any>;
+export declare function setWebhook(token: string, body: SetWebHookOptions, signal: AbortSignal): Promise<Boolean>;
+export declare function deleteWebhook(token: string, signal: AbortSignal): Promise<Boolean>;
 /** @todo cehck if response is the same as in typings */
-export declare function getWebhookInfo(token: string, signal: any): Promise<WebhookInfo>;
-export declare function getMe(token: string, signal: any): Promise<User>;
-export declare function sendMessage(token: string, payload: SendMessageOptions, signal: any): Promise<Message>;
-export declare function editMessageText(token: string, payload: EditMessageTextOptions, signal: any): Promise<Message>;
-export declare function sendPhoto(token: string, payload: SendPhotoOptions, signal: any): Promise<Message>;
-export declare function sendAnimation(token: string, payload: SendAnimationOptions, signal: any): Promise<Message>;
-export declare function sendDocument(token: string, payload: SendDocumentOptions, signal: any): Promise<Message>;
-export declare function sendDocumentStream(token: string, payload: SendDocumentStreamOptions, signal: any): Promise<Message>;
-export declare function getUserProfilePhotos(token: string, payload: GetUserProfilePhotosOptions, signal: any): Promise<UserProfilePhotos>;
-export declare function getFile(token: string, file_id: string, signal: any): Promise<File>;
-export declare function answerCallbackQuery(token: string, payload: AnswerCallbackQueryOptions, signal: any): Promise<File>;
-export declare function getChat(token: string, payload: GetChatOptions, signal: any): Promise<Chat>;
+export declare function getWebhookInfo(token: string, signal: AbortSignal): Promise<WebhookInfo>;
+export declare function getMe(token: string, signal: AbortSignal): Promise<User>;
+export declare function sendMessage(token: string, payload: SendMessageOptions, signal: AbortSignal): Promise<Message>;
+export declare function editMessageText(token: string, payload: EditMessageTextOptions, signal: AbortSignal): Promise<Message>;
+export declare function sendPhoto(token: string, payload: SendPhotoOptions, signal: AbortSignal): Promise<Message>;
+export declare function sendAnimation(token: string, payload: SendAnimationOptions, signal: AbortSignal): Promise<Message>;
+export declare function sendDocument(token: string, payload: SendDocumentOptions, signal: AbortSignal): Promise<Message>;
+export declare function setMessageReaction(token: string, payload: {
+    chat_id: string | number;
+    message_id: number;
+    reaction?: ReactionType[];
+    is_big?: boolean;
+}, signal: AbortSignal): Promise<Boolean>;
+export declare function getUserProfilePhotos(token: string, payload: {
+    user_id: number | string;
+    offset?: number;
+    limit?: number;
+}, signal: AbortSignal): Promise<UserProfilePhotos>;
+export declare function getFile(token: string, payload: {
+    file_id: string;
+}, signal: AbortSignal): Promise<File>;
+export declare function answerCallbackQuery(token: string, payload: AnswerCallbackQueryOptions, signal: AbortSignal): Promise<File>;
+export declare function getChat(token: string, payload: {
+    chat_id: string;
+}, signal: AbortSignal): Promise<Chat>;
 export declare function getChatMember(token: string, payload: {
     chat_id: string;
     user_id: string;
-}, signal: AbortSignal): Promise<ChatMember>;
-export declare function setMyCommands(token: string, payload: SetMyCommandsOptions, signal: any): Promise<Chat>;
-export declare function deleteMyCommands(token: string, payload: DeleteMyCommandsOptions, signal: any): Promise<Chat>;
+}, signal?: AbortSignal): Promise<ChatMember>;
+export declare function setMyCommands(token: string, payload: SetMyCommandsOptions, signal?: AbortSignal): Promise<Chat>;
+export declare function deleteMyCommands(token: string, payload: DeleteMyCommandsOptions, signal: AbortSignal): Promise<Chat>;
 /**
  * Parsers
  */
 export declare function parseUpdate(update: any): Update;
-export declare function parseMessage(m?: any): Message | undefined;
+export declare function parseMessage(m: any): Message;
 export declare function parseUser(u: User): {
     id: string;
     is_bot: boolean;
@@ -574,8 +619,14 @@ export declare function parsePollOption(v: PollOption): {
  * @see https://core.telegram.org/bots/api#callbackquery
  */
 export declare function parseCallbackQuery(v?: CallbackQuery): CallbackQuery | undefined;
+export declare function parseResponse<T>(response: Response): Promise<T>;
 export declare class TelegramError extends Error {
-    status: number;
-    constructor(message: string, status: number);
+    error_code: number;
+    parameters: Record<string, any>;
+    constructor(message: string, error_code: number, parameters?: Record<string, any>);
 }
+/**
+ * Helpers
+ */
+export declare const SUPPORTED_REACTION_EMOJI: string[];
 export {};

package/index.js

@@ -1,6 +1,9 @@
+/**
+ * Common headers for API calls
+ */
 const headers = {
-    "Content-Type": "application/json",
     "Accept": "application/json",
+    "Content-Type": "application/json",
 };
 /**
  * Methods
@@ -11,7 +14,7 @@ export function setWebhook(token, body, signal) {
         body: JSON.stringify(body),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function deleteWebhook(token, signal) {
     return fetch(`https://api.telegram.org/bot${token}/deleteWebhook`, {
@@ -19,7 +22,7 @@ export function deleteWebhook(token, signal) {
         body: JSON.stringify({}),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 /** @todo cehck if response is the same as in typings */
 export function getWebhookInfo(token, signal) {
@@ -28,7 +31,7 @@ export function getWebhookInfo(token, signal) {
         body: JSON.stringify({}),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function getMe(token, signal) {
     return fetch(`https://api.telegram.org/bot${token}/getMe`, {
@@ -36,7 +39,7 @@ export function getMe(token, signal) {
         body: JSON.stringify({}),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function sendMessage(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
@@ -44,7 +47,7 @@ export function sendMessage(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function editMessageText(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/editMessageText`, {
@@ -52,7 +55,7 @@ export function editMessageText(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function sendPhoto(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendPhoto`, {
@@ -60,7 +63,7 @@ export function sendPhoto(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function sendAnimation(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendAnimation`, {
@@ -68,7 +71,7 @@ export function sendAnimation(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function sendDocument(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendDocument`, {
@@ -76,23 +79,15 @@ export function sendDocument(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
-export function sendDocumentStream(token, payload, signal) {
-    const body = new FormData();
-    body.append("chat_id", String(payload.chat_id));
-    if (payload.caption) {
-        body.append("caption", payload.caption);
-    }
-    body.append("document", payload.document, payload.documentName);
-    if (payload.parse_mode) {
-        body.append("parse_mode", payload.parse_mode);
-    }
-    return fetch(`https://api.telegram.org/bot${token}/sendDocument`, {
+export function setMessageReaction(token, payload, signal) {
+    return fetch(`https://api.telegram.org/bot${token}/setMessageReaction`, {
         method: "POST",
-        body: body,
+        body: JSON.stringify(payload),
+        headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function getUserProfilePhotos(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/getUserProfilePhotos`, {
@@ -100,15 +95,15 @@ export function getUserProfilePhotos(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
-export function getFile(token, file_id, signal) {
+export function getFile(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/getFile`, {
         method: "POST",
-        body: JSON.stringify({ file_id }),
+        body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function answerCallbackQuery(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/answerCallbackQuery`, {
@@ -116,7 +111,7 @@ export function answerCallbackQuery(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function getChat(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/getChat`, {
@@ -124,7 +119,7 @@ export function getChat(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function getChatMember(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/getChatMember`, {
@@ -132,7 +127,7 @@ export function getChatMember(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal: signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function setMyCommands(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/setMyCommands`, {
@@ -140,7 +135,7 @@ export function setMyCommands(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 export function deleteMyCommands(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/deleteMyCommands`, {
@@ -148,24 +143,33 @@ export function deleteMyCommands(token, payload, signal) {
         body: JSON.stringify(payload),
         headers,
         signal
-    }).then(parseResponse);
+    }).then((parseResponse));
 }
 /**
  * Parsers
  */
 export function parseUpdate(update) {
-    const update_id = Number(update.update_id);
-    return {
-        update_id,
-        message: parseMessage(update.message),
-        edited_message: parseMessage(update.edited_message),
-        callback_query: parseCallbackQuery(update.callback_query),
+    const u = {
+        update_id: Number(update.update_id)
     };
+    if (update.message) {
+        u.message = parseMessage(update.message);
+    }
+    if (update.edited_message) {
+        u.edited_message = parseMessage(update.edited_message);
+    }
+    if (update.callback_query) {
+        u.callback_query = parseCallbackQuery(update.callback_query);
+    }
+    if (update.message_reaction) {
+        u.message_reaction = parseMessageReaction(update.message_reaction);
+    }
+    if (update.message_reaction_count) {
+        u.message_reaction_count = parseMessageReactionCount(update.message_reaction_count);
+    }
+    return u;
 }
 export function parseMessage(m) {
-    if (!m) {
-        return;
-    }
     return {
         message_id: Number(m.message_id),
         from: m.from ? parseUser(m.from) : void 0,
@@ -388,7 +392,65 @@ export function parseCallbackQuery(v) {
         chat_instance: String(v.chat_instance ?? ""),
     };
 }
-function parseResponse(response) {
+function parseMessageReaction(d) {
+    if (!d) {
+        return;
+    }
+    return {
+        chat: parseChat(d.chat),
+        message_id: Number(d.message_id),
+        user: d.user ? parseUser(d.user) : void 0,
+        actor_chat: d.actor_chat ? parseChat(d.actor_chat) : void 0,
+        date: Number(d.date),
+        old_reaction: parseReactions(d.old_reaction),
+        new_reaction: parseReactions(d.new_reaction),
+    };
+}
+function parseReactions(reactions) {
+    if (!Array.isArray(reactions)) {
+        return [];
+    }
+    return reactions.map(parseReaction);
+}
+function parseReaction(reaction) {
+    if (reaction.type === "emoji") {
+        return {
+            type: "emoji",
+            emoji: String(reaction.emoji),
+        };
+    }
+    if (reaction.type === "custom_emoji") {
+        return {
+            type: "custom_emoji",
+            custom_emoji_id: String(reaction.custom_emoji_id),
+        };
+    }
+    throw new RangeError(`Unknown type of reaction: ${JSON.stringify(reaction)}`);
+}
+function parseMessageReactionCount(d) {
+    if (!d) {
+        return d;
+    }
+    return {
+        chat: parseChat(d.chat),
+        message_id: Number(d.message_id),
+        date: Number(d.date),
+        reactions: parseReactionsCount(d.reactions)
+    };
+}
+function parseReactionsCount(reactions) {
+    if (!Array.isArray(reactions)) {
+        return [];
+    }
+    return reactions.map(parseReactionCount);
+}
+function parseReactionCount(reaction) {
+    return {
+        type: parseReaction(reaction.type),
+        total_count: Number(reaction.total_count),
+    };
+}
+export function parseResponse(response) {
     return response.text().then(function (text) {
         let data;
         try {
@@ -399,17 +461,32 @@ function parseResponse(response) {
         }
         const ok = Boolean(data.ok);
         if (ok) {
-            return data.result || {};
+            return data.result;
         }
         const error_code = Number(data.error_code ?? 0);
         const description = String(data.description ?? "");
-        throw new TelegramError(description, response.status);
+        const parameters = data.parameters || {};
+        throw new TelegramError(description, error_code, parameters);
     });
 }
 export class TelegramError extends Error {
-    status;
-    constructor(message, status) {
+    error_code;
+    parameters;
+    constructor(message, error_code, parameters = {}) {
         super(message);
-        this.status = status;
+        this.error_code = error_code;
+        this.parameters = parameters;
     }
 }
+/**
+ * Helpers
+ */
+export const SUPPORTED_REACTION_EMOJI = ["👍", "👎", "\u2764\ufe0f" // red heart
+    ,
+    "🔥", "🥰", "👏", "😁", "🤔", "🤯", "😱", "🤬", "😢",
+    "🎉", "🤩", "🤮", "💩", "🙏", "👌", "🕊", "🤡", "🥱", "🥴", "😍", "🐳", "❤‍🔥",
+    "🌚", "🌭", "💯", "🤣", "⚡", "🍌", "🏆", "💔", "🤨", "😐", "🍓", "🍾", "💋",
+    "🖕", "😈", "😴", "😭", "🤓", "👻", "👨‍💻", "👀", "🎃", "🙈", "😇", "😨", "🤝",
+    "✍", "🤗", "🫡", "🎅", "🎄", "☃", "💅", "🤪", "🗿", "🆒", "💘", "🙉", "🦄",
+    "😘", "💊", "🙊", "😎", "👾", "🤷‍♂", "🤷", "🤷‍♀", "😡"
+];

package/index.ts

@@ -1,46 +1,86 @@
+/**
+ * Common headers for API calls
+ */
 const headers = {
-  "Content-Type": "application/json",
   "Accept": "application/json",
+  "Content-Type": "application/json",
 }
 
-export type ChatType = "private" | "group" | "supergroup" | "channel";
-export type ChatAction = "typing" | "upload_photo" | "record_video" | "upload_video" | "record_audio" | "upload_audio" | "upload_document" | "find_location" | "record_video_note" | "upload_video_note";
-export type ChatMemberStatus = "creator" | "administrator" | "member" | "restricted" | "left" | "kicked";
+export type ChatType = "private"
+  | "group"
+  | "supergroup"
+  | "channel";
+
+export type ChatAction = "typing"
+  | "upload_photo"
+  | "record_video"
+  | "upload_video"
+  | "record_audio"
+  | "upload_audio"
+  | "upload_document"
+  | "find_location"
+  | "record_video_note"
+  | "upload_video_note";
+
+export type ChatMemberStatus = "creator"
+  | "administrator"
+  | "member"
+  | "restricted"
+  | "left"
+  | "kicked";
+
 export type DocumentMimeType = "application/pdf" | "application/zip";
+
 export type MessageType =
-  "text" |
-  "animation" |
-  "audio" |
-  "channel_chat_created" |
-  "contact" |
-  "delete_chat_photo" |
-  "document" |
-  "game" |
-  "group_chat_created" |
-  "invoice" |
-  "left_chat_member" |
-  "location" |
-  "migrate_from_chat_id" |
-  "migrate_to_chat_id" |
-  "new_chat_members" |
-  "new_chat_photo" |
-  "new_chat_title" |
-  "passport_data" |
-  "photo" |
-  "pinned_message" |
-  "sticker" |
-  "successful_payment" |
-  "supergroup_chat_created" |
-  "video" |
-  "video_note" |
-  "voice";
-type MessageEntityType = "mention" | "hashtag" | "bot_command" | "url" | "email" | "bold" | "italic" | "code" | "pre" | "text_link" | "text_mention";
-type ParseMode = "Markdown" | "MarkdownV2" | "HTML";
+  | "text"
+  | "animation"
+  | "audio"
+  | "channel_chat_created"
+  | "contact"
+  | "delete_chat_photo"
+  | "document"
+  | "game"
+  | "group_chat_created"
+  | "invoice"
+  | "left_chat_member"
+  | "location"
+  | "migrate_from_chat_id"
+  | "migrate_to_chat_id"
+  | "new_chat_members"
+  | "new_chat_photo"
+  | "new_chat_title"
+  | "passport_data"
+  | "photo"
+  | "pinned_message"
+  | "sticker"
+  | "successful_payment"
+  | "supergroup_chat_created"
+  | "video"
+  | "video_note"
+  | "voice";
+
+type MessageEntityType = "mention"
+  | "hashtag"
+  | "bot_command"
+  | "url"
+  | "email"
+  | "bold"
+  | "italic"
+  | "code"
+  | "pre"
+  | "text_link"
+  | "text_mention"
+
+type ParseMode = "Markdown"
+  | "MarkdownV2"
+  | "HTML";
+
+export type AllowedUpdates = keyof (Omit<Update, "update_id">)
 
 export interface SetWebHookOptions {
-  url?: string;
+  url: string;
   max_connections?: number;
-  allowed_updates?: string[];
+  allowed_updates?: AllowedUpdates[]
 }
 
 interface SendBasicOptions {
@@ -95,13 +135,6 @@ interface SendDocumentOptions extends SendBasicOptions {
   caption?: string;
 }
 
-interface SendDocumentStreamOptions extends SendBasicOptions {
-  document: Blob
-  documentName: string
-  parse_mode?: ParseMode;
-  caption?: string;
-}
-
 interface SendMediaGroupOptions {
   disable_notification?: boolean;
   reply_to_message_id?: number;
@@ -184,10 +217,6 @@ export interface AnswerCallbackQueryOptions {
   cache_time?: number
 }
 
-export interface GetChatOptions {
-  chat_id: string
-}
-
 interface SetMyCommandsOptions {
   commands: BotCommand[]
 }
@@ -210,12 +239,6 @@ interface EditMessageReplyMarkupOptions {
   inline_message_id?: string;
 }
 
-export interface GetUserProfilePhotosOptions {
-  user_id: number | string
-  offset?: number;
-  limit?: number;
-}
-
 interface SetGameScoreOptions {
   force?: boolean;
   disable_edit_message?: boolean;
@@ -275,7 +298,9 @@ export interface Update {
   message?: Message;
   edited_message?: Message;
   channel_post?: Message;
-  edited_channel_post?: Message;
+  edited_channel_post?: Message
+  message_reaction?: MessageReactionUpdated
+  message_reaction_count?: MessageReactionCountUpdated
   inline_query?: InlineQuery;
   chosen_inline_result?: ChosenInlineResult;
   callback_query?: CallbackQuery;
@@ -290,7 +315,7 @@ export interface WebhookInfo {
   last_error_date?: number;
   last_error_message?: string;
   max_connections?: number;
-  allowed_updates?: string[];
+  allowed_updates?: AllowedUpdates[]
 }
 
 export interface User {
@@ -372,6 +397,56 @@ export interface Message {
   sender_chat?: Chat
 }
 
+export interface MessageReactionUpdated {
+  chat: Chat
+  message_id: number
+  user?: User
+  actor_chat?: Chat
+  date: number
+  old_reaction: ReactionType[]
+  new_reaction: ReactionType[]
+}
+
+/**
+ * @see https://core.telegram.org/bots/api#reactiontype
+ */
+export type ReactionType = ReactionTypeEmoji
+  | ReactionTypeCustomEmoji
+
+/**
+ * @see https://core.telegram.org/bots/api#reactiontypeemoji
+ */
+export interface ReactionTypeEmoji {
+  type: "emoji"
+  emoji: string
+}
+
+/**
+ * @see https://core.telegram.org/bots/api#reactiontypecustomemoji
+ */
+export interface ReactionTypeCustomEmoji {
+  type: "custom_emoji"
+  custom_emoji_id: string
+}
+
+/**
+ * @see https://core.telegram.org/bots/api#messagereactioncountupdated
+ */
+export interface MessageReactionCountUpdated {
+  chat: Chat
+  message_id: number
+  date: number
+  reactions: ReactionCount[]
+}
+
+/**
+ * @see https://core.telegram.org/bots/api#reactioncount
+ */
+export interface ReactionCount {
+  type: ReactionType
+  total_count: number
+}
+
 export interface MessageEntity {
   type: MessageEntityType;
   offset: number;
@@ -977,171 +1052,171 @@ interface BotCommand {
  * Methods
  */
 
-export function setWebhook(token: string, body: SetWebHookOptions, signal: any) {
+export function setWebhook(token: string, body: SetWebHookOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/setWebhook`, {
     method: "POST",
     body: JSON.stringify(body),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Boolean>)
 }
 
-export function deleteWebhook(token: string, signal: any) {
+export function deleteWebhook(token: string, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/deleteWebhook`, {
     method: "POST",
     body: JSON.stringify({}),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Boolean>)
 }
 
 /** @todo cehck if response is the same as in typings */
-export function getWebhookInfo(token: string, signal: any): Promise<WebhookInfo> {
+export function getWebhookInfo(token: string, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/getWebhookInfo`, {
     method: "POST",
     body: JSON.stringify({}),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<WebhookInfo>)
 }
 
-export function getMe(token: string, signal: any): Promise<User> {
+export function getMe(token: string, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/getMe`, {
     method: "POST",
     body: JSON.stringify({}),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<User>)
 }
 
-export function sendMessage(token: string, payload: SendMessageOptions, signal: any): Promise<Message> {
+export function sendMessage(token: string, payload: SendMessageOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Message>)
 }
 
-export function editMessageText(token: string, payload: EditMessageTextOptions, signal: any): Promise<Message> {
+export function editMessageText(token: string, payload: EditMessageTextOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/editMessageText`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Message>)
 }
 
-export function sendPhoto(token: string, payload: SendPhotoOptions, signal: any): Promise<Message> {
+export function sendPhoto(token: string, payload: SendPhotoOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/sendPhoto`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Message>)
 }
 
-export function sendAnimation(token: string, payload: SendAnimationOptions, signal: any): Promise<Message> {
+export function sendAnimation(token: string, payload: SendAnimationOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/sendAnimation`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Message>)
 }
 
-export function sendDocument(token: string, payload: SendDocumentOptions, signal: any): Promise<Message> {
+export function sendDocument(token: string, payload: SendDocumentOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/sendDocument`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Message>)
 }
 
-export function sendDocumentStream(token: string, payload: SendDocumentStreamOptions, signal: any): Promise<Message> {
-  const body = new FormData()
-
-  body.append("chat_id", String(payload.chat_id))
-
-  if (payload.caption) {
-    body.append("caption", payload.caption)
-  }
-
-  body.append("document", payload.document, payload.documentName)
-
-  if (payload.parse_mode) {
-    body.append("parse_mode", payload.parse_mode)
-  }
-
-  return fetch(`https://api.telegram.org/bot${token}/sendDocument`, {
+export function setMessageReaction(token: string, payload: {
+  chat_id: string | number
+  message_id: number
+  reaction?: ReactionType[]
+  is_big?: boolean
+}, signal: AbortSignal) {
+  return fetch(`https://api.telegram.org/bot${token}/setMessageReaction`, {
     method: "POST",
-    body: body,
+    body: JSON.stringify(payload),
+    headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Boolean>)
 }
 
-export function getUserProfilePhotos(token: string, payload: GetUserProfilePhotosOptions, signal: any): Promise<UserProfilePhotos> {
+export function getUserProfilePhotos(token: string, payload: {
+  user_id: number | string
+  offset?: number;
+  limit?: number;
+}, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/getUserProfilePhotos`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<UserProfilePhotos>)
 }
 
-export function getFile(token: string, file_id: string, signal: any): Promise<File> {
+export function getFile(token: string, payload: {
+  file_id: string
+}, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/getFile`, {
     method: "POST",
-    body: JSON.stringify({ file_id }),
+    body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<File>)
 }
 
-export function answerCallbackQuery(token: string, payload: AnswerCallbackQueryOptions, signal: any): Promise<File> {
+export function answerCallbackQuery(token: string, payload: AnswerCallbackQueryOptions, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/answerCallbackQuery`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<File>)
 }
 
-export function getChat(token: string, payload: GetChatOptions, signal: any): Promise<Chat> {
+export function getChat(token: string, payload: {
+  chat_id: string
+}, signal: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/getChat`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Chat>)
 }
 
-export function getChatMember(token: string, payload: { chat_id: string, user_id: string }, signal: AbortSignal): Promise<ChatMember> {
+export function getChatMember(token: string, payload: { chat_id: string, user_id: string }, signal?: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/getChatMember`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal: signal
-  }).then(parseResponse)
+  }).then(parseResponse<ChatMember>)
 }
 
-export function setMyCommands(token: string, payload: SetMyCommandsOptions, signal: any): Promise<Chat> {
+export function setMyCommands(token: string, payload: SetMyCommandsOptions, signal?: AbortSignal) {
   return fetch(`https://api.telegram.org/bot${token}/setMyCommands`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Chat>)
 }
 
-export function deleteMyCommands(token: string, payload: DeleteMyCommandsOptions, signal: any): Promise<Chat> {
+export function deleteMyCommands(token: string, payload: DeleteMyCommandsOptions, signal: AbortSignal): Promise<Chat> {
   return fetch(`https://api.telegram.org/bot${token}/deleteMyCommands`, {
     method: "POST",
     body: JSON.stringify(payload),
     headers,
     signal
-  }).then(parseResponse)
+  }).then(parseResponse<Chat>)
 }
 
 /**
@@ -1149,21 +1224,34 @@ export function deleteMyCommands(token: string, payload: DeleteMyCommandsOptions
  */
 
 export function parseUpdate(update: any): Update {
-  const update_id = Number(update.update_id);
+  const u: Update = {
+    update_id: Number(update.update_id)
+  }
 
-  return {
-    update_id,
-    message: parseMessage(update.message),
-    edited_message: parseMessage(update.edited_message),
-    callback_query: parseCallbackQuery(update.callback_query),
+  if (update.message) {
+    u.message = parseMessage(update.message)
   }
-}
 
-export function parseMessage(m?: any): Message | undefined {
-  if (!m) {
-    return
+  if (update.edited_message) {
+    u.edited_message = parseMessage(update.edited_message)
+  }
+
+  if (update.callback_query) {
+    u.callback_query = parseCallbackQuery(update.callback_query)
+  }
+
+  if (update.message_reaction) {
+    u.message_reaction = parseMessageReaction(update.message_reaction)
   }
 
+  if (update.message_reaction_count) {
+    u.message_reaction_count = parseMessageReactionCount(update.message_reaction_count)
+  }
+
+  return u
+}
+
+export function parseMessage(m: any): Message {
   return {
     message_id: Number(m.message_id),
     from: m.from ? parseUser(m.from) : void 0,
@@ -1409,7 +1497,77 @@ export function parseCallbackQuery(v?: CallbackQuery): CallbackQuery | undefined
   }
 }
 
-function parseResponse<T>(response: Response) {
+function parseMessageReaction(d?: MessageReactionUpdated): MessageReactionUpdated | undefined {
+  if (!d) {
+    return
+  }
+
+  return {
+    chat: parseChat(d.chat),
+    message_id: Number(d.message_id),
+    user: d.user ? parseUser(d.user) : void 0,
+    actor_chat: d.actor_chat ? parseChat(d.actor_chat) : void 0,
+    date: Number(d.date),
+    old_reaction: parseReactions(d.old_reaction),
+    new_reaction: parseReactions(d.new_reaction),
+  }
+}
+
+function parseReactions(reactions: ReactionType[]): ReactionType[] {
+  if (!Array.isArray(reactions)) {
+    return []
+  }
+
+  return reactions.map(parseReaction)
+}
+
+function parseReaction(reaction: ReactionType): ReactionType {
+  if (reaction.type === "emoji") {
+    return {
+      type: "emoji",
+      emoji: String(reaction.emoji),
+    }
+  }
+
+  if (reaction.type === "custom_emoji") {
+    return {
+      type: "custom_emoji",
+      custom_emoji_id: String(reaction.custom_emoji_id),
+    }
+  }
+
+  throw new RangeError(`Unknown type of reaction: ${JSON.stringify(reaction)}`)
+}
+
+function parseMessageReactionCount(d?: MessageReactionCountUpdated): MessageReactionCountUpdated | undefined {
+  if (!d) {
+    return d
+  }
+
+  return {
+    chat: parseChat(d.chat),
+    message_id: Number(d.message_id),
+    date: Number(d.date),
+    reactions: parseReactionsCount(d.reactions)
+  }
+}
+
+function parseReactionsCount(reactions?: ReactionCount[]): ReactionCount[] {
+  if (!Array.isArray(reactions)) {
+    return []
+  }
+
+  return reactions.map(parseReactionCount)
+}
+
+function parseReactionCount(reaction: ReactionCount): ReactionCount {
+  return {
+    type: parseReaction(reaction.type),
+    total_count: Number(reaction.total_count),
+  }
+}
+
+export function parseResponse<T>(response: Response) {
   return response.text().then(function (text) {
     let data: any
 
@@ -1423,22 +1581,37 @@ function parseResponse<T>(response: Response) {
     const ok = Boolean(data.ok)
 
     if (ok) {
-      return data.result || {} as T
+      return data.result as T
     }
 
     const error_code = Number(data.error_code ?? 0)
     const description = String(data.description ?? "")
+    const parameters = data.parameters || {}
 
-    throw new TelegramError(description, response.status)
+    throw new TelegramError(description, error_code, parameters)
   })
 }
 
 export class TelegramError extends Error {
-  status: number
+  error_code: number
+  parameters: Record<string, any>
 
-  constructor(message: string, status: number) {
+  constructor(message: string, error_code: number, parameters: Record<string, any> = {}) {
     super(message)
 
-    this.status = status
+    this.error_code = error_code
+    this.parameters = parameters
   }
 }
+
+/**
+ * Helpers
+ */
+export const SUPPORTED_REACTION_EMOJI = ["👍", "👎", "\u2764\ufe0f" // red heart
+  , "🔥", "🥰", "👏", "😁", "🤔", "🤯", "😱", "🤬", "😢"
+  , "🎉", "🤩", "🤮", "💩", "🙏", "👌", "🕊", "🤡", "🥱", "🥴", "😍", "🐳", "❤‍🔥"
+  , "🌚", "🌭", "💯", "🤣", "⚡", "🍌", "🏆", "💔", "🤨", "😐", "🍓", "🍾", "💋"
+  , "🖕", "😈", "😴", "😭", "🤓", "👻", "👨‍💻", "👀", "🎃", "🙈", "😇", "😨", "🤝"
+  , "✍", "🤗", "🫡", "🎅", "🎄", "☃", "💅", "🤪", "🗿", "🆒", "💘", "🙉", "🦄"
+  , "😘", "💊", "🙊", "😎", "👾", "🤷‍♂", "🤷", "🤷‍♀", "😡"
+]

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "telegram-bot-api-nodejs",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Telegram Bot API client for nodejs",
   "type": "module",
-  "main": "index.js",
+  "module": "index.js",
+  "types": "index.d.ts",
   "scripts": {
-    "prepublish": "npm run build",
+    "prepublishOnly": "npm run build",
     "build": "tsc",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "pretest": "npm run build",
+    "test": "node --test"
   },
   "author": "",
   "license": "ISC",