telegram-bot-api-nodejs 1.2.6 → 1.2.9

package/index.d.ts

@@ -26,6 +26,16 @@ export interface SendMessageOptions extends SendBasicOptions {
     disable_web_page_preview?: boolean;
     entities?: MessageEntity[];
 }
+export interface SendPhotoOptions extends SendBasicOptions {
+    photo: string;
+    caption?: string;
+    parse_mode?: ParseMode;
+}
+export interface SendAudioOptions extends SendBasicOptions {
+    audio: string;
+    caption?: string;
+    parse_mode?: ParseMode;
+}
 export interface SendAnimationOptions extends SendBasicOptions {
     animation: string;
     parse_mode?: ParseMode;
@@ -36,6 +46,16 @@ export interface SendDocumentOptions extends SendBasicOptions {
     parse_mode?: ParseMode;
     caption?: string;
 }
+export interface SendVideoOptions extends SendBasicOptions {
+    video: string;
+    caption?: string;
+    parse_mode?: ParseMode;
+}
+export interface SendVoiceOptions extends SendBasicOptions {
+    voice: string;
+    caption?: string;
+    parse_mode?: ParseMode;
+}
 export interface SendMediaGroupOptions extends SendBasicOptions {
     media: Array<InputMediaAudio | InputMediaDocument | InputMediaPhoto | InputMediaVideo>;
 }
@@ -1082,44 +1102,13 @@ export declare function deleteMessage(token: string, payload: {
     chat_id: string | number;
     message_id: number;
 }, signal: AbortSignal): Promise<{}>;
-export declare function sendPhoto(token: string, payload: SendBasicOptions & {
-    photo: string;
-    caption?: string;
-    parse_mode?: ParseMode;
-}, signal: AbortSignal): Promise<Message>;
-export declare function sendAudio(token: string, payload: SendBasicOptions & {
-    audio: string;
-    caption?: string;
-    parse_mode?: ParseMode;
-}, signal: AbortSignal): Promise<Message>;
-export declare function sendAnimation(token: string, payload: SendAnimationOptions, signal: AbortSignal): Promise<Message>;
-/**
-   * @example
-   *
-   * const body = new FormData()
-   *
-   * body.append("chat_id", payload.chat_id)
-   * body.append("caption", payload.caption)
-   * body.append("document", payload.document, payload.documentName)
-   *
-   * if (payload.parse_mode) {
-   *   body.append("parse_mode", payload.parse_mode)
-   * }
-   *
-   * sendDocument("token", payload)
-   */
+export declare function sendPhoto(token: string, payload: SendPhotoOptions | FormData, signal: AbortSignal): Promise<Message>;
+export declare function sendAudio(token: string, payload: SendAudioOptions | FormData, signal: AbortSignal): Promise<Message>;
+export declare function sendAnimation(token: string, payload: SendAnimationOptions | FormData, signal: AbortSignal): Promise<Message>;
 export declare function sendDocument(token: string, payload: SendDocumentOptions | FormData, signal: AbortSignal): Promise<Message>;
-export declare function sendVideo(token: string, payload: SendBasicOptions & {
-    video: string;
-    caption?: string;
-    parse_mode?: ParseMode;
-}, signal: AbortSignal): Promise<Message>;
-export declare function sendVoice(token: string, payload: SendBasicOptions & {
-    voice: string;
-    caption?: string;
-    parse_mode?: ParseMode;
-}, signal: AbortSignal): Promise<Message>;
-export declare function sendMediaGroup(token: string, payload: SendMediaGroupOptions, signal: AbortSignal): Promise<Message[]>;
+export declare function sendVideo(token: string, payload: SendVideoOptions | FormData, signal: AbortSignal): Promise<Message>;
+export declare function sendVoice(token: string, payload: SendVoiceOptions | FormData, signal: AbortSignal): Promise<Message>;
+export declare function sendMediaGroup(token: string, payload: SendMediaGroupOptions | FormData, signal: AbortSignal): Promise<Message[]>;
 export declare function setMessageReaction(token: string, payload: {
     chat_id: string | number;
     message_id: number;
@@ -1155,6 +1144,8 @@ export declare function getBusinessConnection(token: string, payload: {
  * Parsers
  */
 export declare function parseUpdate(update: any): Update;
+export declare function prepareFormBody(payload: FormData | Object): BodyInit | string;
+export declare function prepareFormHeaders(forPayload: FormData | Object): HeadersInit | undefined;
 export declare function parseResponse<T>(response: Response): Promise<T>;
 export declare class TelegramError extends Error {
     status: number;
@@ -1185,12 +1176,14 @@ export declare function isMessageToEditNotFoundError(err: unknown): boolean;
 export declare function isMessageToDeleteNotFoundError(err: unknown): boolean;
 export declare function isMessageNotModifiedError(err: unknown): boolean;
 export declare function isWrongTypeOfTheWebPageContentError(err: unknown): boolean;
+export declare function isWebpageMediaEmptyError(err: unknown): boolean;
 export declare function isFailToGetHTTPURLContentError(err: unknown): boolean;
 export declare function isWrongFileIdentifierError(err: unknown): boolean;
 export declare function isInvalidFileUrlSpecifiedError(err: unknown): boolean;
 export declare function isMessageDeleteError(err: unknown): boolean;
 export declare function isBotNotMemberGroupChatError(err: unknown): boolean;
 export declare function isBusinessPeerUsageMissingError(err: unknown): boolean;
+export declare function isInvalidPhotoDimensionsError(err: unknown): boolean;
 export declare function parseRetryAfterTime(err: unknown): number;
 export declare function resolveNameFromMessageOrigin(messageOrigin: MessageOrigin): string;
 export declare function resolveChatName(chat: any): string;

package/index.js

@@ -66,80 +66,56 @@ export function deleteMessage(token, payload, signal) {
 export function sendPhoto(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendPhoto`, {
         method: "POST",
-        body: JSON.stringify(payload),
-        headers,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
 export function sendAudio(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendAudio`, {
         method: "POST",
-        body: JSON.stringify(payload),
-        headers,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
 export function sendAnimation(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendAnimation`, {
         method: "POST",
-        body: JSON.stringify(payload),
-        headers,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
-/**
-   * @example
-   *
-   * const body = new FormData()
-   *
-   * body.append("chat_id", payload.chat_id)
-   * body.append("caption", payload.caption)
-   * body.append("document", payload.document, payload.documentName)
-   *
-   * if (payload.parse_mode) {
-   *   body.append("parse_mode", payload.parse_mode)
-   * }
-   *
-   * sendDocument("token", payload)
-   */
 export function sendDocument(token, payload, signal) {
-    let h = headers;
-    let b = undefined;
-    if (payload instanceof FormData) {
-        h = undefined;
-        b = payload;
-    }
-    else {
-        b = JSON.stringify(payload);
-    }
     return fetch(`https://api.telegram.org/bot${token}/sendDocument`, {
         method: "POST",
-        body: b,
-        headers: h,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
 export function sendVideo(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendVideo`, {
         method: "POST",
-        body: JSON.stringify(payload),
-        headers,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
 export function sendVoice(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendVoice`, {
         method: "POST",
-        body: JSON.stringify(payload),
-        headers,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
 export function sendMediaGroup(token, payload, signal) {
     return fetch(`https://api.telegram.org/bot${token}/sendMediaGroup`, {
         method: "POST",
-        body: JSON.stringify(payload),
-        headers,
+        body: prepareFormBody(payload),
+        headers: prepareFormHeaders(payload),
         signal
     }).then(parseResponse);
 }
@@ -497,6 +473,21 @@ function parseReactionCount(reaction) {
         total_count: Number(reaction.total_count),
     };
 }
+export function prepareFormBody(payload) {
+    if (payload instanceof FormData) {
+        return payload;
+    }
+    return JSON.stringify(payload);
+}
+export function prepareFormHeaders(forPayload) {
+    if (forPayload instanceof FormData) {
+        return undefined;
+    }
+    return {
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+    };
+}
 export function parseResponse(response) {
     return response.text().then(function (text) {
         let data;
@@ -616,6 +607,11 @@ export function isMessageNotModifiedError(err) {
 export function isWrongTypeOfTheWebPageContentError(err) {
     return err instanceof Error && err.message.includes("wrong type of the web page content");
 }
+// Bad Request: failed to send message #1 with the error message "WEBPAGE_MEDIA_EMPTY"
+export function isWebpageMediaEmptyError(err) {
+    return err instanceof Error
+        && /^Bad Request: failed to send message #\d+ with the error message "WEBPAGE_MEDIA_EMPTY"$/.test(err.message);
+}
 // Bad Request: failed to get HTTP URL content
 export function isFailToGetHTTPURLContentError(err) {
     return err instanceof Error && err.message.includes("failed to get HTTP URL content");
@@ -638,6 +634,9 @@ export function isBotNotMemberGroupChatError(err) {
 export function isBusinessPeerUsageMissingError(err) {
     return err instanceof Error && err.message === "Bad Request: BUSINESS_PEER_USAGE_MISSING";
 }
+export function isInvalidPhotoDimensionsError(err) {
+    return err instanceof Error && err.message.includes("PHOTO_INVALID_DIMENSIONS");
+}
 export function parseRetryAfterTime(err) {
     if (!(err instanceof Error)) {
         throw new RangeError("`err` needs to be an Error");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telegram-bot-api-nodejs",
-  "version": "1.2.6",
+  "version": "1.2.9",
   "description": "Telegram Bot API client for nodejs",
   "type": "module",
   "main": "index.js",
@@ -25,9 +25,9 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^25.0.9"
+    "@types/node": "^25.2.2"
   },
   "dependencies": {
-    "@typescript/native-preview": "^7.0.0-dev.20260119.1"
+    "@typescript/native-preview": "^7.0.0-dev.20260208.1"
   }
 }