telegram 1.0.0

A comprehensive Telegram utility for Flutter with URL schemes, Bot API integration, media sharing, chat management, and Web App support.

1.0.0 - Major Release 🚀

Added

• Modular Architecture: Refactored codebase into focused modules for better maintainability
  • url_schemes.dart - Client-side URL scheme methods
  • messaging.dart - Bot API messaging functionality
  • media.dart - Media handling for all file types
  • chat.dart - Chat management and information
  • members.dart - Member management and moderation
  • bot_config.dart - Bot configuration and commands
  • webhook.dart - Webhook management for real-time updates

Improved

• Code Organization: Clean separation of concerns with modular structure
• Maintainability: Each module focuses on specific functionality
• Import Flexibility: Option to import specific modules or use unified interface
• Documentation: Updated with modular architecture information
• Developer Experience: Better code navigation and understanding

Technical Details

• All existing APIs remain unchanged and fully backward compatible
• Main Telegram class provides unified interface to all modules
• Individual modules can be imported for targeted functionality
• Comprehensive test coverage maintained across all modules
• Example app updated to demonstrate all features

Added

• Complete Telegram Bot API Integration: Full support for Bot API with comprehensive methods
• Media Messaging: Support for sending photos, videos, audio, documents, animations, voice messages, and video notes
• Rich Content: Added support for stickers, contact sharing, venue sharing, location sharing
• Interactive Features: Poll creation, dice games, callback query handling
• Chat Management: Complete chat administration features including member management, permissions, invite links
• Message Management: Edit, delete, pin/unpin messages with full control
• Bot Configuration: Set bot descriptions, commands, and manage bot profile
• Webhook Support: Full webhook integration for real-time message handling
• Advanced URL Schemes: Support for Web Apps, sticker sets, themes, and sharing URLs
• File Upload Support: Handle file uploads for media messages
• Comprehensive Error Handling: Detailed error responses and validation

Bot API Methods Added

• getMe() - Get bot information
• sendMessage() - Send text messages with formatting
• forwardMessage() - Forward messages between chats
• sendPhoto() - Send photo messages with captions
• sendAudio() - Send audio files with metadata
• sendDocument() - Send document files
• sendVideo() - Send video files with preview
• sendVoice() - Send voice messages
• sendVideoNote() - Send circular video messages
• sendAnimation() - Send GIF animations
• sendSticker() - Send sticker messages
• sendContact() - Share contact information
• sendVenue() - Share venue/location details
• sendLocation() - Share location coordinates
• sendPoll() - Create polls and quizzes
• sendDice() - Send dice roll animations
• editMessageText() - Edit existing text messages
• deleteMessage() - Delete messages
• answerCallbackQuery() - Respond to inline keyboard presses

Chat Management Methods Added

• getChat() - Get chat information
• getChatMember() - Get member information
• getChatMemberCount() - Count chat members
• banChatMember() - Ban users from chat
• unbanChatMember() - Unban users
• restrictChatMember() - Restrict user permissions
• promoteChatMember() - Promote users to admin
• setChatAdministratorCustomTitle() - Set custom admin titles
• setChatTitle() - Change chat title
• setChatDescription() - Set chat description
• setChatPhoto() - Set chat profile photo
• deleteChatPhoto() - Remove chat photo
• setChatStickerSet() - Set chat sticker set
• deleteChatStickerSet() - Remove chat sticker set
• pinChatMessage() - Pin messages
• unpinChatMessage() - Unpin messages
• unpinAllChatMessages() - Unpin all messages
• leaveChat() - Leave a chat

Invite Link Management

• exportChatInviteLink() - Export primary invite link
• createChatInviteLink() - Create custom invite links
• editChatInviteLink() - Modify invite link settings
• revokeChatInviteLink() - Revoke invite links

Bot Configuration

