QXmppMucManager.h

// SPDX-FileCopyrightText: 2010 Jeremy Lainé <jeremy.laine@m4x.org>
//
// SPDX-License-Identifier: LGPL-2.1-or-later

#ifndef QXMPPMUCMANAGER_H
#define QXMPPMUCMANAGER_H

#include "QXmppClientExtension.h"
#include "QXmppMucIq.h"
#include "QXmppPresence.h"

class QXmppDataForm;
class QXmppDiscoveryIq;
class QXmppMessage;
class QXmppMucManagerPrivate;
class QXmppMucRoom;
class QXmppMucRoomPrivate;

class QXMPP_EXPORT QXmppMucManager : public QXmppClientExtension
{
    Q_OBJECT
    Q_PROPERTY(QList<QXmppMucRoom *> rooms READ rooms NOTIFY roomAdded)

public:
    QXmppMucManager();
    ~QXmppMucManager() override;

    QXmppMucRoom *addRoom(const QString &roomJid);

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QList<QXmppMucRoom *> rooms() const;

    QStringList discoveryFeatures() const override;
    bool handleStanza(const QDomElement &element) override;

    Q_SIGNAL void invitationReceived(const QString &roomJid, const QString &inviter, const QString &reason);

    Q_SIGNAL void roomAdded(QXmppMucRoom *room);

protected:
    void onRegistered(QXmppClient *client) override;
    void onUnregistered(QXmppClient *client) override;

private:
    Q_SLOT void _q_messageReceived(const QXmppMessage &message);
    Q_SLOT void _q_roomDestroyed(QObject *object);

    const std::unique_ptr<QXmppMucManagerPrivate> d;
};

class QXMPP_EXPORT QXmppMucRoom : public QObject
{
    Q_OBJECT
    Q_FLAGS(Action Actions)

    
    Q_PROPERTY(QXmppMucRoom::Actions allowedActions READ allowedActions NOTIFY allowedActionsChanged)
    Q_PROPERTY(bool isJoined READ isJoined NOTIFY isJoinedChanged)
    Q_PROPERTY(QString jid READ jid CONSTANT)
    Q_PROPERTY(QString name READ name NOTIFY nameChanged)
    Q_PROPERTY(QString nickName READ nickName WRITE setNickName NOTIFY nickNameChanged)
    Q_PROPERTY(QStringList participants READ participants NOTIFY participantsChanged)
    Q_PROPERTY(QString password READ password WRITE setPassword)
    Q_PROPERTY(QString subject READ subject WRITE setSubject NOTIFY subjectChanged)

public:
    enum Action {
        NoAction = 0,             
        SubjectAction = 1,        
        ConfigurationAction = 2,  
        PermissionsAction = 4,    
        KickAction = 8            
    };
    Q_DECLARE_FLAGS(Actions, Action)

    ~QXmppMucRoom() override;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    Actions allowedActions() const;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    bool isJoined() const;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QString jid() const;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QString name() const;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QString nickName() const;
    void setNickName(const QString &nickName);

    Q_INVOKABLE QString participantFullJid(const QString &jid) const;
    QXmppPresence participantPresence(const QString &jid) const;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QStringList participants() const;

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QString password() const;
    void setPassword(const QString &password);

    // documentation needs to be here, see https://stackoverflow.com/questions/49192523/
    QString subject() const;
    void setSubject(const QString &subject);

    Q_SIGNAL void allowedActionsChanged(QXmppMucRoom::Actions actions);

    Q_SIGNAL void configurationReceived(const QXmppDataForm &configuration);

    Q_SIGNAL void error(const QXmppStanza::Error &error);

    Q_SIGNAL void joined();

    Q_SIGNAL void kicked(const QString &jid, const QString &reason);

    Q_SIGNAL void isJoinedChanged();

    Q_SIGNAL void left();

    Q_SIGNAL void messageReceived(const QXmppMessage &message);

    Q_SIGNAL void nameChanged(const QString &name);

    Q_SIGNAL void nickNameChanged(const QString &nickName);

    Q_SIGNAL void participantAdded(const QString &jid);

    Q_SIGNAL void participantChanged(const QString &jid);

    Q_SIGNAL void participantRemoved(const QString &jid);

    Q_SIGNAL void participantsChanged();

    Q_SIGNAL void permissionsReceived(const QList<QXmppMucItem> &permissions);

    Q_SIGNAL void subjectChanged(const QString &subject);

    Q_SLOT bool ban(const QString &jid, const QString &reason);
    Q_SLOT bool join();
    Q_SLOT bool kick(const QString &jid, const QString &reason);
    Q_SLOT bool leave(const QString &message = QString());
    Q_SLOT bool requestConfiguration();
    Q_SLOT bool requestPermissions();
    Q_SLOT bool setConfiguration(const QXmppDataForm &form);
    Q_SLOT bool setPermissions(const QList<QXmppMucItem> &permissions);
    Q_SLOT bool sendInvitation(const QString &jid, const QString &reason);
    Q_SLOT bool sendMessage(const QString &text);

private:
    QXmppMucRoom(QXmppClient *client, const QString &jid, QObject *parent);

    Q_SLOT void _q_disconnected();
    Q_SLOT void _q_messageReceived(const QXmppMessage &message);
    Q_SLOT void _q_presenceReceived(const QXmppPresence &presence);

    const std::unique_ptr<QXmppMucRoomPrivate> d;
    friend class QXmppMucManager;
};

Q_DECLARE_OPERATORS_FOR_FLAGS(QXmppMucRoom::Actions)

#endif