telegram-bot-api-nodejs 1.0.13 → 1.0.15

package/index.d.ts

@@ -552,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;
@@ -668,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));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telegram-bot-api-nodejs",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Telegram Bot API client for nodejs",
   "type": "module",
   "main": "index.js",
@@ -22,7 +22,7 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^20.11.17",
-    "typescript": "^5.3.3"
+    "@types/node": "^20.12.7",
+    "typescript": "^5.4.5"
   }
 }