teledzik 1.1.4 → 1.2.1

package/src/core/types/bot-api-recent.ts

@@ -0,0 +1,187 @@
+/**
+ * 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'
+
+// ---------------------------------------------------------------------------
+// Bot API 10.3 (August 24, 2026)
+// ---------------------------------------------------------------------------
+
+/**
+ * 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
+}
+
+// ---------------------------------------------------------------------------
+// Bot API 10.2 (July 14, 2026)
+// ---------------------------------------------------------------------------
+
+/**
+ * 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
+}
+
+// ---------------------------------------------------------------------------
+// Bot API 10.1 (June 11, 2026)
+// ---------------------------------------------------------------------------
+
+/**
+ * Represents a link in poll media.
+ */
+export interface PollMediaLink {
+  url: string
+}
+
+/**
+ * Input media link for poll options.
+ */
+export interface InputMediaLink {
+  type: 'link'
+  url: string
+}
+
+// ---------------------------------------------------------------------------
+// Bot API 10.0 (May 8, 2026)
+// ---------------------------------------------------------------------------
+
+/**
+ * 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/src/core/types/rich-message.ts

@@ -15,16 +15,31 @@ 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. */
@@ -139,11 +154,22 @@ export class RichHTMLBuilder {
     return this
   }
 
+  expandableBlockQuote(html: string) {
+    this._parts.push(`<blockquote expandable>${html}</blockquote>`)
+    return this
+  }
+
   pullQuote(html: string, cite?: string) {
     this._parts.push(`<aside>${html}${cite ? `<cite>${cite}</cite>` : ''}</aside>`)
     return this
   }
 
