Latest

Author: irazasyed

CHANGELOG.md

@@ -9,10 +9,12 @@ All notable changes to `telegram` will be documented in this file
 * Drop support for Laravel 10.
 * Drop support for PHP 8.1.
 * Add support for Laravel 12.
+* Add `sticker` method to the `TelegramFile` to send sticker file.
 * Add `sendWhen` method to conditionally send a message.
 * Add ParseMode Enum and refactor parsing mode setting logic.
 * Add `buttonWithWebApp` method to open web app from a button.
 * Add `onError` method to handle exceptions. Based of https://github.com/laravel-notification-channels/telegram/pull/201
+* Refactor `sendFile` to support raw data sending.
 * Refactor `escapedLine` method.
 * Refactor `HasSharedLogic` trait.
 * Refactor classes to use PHP 8.2 features.

README.md

@@ -513,6 +513,7 @@ For more information on supported parameters, check out these [docs](https://cor
 - `animation(string $file)` - Send animated GIF.
 - `voice(string $file)` - Send voice note (OGG/OPUS).
 - `videoNote(string $file)` - Send video note (≤1min, rounded square video).
+- `sticker(string $file)` - Send sticker (static PNG/WEBP, animated .TGS, or video .WEBM stickers).
 
 ### Telegram Contact Methods
 

src/Enums/FileType.php

@@ -0,0 +1,81 @@
+<?php
+
+namespace NotificationChannels\Telegram\Enums;
+
+/**
+ * Enum FileType
+ *
+ * Represents the different file types supported by Telegram Bot API.
+ */
+enum FileType: string
+{
+    case Document = 'document';
+    case Photo = 'photo';
+    case Audio = 'audio';
+    case Video = 'video';
+    case Animation = 'animation';
+    case Voice = 'voice';
+    case VideoNote = 'video_note';
+    case Sticker = 'sticker';
+
+    /**
+     * Get the mime type associated with this file type.
+     */
+    public function getMimeType(): string
+    {
+        return match($this) {
+            self::Document => 'application/octet-stream',
+            self::Photo => 'image/jpeg',
+            self::Audio => 'audio/mp3',
+            self::Video => 'video/mp4',
+            self::Animation => 'video/mp4',
+            self::Voice => 'audio/ogg',
+            self::VideoNote => 'video/mp4',
+            self::Sticker => 'image/webp',
+        };
+    }
+
+    /**
+     * Get allowed file extensions for this type.
+     *
+     * @return array<string>
+     */
+    public function getAllowedExtensions(): array
+    {
+        return match($this) {
+            self::Document => [], // Any extension allowed
+            self::Photo => ['jpg', 'jpeg', 'png', 'webp'],
+            self::Audio => ['mp3', 'ogg', 'm4a'],
+            self::Video => ['mp4', 'avi', 'mov', 'mkv'],
+            self::Animation => ['gif', 'mp4'],
+            self::Voice => ['ogg', 'mp3'],
+            self::VideoNote => ['mp4'],
+            self::Sticker => ['png', 'webp', 'tgs', 'webm'],
+        };
+    }
+
+    /**
+     * Check if a file extension is allowed for this type.
+     */
+    public function isExtensionAllowed(string $extension): bool
+    {
+        $extensions = $this->getAllowedExtensions();
+
+        // Document allows all extensions
+        if ($this === self::Document || empty($extensions)) {
+            return true;
+        }
+
+        return in_array(strtolower($extension), $extensions, true);
+    }
+
+    /**
+     * Get all file types as an array.
+     *
+     * @return array<string, string>
+     */
+    public static function toArray(): array
+    {
+        return array_column(self::cases(), 'value', 'name');
+    }
+}

src/Exceptions/CouldNotSendNotification.php

@@ -46,4 +46,20 @@ public static function couldNotCommunicateWithTelegram(string $message): self
     {
         return new self("The communication with Telegram failed. `{$message}`");
     }
+
+    /**
+     * Thrown when the file cannot be opened.
+     */
+    public static function fileAccessFailed(string $file): self
+    {
+        return new self("Failed to open file: {$file}");
+    }
+
+    /**
+     * Thrown when the file identifier is invalid (ID or URL).
+     */
+    public static function invalidFileIdentifier(string $file): self
+    {
+        return new self("Invalid file identifier: {$file}");
+    }
 }