Telegram Log Channel Laravel Package

Added

• Guzzle 8 support: the guzzlehttp/guzzle constraint is now ^7.0|^8.0. No code changes were required — the client options (verify, timeout, connect_timeout) and the post() JSON send path behave identically on both majors.

Notes

• laravel/framework still pins guzzlehttp/guzzle ^7.8.2 (as of v13.20.0), so a standard Laravel app will keep resolving Guzzle 7 until the framework widens its own constraint. This release simply stops the package from being the blocker.

Added

• Spam throttling: identical messages (same level, text, and source file:line) are now suppressed for a configurable window via the Cache facade. Controlled by TELEGRAM_LOG_THROTTLE (defaults to 600 seconds = 10 minutes; 0 disables it).

Fixed

• Added Guzzle timeout (5s) and connect_timeout (3s) so an unreachable Telegram API no longer blocks the request/queue worker indefinitely.

Fixed

• Queue failures setting now reads from a dedicated config file via config() instead of env() directly, ensuring compatibility with php artisan config:cache.
• Added mergeConfigFrom in register() so default values work without publishing.
• Added publishes() so users can publish config/telegram-log-channel.php for production use with config cache.

Added

• Automatic Telegram notification when a queued job fails (Queue::failing listener).
• Notifications include job name, exception message, connection name, and queue name.
• Controlled via TELEGRAM_LOG_QUEUE_FAILURES env variable (defaults to true).
• Compatible with Laravel 10, 11, and 12.

Added

• Added unit tests for TelegramHandler to verify recursion protection and error handling.
• Added autoload-dev to composer.json for test support.

Fixed

• Added protection against recursive logging in TelegramHandler.
• Added try-catch block in TelegramHandler::write to handle exceptions during log sending.
• Implemented logSelfError to log internal errors to the single channel or system log without recursion.