@zero-bot.net/tg-bot-api 1.1.0 → 1.3.0

package/lib/telegram.js

@@ -23,7 +23,33 @@ const fs = require('fs');
 const pump = require('pump');
 const deprecate = require('./utils').deprecate;
 
-const _messageTypes = ['text', 'animation', 'audio', 'channel_chat_created', 'contact', 'delete_chat_photo', 'dice', 'document', 'game', 'group_chat_created', 'invoice', 'left_chat_member', 'location', 'migrate_from_chat_id', 'migrate_to_chat_id', 'new_chat_members', 'new_chat_photo', 'new_chat_title', 'passport_data', 'photo', 'pinned_message', 'poll', 'sticker', 'successful_payment', 'supergroup_chat_created', 'video', 'video_note', 'voice', 'video_chat_started', 'video_chat_ended', 'video_chat_participants_invited', 'video_chat_scheduled', 'message_auto_delete_timer_changed', 'chat_invite_link', 'chat_member_updated', 'web_app_data', 'message_reaction'];
+const _messageTypes = ['text', 'animation', 'audio', 'channel_chat_created', 'contact', 'delete_chat_photo', 'dice', 'document', 'game', 'group_chat_created', 'invoice', 'left_chat_member', 'location', 'migrate_from_chat_id', 'migrate_to_chat_id', 'new_chat_members', 'new_chat_photo', 'new_chat_title', 'passport_data', 'photo', 'pinned_message', 'poll', 'sticker', 'successful_payment', 'supergroup_chat_created', 'video', 'video_note', 'voice', 'video_chat_started', 'video_chat_ended', 'video_chat_participants_invited', 'video_chat_scheduled', 'message_auto_delete_timer_changed', 'chat_invite_link', 'chat_member_updated', 'web_app_data', 'message_reaction',
+// Bot API 7.7
+'refunded_payment',
+// Bot API 9.0
+'gift', 'unique_gift', 'paid_message_price_changed', 'paid_star_count',
+// Bot API 9.1
+'checklist', 'checklist_tasks_done', 'checklist_tasks_added', 'direct_message_price_changed',
+// Bot API 9.2
+'direct_messages_topic', 'suggested_post_info', 'suggested_post_approved', 'suggested_post_approval_failed', 'suggested_post_declined', 'suggested_post_paid', 'suggested_post_refunded',
+// Bot API 9.3
+'gift_upgrade_sent',
+// Bot API 9.4
+'chat_owner_left', 'chat_owner_changed',
+// Bot API 9.5
+'sender_tag',
+// Bot API 9.6
+'managed_bot_created', 'poll_option_added', 'poll_option_deleted',
+// Bot API 10.0
+'guest_bot_caller_user', 'guest_bot_caller_chat', 'guest_query_id', 'live_photo',
+// Bot API 10.1
+'rich_message',
+// Bot API 10.2
+'ephemeral_message_id', 'receiver_user', 'community_chat_added', 'community_chat_removed',
+// Bot API 10.3
+'stopped_message_generation', 'community_chat_joined',
+// Bot API 8.3+
+'giveaway_created', 'giveaway', 'giveaway_winners', 'giveaway_completed', 'chat_boost_added', 'story', 'chat_background_set', 'forum_topic_created', 'forum_topic_closed', 'forum_topic_reopened', 'forum_topic_edited', 'general_forum_topic_hidden', 'general_forum_topic_unhidden', 'write_access_allowed', 'boost'];
 
 const _deprecatedMessageTypes = ['new_chat_participant', 'left_chat_participant'];
 
@@ -232,6 +258,21 @@ class TelegramBot extends EventEmitter {
     }
   }
 
