telegram-bot-api-nodejs 1.0.1 → 1.0.3

package/index.d.ts

@@ -23,12 +23,7 @@ export interface SendMessageOptions extends SendBasicOptions {
     disable_web_page_preview?: boolean;
     entities?: MessageEntity[];
 }
-export interface SendPhotoOptions extends SendBasicOptions {
-    photo: string;
-    parse_mode?: ParseMode;
-    caption?: string;
-}
-export interface SendAnimationOptions extends SendBasicOptions {
+interface SendAnimationOptions extends SendBasicOptions {
     animation: string;
     parse_mode?: ParseMode;
     caption?: string;
@@ -45,9 +40,6 @@ export interface AnswerCallbackQueryOptions {
     url?: string;
     cache_time?: number;
 }
-export interface GetChatOptions {
-    chat_id: string;
-}
 interface SetMyCommandsOptions {
     commands: BotCommand[];
 }
@@ -63,11 +55,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;
@@ -498,9 +485,6 @@ interface BotCommand {
     command: string;
     description: string;
 }
-/**
- * Methods
- */
 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 */
@@ -508,7 +492,11 @@ export declare function getWebhookInfo(token: string, signal: AbortSignal): Prom
 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 sendPhoto(token: string, payload: SendBasicOptions & {
+    photo: string;
+    caption?: string;
+    parse_mode?: ParseMode;
+}, 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: {
@@ -517,10 +505,18 @@ export declare function setMessageReaction(token: string, payload: {
     reaction?: ReactionType[];
     is_big?: boolean;
 }, signal: AbortSignal): Promise<Boolean>;
-export declare function getUserProfilePhotos(token: string, payload: GetUserProfilePhotosOptions, signal: AbortSignal): Promise<UserProfilePhotos>;
-export declare function getFile(token: string, file_id: string, signal: AbortSignal): Promise<File>;
+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: GetChatOptions, signal: AbortSignal): Promise<Chat>;
+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;
@@ -619,9 +615,11 @@ 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

package/index.js

@@ -1,13 +1,10 @@
 /**
- * Common headers for API calls
+ * Methods
  */
 const headers = {
     "Accept": "application/json",
     "Content-Type": "application/json",
 };
-/**
- * Methods
- */
 export function setWebhook(token, body, signal) {
     return fetch(`https://api.telegram.org/bot${token}/setWebhook`, {
         method: "POST",
@@ -97,10 +94,10 @@ export function getUserProfilePhotos(token, payload, signal) {
         signal
     }).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));
@@ -176,17 +173,17 @@ export function parseMessage(m) {
         date: Number(m.date),
         chat: parseChat(m.chat),
         text: String(m.text ?? ""),
-        forward_from: m.forward_from ? parseUser(m.forward_from) : void 0,
-        forward_from_chat: m.forward_from_chat ? parseChat(m.forward_from_chat) : void 0,
-        forward_from_message_id: m.forward_from_message_id ? Number(m.forward_from_message_id) : void 0,
-        forward_signature: m.forward_signature ? String(m.forward_signature) : void 0,
-        forward_sender_name: m.forward_sender_name ? String(m.forward_sender_name) : void 0,
-        forward_date: m.forward_date ? Number(m.forward_date) : void 0,
+        forward_from: m.forward_from ? parseUser(m.forward_from) : void 0, // User;
+        forward_from_chat: m.forward_from_chat ? parseChat(m.forward_from_chat) : void 0, // Chat;
+        forward_from_message_id: m.forward_from_message_id ? Number(m.forward_from_message_id) : void 0, // number;
+        forward_signature: m.forward_signature ? String(m.forward_signature) : void 0, // string;
+        forward_sender_name: m.forward_sender_name ? String(m.forward_sender_name) : void 0, // string;
+        forward_date: m.forward_date ? Number(m.forward_date) : void 0, // number;
         // reply_to_message: m.reply_to_message ? parseMessage(m.reply_to_message) : void 0, // Message;
-        edit_date: m.edit_date ? Number(m.edit_date) : void 0,
-        media_group_id: m.media_group_id ? String(m.media_group_id) : void 0,
-        author_signature: m.author_signature ? String(m.author_signature) : void 0,
-        entities: m.entities ? parseEntities(m.entities) : void 0,
+        edit_date: m.edit_date ? Number(m.edit_date) : void 0, // number;
+        media_group_id: m.media_group_id ? String(m.media_group_id) : void 0, // string;
+        author_signature: m.author_signature ? String(m.author_signature) : void 0, // string;
+        entities: m.entities ? parseEntities(m.entities) : void 0, // MessageEntity[];
         // caption_entities: m.caption_entities ? parseSometh(m.caption_entities) : void 0, // MessageEntity[];
         audio: m.audio ? parseAudio(m.audio) : void 0,
         document: m.document ? parseDocument(m.document) : void 0,
@@ -450,7 +447,7 @@ function parseReactionCount(reaction) {
         total_count: Number(reaction.total_count),
     };
 }
-function parseResponse(response) {
+export function parseResponse(response) {
     return response.text().then(function (text) {
         let data;
         try {
@@ -465,14 +462,17 @@ function parseResponse(response) {
         }
         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;
     }
 }
 /**

package/package.json

@@ -1,19 +1,27 @@
 {
   "name": "telegram-bot-api-nodejs",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Telegram Bot API client for nodejs",
   "type": "module",
-  "module": "index.js",
+  "main": "index.js",
   "types": "index.d.ts",
+  "engines": {
+    "node": ">=18.x"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
   "scripts": {
     "prepublishOnly": "npm run build",
     "build": "tsc",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "pretest": "npm run build",
+    "test": "node --test"
   },
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^20.8.10",
-    "typescript": "^5.2.2"
+    "@types/node": "^20.11.17",
+    "typescript": "^5.3.3"
   }
 }