teledzik 1.1.4 → 1.2.0

package/lib/context.js

@@ -1153,6 +1153,117 @@ class Context {
         this.assert(this.chat, 'deleteMessages');
         return this.telegram.deleteMessages(this.chat.id, messageIds);
     }
+    // -------------------------------------------------------------------------
+    // Bot API 10.0 - 10.3 Context Shorthands
+    // -------------------------------------------------------------------------
+    /**
+     * Send a live photo to the current chat.
+     * @see https://core.telegram.org/bots/api#sendlivephoto
+     */
+    sendLivePhoto(photo, video, extra) {
+        this.assert(this.chat, 'sendLivePhoto');
+        return this.telegram.sendLivePhoto(this.chat.id, photo, video, extra);
+    }
+    /**
+     * Reply with a live photo to the current message.
+     * @see https://core.telegram.org/bots/api#sendlivephoto
+     */
+    replyWithLivePhoto(photo, video, extra) {
+        this.assert(this.chat, 'replyWithLivePhoto');
+        this.assert(this.msgId, 'replyWithLivePhoto');
+        return this.telegram.sendLivePhoto(this.chat.id, photo, video, {
+            reply_parameters: { message_id: this.msgId },
+            ...extra,
+        });
+    }
+    /**
+     * Edit an ephemeral message text in the current chat.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagetext
+     */
+    editEphemeralMessageText(messageId, text, extra) {
+        this.assert(this.chat, 'editEphemeralMessageText');
+        return this.telegram.editEphemeralMessageText(this.chat.id, messageId, text, extra);
+    }
+    /**
+     * Edit an ephemeral message media in the current chat.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagemedia
+     */
+    editEphemeralMessageMedia(messageId, media, extra) {
+        this.assert(this.chat, 'editEphemeralMessageMedia');
+        return this.telegram.editEphemeralMessageMedia(this.chat.id, messageId, media, extra);
+    }
+    /**
+     * Edit an ephemeral message caption in the current chat.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
+     */
+    editEphemeralMessageCaption(messageId, extra) {
+        this.assert(this.chat, 'editEphemeralMessageCaption');
+        return this.telegram.editEphemeralMessageCaption(this.chat.id, messageId, extra);
+    }
+    /**
+     * Edit an ephemeral message reply markup in the current chat.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
+     */
+    editEphemeralMessageReplyMarkup(messageId, replyMarkup) {
+        this.assert(this.chat, 'editEphemeralMessageReplyMarkup');
+        return this.telegram.editEphemeralMessageReplyMarkup(this.chat.id, messageId, replyMarkup);
+    }
+    /**
+     * Delete an ephemeral message in the current chat.
+     * @see https://core.telegram.org/bots/api#deleteephemeralmessage
+     */
+    deleteEphemeralMessage(messageId) {
+        this.assert(this.chat, 'deleteEphemeralMessage');
+        const id = messageId ?? this.msgId;
+        this.assert(id, 'deleteEphemeralMessage');
+        return this.telegram.deleteEphemeralMessage(this.chat.id, id);
+    }
+    /**
+     * Send a streaming message draft (private chats only).
+     * @see https://core.telegram.org/bots/api#sendmessagedraft
+     */
+    sendMessageDraft(draftId, text, extra) {
+        this.assert(this.chat, 'sendMessageDraft');
+        return this.telegram.sendMessageDraft(this.chat.id, draftId, text, extra);
+    }
+    /**
+     * Delete all reactions from the current message.
+     * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+     */
+    deleteAllMessageReactions(messageId) {
+        this.assert(this.chat, 'deleteAllMessageReactions');
+        const id = messageId ?? this.msgId;
+        this.assert(id, 'deleteAllMessageReactions');
+        return this.telegram.deleteAllMessageReactions(this.chat.id, id);
+    }
+    /**
+     * Delete a specific reaction from the current message.
+     * @see https://core.telegram.org/bots/api#deletemessagereaction
+     */
+    deleteMessageReaction(messageId, extra) {
+        this.assert(this.chat, 'deleteMessageReaction');
+        const id = messageId ?? this.msgId;
+        this.assert(id, 'deleteMessageReaction');
+        return this.telegram.deleteMessageReaction(this.chat.id, id, extra);
+    }
+    /**
+     * Answer a guest query.
+     * @see https://core.telegram.org/bots/api#answerguestquery
+     */
+    answerGuestQuery(result, extra) {
+        const queryId = this.message?.guest_query_id;
+        this.assert(queryId, 'answerGuestQuery');
+        return this.telegram.answerGuestQuery(queryId, result, extra);
+    }
+    /**
+     * Answer a chat join request query.
+     * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
+     */
+    answerChatJoinRequestQuery(isApproved, extra) {
+        const queryId = this.chatJoinRequest?.query_id;
+        this.assert(queryId, 'answerChatJoinRequestQuery');
+        return this.telegram.answerChatJoinRequestQuery(queryId, isApproved, extra);
+    }
     /**
      * @see https://core.telegram.org/bots/api#forwardmessage
      */

