telegram-bot-api-nodejs 1.0.12 → 1.0.14

package/index.d.ts

@@ -441,6 +441,8 @@ export interface Sticker {
     file_id: string;
     width: number;
     height: number;
+    thumbnail?: PhotoSize;
+    /** @deprecated */
     thumb?: PhotoSize;
     emoji?: string;
     set_name?: string;
@@ -524,7 +526,9 @@ export interface Animation extends FileBase {
     width: number;
     height: number;
     duration: number;
+    /** @deprecated */
     thumb?: PhotoSize;
+    thumbnail?: PhotoSize;
     file_name?: string;
     mime_type?: string;
 }
@@ -548,7 +552,22 @@ export declare function sendPhoto(token: string, payload: SendBasicOptions & {
     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>;
+/**
+   * @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 sendDocument(token: string, payload: SendDocumentOptions | FormData, signal: AbortSignal): Promise<Message>;
 export declare function sendMediaGroup(token: string, payload: SendMediaGroupOptions, signal: AbortSignal): Promise<Message[]>;
 export declare function setMessageReaction(token: string, payload: {
     chat_id: string | number;
@@ -609,14 +628,7 @@ export declare function parseVideoNote(v: VideoNote): VideoNote;
 export declare function parseEntities(v: MessageEntity[]): MessageEntity[];
 export declare function parseAudio(v: Audio): Audio;
 export declare function parseDocument(v: Document): Document;
-export declare function parseAnimation(v: Animation): {
-    file_id: string;
-    width: number;
-    height: number;
-    duration: number;
-    file_name: string;
-    mime_type: string;
-};
+export declare function parseAnimation(v: Animation): Animation;
 export declare function parseContact(v: Contact): {
     phone_number: string;
     first_name: string;
@@ -671,10 +683,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 declare function isUnauthorizedError(err: unknown): boolean;
+export declare function isBotBlockedByUserError(err: unknown): boolean;
+export declare function isChatNotFoundError(err: unknown): boolean;
+export declare function isUserDeactivatedError(err: unknown): boolean;
+export declare function isBotKickedFromSupergroupError(err: unknown): boolean;
+export declare function isNotEnoughRightsError(err: unknown): boolean;
 export {};

package/index.js

@@ -70,11 +70,35 @@ export function sendAnimation(token, payload, signal) {
         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: JSON.stringify(payload),
-        headers,
+        body: b,
+        headers: h,
         signal
     }).then((parseResponse));
 }
@@ -268,6 +292,7 @@ export function parseSticker(v) {
         width: Number(v.width),
         height: Number(v.height),
         thumb: v.thumb ? parsePhotoSize(v.thumb) : void 0,
+        thumbnail: v.thumbnail ? parsePhotoSize(v.thumbnail) : void 0,
         emoji: String(v.emoji),
     };
 }
@@ -339,6 +364,8 @@ export function parseAnimation(v) {
         duration: Number(v.duration),
         file_name: String(v.file_name),
         mime_type: String(v.mime_type || ""),
+        thumb: v.thumb ? parsePhotoSize(v.thumb) : void 0,
+        thumbnail: v.thumbnail ? parsePhotoSize(v.thumbnail) : void 0,
     };
 }
 export function parseContact(v) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telegram-bot-api-nodejs",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Telegram Bot API client for nodejs",
   "type": "module",
   "main": "index.js",