• setMyCommands() - Set bot command menu
• getMyCommands() - Get current bot commands
• setMyDescription() - Set bot description
• getMyDescription() - Get bot description
• setMyShortDescription() - Set short description
• getMyShortDescription() - Get short description

Webhook Integration

• setWebhook() - Configure webhook URL
• deleteWebhook() - Remove webhook
• getWebhookInfo() - Get webhook status
• getUpdates() - Poll for updates (alternative to webhook)

Enhanced URL Scheme Methods

• openWebApp() - Launch Telegram Web Apps
• openStickerSet() - Open sticker set installation
• openTheme() - Open theme installation
• generateShareUrl() - Generate content sharing URLs
• createInlineKeyboardUrl() - Create inline button URLs

Improved

• Better Error Handling: More descriptive error messages and validation
• Enhanced Documentation: Comprehensive inline documentation with examples
• Type Safety: Better parameter validation and type checking
• Example Application: Complete demo showcasing all features
• Performance: Optimized API request handling

Breaking Changes

• Minimum Flutter SDK requirement updated
• Some method signatures updated for consistency
• Enhanced parameter validation may reject previously accepted invalid inputs

Documentation

• Updated README with comprehensive API reference
• Added detailed examples for all Bot API methods
• Improved getting started guide
• Added troubleshooting section

🎉 NEW: Official Telegram Bot API Integration

• Complete Bot API Support: Full integration with Telegram Bot API
• Bot Token Management: Secure bot token handling with setBotToken()
• Bot Information: Get bot details with getMe()
• Advanced Messaging: Send text, media, and formatted messages via Bot API

📨 Enhanced Messaging Features

• Rich Text Support: HTML, Markdown, and MarkdownV2 formatting
• Message Management: Edit, delete, and forward messages
• Reply Functionality: Reply to specific messages
• Silent Notifications: Send messages without notifications

🖼️ Media & File Support

• Photo Sharing: Send photos with captions via sendPhoto()
• Video Support: Send videos with metadata via sendVideo()
• Audio Files: Send audio with performer/title info via sendAudio()
• Document Sharing: Send any document type via sendDocument()
• Location Sharing: Send GPS coordinates via sendLocation()

💬 Chat Management

• Chat Information: Get detailed chat info with getChat()
• Member Count: Get chat member statistics with getChatMemberCount()
• Member Details: Get specific member info with getChatMember()
• Bot Commands: Set and manage bot commands with setMyCommands()

🌐 Web App Integration

• Telegram Web Apps: Open Web Apps with openWebApp()
• Inline Keyboards: Create interactive button URLs
• Share URLs: Generate content sharing links with generateShareUrl()

🎨 Enhanced UI Features

• Sticker Sets: Open sticker sets with openStickerSet()
• Themes: Open Telegram themes with openTheme()
• Better URL Handling: Improved URL generation and validation

🔧 Developer Experience

• Comprehensive Example: Full-featured demo app with all APIs
• Better Error Handling: Detailed error messages and exception handling
• Type Safety: Improved type definitions and null safety
• Documentation: Complete API documentation and usage examples

🐛 Bug Fixes & Improvements

• URL Encoding: Fixed special character handling in URLs
• Error Messages: More descriptive error messages
• Performance: Optimized API request handling
• Code Quality: Improved code structure and maintainability

---

0.0.9

📨 Send Message via Telegram 🔗 Telegram Link Generator 📌 Copy Telegram Link 💬 Open Chat Directly 📢 Join Telegram Channel/Group ✅ Check if Telegram is Installed 📞 Share Contact via Telegram 👥 Open Telegram Group 📷 Send Media via Telegram 🔍 Check Username Availability 🤖 Open Telegram Bot

0.0.7

Minor Updates

0.0.6

Updated README.md

0.0.5

Minor Updates

0.0.4

Updated Versions

0.0.2

copyLinkToClipboard()

Copy Telegram URL

getLink()

Get Telegram URL as String

send()

Send Message via Telegram