teledzik 1.1.3 → 1.2.0

package/typings/context.d.ts

@@ -80,7 +80,7 @@ export declare class Context<U extends Deunionize<tg.Update> = tg.Update> {
     has<Filter extends tt.UpdateType | Guard<Context['update']>>(filters: MaybeArray<Filter>): this is FilteredContext<Context, Filter>;
     get text(): GetText<U>;
     entities<EntityTypes extends tg.MessageEntity['type'][]>(...types: EntityTypes): (tg.MessageEntity & {
-        type: EntityTypes extends [] ? "mention" | "hashtag" | "cashtag" | "bot_command" | "url" | "email" | "phone_number" | "bold" | "blockquote" | "italic" | "underline" | "strikethrough" | "spoiler" | "code" | "custom_emoji" | "pre" | "text_link" | "text_mention" : EntityTypes[number];
+        type: EntityTypes extends [] ? "url" | "mention" | "hashtag" | "cashtag" | "bot_command" | "email" | "phone_number" | "bold" | "blockquote" | "italic" | "underline" | "strikethrough" | "spoiler" | "code" | "custom_emoji" | "pre" | "text_link" | "text_mention" : EntityTypes[number];
         fragment: string;
     })[];
     /**
@@ -171,7 +171,11 @@ export declare class Context<U extends Deunionize<tg.Update> = tg.Update> {
         chat_id: string | number;
         user_id: number;
         until_date?: number | undefined;
-        revoke_messages?: boolean | undefined;
+        revoke_messages?: boolean | undefined; /**
+         * Context-aware shorthand for {@link Telegram.copyMessages}
+         * @param chatId Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+         * @param messageIds Identifiers of 1-100 messages in the chat from_chat_id to copy. The identifiers must be specified in a strictly increasing order.
+         */
     }, "chat_id" | "user_id" | "until_date"> | undefined) => Promise<true>;
     /**
      * @see https://core.telegram.org/bots/api#unbanchatmember
@@ -637,6 +641,66 @@ export declare class Context<U extends Deunionize<tg.Update> = tg.Update> {
      * @param messageIds Identifiers of 1-100 messages to delete. See deleteMessage for limitations on which messages can be deleted
      */
     deleteMessages(messageIds: number[]): Promise<true>;
+    /**
+     * 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): Promise<never>;
+    /**
+     * 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): Promise<never>;
+    /**
+     * 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): Promise<never>;
+    /**
+     * 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): Promise<never>;
+    /**
+     * Edit an ephemeral message caption in the current chat.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
+     */
+    editEphemeralMessageCaption(messageId: number, extra?: tt.ExtraEditEphemeralMessageCaption): Promise<never>;
+    /**
+     * Edit an ephemeral message reply markup in the current chat.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
+     */
+    editEphemeralMessageReplyMarkup(messageId: number, replyMarkup?: tg.InlineKeyboardMarkup): Promise<never>;
+    /**
+     * Delete an ephemeral message in the current chat.
+     * @see https://core.telegram.org/bots/api#deleteephemeralmessage
+     */
+    deleteEphemeralMessage(messageId?: number): Promise<never>;
+    /**
+     * Send a streaming message draft (private chats only).
+     * @see https://core.telegram.org/bots/api#sendmessagedraft
+     */
+    sendMessageDraft(draftId: number, text: string, extra?: tt.ExtraSendMessageDraft): Promise<never>;
+    /**
+     * Delete all reactions from the current message.
+     * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+     */
+    deleteAllMessageReactions(messageId?: number): Promise<never>;
+    /**
+     * Delete a specific reaction from the current message.
+     * @see https://core.telegram.org/bots/api#deletemessagereaction
+     */
+    deleteMessageReaction(messageId?: number, extra?: tt.ExtraDeleteMessageReaction): Promise<never>;
+    /**
+     * Answer a guest query.
+     * @see https://core.telegram.org/bots/api#answerguestquery
+     */
+    answerGuestQuery(result: any, extra?: tt.ExtraAnswerGuestQuery): Promise<never>;
+    /**
+     * Answer a chat join request query.
+     * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
+     */
+    answerChatJoinRequestQuery(isApproved: boolean, extra?: tt.ExtraAnswerChatJoinRequestQuery): Promise<never>;
     /**
      * @see https://core.telegram.org/bots/api#forwardmessage
      */

