File indexing completed on 2024-12-08 07:33:45

 // SPDX-FileCopyrightText: 2019 Black Hat <bhat@encom.eu.org>
 // SPDX-License-Identifier: GPL-3.0-only
 
 #pragma once
 
 #include <QAbstractListModel>
 #include <QObject>
 #include <QQmlEngine>
 
 #include <Quotient/csapi/list_public_rooms.h>
 
 namespace Quotient
 {
 class Connection;
 }
 
 /**
  * @class PublicRoomListModel
  *
  * This class defines the model for visualising a list of public rooms.
  *
  * The model finds the public rooms visible to the given server (which doesn't have
  * to be the user's home server) and can also apply a filter if desired.
  *
  * Due to the fact that the public room list could be huge the model is lazily loaded
  * and requires that the next batch of rooms be manually called.
  */
 class PublicRoomListModel : public QAbstractListModel
 {
     Q_OBJECT
     QML_ELEMENT
 
     /**
      * @brief The current connection that the model is getting its rooms from.
      */
     Q_PROPERTY(Quotient::Connection *connection READ connection WRITE setConnection NOTIFY connectionChanged)
 
     /**
      * @brief The server to get the public room list from.
      */
     Q_PROPERTY(QString server READ server WRITE setServer NOTIFY serverChanged)
 
     /**
      * @brief The filter keyword for the list of public rooms.
      */
     Q_PROPERTY(QString keyword READ keyword WRITE setKeyword NOTIFY keywordChanged)
 
     /**
      * @brief Whether only space rooms should be shown.
      */
     Q_PROPERTY(bool showOnlySpaces READ showOnlySpaces WRITE setShowOnlySpaces NOTIFY showOnlySpacesChanged)
 
     /**
      * @brief Whether the model has more items to load.
      */
     Q_PROPERTY(bool hasMore READ hasMore NOTIFY hasMoreChanged)
 
     /**
      * @biref Whether the model is still loading.
      */
     Q_PROPERTY(bool loading READ loading NOTIFY loadingChanged)
 
 public:
     /**
      * @brief Defines the model roles.
      */
     enum EventRoles {
         DisplayNameRole = Qt::DisplayRole + 1, /**< The name of the room. */
         AvatarUrlRole, /**< The source URL for the room's avatar. */
         TopicRole, /**< The room topic. */
         RoomIdRole, /**< The room matrix ID. */
         AliasRole, /**< The room canonical alias. */
         MemberCountRole, /**< The number of members in the room. */
         AllowGuestsRole, /**< Whether the room allows guest users. */
         WorldReadableRole, /**< Whether the room events can be seen by non-members. */
         IsJoinedRole, /**< Whether the local user has joined the room. */
     };
 
     explicit PublicRoomListModel(QObject *parent = nullptr);
 
     /**
      * @brief Get the given role value at the given index.
      *
      * @sa QAbstractItemModel::data
      */
     [[nodiscard]] QVariant data(const QModelIndex &index, int role = DisplayNameRole) const override;
 
     /**
      * @brief Number of rows in the model.
      *
      * @sa  QAbstractItemModel::rowCount
      */
     [[nodiscard]] int rowCount(const QModelIndex &parent = QModelIndex()) const override;
 
     /**
      * @brief Returns a mapping from Role enum values to role names.
      *
      * @sa EventRoles, QAbstractItemModel::roleNames()
      */
     [[nodiscard]] QHash<int, QByteArray> roleNames() const override;
 
     [[nodiscard]] Quotient::Connection *connection() const;
     void setConnection(Quotient::Connection *conn);
 
     [[nodiscard]] QString server() const;
     void setServer(const QString &value);
 
     [[nodiscard]] QString keyword() const;
     void setKeyword(const QString &value);
 
     [[nodiscard]] bool showOnlySpaces() const;
     void setShowOnlySpaces(bool showOnlySpaces);
 
     [[nodiscard]] bool hasMore() const;
 
     [[nodiscard]] bool loading() const;
 
     /**
      * @brief Load the next set of rooms.
      *
      * @param count the maximum number of rooms to load.
      */
     Q_INVOKABLE void next(int count = 50);
 
 private:
     Quotient::Connection *m_connection = nullptr;
     QString m_server;
     QString m_keyword;
     bool m_showOnlySpaces = false;
 
     bool attempted = false;
     bool m_loading = false;
     QString nextBatch;
 
     QList<Quotient::PublicRoomsChunk> rooms;
 
     Quotient::QueryPublicRoomsJob *job = nullptr;
 
 Q_SIGNALS:
     void connectionChanged();
     void serverChanged();
     void keywordChanged();
     void showOnlySpacesChanged();
     void hasMoreChanged();
     void loadingChanged();
 };