+  /**
+   * Fix JSON-serialized object fields by making them JSON strings if they are still objects.
+   * Covers new Bot API 7.4-10.3 fields that accept JSON-serialized objects.
+   * @param {Object} obj Object; either 'form' or 'qs'
+   * @private
+   */
+  _fixJsonFields(obj) {
+    const jsonFields = ['rich_message', 'content', 'result', 'button', 'web_app', 'photo', 'tasks', 'reaction_type', 'restricted_channels', 'target_business_connection_ids', 'accepted_gift_types', 'link_preview_options'];
+    for (const field of jsonFields) {
+      if (obj.hasOwnProperty(field) && typeof obj[field] !== 'string') {
+        obj[field] = stringify(obj[field]);
+      }
+    }
+  }
+
   /**
    * Make request against the API
    * @param  {String} _path API endpoint
@@ -252,10 +293,12 @@ class TelegramBot extends EventEmitter {
       this._fixReplyMarkup(options.form);
       this._fixEntitiesField(options.form);
       this._fixReplyParameters(options.form);
+      this._fixJsonFields(options.form);
     }
     if (options.qs) {
       this._fixReplyMarkup(options.qs);
       this._fixReplyParameters(options.qs);
+      this._fixJsonFields(options.qs);
     }
 
     options.method = 'POST';
@@ -775,6 +818,34 @@ class TelegramBot extends EventEmitter {
       debug('Process Update removed_chat_boost %j', removedChatBoost);
       this.emit('removed_chat_boost', removedChatBoost);
     }
+
+    // Update-level types not tied to message content
+    const purchasedPaidMedia = update.purchased_paid_media;
+    const subscription = update.subscription;
+    const managedBot = update.managed_bot;
+    const guestMessage = update.guest_message;
+    const stoppedMessageGeneration = update.stopped_message_generation;
+    const reaction = update.reaction;
+
+    if (purchasedPaidMedia) {
+      debug('Process Update purchased_paid_media %j', purchasedPaidMedia);
+      this.emit('purchased_paid_media', purchasedPaidMedia);
+    } else if (subscription) {
+      debug('Process Update subscription %j', subscription);
+      this.emit('subscription', subscription);
+    } else if (managedBot) {
+      debug('Process Update managed_bot %j', managedBot);
+      this.emit('managed_bot', managedBot);
+    } else if (guestMessage) {
+      debug('Process Update guest_message %j', guestMessage);
+      this.emit('guest_message', guestMessage);
+    } else if (stoppedMessageGeneration) {
+      debug('Process Update stopped_message_generation %j', stoppedMessageGeneration);
+      this.emit('stopped_message_generation', stoppedMessageGeneration);
+    } else if (reaction) {
+      debug('Process Update reaction %j', reaction);
+      this.emit('reaction', reaction);
+    }
   }
 
   /** Start Telegram Bot API methods */
@@ -3165,7 +3236,14 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendgift
    */
   sendGift(userId, giftId, form = {}) {
-    form.user_id = userId;
+    if (typeof userId === 'number' || typeof userId === 'string') {
+      // Check if it looks like a chat ID (negative numbers or @channel)
+      if (String(userId).charAt(0) === '-' || String(userId).charAt(0) === '@') {
+        form.chat_id = userId;
+      } else {
+        form.user_id = userId;
+      }
+    }
     form.gift_id = giftId;
     return this._request('sendGift', { form });
   }
