televerse

• Bot API 10.2
• Fixes an issue with InputFile that caused API call failure on different send methods. Thanks to @devsdocs over #364

What's Changed

• Add missing parameters to RawAPI and refactor Context methods by @The0xArchitect in #363

Full Changelog: v3.5.1...v3.5.2

• Fix: added missing InputFile parameters to RawAPI methods (sendDocument, sendVideo, sendAnimation, sendVoice, sendVideoNote).
• Implemented Context.fileId getter to get file ID from messages if any.

What's Changed

• Prevent including null richMessage in editMessageText payload by @albor09 in #361
• 3.5.1 by @The0xArchitect in #362

New Contributors

• @albor09 made their first contribution in #361

Full Changelog: v3.4.0...v3.5.1

• Fixes rich message being passed as null on edit message text methods.
• Thanks to @albor09

• 🤖 Bot API 9.6 (April 3, 2026)

• Bot API 9.5

• Bot API 9.4
• Breaking: Changed APICaller signature to use String instead of APIMethod. This gives unrestricted access to Telegram API Methods using RawAPI.call.
• Updated Transformer to also use the new updated signature.
• Reworked RawAPI to be more efficient in making API calls.
• Updated LoggingPlugin to use JSON logging for requests as well.
• InputFile and other media models are now JSON serializable, and does not require special handling.
• Breaking: Changed signatures for InlineKeyboard.text, InlineKeyboard.switchInline, InlineKeyboard.switchInlineCurrentChat
• Updated test file

What's Changed

• v3.1.4 by @The0xArchitect in #356

Full Changelog: v3.1.3...v3.1.4

• Added isTest parameter to Bot constructor to support test environment.
• Improved RawAPI to support test environment and custom base URL.

What's Changed

• chore: version bump by @The0xArchitect in #354
• v3.1.3 by @The0xArchitect in #355

Full Changelog: v3.1.2...v3.1.3

• Added sourceIsMiddleware property to BotError to identify the source of the error.
• Added Bot.onStop method to handle stop events.

What's Changed

• chore: project moved to weaver labs by @The0xArchitect in #353

Full Changelog: v3.1.1...v3.1.2

• Project moved to Weaver Labs

What's Changed

• Introduce InputFileProvider to streamline file extraction in media models.
• Include gift related messages in isServiceMessage check.
• Move convenience handler methods from Bot to Composer.

Full Changelog: v3.1.0...v3.1.1

• Introduce InputFileProvider to streamline file extraction in media models.
• Include gift related messages in isServiceMessage check.
• Move convenience handler methods from Bot to Composer.

• 🤖 Bot API 9.3
• See changes here: https://core.telegram.org/bots/api-changelog#december-31-2025

• Removed one last stray dynamic type from the library.
• Typed Payload's [] operator as Object?.

• Bot API 9.2
• Televerse v3
• ⚠️ Contains Breaking Changes: See migration guide here.

• Fixes a bug in Conversation.filter method.
• Updates the Context.from retrieval order.

🚀 Major Architectural Overhaul

This is a major breaking release that introduces a complete architectural redesign inspired by grammY, bringing modern patterns and enhanced developer experience to Telegram bot development in Dart.

✨ New Features

🎯 Filter System

• NEW: Added 80+ filters for comprehensive update handling
• NEW: Filter combination with logical operators (+ for OR, * for AND, - for NOT)
• NEW: bot.filters property for type-safe filter access without generic specifications
• NEW: PredicateFilter for custom filtering logic with optional naming
• NEW: Complex filter combinations like bot.filters.photo + bot.filters.video
• NEW: Negation operations like bot.filters.anyMessage - bot.filters.command

🔌 Comprehensive Plugin System

• NEW: BotPlugin<CTX> interface for extensible bot functionality
• NEW: Three built-in plugins:
  • SessionPlugin<CTX, T> - Persistent user sessions with customizable storage
  • ConversationPlugin<CTX> - Advanced multi-step conversations with timeout support
  • LoggingPlugin<CTX> - Request/response logging
• NEW: Plugin dependency management and validation
• NEW: MiddlewarePlugin and TransformerPlugin base classes for easy plugin development

💬 Advanced Conversation API

• NEW: Conversation.wait() with timeout support and ConversationTimeoutException
• NEW: Conversation.waitFor() for predicate-based waiting
• NEW: Conversation.filter() for filter-based waiting
• NEW: Conversation.waitUntil() with validation and otherwise callback
• NEW: Conversation timeout management with extendTimeout() and setCustomTimeout()
• NEW: ConversationStorage interface with MemoryConversationStorage implementation
• NEW: Automatic conversation cleanup and statistics via getConversationStats()

