Docs update and fixes

Author: irazasyed

README.md

@@ -27,6 +27,7 @@ This package makes it easy to send Telegram notification using [Telegram Bot API
   - [Attach a Venue](#attach-a-venue)
   - [Attach a Video](#attach-a-video)
   - [Attach a GIF File](#attach-a-gif-file)
+  - [Attach a Sticker](#attach-a-sticker)
   - [Routing a Message](#routing-a-message)
   - [Handling Response](#handling-response)
   - [Exception Handling](#exception-handling)
@@ -318,13 +319,17 @@ Preview:
 public function toTelegram($notifiable)
 {
     return TelegramVenue::create()
-        ->latitude('40.6892494')
-        ->longitude('-74.0466891')
-        ->title('Sample Venue')
-        ->address('123 Main St.');
+        ->latitude('38.8951')
+        ->longitude('-77.0364')
+        ->title('Grand Palace')
+        ->address('Bangkok, Thailand');
 }
 ```
 
+Preview:
+
+![Laravel Telegram Venue Notification Example](https://github.com/user-attachments/assets/96e762a6-c4b5-4d8d-8c2d-9d32adb754d0)
+
 ### Attach a Video
 
 ```php
@@ -358,6 +363,20 @@ Preview:
 
 ![Laravel Telegram Gif Notification Example](https://user-images.githubusercontent.com/1915268/66617071-109ed080-ebf1-11e9-989b-b237f2b9502d.jpg)
 
+### Attach a Sticker
+
+```php
+public function toTelegram($notifiable)
+{
+    return TelegramFile::create()
+        ->sticker(storage_path('telegram/AnimatedSticker.tgs'));
+}
+```
+
+Preview:
+
+![Laravel Telegram Sticker Notification Example](https://github.com/user-attachments/assets/5206aac7-022c-4288-ae26-3a117f117fe0)
+
 ### Routing a Message
 
 You can either send the notification by providing with the chat ID of the recipient to the `to($chatId)` method like shown in the previous examples or add a `routeNotificationForTelegram()` method in your notifiable model:

src/Exceptions/CouldNotSendNotification.php

@@ -25,7 +25,7 @@ public static function telegramRespondedWithAnError(ClientException $exception):
 
         $statusCode = $exception->getResponse()->getStatusCode();
 
-        $result = json_decode($exception->getResponse()->getBody()->getContents(), false, 512, JSON_THROW_ON_ERROR);
+        $result = json_decode($exception->getResponse()->getBody()->getContents());
         $description = $result->description ?? 'no description given';
 
         return new self("Telegram responded with an error `{$statusCode} - {$description}`", 0, $exception);

src/Telegram.php

@@ -14,15 +14,15 @@
  */
 class Telegram
 {
-    /** @var string Telegram Bot API Base URI */
-    protected string $apiBaseUri;
+    /** Default Telegram Bot API Base URI.*/
+    protected const API_BASE_URI = 'https://api.telegram.org';
 
     public function __construct(
         protected ?string $token = null,
         protected HttpClient $http = new HttpClient,
-        string $apiBaseUri = 'https://api.telegram.org'
+        protected ?string $apiBaseUri = null
     ) {
-        $this->setApiBaseUri($apiBaseUri);
+        $this->setApiBaseUri($apiBaseUri ?? static::API_BASE_URI);
     }
 
     /**

src/TelegramFile.php

@@ -69,7 +69,7 @@ public function file(mixed $file, FileType|string $type, ?string $filename = nul
         $typeValue = $this->type->value;
 
         // Handle file URLs or Telegram file IDs
-        if (is_string($file) && !$this->isReadableFile($file)) {
+        if (is_string($file) && !$this->isReadableFile($file) && $filename === null) {
             if (!filter_var($file, FILTER_VALIDATE_URL) && !preg_match('/^[a-zA-Z0-9_-]+$/', $file)) {
                 throw CouldNotSendNotification::invalidFileIdentifier($file);
             }