package/typings/core/types/bot-api-recent.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Telegram Bot API 10.0 - 10.3 Recent Updates
+ * @see https://core.telegram.org/bots/api#recent-changes
+ */
+import { Chat, User, MessageEntity, PhotoSize, Video } from '@telegraf/types';
+import { InputFile } from './typegram';
+/**
+ * Ephemeral message parameters.
+ * Allows sending messages visible only to a specific user and the bot.
+ */
+export interface EphemeralMessageParameters {
+    /** Target user who will see the ephemeral message */
+    receiver_user_id?: number;
+    /** Callback query ID if replying to a callback */
+    callback_query_id?: string;
+    /** If true, replace the original message that generated the callback query */
+    replace_callback_query_message?: boolean;
+}
+/**
+ * Disabled button representation in reply markup.
+ */
+export interface DisabledButton {
+    text: string;
+    disabled: true;
+}
+/**
+ * Information about a unique gift.
+ */
+export interface UniqueGiftInfo {
+    text?: string;
+    entities?: MessageEntity[];
+    is_private?: boolean;
+    [key: string]: any;
+}
+/**
+ * Update when a user stops streaming/message generation.
+ */
+export interface MessageGenerationStopped {
+    chat_id: number;
+    draft_id: number;
+    user?: User;
+}
+/**
+ * Service message when a chat joins a community.
+ */
+export interface CommunityChatJoined {
+    community: Community;
+    chat: Chat;
+}
+/**
+ * Represents a community — group of chats and channels linked together.
+ */
+export interface Community {
+    id: number;
+    title: string;
+    username?: string;
+    is_channel?: boolean;
+}
+/**
+ * Service message when a chat is added to a community.
+ */
+export interface CommunityChatAdded {
+    community: Community;
+    chat: Chat;
+}
+/**
+ * Service message when a chat is removed from a community.
+ */
+export interface CommunityChatRemoved {
+    community: Community;
+    chat: Chat;
+}
+/**
+ * Represents an update to a user payment subscription.
+ */
+export interface BotSubscriptionUpdated {
+    chat: Chat;
+    user?: User;
+    date: number;
+    subscription_expiration_date?: number;
+    is_canceled?: boolean;
+}
+/**
+ * Represents a link in poll media.
+ */
+export interface PollMediaLink {
+    url: string;
+}
+/**
+ * Input media link for poll options.
+ */
+export interface InputMediaLink {
+    type: 'link';
+    url: string;
+}
+/**
+ * Represents a live photo (photo with short video).
+ */
+export interface LivePhoto {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    duration: number;
+    file_size?: number;
+}
+/**
+ * Input media representation for sending live photos.
+ */
+export interface InputMediaLivePhoto<File = InputFile> {
+    type: 'live_photo';
+    media: string | File;
+    video: string | File;
+    caption?: string;
+    parse_mode?: string;
+    caption_entities?: MessageEntity[];
+    has_spoiler?: boolean;
+}
+/**
+ * Describes paid media containing a live photo.
+ */
+export interface PaidMediaLivePhoto {
+    type: 'live_photo';
+    photo: PhotoSize[];
+    video: Video;
+}
+/**
+ * Input media representation for sending live photos as paid media.
+ */
+export interface InputPaidMediaLivePhoto<File = InputFile> {
+    type: 'live_photo';
+    media: string | File;
+    video: string | File;
+}
+/**
+ * Represents a sent guest message.
+ */
+export interface SentGuestMessage {
+    message_id: number;
+    chat: Chat;
+}
+/**
+ * Access settings for managed secretary bots.
+ */
+export interface BotAccessSettings {
+    can_manage_messages?: boolean;
+    can_send_messages?: boolean;
+    can_read_messages?: boolean;
+    can_post_messages?: boolean;
+    can_edit_messages?: boolean;
+    can_delete_messages?: boolean;
+    [key: string]: any;
+}

package/typings/core/types/rich-message.d.ts

@@ -10,15 +10,29 @@ export interface RichMessage {
     blocks: object[];
     is_rtl?: boolean;
 }
+export interface RichMessageButton {
+    text: string;
+    url?: string;
+    callback_data?: string;
+    web_app?: any;
+    [key: string]: any;
+}
+export interface InputRichMessageMedia {
+    type: string;
+    media: string;
+    [key: string]: any;
+}
 /**
  * Describes a rich message to send.
- * Exactly ONE of `html` or `markdown` must be specified.
+ * Exactly ONE of `html` or `markdown` must be specified, or `blocks`.
  */
 export interface InputRichMessage {
     html?: string;
     markdown?: string;
     is_rtl?: boolean;
     skip_entity_detection?: boolean;
+    media?: InputRichMessageMedia[];
+    blocks?: object[];
 }
 /** Can be used as InputMessageContent in inline, guest, and Web App queries. */
 export interface InputRichMessageContent {
@@ -86,7 +100,9 @@ export declare class RichHTMLBuilder {
         checked?: boolean;
     }>): this;
     blockQuote(html: string): this;