🛠️ Enhanced Middleware System

• NEW: Function-based middleware with Middleware<CTX> typedef
• NEW: Composer<CTX> class for advanced middleware composition
• NEW: Conditional middleware with bot.when()
• NEW: Concurrent middleware with bot.fork()
• NEW: Lazy middleware with bot.lazy()
• NEW: Branching middleware with bot.branch()
• NEW: Error boundaries with bot.errorBoundary() and recovery support
• NEW: Named middleware support for debugging and management

🌐 Built-in Webhook Server

• NEW: bot.startWebhook() for instant webhook deployment
• NEW: bot.startWebhookDev() for ngrok development workflow
• NEW: Built-in HTTP server with health check and status endpoints
• NEW: CORS support and secret token validation
• NEW: Automatic webhook URL configuration with Telegram

🎯 Enhanced Type Safety

• NEW: Full generic support with Bot<CTX extends Context>
• NEW: Custom context factories with contextFactory parameter
• NEW: Type-safe filter access through bot.filters
• NEW: Strongly typed plugin interfaces
• NEW: Zero dynamic types in public API

📊 Bot Statistics and Monitoring

• NEW: BotStats class with comprehensive metrics
• NEW: Processing time tracking and success/error rates
• NEW: Real-time update statistics via bot.stats
• NEW: Plugin installation tracking

🔧 Advanced HTTP Client Support

• NEW: Custom HTTP client injection via constructor
• NEW: DioHttpClient as default implementation
• NEW: Interceptor support through custom HTTP clients
• NEW: Network request/response transformation

💥 Breaking Changes

Middleware System

• BREAKING: Middleware is now a function typedef instead of a class
• BREAKING: Remove MiddlewareBase - use function-based middleware
• BREAKING: Bot.use() now only accepts Middleware<CTX> functions
• BREAKING: Transformer attachment moved to bot.api.use() instead of Bot.use()

Constructor and Configuration

• BREAKING: Bot.local() constructor now takes URL as second positional parameter
• BREAKING: Context factory moved from Bot.useContext() to constructor parameter contextFactory
• BREAKING: Update fetcher moved from constructor to Bot.start() method
• BREAKING: Removed LoggerOptions - use custom HTTP client with interceptors instead

Context Changes

• BREAKING: Context.me is now BotInfo instead of User
• BREAKING: Access bot user info via ctx.me.me?.firstName instead of ctx.me.firstName

Conversation API

• BREAKING: Remove Conversation.waitForTextMessage() and similar methods
• BREAKING: Replace with conversation.filter(Filters().text) pattern
• BREAKING: ConversationResult classes removed - methods now return Context directly
• BREAKING: Conversation methods no longer return ConversationSuccess/ConversationError

Keyboard and Menu Changes

• BREAKING: Keyboard.addText() renamed to Keyboard.text()
• BREAKING: InlineKeyboard.addUrl() renamed to InlineKeyboard.url()
• BREAKING: InlineMenu.text() signature changed to (String text, String callbackData, UpdateHandler<CTX>)
• BREAKING: switchInlineQueryCurrentChat renamed to switchInlineCurrentChat
• BREAKING: Bot.removeMenu() method removed

Type and Handler Changes

• BREAKING: Handler<Context> typedef renamed to UpdateHandler<Context>
• BREAKING: ID.get() method removed - use api.getChat(id) instead
• BREAKING: Links library removed - use Telegram deeplink documentation

Import Structure

• BREAKING: Many enums and types moved from televerse.dart to telegram.dart
• BREAKING: Must import package:televerse/telegram.dart for ParseMode, ChatAction, etc.

• 🤖 Bot API 9.1

• ForumTopic.messageThreadId is int not String

• Removed Update.msg usage in the Conversation.waitForTextMessage, this could unintentionally match callback query message texts.
• Removed a maintenance script

• Supports accepting custom Dio instances for HTTP calls - See #337

• Fix #334 - thanks to @zelmkhan for raising this!

• 🤖 Bot API 9.0

• Migrated to Freezed 3.x.x

• Fixed: ChatMemberOwner is now correctly represented as ChatMember.creator instead of ChatMember.owner.

• Fixed: ChatMemberBanned is now correctly represented as ChatMember.kicked instead of ChatMember.banned.

• Added missing @JsonKey annotations for InputMessageContent in InlineQueryResultArticle
• Added missing @JsonKey annotation for LinkPreviewOptions in InputTextMessageContent
• Thanks to @otopba for #327

• Fix typo in MessageOriginChannel

