@codebam/cf-workers-telegram-bot 11.3.3 → 11.4.0

package/dist/main.d.ts

@@ -1,7 +1,7 @@
 import TelegramBot from './telegram_bot.js';
 import TelegramExecutionContext from './telegram_execution_context.js';
 import Webhook from './webhook.js';
-import TelegramApi, { TelegramApiBaseParams, SendMessageParams, SendMessageDraftParams, SendPhotoParams, SendVideoParams, SendChatActionParams, AnswerCallbackParams, AnswerInlineParams, AnswerGuestParams, SendInvoiceParams, AnswerPreCheckoutParams, TelegramApiParams } from './telegram_api.js';
+import TelegramApi, { TelegramApiBaseParams, SendMessageParams, SendMessageDraftParams, SendPhotoParams, SendVideoParams, SendVoiceParams, SendChatActionParams, AnswerCallbackParams, AnswerInlineParams, AnswerGuestParams, SendInvoiceParams, AnswerPreCheckoutParams, TelegramApiParams } from './telegram_api.js';
 import TelegramCommand from './types/TelegramCommand.js';
 import TelegramFrom from './types/TelegramFrom.js';
 import TelegramChat from './types/TelegramChat.js';
@@ -9,6 +9,7 @@ import TelegramUser from './types/TelegramUser.js';
 import TelegramMessageEntity from './types/TelegramMessageEntity.js';
 import TelegramPhotoSize from './types/TelegramPhotoSize.js';
 import TelegramMessage from './types/TelegramMessage.js';
+import { TelegramVoice } from './types/TelegramVoice.js';
 import TelegramGuestMessage from './types/TelegramGuestMessage.js';
 import TelegramInputMessageContent from './types/TelegramInputMessageContent.js';
 import TelegramInlineQuery from './types/TelegramInlineQuery.js';
@@ -26,4 +27,4 @@ import TelegramPreCheckoutQuery from './types/TelegramPreCheckoutQuery.js';
 import TelegramDocument from './types/TelegramDocument.js';
 import TelegramSuccessfulPayment from './types/TelegramSuccessfulPayment.js';
 export default TelegramBot;
-export { TelegramBot, TelegramExecutionContext, Webhook, TelegramApi, TelegramApiBaseParams, SendMessageParams, SendMessageDraftParams, SendPhotoParams, SendVideoParams, SendChatActionParams, AnswerCallbackParams, AnswerInlineParams, AnswerGuestParams, SendInvoiceParams, AnswerPreCheckoutParams, TelegramApiParams, TelegramCommand, TelegramFrom, TelegramChat, TelegramUser, TelegramMessageEntity, TelegramPhotoSize, TelegramMessage, TelegramGuestMessage, TelegramInputMessageContent, TelegramInlineQuery, TelegramUpdate, PartialTelegramUpdate, TelegramInlineQueryType, TelegramInlineQueryResult, TelegramInlineQueryResultPhoto, TelegramInlineQueryResultArticle, TelegramInlineQueryResultVideo, ChatPermissions, TelegramBusinessMessage, TelegramCallbackQuery, TelegramPreCheckoutQuery, TelegramDocument, TelegramSuccessfulPayment, };
+export { TelegramBot, TelegramExecutionContext, Webhook, TelegramApi, TelegramApiBaseParams, SendMessageParams, SendMessageDraftParams, SendPhotoParams, SendVideoParams, SendVoiceParams, SendChatActionParams, AnswerCallbackParams, AnswerInlineParams, AnswerGuestParams, SendInvoiceParams, AnswerPreCheckoutParams, TelegramApiParams, TelegramCommand, TelegramFrom, TelegramChat, TelegramUser, TelegramMessageEntity, TelegramPhotoSize, TelegramMessage, TelegramVoice, TelegramGuestMessage, TelegramInputMessageContent, TelegramInlineQuery, TelegramUpdate, PartialTelegramUpdate, TelegramInlineQueryType, TelegramInlineQueryResult, TelegramInlineQueryResultPhoto, TelegramInlineQueryResultArticle, TelegramInlineQueryResultVideo, ChatPermissions, TelegramBusinessMessage, TelegramCallbackQuery, TelegramPreCheckoutQuery, TelegramDocument, TelegramSuccessfulPayment, };

package/dist/telegram_api.d.ts

@@ -84,8 +84,19 @@ export interface AnswerPreCheckoutParams {
     ok: boolean;
     error_message?: string;
 }
+/** Interface for voice parameters */
+export interface SendVoiceParams extends TelegramApiBaseParams {
+    voice: string;
+    caption?: string;
+    parse_mode?: string;
+    duration?: number;
+    reply_to_message_id?: number | string;
+    disable_notification?: boolean;
+    protect_content?: boolean;
+    reply_markup?: object;
+}
 /** Type for all possible API parameters */