+    expandableBlockQuote(html: string): this;
     pullQuote(html: string, cite?: string): this;
+    document(src: string, caption?: string): this;
     photo(src: string, caption?: string, spoiler?: boolean): this;
     video(src: string, caption?: string, spoiler?: boolean): this;
     audio(src: string, caption?: string): this;
@@ -97,6 +113,7 @@ export declare class RichHTMLBuilder {
         bordered?: boolean;
         striped?: boolean;
         hasHeader?: boolean;
+        isCompact?: boolean;
     }): this;
     details(summary: string, content: string, open?: boolean): this;
     mathBlock(expression: string): this;

package/typings/core/types/typegram.d.ts

@@ -4,6 +4,7 @@
 import * as Typegram from '@telegraf/types';
 export * from '@telegraf/types';
 export * from './rich-message';
+export * from './bot-api-recent';
 interface InputFileByPath {
     source: string;
     filename?: string;

package/typings/index.d.ts

@@ -13,6 +13,7 @@ export { deunionize } from './core/helpers/deunionize';
 export { session, MemorySessionStore, SessionStore } from './session';
 export * as Scenes from './scenes';
 export * as RichMessage from './core/types/rich-message';
+export * as RecentTypes from './core/types/bot-api-recent';
 export { RichHTMLBuilder, RichMarkdownBuilder, RichHTMLBuilder as HTML, MD } from './core/types/rich-message';
 export { SmartQueue } from './core/helpers/smart-queue';
 export { AIStreamAdapter } from './core/helpers/ai-stream';

package/typings/telegram-types.d.ts

@@ -1,6 +1,6 @@
 /** @format */
 import { Expand } from './core/helpers/util';
-import { Message, Opts, Telegram, Update, InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo, InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply, ReplyParameters, ParseMode } from './core/types/typegram';
+import { Message, Opts, Telegram, Update, InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo, InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply, ReplyParameters, ParseMode, MessageEntity, EphemeralMessageParameters } from './core/types/typegram';
 import type { InputRichMessage } from './core/types/rich-message';
 import { UnionKeys } from './core/helpers/deunionize';
 import { FmtString } from './format';
@@ -125,10 +125,13 @@ export type ExtraSendRichMessage = {
     message_effect_id?: string;
     reply_parameters?: ReplyParameters;
     reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+    ephemeral_message_parameters?: EphemeralMessageParameters;
 };
 /** sendRichMessageDraft only works in private chats; chat_id must be a number. */
 export type ExtraSendRichMessageDraft = {
     message_thread_id?: number;
+    can_stop?: boolean;
+    keep_on_stop?: boolean;
 };
 export type ExtraEditMessageRichText = {
     chat_id?: number | string;
@@ -138,3 +141,57 @@ export type ExtraEditMessageRichText = {
     parse_mode?: ParseMode;
     reply_markup?: InlineKeyboardMarkup;
 };
+export type ExtraSendLivePhoto = {
+    business_connection_id?: string;
+    message_thread_id?: number;
+    caption?: string;
+    parse_mode?: ParseMode;
+    caption_entities?: MessageEntity[];
+    has_spoiler?: boolean;
+    disable_notification?: boolean;
+    protect_content?: boolean;
+    message_effect_id?: string;
+    reply_parameters?: ReplyParameters;
+    reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+    ephemeral_message_parameters?: EphemeralMessageParameters;
+    allow_paid_broadcast?: boolean;
+};
+export type ExtraEditEphemeralMessageText = {
+    parse_mode?: ParseMode;
+    entities?: MessageEntity[];
+    rich_message?: InputRichMessage;
+    link_preview_options?: any;
+    reply_markup?: InlineKeyboardMarkup;
+};
+export type ExtraEditEphemeralMessageMedia = {
+    reply_markup?: InlineKeyboardMarkup;
+};
+export type ExtraEditEphemeralMessageCaption = {
+    caption?: string;
+    parse_mode?: ParseMode;
+    caption_entities?: MessageEntity[];
+    show_caption_above_media?: boolean;
+    reply_markup?: InlineKeyboardMarkup;
+};
+export type ExtraSendMessageDraft = {
+    message_thread_id?: number;
+    can_stop?: boolean;
+    keep_on_stop?: boolean;
+    parse_mode?: ParseMode;
+    entities?: MessageEntity[];
+};
+export type ExtraAnswerGuestQuery = {
+    cache_time?: number;
+    is_personal?: boolean;
+    next_offset?: string;
+};
+export type ExtraAnswerChatJoinRequestQuery = {
+    error_message?: string;
+};
+export type ExtraSendChatJoinRequestWebApp = {
+    button_text?: string;
+};
+export type ExtraDeleteMessageReaction = {
+    user_id?: number;
+    reaction?: any[];
+};

package/typings/telegram.d.ts

@@ -693,5 +693,80 @@ export declare class Telegram extends ApiClient {
      * Universal in-place message editor with Modern Rich UI formatting.
      */
     editRichMessage(chatId: number | string, messageId: number | string, content: any, extra?: any): Promise<any>;
+    /**
+     * Send a live photo (photo with short video).
+     * @see https://core.telegram.org/bots/api#sendlivephoto
+     */
+    sendLivePhoto(chatId: number | string, photo: tg.InputFile | string, video: tg.InputFile | string, extra?: tt.ExtraSendLivePhoto): Promise<never>;
+    /**
+     * Edit an ephemeral message text.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagetext
+     */
+    editEphemeralMessageText(chatId: number | string, messageId: number, text: string, extra?: tt.ExtraEditEphemeralMessageText): Promise<never>;
+    /**
+     * Edit an ephemeral message media.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagemedia
+     */
+    editEphemeralMessageMedia(chatId: number | string, messageId: number, media: tg.InputMedia, extra?: tt.ExtraEditEphemeralMessageMedia): Promise<never>;
+    /**
+     * Edit an ephemeral message caption.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
+     */
+    editEphemeralMessageCaption(chatId: number | string, messageId: number, extra?: tt.ExtraEditEphemeralMessageCaption): Promise<never>;
+    /**
+     * Edit an ephemeral message reply markup.
+     * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
+     */
+    editEphemeralMessageReplyMarkup(chatId: number | string, messageId: number, replyMarkup?: tg.InlineKeyboardMarkup): Promise<never>;
+    /**
+     * Delete an ephemeral message.
+     * @see https://core.telegram.org/bots/api#deleteephemeralmessage
+     */
+    deleteEphemeralMessage(chatId: number | string, messageId: number): Promise<never>;
+    /**
+     * Send a streaming message draft (private chats only).
+     * @see https://core.telegram.org/bots/api#sendmessagedraft
+     */
+    sendMessageDraft(chatId: number, draftId: number, text: string, extra?: tt.ExtraSendMessageDraft): Promise<never>;
+    /**
+     * Answer a guest query.
+     * @see https://core.telegram.org/bots/api#answerguestquery
+     */
+    answerGuestQuery(guestQueryId: string, result: any, extra?: tt.ExtraAnswerGuestQuery): Promise<never>;
+    /**
+     * Answer a chat join request query.
+     * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
+     */
+    answerChatJoinRequestQuery(queryId: string, isApproved: boolean, extra?: tt.ExtraAnswerChatJoinRequestQuery): Promise<never>;
+    /**
+     * Send a Web App to verify or complete a chat join request.
+     * @see https://core.telegram.org/bots/api#sendchatjoinrequestwebapp
+     */
+    sendChatJoinRequestWebApp(queryId: string, webAppUrl: string, extra?: tt.ExtraSendChatJoinRequestWebApp): Promise<never>;
+    /**
+     * Delete all reactions from a message.
+     * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+     */
+    deleteAllMessageReactions(chatId: number | string, messageId: number): Promise<never>;
+    /**
+     * Delete a specific reaction on a message.
+     * @see https://core.telegram.org/bots/api#deletemessagereaction
+     */
+    deleteMessageReaction(chatId: number | string, messageId: number, extra?: tt.ExtraDeleteMessageReaction): Promise<never>;
+    /**
+     * Get access settings for a managed secretary bot.
+     * @see https://core.telegram.org/bots/api#getmanagedbotaccesssettings
+     */
+    getManagedBotAccessSettings(userId: number): Promise<never>;
+    /**
+     * Set access settings for a managed secretary bot.
+     * @see https://core.telegram.org/bots/api#setmanagedbotaccesssettings
+     */
+    setManagedBotAccessSettings(userId: number, settings: tg.BotAccessSettings): Promise<never>;
+    /**
+     * Get personal chat messages managed by a secretary bot.
+     * @see https://core.telegram.org/bots/api#getuserpersonalchatmessages
+     */
+    getUserPersonalChatMessages(userId: number, chatId: number | string, messageIds: number[]): Promise<never>;
 }
 export default Telegram;