• All Telegram models are now re-written with Freezed
• Breaking: Keyboard & InlineKeyboard usage. Check this PR comment for details.

• Surpress all the invalid_annotation_target warnings
• Fix other linter issues.

• fix: bot.init (#320)
• updated analysis_options.yaml

• Minor lint supression - excluded generated files being anlyzed.

• All Telegram Models are now built with Freezed.
• Breaking: Keyboard & InlineKeyboard usage. Check this PR comment for details.

• 🤖 Bot API 8.3
• Check the Telegram Bot API changelog for detailled change info.

• 🤖 Bot API 8.2
• Added the methods verifyUser, verifyChat, removeUserVerification, and removeChatVerification, allowing bots to manage verifications on behalf of an organization.
• Added the field upgrade_star_count to the class Gift.
• Added the parameter pay_for_upgrade to the method sendGift.
• Removed the field hide_url from the class InlineQueryResultArticle. Pass an empty string as url instead.

• Updated switch statements to Switch expressions.
• Fix: BackgroundTypeType.chatTheme typo

• 🤖 Bot API 8.1
• Added class AffiliateInfo and reflected all the changes from Bot API 8.1

• 🆕 Supports Middleware chaining for each handler.
• ⚠️ Updated Conversation API definitions.
• 📖 Conversation API migration guide is available at website.
• Updated Fetcher implementations.
• Improved error wordings.
• Refactored bot.dart
• ⚠️ Removed Bot.on method & TeleverseEvent enum.

• [Retracted]

• [Retracted]

• 🤖 Bot API 8.0
• Updated RawAPI.createInvoiceLink to the docs.
• Updated SuccessfulPayment, TransactionPartnerUser to reflect the new Star Subscription features.
• 🆕 Added new API Methods - editUserStarSubscription, setUserEmojiStatus, savePreparedInlineMessage, getAvailableGifts, sendGift.
• 🆕 Added new classes - PreparedInlineMessage, Gift, Gifts.

• ⚠️ Removed baseURL from Bot primary constructor.
• This is to rigidly separate Bot.local against Bot constructors. Why do we need to keep two copies of the same thing?
• From now on, local bots must be constructed using Bot.local.
• If you weren't using the local bot API, this change won't affect you.

• Fix: Base URL wasn't even being considered.
• Thanks to @itsmhmd for reporting
• Updated Request URI construction logic
• ⚠️ Breaking! Removed APIScheme. Now the scheme must be added to the baseURL itself.
• If you weren't using the local bot API, this change won't affect you.

• Fix RawAPI.sendPaidMedia crashes while sending local file using InputFile.fromFile

• 🤖 Bot API 7.11 🎃

• Fix in Context.hasCallbackQuery

• Check Webhook.secretToken with the header X-Telegram-Bot-Api-Secret-Token before processing the incoming webhook update.

• Fix typo in ReactionTypeCustomEmoji.customEmojiId

• Added LocalFile class.
• Redefined Payload.files parameter with the LocalFile objects instead of MultipartFile from Dio.

• 🐞 Fix: Webhook Bots crashed when an invalid body was present in the request.

• Added way too many internal changes.
• Added separate method for RawAPI construction in Bot
• RawAPI instance will be created along with Bot instance.
• 🐞 Not having above caused transformers to not work. So obviously, fixed that.
• Added more Context helper methods.
• (Internal) Bot._api is now non-nullable.
• (Internal) Properties _loggerOptions, _baseURL, and _scheme has been removed from Bot. They now solely belong to RawAPI.
• (Internal) Expensive calls are cached in Context, such as chat, msg are now cached for better performance in recurring access.

• Fix #294.
• Updated the Bot.init method to initalize the update streams as well.

• [⚠️ Breaking | Plugins] Updated the Transformer class
• Made the payload parameter for the Transformer.transform method optional-positional argument.
• Added RawAPI.call method for independently calling the Telegram Bot API methods.

• 🤖 Bot API 7.10
• Added Bot.onPaidMediaPurchase for listening to PaidMediaPurchased updates.
• Added much more helper methods on Context

• 🤖 Bot API 7.9
• Added new methods
• Published Televerse Documentation website (https://televerse.weaverlabs.ca)

• Exposed couple of more properties in Context
• Added Bot.additionalInfo
• Documentation website is up.

• 🤖 Bot API 7.8
• Added User.hasMainWebApp
• Support for managing pinned messages on behalf of user (Business Bots)

• Just a re-release to move the repo to @theweaverlabs

• Retracted :)

• Fixes #281 (Thanks to @IsD4n73 for raising the issue)
• Updated the Bot.start and Bot.stop logic
• Added LongPolling.allExcept

• Retracted