telegram-bot-api-nodejs 1.0.2 → 1.0.4

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;
@@ -490,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 */
@@ -500,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: {
@@ -629,4 +625,10 @@ export declare class TelegramError extends Error {
  * Helpers
  */
 export declare const SUPPORTED_REACTION_EMOJI: string[];
+export declare function isUnauthorizedError(err: unknown): err is Error;
+export declare function isBotBlockedByUserError(err: unknown): err is Error;
+export declare function isChatNotFoundError(err: unknown): err is Error;
+export declare function isUserDeactivatedError(err: unknown): err is Error;
+export declare function isBotKickedFromSupergroupError(err: unknown): err is Error;
+export declare function isNotEnoughRightsError(err: unknown): err is Error;
 export {};

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",
@@ -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,
@@ -490,3 +487,21 @@ export const SUPPORTED_REACTION_EMOJI = ["👍", "👎", "\u2764\ufe0f" // red h
     "✍", "🤗", "🫡", "🎅", "🎄", "☃", "💅", "🤪", "🗿", "🆒", "💘", "🙉", "🦄",
     "😘", "💊", "🙊", "😎", "👾", "🤷‍♂", "🤷", "🤷‍♀", "😡"
 ];
+export function isUnauthorizedError(err) {
+    return err instanceof Error && err.message === "Unauthorized";
+}
+export function isBotBlockedByUserError(err) {
+    return err instanceof Error && err.message.includes("Forbidden: bot was blocked by the user");
+}
+export function isChatNotFoundError(err) {
+    return err instanceof Error && err.message.includes("Bad Request: chat not found");
+}
+export function isUserDeactivatedError(err) {
+    return err instanceof Error && err.message.includes("Forbidden: user is deactivated");
+}
+export function isBotKickedFromSupergroupError(err) {
+    return err instanceof Error && err.message.includes("Forbidden: bot was kicked from the supergroup chat");
+}
+export function isNotEnoughRightsError(err) {
+    return err instanceof Error && err.message.includes("Bad Request: not enough rights to send text messages to the chat");
+}

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "telegram-bot-api-nodejs",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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",
@@ -14,7 +21,7 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^20.8.10",
-    "typescript": "^5.2.2"
+    "@types/node": "^20.11.17",
+    "typescript": "^5.3.3"
   }
 }