. * * @author Daniil Gentili * @copyright 2016-2025 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use AssertionError; use danog\Decoder\FileId; use danog\Decoder\FileIdType; use danog\MadelineProto\EventHandler\Media; use danog\MadelineProto\EventHandler\Media\AbstractSticker; use danog\MadelineProto\EventHandler\Media\Audio; use danog\MadelineProto\EventHandler\Media\Document; use danog\MadelineProto\EventHandler\Media\Gif; use danog\MadelineProto\EventHandler\Media\Photo; use danog\MadelineProto\EventHandler\Media\RoundVideo; use danog\MadelineProto\EventHandler\Media\Video; use danog\MadelineProto\EventHandler\Media\Voice; /** * Indicates a bot API file ID to upload using sendDocument, sendPhoto etc... */ final class BotApiFileId { /** * @param string $fileId The file ID * @param int<1, max> $size The file size * @param string $fileName The original file name * @param bool $protected Whether the original file is protected */ public function __construct( public readonly string $fileId, public readonly int $size, public readonly string $fileName, public readonly bool $protected ) { if ($size <= 0) { throw new AssertionError("The specified size must be >= 0!"); } } /** * @internal * * @return class-string */ public function getTypeClass(): string { $f = FileId::fromBotAPI($this->fileId); return match ($f->type) { FileIdType::PHOTO => Photo::class, FileIdType::VOICE => Voice::class, FileIdType::VIDEO => Video::class, FileIdType::DOCUMENT => Document::class, FileIdType::STICKER => AbstractSticker::class, FileIdType::VIDEO_NOTE => RoundVideo::class, FileIdType::AUDIO => Audio::class, FileIdType::ANIMATION => Gif::class, default => throw new AssertionError("Cannot use bot API file ID of type ".$f->type->value) }; } }