+  document(src: string, caption?: string) {
+    const doc = `<tg-document src="${src}"></tg-document>`
+    this._parts.push(caption ? `<figure>${doc}<figcaption>${caption}</figcaption></figure>` : doc)
+    return this
+  }
+
   photo(src: string, caption?: string, spoiler?: boolean) {
     const img = `<img src="${src}"${spoiler ? ' tg-spoiler' : ''}/>`
     this._parts.push(caption ? `<figure>${img}<figcaption>${caption}</figcaption></figure>` : img)
@@ -180,9 +206,13 @@ export class RichHTMLBuilder {
 
   table(
     rows: string[][],
-    options?: { bordered?: boolean; striped?: boolean; hasHeader?: boolean }
+    options?: { bordered?: boolean; striped?: boolean; hasHeader?: boolean; isCompact?: boolean }
   ) {
-    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/src/core/types/typegram.ts

@@ -1,6 +1,7 @@
 import * as Typegram from '@telegraf/types'
 export * from '@telegraf/types'
 export * from './rich-message'
+export * from './bot-api-recent'
 
 // telegraf input file definition
 interface InputFileByPath {

package/src/future.ts

@@ -123,6 +123,10 @@ const replyContext: ReplyContext = {
     this.assert(this.chat, 'replyWithPhoto')
     return this.telegram.sendPhoto(this.chat.id, photo, makeReply(this, extra))
   },
+  replyWithLivePhoto(this: Context, photo, video, extra) {
+    this.assert(this.chat, 'replyWithLivePhoto')
+    return this.telegram.sendLivePhoto(this.chat.id, photo, video, makeReply(this, extra))
+  },
   replyWithPoll(this: Context, question, options, extra) {
     this.assert(this.chat, 'replyWithPoll')
     return this.telegram.sendPoll(
@@ -226,6 +230,7 @@ export function useNewReplies<C extends Context>(): Middleware<C> {
     ctx.replyWithHTML = replyContext.replyWithHTML
     ctx.replyWithRichMessage = replyContext.replyWithRichMessage
     ctx.replyWithRichMessageContent = replyContext.replyWithRichMessageContent
+    ctx.replyWithLivePhoto = replyContext.replyWithLivePhoto
     return next()
   }
 }

package/src/index.ts

@@ -16,6 +16,7 @@ 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'

package/src/telegram-types.ts

@@ -16,6 +16,8 @@ import {
   ForceReply,
   ReplyParameters,
   ParseMode,
+  MessageEntity,
+  EphemeralMessageParameters,
 } from './core/types/typegram'
 import type { InputRichMessage } from './core/types/rich-message'
 
@@ -239,11 +241,14 @@ 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 = {
@@ -254,3 +259,70 @@ export type ExtraEditMessageRichText = {
   parse_mode?: ParseMode
   reply_markup?: InlineKeyboardMarkup
 }
+
+// ---------------------------------------------------------------------------
+// Bot API 10.0 - 10.3 Extra types
+// ---------------------------------------------------------------------------
+
+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/src/telegram.ts

@@ -1762,6 +1762,237 @@ export class Telegram extends ApiClient {
       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: number | string,
+    photo: tg.InputFile | string,
+    video: tg.InputFile | string,
+    extra?: tt.ExtraSendLivePhoto
+  ) {
+    return this.callApi('sendLivePhoto' as never, {
+      chat_id: chatId,
+      photo,
+      video,
+      ...extra,
+    } as 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
+  ) {
+    return this.callApi('editEphemeralMessageText' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+      text,
+      ...extra,
+    } as 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
+  ) {
+    return this.callApi('editEphemeralMessageMedia' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+      media,
+      ...extra,
+    } as never)
+  }
+
+  /**
+   * Edit an ephemeral message caption.
+   * @see https://core.telegram.org/bots/api#editephemeralmessagecaption
+   */
+  editEphemeralMessageCaption(
+    chatId: number | string,
+    messageId: number,
+    extra?: tt.ExtraEditEphemeralMessageCaption
+  ) {
+    return this.callApi('editEphemeralMessageCaption' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+      ...extra,
+    } as never)
+  }
+
+  /**
+   * Edit an ephemeral message reply markup.
+   * @see https://core.telegram.org/bots/api#editephemeralmessagereplymarkup
+   */
+  editEphemeralMessageReplyMarkup(
+    chatId: number | string,
+    messageId: number,
+    replyMarkup?: tg.InlineKeyboardMarkup
+  ) {
+    return this.callApi('editEphemeralMessageReplyMarkup' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+      reply_markup: replyMarkup,
+    } as never)
+  }
+
+  /**
+   * Delete an ephemeral message.
+   * @see https://core.telegram.org/bots/api#deleteephemeralmessage
+   */
+  deleteEphemeralMessage(chatId: number | string, messageId: number) {
+    return this.callApi('deleteEphemeralMessage' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+    } as 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
+  ) {
+    return this.callApi('sendMessageDraft' as never, {
+      chat_id: chatId,
+      draft_id: draftId,
+      text,
+      ...extra,
+    } as never)
+  }
+
+  /**
+   * Answer a guest query.
+   * @see https://core.telegram.org/bots/api#answerguestquery
+   */
+  answerGuestQuery(
+    guestQueryId: string,
+    result: any,
+    extra?: tt.ExtraAnswerGuestQuery
+  ) {
+    return this.callApi('answerGuestQuery' as never, {
+      guest_query_id: guestQueryId,
+      result,
+      ...extra,
+    } as never)
+  }
+
+  /**
+   * Answer a chat join request query.
+   * @see https://core.telegram.org/bots/api#answerchatjoinrequestquery
+   */
+  answerChatJoinRequestQuery(
+    queryId: string,
+    isApproved: boolean,
+    extra?: tt.ExtraAnswerChatJoinRequestQuery
+  ) {
+    return this.callApi('answerChatJoinRequestQuery' as never, {
+      query_id: queryId,
+      is_approved: isApproved,
+      ...extra,
+    } as 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
+  ) {
+    return this.callApi('sendChatJoinRequestWebApp' as never, {
+      query_id: queryId,
+      web_app_url: webAppUrl,
+      ...extra,
+    } as never)
+  }
+
+  /**
+   * Delete all reactions from a message.
+   * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+   */
+  deleteAllMessageReactions(chatId: number | string, messageId: number) {
+    return this.callApi('deleteAllMessageReactions' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+    } as 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
+  ) {
+    return this.callApi('deleteMessageReaction' as never, {
+      chat_id: chatId,
+      message_id: messageId,
+      ...extra,
+    } as never)
+  }
+
+  /**
+   * Get access settings for a managed secretary bot.
+   * @see https://core.telegram.org/bots/api#getmanagedbotaccesssettings
+   */
+  getManagedBotAccessSettings(userId: number) {
+    return this.callApi('getManagedBotAccessSettings' as never, {
+      user_id: userId,
+    } as never)
+  }
+
+  /**
+   * Set access settings for a managed secretary bot.
+   * @see https://core.telegram.org/bots/api#setmanagedbotaccesssettings
+   */
+  setManagedBotAccessSettings(userId: number, settings: tg.BotAccessSettings) {
+    return this.callApi('setManagedBotAccessSettings' as never, {
+      user_id: userId,
+      ...settings,
+    } as 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[]
+  ) {
+    return this.callApi('getUserPersonalChatMessages' as never, {
+      user_id: userId,
+      chat_id: chatId,
+      message_ids: messageIds,
+    } as never)
+  }
 }
 
 export default Telegram