itelegrambot.h

Go to the documentation of this file.

//#
//# Copyright (C) 2023-2024 QuasarApp.
//# Distributed under the GPLv3 software license, see the accompanying
//# Everyone is permitted to copy and distribute verbatim copies
//# of this license document, but changing it is not allowed.
//#
 
 
 
#ifndef ITELEGRAMBOT_H
#define ITELEGRAMBOT_H
 
#include "ibot.h"
#include "qTbot/telegramargs.h"
#include <QObject>
 
class QNetworkAccessManager;
class QNetworkReply;
 
namespace qTbot {
 
class ITelegramMessage;
class TelegramFile;
class TelegramUpdateAnswer;
class TelegramSendFile;
class TelegramSingleRquest;
 
typedef std::function<void(const QString& buttonKey, const QVariant& msgID)> ButtonCB;
typedef QList<QHash<QString, ButtonCB >> KeyboardOnMessage;
 
class QTBOT_EXPORT ITelegramBot : public IBot
{
    Q_OBJECT
public:
    ITelegramBot();
    ~ITelegramBot();
 
    bool login(const QByteArray &token) override;
 
    bool sendMessage(const QVariant &chatId, const QString& text) override;
 
    bool sendLocationRequest(const QVariant &chatId, const QString& text, const QString &buttonText, bool onetimeKeyboard);
 
    bool sendSelfContactRequest(const QVariant &chatId, const QString& text, const QString &buttonText, bool onetimeKeyboard);
 
    bool sendSpecificMessage(const TelegramArgs& args,
                             const qTbot::ExtraJsonObjects &extraObjects = {});
 
    bool sendSpecificMessageWithKeyboard(const TelegramArgs& args,
                                         const KeyboardOnMessage &keyboard);
 
    bool sendSpecificMessageWithKeyboard(const TelegramArgs& args,
                                         const QList<QList<QString> > &keyboard,
                                         bool onTimeKeyboard = false,
                                         bool autoResizeKeyboard = true);
 
    bool deleteMessage(const QVariant& chatId, const QVariant& messageId) override;
 
    bool editSpecificMessageWithKeyboard(const QVariant &messageId,
                                         const TelegramArgs& args,
                                         const QList<QList<QString> > &keyboard = {},
                                         bool onTimeKeyboard = false,
                                         bool autoResizeKeyboard = false);
 
 
    bool editSpecificMessageWithKeyboard(const QVariant& messageId,
                                         const TelegramArgs& args,
                                         const KeyboardOnMessage &keyboard = {});
 
    bool editMessageKeyboard(const QVariant& messageId,
                             const QVariant &chatId,
                             const KeyboardOnMessage &keyboard = {},
                             const QString &callBackQueryId = "");
 
    bool editSpecificMessage(const QVariant &messageId,
                             const TelegramArgs& args);
 
    [[nodiscard("do not forget to save shared pointer of file handler, because it's will not save inner bot object.")]]
    QSharedPointer<iFile> getFile(const QString& fileId, iFile::Type fileType = iFile::Type::Ram) override;
 
    QSharedPointer<QNetworkReply> getFileMeta(const QString& fileId,
                                              const QWeakPointer<iFile> &receiver = {nullptr});
 
    bool sendFile( const QFileInfo& file, const QVariant& chatId) override;
 
    bool sendFile( const QByteArray& file, const QString& fileName, const QVariant& chatId) override;
 
    bool sendFileMessage( const TelegramArgs& args, const QFileInfo& file);
 
    bool sendFileMessage( const TelegramArgs& args, const QByteArray& file, const QString& fileName);
 
    bool sendPhoto(const TelegramArgs& args,
                   const QFileInfo& photo,
                   const KeyboardOnMessage &keyboard = {});
 
    bool sendPhoto(const TelegramArgs &args,
                   const QByteArray& photo,
                   const QString& fileName,
                   const KeyboardOnMessage &keyboard = {});
 
    bool sendFileById(const QString& fileID, const QVariant& chatId);
 
    bool sendLocation(const TelegramArgs &args,
                      float latitude,
                      float longitude,
                      const KeyboardOnMessage &keyboard = {});
 
    bool sendContact(const TelegramArgs &args,
                     const QString& phone,
                     const QString& firstName,
                     const QString& secondName = "");
 
    // to do
 
    // * forwardMessage implementations
    // * copyMessage implementations
    // * sendAudio implementations
    // * sendVideo implementations
    // * sendVoice implementations
    // * sendContact implementations
    // * sendPoll implementations
    // * sendDice implementations
    // * sendChatAction implementations
    // * getUserProfilePhotos implementations
    // * banChatMember implementations
    // * unbanChatMember implementations
    // * restrictChatMember implementations
    // * setChatAdministratorCustomTitle implementations
    // * banChatSenderChat implementations
    // * unbanChatSenderChat implementations
    // * exportChatInviteLink implementations
    // * approveChatJoinRequest implementations
    // * declineChatJoinRequest implementations
    // * setChatTitle implementations
    // * pinChatMessage implementations
    // * unpinChatMessage implementations
    // * unpinAllChatMessages implementations
    // * leaveChat implementations
    // * getChat implementations
    // * getChatAdministrators implementations
    // * getChatMemberCount implementations
    // * getChatMember implementations
    // * answerCallbackQuery implementations
    // * getMyCommands implementations
    // * deleteMyCommands implementations
    // * getMyCommands implementations
    // * editMessageText implementations
    // * editMessageReplyMarkup implementations
    // * stopPoll implementations
    // * deleteMessage implementations
    // * sendSticker implementations
 
 
    unsigned long long id() const;
 
    const QString& username() const;
 
    int gelLastMessageId(unsigned long long &chatId) const;
 
protected:
 
    void setId(unsigned long long newId);
 
    void setUsername(const QString &newUsername);
 
    QString makeUrl(const QSharedPointer<iRequest>& request) const override;
 
    int getFileSizeByUniqueId(const QString& id) const;
 
    QSharedPointer<TelegramFile> getFileInfoByUniqueId(const QString& id) const;
 
    virtual void onRequestError(const QSharedPointer<TelegramUpdateAnswer>& ansverWithError) const;
 
    void handleIncomeNewUpdate(const QSharedPointer<iUpdate> &) override;
 
    virtual bool sendMessageRequest(const QSharedPointer<iRequest> &rquest,
                                    const std::function<void(int msgId)>& msgIdCB = {});
 
private slots:
    void handleLogin();
    void handleLoginErr(QNetworkReply::NetworkError err);
    void handleFileHeader(const QWeakPointer<QNetworkReply>& sender,
                          const QWeakPointer<iFile> &receiver);
 
private:
 
    QString findFileInlocatStorage(const QString& fileId) const;
    QHash<QString, QSharedPointer<QJsonObject> >
    prepareInlineKeyBoard(const KeyboardOnMessage &keyboard);
    ExtraJsonObjects prepareKeyboard(bool autoResizeKeyboard,
                                     bool onTimeKeyboard,
                                     const QList<QList<QString> > &keyboard);
 
    unsigned long long _id = 0;
    QString _username;
    QSharedPointer<QNetworkReply> _loginReplay;
    QMap<QString, std::function<void(const QString&, const QVariant&)>> _handleButtons;
 
    QHash<unsigned long long, int> _lastMessageId;
 
    QHash<QString, QSharedPointer<TelegramFile>> _filesMetaInfo;
 
 
};
}
#endif // ITELEGRAMBOT_H