Telegram Bot Laravel Package

Fixed

• Disable new_expression_parentheses PHP-CS-Fixer rule entirely to prevent false positives across all PHP versions

General

• Add Bot Api 7.6 (July 1, 2024) functionality

Other

• Small cosmetic fixes

Added

• Add full test suite infrastructure: TestHttpClient (PSR-18 mock), shared BaseFixtureGenerator, reflection-based generators for Entity/Request/Response/API fixtures
• Add 295 EntityDeserializationTest, 173 RequestConstructionTest, 84 ResponseConstructionTest via AbstractFixtureConstructionTest
• Add ApiUnitTest with DataProvider covering 177 API methods via TestHttpClient pipeline
• Add EntityComplexFixturesTest with real Telegram API responses: 28 Message entities (7 overlapping groups), 43 RichMessage blocks (all types, deep nesting to 4 levels)
• Add ValueObject tests for EncodedJson, CallbackData, IpV4, IpV6, Filename, Language (all 11 ValueObjects covered)
• Add Kernel unit tests: Request, LogMiddleware, LogPlugin, LogRequestHandler, Events, UpdateSources (Array, CustomInput)
• Add CI/CD pipeline (.github/workflows/ci.yml): PHP 8.2/8.3/8.4 matrix, cs-check, phpstan, phpunit+clover, codecov upload
• Add coverage configuration to phpunit.xml.dist (Clover + HTML reports, exclude Entity/Request/Response/Enum/HttpClient)
• Add README/COVERAGE.md with P0-P4 priority strategy
• Add CI and Codecov badges to README.md
• Add Bot API 10.1 support: 6 new enums (RichTextTypeEnum, RichBlockTypeEnum, ChatJoinRequestResultEnum, RichBlockTableCellAlignEnum, RichBlockTableCellVerticalAlignEnum, RichBlockListItemTypeEnum)
• Add 2 abstract base classes (AbstractRichText, AbstractRichBlock) and ~55 concrete entity classes for rich messages
• Add 4 request/response classes (SendRichMessageRequest/Response, SendRichMessageDraftRequest, AnswerChatJoinRequestQueryRequest, SendChatJoinRequestWebAppRequest)
• Add 4 new API methods (sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp)
• Add fields to existing entities: Message.rich_message, User.supports_join_request_queries, ChatFullInfo.guard_bot, ChatJoinRequest.query_id, PollMedia.link, EditMessageTextRequest.rich_message
• Add InputRichMessageContent to AbstractInputMessageContent inheritors, InputMediaLink to InputPollOptionMediaInterface inheritors
• Add semantic documentation markup across the entire codebase: [@moduleContract](https://github.com/moduleContract) PHPDoc blocks, // region/// endregion semantic tags, GREP_SUMMARY, and STRUCTURE mini block diagrams for all 686+ source files
• Create 24+ _module_contract.php namespace contract files for all namespaces under src/
• Add semantic markup to src/Request/RequestInterface.php
• Add PHPStan static analysis config (phpstan.neon, level 2) as dev dependency

Changed

• Add declare(strict_types=1) to all 710 source files without it (now 100% coverage)
• Update dependencies: phpunit 11.5.46→11.5.55 (CVE fix), php-cs-fixer 3.95.2→3.95.5, class-builder 1.3.3→1.3.4, serializer 1.3.0→1.3.1
• Replace regex-based phone validation with giggsey/libphonenumber-for-php in Phone value object. Now accepts any readable format, normalizes to E.164. Country-specific validity delegated to Telegram API.

Fixed

• Fix strict_types regression in MessageCommandChecker: strpos() returning false passed to substr($length)
• Fix PHPStan level 2 errors: static:: private constant access, misplaced [@var](https://github.com/var) PHPDoc, HArray generics cleanup, [@return](https://github.com/return) mixed mismatch, undefined variables in Utils.php try/catch blocks
• Fix Url value object to normalize scheme-less URLs (e.g., t.me/path → https://t.me/path) in Url::normalize()

Fixed

• Fix http client implementation

Added

• Add Bot Api 10.0 (May 8, 2026)

Added

• Add \AndrewGos\TelegramBot\Kernel\UpdateSource\ArrayUpdateSource update source

Added

• Add Bot Api 9.6 (April 3, 2026) functionality

Changed

• Make $serializer parameter in Api required

Removed

• Remove deprecations

Added

• Add Bot Api 9.5 (March 1, 2026) functionality

Added

• Add Bot Api 9.4 (February 9, 2026) functionality

Added

• Add functionality that allows you to stop request propagation

Added

• Add Bot Api 9.3 (December 31, 2025) functionality

Added

• Connect andrew-gos/serializer package for requests and entities serialization

Removed

• Drop all toArray methods from entities and requests
• Remove AbstractEntity class to improve performance

Added

• Add Bot Api 9.2 (August 15, 2025) functionality

Changed

• Rename has_protected_forwards property of ChatFullInfo to has_private_forwards
• Sync all models with documentation
• Add null as default value for all responses constructors

Fixed

• Fix descriptions of classes and their parameters

Removed

• Drop AndrewGos\TelegramBot\ValueObject\RequestId class

Added

• Add Bot Api 9.1 (July 3, 2025) functionality

Fixed

• Fix comments on some entities

Added

• Add error throw on non 2xx responses

Fixed

• Fix documentation

Added

• Add setters for api and update handler for Telegram class
• Add setter for api for UpdateHandler class

Changed

• Change update processors, fixes

Added

• Add Bot Api 8.3 (February 12, 2025) functionality

Added

• Add Bot Api 8.2 (January 1, 2025) functionality

Added

• Add Bot Api 8.1 (December 4, 2024) functionality

Added

• Add Bot Api 8.0 (November 17, 2024) functionality

Added

• Add Bot Api 7.11 (October 31, 2024) functionality

Added

• Add Bot Api 7.10 (September 6, 2024) functionality
• Allow IpV4 to be used with mask (like 127.0.0.1/32)

Added

• Add Bot Api 7.9 (August 14, 2024) functionality

Added

• Add Bot Api 7.8 (July 31, 2024) functionality

Fixed

• Fix purchased_paid_media update

Added

• Add Bot Api 9.0 (April 11, 2025) functionality

Changed

• Small cosmetic fixes

Added

• Add Bot Api 7.7 (July 7, 2024) functionality

Changed

• Move ClassBuilder to external package
• Some cleaning and small fixes

Added

• Add Bot Api 7.6 (July 1, 2024) functionality

Changed

• Small cosmetic fixes