-export type TelegramApiParams = SendMessageParams | SendPhotoParams | SendVideoParams | SendChatActionParams | AnswerCallbackParams | AnswerInlineParams | AnswerGuestParams | SendInvoiceParams | AnswerPreCheckoutParams | Record<string, unknown>;
+export type TelegramApiParams = SendMessageParams | SendPhotoParams | SendVideoParams | SendVoiceParams | SendChatActionParams | AnswerCallbackParams | AnswerInlineParams | AnswerGuestParams | SendInvoiceParams | AnswerPreCheckoutParams | Record<string, unknown>;
 /** Class representing the Telegram API and all its methods */
 export default class TelegramApi {
     /**
@@ -142,6 +153,13 @@ export default class TelegramApi {
      * @returns Promise with the API response
      */
     sendPhoto(botApi: string, data: SendPhotoParams): Promise<Response>;
+    /**
+     * Send a voice message to a given botApi
+     * @param botApi - full URL to the telegram API without slug
+     * @param data - data to append to the request
+     * @returns Promise with the API response
+     */
+    sendVoice(botApi: string, data: SendVoiceParams): Promise<Response>;
     /**
      * Send an inline response to a given botApi
      * @param botApi - full URL to the telegram API without slug

package/dist/telegram_api.js

@@ -106,6 +106,16 @@ export default class TelegramApi {
         const url = this.getApiUrl(botApi, 'sendPhoto', data);
         return await this.fetchAndLog(url, 'sendPhoto', data);
     }
+    /**
+     * Send a voice message to a given botApi
+     * @param botApi - full URL to the telegram API without slug
+     * @param data - data to append to the request
+     * @returns Promise with the API response
+     */
+    async sendVoice(botApi, data) {
+        const url = this.getApiUrl(botApi, 'sendVoice', data);
+        return await this.fetchAndLog(url, 'sendVoice', data);
+    }
     /**
      * Send an inline response to a given botApi
      * @param botApi - full URL to the telegram API without slug

package/dist/telegram_bot.js

@@ -105,6 +105,8 @@ export default class TelegramBot {
         switch (ctx.update_type) {
             case 'photo':
                 return ':photo' in this.commands ? ':photo' : this.defaultCommand;
+            case 'voice':
+                return ':voice' in this.commands ? ':voice' : this.defaultCommand;
             case 'document':
                 return ':document' in this.commands ? ':document' : this.defaultCommand;
             case 'callback':

package/dist/telegram_execution_context.d.ts

@@ -80,6 +80,14 @@ export default class TelegramExecutionContext {
      * @returns Promise with the API response
      */
     replyPhoto(photo: string, caption?: string, options?: Record<string, number | string | boolean>): Promise<Response | null>;
+    /**
+     * Reply to the last message with a voice message
+     * @param voice - url or file_id to voice
+     * @param caption - voice caption
+     * @param options - any additional options to pass to sendVoice
+     * @returns Promise with the API response
+     */
+    replyVoice(voice: string, caption?: string, options?: Record<string, number | string | boolean>): Promise<Response | null>;
     /**
      * Send typing in a chat
      * @returns Promise with the API response

package/dist/telegram_execution_context.js

@@ -70,6 +70,9 @@ export default class TelegramExecutionContext {
         if (this.update.message?.photo) {
             return 'photo';
         }
+        else if (this.update.message?.voice) {
+            return 'voice';
+        }
         else if (this.update.message?.text) {
             return 'message';
         }
@@ -199,6 +202,30 @@ export default class TelegramExecutionContext {
                 return null;
         }
     }
+    /**
+     * Reply to the last message with a voice message
+     * @param voice - url or file_id to voice
+     * @param caption - voice caption
+     * @param options - any additional options to pass to sendVoice
+     * @returns Promise with the API response
+     */
+    async replyVoice(voice, caption = '', options = {}) {
+        switch (this.update_type) {
+            case 'voice':
+            case 'message':
+            case 'guest_message':
+                return await this.api.sendVoice(this.bot.api.toString(), {
+                    ...options,
+                    chat_id: this.getChatId(),
+                    message_thread_id: this.getThreadId(),
+                    reply_to_message_id: this.getMessageId(),
+                    voice,
+                    caption,
+                });
+            default:
+                return null;
+        }
+    }
     /**
      * Send typing in a chat
      * @returns Promise with the API response

package/dist/types/TelegramMessage.d.ts

@@ -5,6 +5,7 @@ import TelegramMessageEntity from './TelegramMessageEntity.js';
 import TelegramPhotoSize from './TelegramPhotoSize.js';
 import TelegramUser from './TelegramUser.js';
 import TelegramSuccessfulPayment from './TelegramSuccessfulPayment.js';
+import { TelegramVoice } from './TelegramVoice.js';
 interface TelegramMessage {
     message_id: number;
     message_thread_id?: number;
@@ -29,6 +30,7 @@ interface TelegramMessage {
     entities?: TelegramMessageEntity[];
     document?: TelegramDocument;
     photo?: TelegramPhotoSize[];
+    voice?: TelegramVoice;
     caption?: string;
     caption_entities?: TelegramMessageEntity[];
     new_chat_members?: TelegramUser[];

package/dist/types/TelegramVoice.d.ts

@@ -0,0 +1,7 @@
+export interface TelegramVoice {
+    file_id: string;
+    file_unique_id: string;
+    duration: number;
+    mime_type?: string;
+    file_size?: number;
+}

package/dist/types/TelegramVoice.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@codebam/cf-workers-telegram-bot",
-	"version": "11.3.3",
+	"version": "11.4.0",
 	"description": "serverless telegram bot on cf workers",
 	"main": "./dist/main.js",
 	"module": "./dist/main.js",