@@ -3556,6 +3634,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendchecklist
    */
   sendChecklist(businessConnectionId, title, tasks, form = {}) {
+    if (!businessConnectionId) return Promise.reject(new Error('businessConnectionId is required'));
+    if (!title) return Promise.reject(new Error('title is required'));
     form.business_connection_id = businessConnectionId;
     form.title = title;
     form.tasks = stringify(tasks);
@@ -3572,6 +3652,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#editmessagechecklist
    */
   editMessageChecklist(businessConnectionId, messageId, form = {}) {
+    if (!businessConnectionId) return Promise.reject(new Error('businessConnectionId is required'));
+    if (!messageId) return Promise.reject(new Error('messageId is required'));
     form.business_connection_id = businessConnectionId;
     form.message_id = messageId;
     if (form.tasks) {
@@ -3605,6 +3687,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#approvesuggestedpost
    */
   approveSuggestedPost(businessConnectionId, messageId, form = {}) {
+    if (!businessConnectionId) return Promise.reject(new Error('businessConnectionId is required'));
+    if (!messageId) return Promise.reject(new Error('messageId is required'));
     form.business_connection_id = businessConnectionId;
     form.message_id = messageId;
     return this._request('approveSuggestedPost', { form });
@@ -3620,6 +3704,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#declinesuggestedpost
    */
   declineSuggestedPost(businessConnectionId, messageId, form = {}) {
+    if (!businessConnectionId) return Promise.reject(new Error('businessConnectionId is required'));
+    if (!messageId) return Promise.reject(new Error('messageId is required'));
     form.business_connection_id = businessConnectionId;
     form.message_id = messageId;
     return this._request('declineSuggestedPost', { form });
@@ -3639,6 +3725,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendmessagedraft
    */
   sendMessageDraft(chatId, text, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!text) return Promise.reject(new Error('text is required'));
     form.chat_id = chatId;
     form.text = text;
     if (form.entities) {
@@ -3687,6 +3775,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#repoststory
    */
   repostStory(businessConnectionId, storyId, targetBusinessConnectionIds, form = {}) {
+    if (!businessConnectionId) return Promise.reject(new Error('businessConnectionId is required'));
+    if (!storyId) return Promise.reject(new Error('storyId is required'));
     form.business_connection_id = businessConnectionId;
     form.story_id = storyId;
     form.target_business_connection_ids = stringify(targetBusinessConnectionIds);
@@ -3810,6 +3900,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#answerguestquery
    */
   answerGuestQuery(guestQueryId, text, form = {}) {
+    if (!guestQueryId) return Promise.reject(new Error('guestQueryId is required'));
+    if (!text) return Promise.reject(new Error('text is required'));
     form.guest_query_id = guestQueryId;
     form.text = text;
     return this._request('answerGuestQuery', { form });
@@ -3860,6 +3952,7 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendlivephoto
    */
   sendLivePhoto(chatId, photo, video, form = {}, fileOptions = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
     const opts = {
       qs: form
     };
@@ -3928,6 +4021,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendrichmessage
    */
   sendRichMessage(chatId, content, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!content) return Promise.reject(new Error('content is required'));
     form.chat_id = chatId;
     form.content = stringify(content);
     return this._request('sendRichMessage', { form });
@@ -3943,6 +4038,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendrichmessagedraft
    */
   sendRichMessageDraft(chatId, content, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!content) return Promise.reject(new Error('content is required'));
     form.chat_id = chatId;
     form.content = stringify(content);
     return this._request('sendRichMessageDraft', { form });
@@ -3958,6 +4055,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
    */
   answerChatJoinRequestQuery(chatJoinRequestId, queryId, form = {}) {
+    if (!chatJoinRequestId) return Promise.reject(new Error('chatJoinRequestId is required'));
+    if (!queryId) return Promise.reject(new Error('queryId is required'));
     form.chat_join_request_id = chatJoinRequestId;
     form.query_id = queryId;
     return this._request('answerChatJoinRequestQuery', { form });
@@ -3973,6 +4072,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#sendchatjoinrequestwebapp
    */
   sendChatJoinRequestWebApp(chatJoinRequestId, webApp, form = {}) {
+    if (!chatJoinRequestId) return Promise.reject(new Error('chatJoinRequestId is required'));
+    if (!webApp) return Promise.reject(new Error('webApp is required'));
     form.chat_join_request_id = chatJoinRequestId;
     form.web_app = stringify(webApp);
     return this._request('sendChatJoinRequestWebApp', { form });
@@ -3993,6 +4094,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#editephemeralmessagetext
    */
   editEphemeralMessageText(chatId, ephemeralMessageId, text, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!ephemeralMessageId) return Promise.reject(new Error('ephemeralMessageId is required'));
     form.chat_id = chatId;
     form.ephemeral_message_id = ephemeralMessageId;
     form.text = text;
@@ -4011,6 +4114,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#editephemeralmessagemedia
    */
   editEphemeralMessageMedia(chatId, ephemeralMessageId, media, form = {}, fileOptions = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!ephemeralMessageId) return Promise.reject(new Error('ephemeralMessageId is required'));
     form.chat_id = chatId;
     form.ephemeral_message_id = ephemeralMessageId;
     form.media = stringify(media);
@@ -4027,6 +4132,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
    */
   editEphemeralMessageCaption(chatId, ephemeralMessageId, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!ephemeralMessageId) return Promise.reject(new Error('ephemeralMessageId is required'));
     form.chat_id = chatId;
     form.ephemeral_message_id = ephemeralMessageId;
     this._fixEntitiesField(form);
@@ -4043,6 +4150,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
    */
   editEphemeralMessageReplyMarkup(chatId, ephemeralMessageId, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!ephemeralMessageId) return Promise.reject(new Error('ephemeralMessageId is required'));
     form.chat_id = chatId;
     form.ephemeral_message_id = ephemeralMessageId;
     return this._request('editEphemeralMessageReplyMarkup', { form });
@@ -4058,6 +4167,8 @@ class TelegramBot extends EventEmitter {
    * @see https://core.telegram.org/bots/api#deleteephemeralmessage
    */
   deleteEphemeralMessage(chatId, ephemeralMessageId, form = {}) {
+    if (!chatId) return Promise.reject(new Error('chatId is required'));
+    if (!ephemeralMessageId) return Promise.reject(new Error('ephemeralMessageId is required'));
     form.chat_id = chatId;
     form.ephemeral_message_id = ephemeralMessageId;
     return this._request('deleteEphemeralMessage', { form });

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@zero-bot.net/tg-bot-api",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Telegram Bot API",
   "main": "./index.js",
+  "types": "./lib/telegram.d.ts",
   "directories": {
     "example": "examples",
     "test": "test"