BPT\telegram\telegram

Complexity

Total Complexity

5

Size/Duplication

Total Lines	58
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	fileLink()	0	6	2
A	downloadFile()	0	2	1
A	__call()	0	2	1
A	sendFile()	0	13	1

<?php

namespace BPT\telegram;
use BPT\constants\fileTypes;
use BPT\tools;
use BPT\types\forceReply;
use BPT\types\inlineKeyboardMarkup;
use BPT\types\message;
use BPT\types\replyKeyboardMarkup;
use BPT\types\replyKeyboardRemove;
use BPT\types\responseError;
use stdClass;

/**
 * telegram class , Adding normal method call to request class and a simple name for being easy to call
 */
class telegram extends request {
    public function __call (string $name, array $arguments) {
        return request::$name(...$arguments);
    }

    /**
     * download telegram file with file_id to destination location
     *
     * It has 20MB download limit(same as telegram)
     *
     * e.g. => tools::downloadFile('test.mp4');
     *
     * e.g. => tools::downloadFile('test.mp4','file_id_asdadadadadadad);
     *
     * @param string|null $destination destination for save the file
     * @param string|null $file_id     file_id for download, if not set, will generate by request::catchFields method
     *
     * @return bool
     */
    public static function downloadFile (string|null $destination = null, string|null $file_id = null): bool {
        return tools::downloadFile(self::fileLink($file_id), $destination);

It seems like $destination can also be of type null; however, parameter $path of BPT\tools::downloadFile() does only seem to accept string, maybe add an additional type check?

It seems like self::fileLink($file_id) can also be of type boolean; however, parameter $url of BPT\tools::downloadFile() does only seem to accept string, maybe add an additional type check?

    }

    public static function fileLink(string|null $file_id = null): bool|string {
        $file = self::getFile($file_id);
        if (!isset($file->file_path)) {
            return false;
        }
        return $file->link();
    }

    /**
     * send file with only file_id
     *
     * e.g. => tools::sendFile('file_id_asdadsadadadadadada');
     *
     * e.g. => tools::sendFile('file_id_asdadsadadadadadada','hello');
     *
     * @param string          $file_id
     * @param int|string|null $chat_id
     * @param int|null        $message_thread_id default : null
     * @param string|null     $caption
     *
     * @return message|bool|responseError
     */
    public static function sendFile (string $file_id, int|string $chat_id = null, int $message_thread_id = null, string $caption = null, string $parse_mode = null, array $caption_entities = null, bool $disable_notification = null, bool $protect_content = null, int $reply_to_message_id = null, bool $allow_sending_without_reply = null, inlineKeyboardMarkup|replyKeyboardMarkup|replyKeyboardRemove|forceReply|stdClass|array $reply_markup = null, string $token = null, bool $forgot = null, bool $answer = null): message|bool|responseError {
        $type = tools::fileType($file_id);
        return match ($type) {
            fileTypes::VIDEO => self::sendVideo($file_id, $chat_id, null, null, null, null, $caption, $parse_mode, $caption_entities, null, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::VIDEO_NOTE => self::sendVideoNote($file_id, $chat_id, null, null, null, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::ANIMATION => self::sendAnimation($file_id, $chat_id, null, null, null, null, $caption, $parse_mode, $caption_entities, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::AUDIO => self::sendAudio($file_id, $chat_id, $caption, $parse_mode, $caption_entities, null, null, null, null, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::PHOTO,
            fileTypes::PROFILE_PHOTO => self::sendPhoto($file_id, $chat_id, $caption, $parse_mode, $caption_entities, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::VOICE => self::sendVoice($file_id, $chat_id, $caption, $parse_mode, $caption_entities, null, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::STICKER => self::sendSticker($file_id, $chat_id, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            fileTypes::DOCUMENT => self::sendDocument($file_id, $chat_id, null, $caption, $parse_mode, $caption_entities, null, $disable_notification, $protect_content, $reply_to_message_id, $allow_sending_without_reply, $reply_markup, $token, $forgot, $answer, $message_thread_id),
            default => false,
        };
    }
}