package/lib/core/types/bot-api-recent.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Telegram Bot API 10.0 - 10.3 Recent Updates
+ * @see https://core.telegram.org/bots/api#recent-changes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/core/types/rich-message.js

@@ -81,10 +81,19 @@ class RichHTMLBuilder {
         this._parts.push(`<blockquote>${html}</blockquote>`);
         return this;
     }
+    expandableBlockQuote(html) {
+        this._parts.push(`<blockquote expandable>${html}</blockquote>`);
+        return this;
+    }
     pullQuote(html, cite) {
         this._parts.push(`<aside>${html}${cite ? `<cite>${cite}</cite>` : ''}</aside>`);
         return this;
     }
+    document(src, caption) {
+        const doc = `<tg-document src="${src}"></tg-document>`;
+        this._parts.push(caption ? `<figure>${doc}<figcaption>${caption}</figcaption></figure>` : doc);
+        return this;
+    }
     photo(src, caption, spoiler) {
         const img = `<img src="${src}"${spoiler ? ' tg-spoiler' : ''}/>`;
         this._parts.push(caption ? `<figure>${img}<figcaption>${caption}</figcaption></figure>` : img);
@@ -114,7 +123,11 @@ class RichHTMLBuilder {
         return this;
     }
     table(rows, options) {
-        const attrs = [options?.bordered && 'bordered', options?.striped && 'striped']
+        const attrs = [
+            options?.bordered && 'bordered',
+            options?.striped && 'striped',
+            options?.isCompact && 'compact',
+        ]
             .filter(Boolean)
             .join(' ');
         const [header, ...body] = rows;

package/lib/core/types/typegram.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("@telegraf/types"), exports);
 __exportStar(require("./rich-message"), exports);
+__exportStar(require("./bot-api-recent"), exports);

package/lib/future.js

@@ -83,6 +83,10 @@ const replyContext = {
         this.assert(this.chat, 'replyWithPhoto');
         return this.telegram.sendPhoto(this.chat.id, photo, makeReply(this, extra));
     },
+    replyWithLivePhoto(photo, video, extra) {
+        this.assert(this.chat, 'replyWithLivePhoto');
+        return this.telegram.sendLivePhoto(this.chat.id, photo, video, makeReply(this, extra));
+    },
     replyWithPoll(question, options, extra) {
         this.assert(this.chat, 'replyWithPoll');
         return this.telegram.sendPoll(this.chat.id, question, options, makeReply(this, extra));
@@ -160,6 +164,7 @@ function useNewReplies() {
         ctx.replyWithHTML = replyContext.replyWithHTML;
         ctx.replyWithRichMessage = replyContext.replyWithRichMessage;
         ctx.replyWithRichMessageContent = replyContext.replyWithRichMessageContent;
+        ctx.replyWithLivePhoto = replyContext.replyWithLivePhoto;
         return next();
     };
 }

package/lib/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InputBox = exports.FormScene = exports.PaginatedBuilder = exports.sanitizeRichHtml = exports.AIStreamAdapter = exports.SmartQueue = exports.MD = exports.HTML = exports.RichMarkdownBuilder = exports.RichHTMLBuilder = exports.RichMessage = exports.Scenes = exports.MemorySessionStore = exports.session = exports.deunionize = exports.Format = exports.Input = exports.Markup = exports.Types = exports.Telegram = exports.TelegramError = exports.Router = exports.Composer = exports.Context = exports.Telegraf = void 0;
+exports.InputBox = exports.FormScene = exports.PaginatedBuilder = exports.sanitizeRichHtml = exports.AIStreamAdapter = exports.SmartQueue = exports.MD = exports.HTML = exports.RichMarkdownBuilder = exports.RichHTMLBuilder = exports.RecentTypes = exports.RichMessage = exports.Scenes = exports.MemorySessionStore = exports.session = exports.deunionize = exports.Format = exports.Input = exports.Markup = exports.Types = exports.Telegram = exports.TelegramError = exports.Router = exports.Composer = exports.Context = exports.Telegraf = void 0;
 var telegraf_1 = require("./telegraf");
 Object.defineProperty(exports, "Telegraf", { enumerable: true, get: function () { return telegraf_1.Telegraf; } });
 var context_1 = require("./context");
@@ -47,6 +47,7 @@ Object.defineProperty(exports, "session", { enumerable: true, get: function () {
 Object.defineProperty(exports, "MemorySessionStore", { enumerable: true, get: function () { return session_1.MemorySessionStore; } });
 exports.Scenes = __importStar(require("./scenes"));
 exports.RichMessage = __importStar(require("./core/types/rich-message"));
+exports.RecentTypes = __importStar(require("./core/types/bot-api-recent"));
 var rich_message_1 = require("./core/types/rich-message");
 Object.defineProperty(exports, "RichHTMLBuilder", { enumerable: true, get: function () { return rich_message_1.RichHTMLBuilder; } });
 Object.defineProperty(exports, "RichMarkdownBuilder", { enumerable: true, get: function () { return rich_message_1.RichMarkdownBuilder; } });

package/lib/telegram.js

@@ -1352,6 +1352,173 @@ class Telegram extends client_1.default {
             throw err;
         }
     }
+    // -------------------------------------------------------------------------
+    // Bot API 10.0 - 10.3 Methods
+    // -------------------------------------------------------------------------
+    /**
+     * Send a live photo (photo with short video).
+     * @see https://core.telegram.org/bots/api#sendlivephoto
+     */
+    sendLivePhoto(chatId, photo, video, extra) {
+        return this.callApi('sendLivePhoto', {
+            chat_id: chatId,
+            photo,
+            video,
+            ...extra,
+        });
+    }
+    /**
+     * Edit an ephemeral message text.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagetext
+     */
+    editEphemeralMessageText(chatId, messageId, text, extra) {
+        return this.callApi('editEphemeralMessageText', {
+            chat_id: chatId,
+            message_id: messageId,
+            text,
+            ...extra,
+        });
+    }
+    /**
+     * Edit an ephemeral message media.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagemedia
+     */
+    editEphemeralMessageMedia(chatId, messageId, media, extra) {
+        return this.callApi('editEphemeralMessageMedia', {
+            chat_id: chatId,
+            message_id: messageId,
+            media,
+            ...extra,
+        });
+    }
+    /**
+     * Edit an ephemeral message caption.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
+     */
+    editEphemeralMessageCaption(chatId, messageId, extra) {
+        return this.callApi('editEphemeralMessageCaption', {
+            chat_id: chatId,
+            message_id: messageId,
+            ...extra,
+        });
+    }
+    /**
+     * Edit an ephemeral message reply markup.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
+     */
+    editEphemeralMessageReplyMarkup(chatId, messageId, replyMarkup) {
+        return this.callApi('editEphemeralMessageReplyMarkup', {
+            chat_id: chatId,
+            message_id: messageId,
+            reply_markup: replyMarkup,
+        });
+    }
+    /**
+     * Delete an ephemeral message.
+     * @see https://core.telegram.org/bots/api#deleteephemeralmessage
+     */
+    deleteEphemeralMessage(chatId, messageId) {
+        return this.callApi('deleteEphemeralMessage', {
+            chat_id: chatId,
+            message_id: messageId,
+        });
+    }
+    /**
+     * Send a streaming message draft (private chats only).
+     * @see https://core.telegram.org/bots/api#sendmessagedraft
+     */
+    sendMessageDraft(chatId, draftId, text, extra) {
+        return this.callApi('sendMessageDraft', {
+            chat_id: chatId,
+            draft_id: draftId,
+            text,
+            ...extra,
+        });
+    }
+    /**
+     * Answer a guest query.
+     * @see https://core.telegram.org/bots/api#answerguestquery
+     */
+    answerGuestQuery(guestQueryId, result, extra) {
+        return this.callApi('answerGuestQuery', {
+            guest_query_id: guestQueryId,
+            result,
+            ...extra,
+        });
+    }
+    /**
+     * Answer a chat join request query.
+     * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
+     */
+    answerChatJoinRequestQuery(queryId, isApproved, extra) {
+        return this.callApi('answerChatJoinRequestQuery', {
+            query_id: queryId,
+            is_approved: isApproved,
+            ...extra,
+        });
+    }
+    /**
+     * Send a Web App to verify or complete a chat join request.
+     * @see https://core.telegram.org/bots/api#sendchatjoinrequestwebapp
+     */
+    sendChatJoinRequestWebApp(queryId, webAppUrl, extra) {
+        return this.callApi('sendChatJoinRequestWebApp', {
+            query_id: queryId,
+            web_app_url: webAppUrl,
+            ...extra,
+        });
+    }
+    /**
+     * Delete all reactions from a message.
+     * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+     */
+    deleteAllMessageReactions(chatId, messageId) {
+        return this.callApi('deleteAllMessageReactions', {
+            chat_id: chatId,
+            message_id: messageId,
+        });
+    }
+    /**
+     * Delete a specific reaction on a message.
+     * @see https://core.telegram.org/bots/api#deletemessagereaction
+     */
+    deleteMessageReaction(chatId, messageId, extra) {
+        return this.callApi('deleteMessageReaction', {
+            chat_id: chatId,
+            message_id: messageId,
+            ...extra,
+        });
+    }
+    /**
+     * Get access settings for a managed secretary bot.
+     * @see https://core.telegram.org/bots/api#getmanagedbotaccesssettings
+     */
+    getManagedBotAccessSettings(userId) {
+        return this.callApi('getManagedBotAccessSettings', {
+            user_id: userId,
+        });
+    }
+    /**
+     * Set access settings for a managed secretary bot.
+     * @see https://core.telegram.org/bots/api#setmanagedbotaccesssettings
+     */
+    setManagedBotAccessSettings(userId, settings) {
+        return this.callApi('setManagedBotAccessSettings', {
+            user_id: userId,
+            ...settings,
+        });
+    }
+    /**
+     * Get personal chat messages managed by a secretary bot.
+     * @see https://core.telegram.org/bots/api#getuserpersonalchatmessages
+     */
+    getUserPersonalChatMessages(userId, chatId, messageIds) {
+        return this.callApi('getUserPersonalChatMessages', {
+            user_id: userId,
+            chat_id: chatId,
+            message_ids: messageIds,
+        });
+    }
 }
 exports.Telegram = Telegram;
 exports.default = Telegram;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teledzik",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "Modern Telegram Bot Framework",
   "keywords": [
     "telekaf",
@@ -12,7 +12,7 @@
     "botapi",
     "bot framework",
     "rich messages",
-    "bot api 1.0.5"
+    "bot api 10.3"
   ],
   "homepage": "https://telegraf.js.org",
   "bugs": {

package/src/context.ts

@@ -1509,6 +1509,156 @@ export class Context<U extends Deunionize<tg.Update> = tg.Update> {
     return this.telegram.deleteMessages(this.chat.id, messageIds)
   }
 
+  // -------------------------------------------------------------------------
+  // Bot API 10.0 - 10.3 Context Shorthands
+  // -------------------------------------------------------------------------
+
+  /**
+   * Send a live photo to the current chat.
+   * @see https://core.telegram.org/bots/api#sendlivephoto
+   */
+  sendLivePhoto(
+    photo: tg.InputFile | string,
+    video: tg.InputFile | string,
+    extra?: tt.ExtraSendLivePhoto
+  ) {
+    this.assert(this.chat, 'sendLivePhoto')
+    return this.telegram.sendLivePhoto(this.chat.id, photo, video, extra)
+  }
+
+  /**
+   * Reply with a live photo to the current message.
+   * @see https://core.telegram.org/bots/api#sendlivephoto
+   */
+  replyWithLivePhoto(
+    photo: tg.InputFile | string,
+    video: tg.InputFile | string,
+    extra?: tt.ExtraSendLivePhoto
+  ) {
+    this.assert(this.chat, 'replyWithLivePhoto')
+    this.assert(this.msgId, 'replyWithLivePhoto')
+    return this.telegram.sendLivePhoto(this.chat.id, photo, video, {
+      reply_parameters: { message_id: this.msgId },
+      ...extra,
+    })
+  }
+
+  /**
+   * Edit an ephemeral message text in the current chat.
+   * @see https://core.telegram.org/bots/api#editephemeralmessagetext
+   */
+  editEphemeralMessageText(
+    messageId: number,
+    text: string,
+    extra?: tt.ExtraEditEphemeralMessageText
+  ) {
+    this.assert(this.chat, 'editEphemeralMessageText')
+    return this.telegram.editEphemeralMessageText(this.chat.id, messageId, text, extra)
+  }
+
+  /**
+   * Edit an ephemeral message media in the current chat.
+   * @see https://core.telegram.org/bots/api#editephemeralmessagemedia
+   */
+  editEphemeralMessageMedia(
+    messageId: number,
+    media: tg.InputMedia,
+    extra?: tt.ExtraEditEphemeralMessageMedia
+  ) {
+    this.assert(this.chat, 'editEphemeralMessageMedia')
+    return this.telegram.editEphemeralMessageMedia(this.chat.id, messageId, media, extra)
+  }
+
+  /**
+   * Edit an ephemeral message caption in the current chat.
+   * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
+   */
+  editEphemeralMessageCaption(
+    messageId: number,
+    extra?: tt.ExtraEditEphemeralMessageCaption
+  ) {
+    this.assert(this.chat, 'editEphemeralMessageCaption')
+    return this.telegram.editEphemeralMessageCaption(this.chat.id, messageId, extra)
+  }
+
+  /**
+   * Edit an ephemeral message reply markup in the current chat.
+   * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
+   */
+  editEphemeralMessageReplyMarkup(
+    messageId: number,
+    replyMarkup?: tg.InlineKeyboardMarkup
+  ) {
+    this.assert(this.chat, 'editEphemeralMessageReplyMarkup')
+    return this.telegram.editEphemeralMessageReplyMarkup(this.chat.id, messageId, replyMarkup)
+  }
+
+  /**
+   * Delete an ephemeral message in the current chat.
+   * @see https://core.telegram.org/bots/api#deleteephemeralmessage
+   */
+  deleteEphemeralMessage(messageId?: number) {
+    this.assert(this.chat, 'deleteEphemeralMessage')
+    const id = messageId ?? this.msgId
+    this.assert(id, 'deleteEphemeralMessage')
+    return this.telegram.deleteEphemeralMessage(this.chat.id, id)
+  }
+
+  /**
+   * Send a streaming message draft (private chats only).
+   * @see https://core.telegram.org/bots/api#sendmessagedraft
+   */
+  sendMessageDraft(
+    draftId: number,
+    text: string,
+    extra?: tt.ExtraSendMessageDraft
+  ) {
+    this.assert(this.chat, 'sendMessageDraft')
+    return this.telegram.sendMessageDraft(this.chat.id as number, draftId, text, extra)
+  }
+
+  /**
+   * Delete all reactions from the current message.
+   * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+   */
+  deleteAllMessageReactions(messageId?: number) {
+    this.assert(this.chat, 'deleteAllMessageReactions')
+    const id = messageId ?? this.msgId
+    this.assert(id, 'deleteAllMessageReactions')
+    return this.telegram.deleteAllMessageReactions(this.chat.id, id)
+  }
+
+  /**
+   * Delete a specific reaction from the current message.
+   * @see https://core.telegram.org/bots/api#deletemessagereaction
+   */
+  deleteMessageReaction(messageId?: number, extra?: tt.ExtraDeleteMessageReaction) {
+    this.assert(this.chat, 'deleteMessageReaction')
+    const id = messageId ?? this.msgId
+    this.assert(id, 'deleteMessageReaction')
+    return this.telegram.deleteMessageReaction(this.chat.id, id, extra)
+  }
+
+  /**
+   * Answer a guest query.
+   * @see https://core.telegram.org/bots/api#answerguestquery
+   */
+  answerGuestQuery(result: any, extra?: tt.ExtraAnswerGuestQuery) {
+    const queryId = (this.message as any)?.guest_query_id
+    this.assert(queryId, 'answerGuestQuery')
+    return this.telegram.answerGuestQuery(queryId, result, extra)
+  }
+
+  /**
+   * Answer a chat join request query.
+   * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
+   */
+  answerChatJoinRequestQuery(isApproved: boolean, extra?: tt.ExtraAnswerChatJoinRequestQuery) {
+    const queryId = (this.chatJoinRequest as any)?.query_id
+    this.assert(queryId, 'answerChatJoinRequestQuery')
+    return this.telegram.answerChatJoinRequestQuery(queryId, isApproved, extra)
+  }
+
   /**
    * @see https://core.telegram.org/bots/api#forwardmessage
    */