QXmppJingleIq.h

// SPDX-FileCopyrightText: 2010 Jeremy Lainé <jeremy.laine@m4x.org>
// SPDX-FileCopyrightText: 2022 Melvin Keskin <melvo@olomono.de>
//
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#ifndef QXMPPJINGLEIQ_H
#define QXMPPJINGLEIQ_H
 
#include "QXmppIq.h"
 
#include <variant>
 
#include <QHostAddress>
 
class QXmppJingleCandidatePrivate;
class QXmppJingleIqContentPrivate;
class QXmppJingleIqPrivate;
class QXmppJinglePayloadTypePrivate;
class QXmppJingleRtpCryptoElementPrivate;
class QXmppJingleRtpEncryptionPrivate;
class QXmppJingleRtpFeedbackPropertyPrivate;
class QXmppJingleRtpHeaderExtensionPropertyPrivate;
class QXmppSdpParameterPrivate;
 
class QXMPP_EXPORT QXmppSdpParameter
{
public:
    QXmppSdpParameter();
 
    QXMPP_PRIVATE_DECLARE_RULE_OF_SIX(QXmppSdpParameter)
 
    QString name() const;
    void setName(const QString &name);
 
    QString value() const;
    void setValue(const QString &value);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static bool isSdpParameter(const QDomElement &element);
 
private:
    QSharedDataPointer<QXmppSdpParameterPrivate> d;
};
 
class QXMPP_EXPORT QXmppJingleRtpCryptoElement
{
public:
    QXmppJingleRtpCryptoElement();
 
    QXMPP_PRIVATE_DECLARE_RULE_OF_SIX(QXmppJingleRtpCryptoElement)
 
    uint32_t tag() const;
    void setTag(uint32_t tag);
 
    QString cryptoSuite() const;
    void setCryptoSuite(const QString &cryptoSuite);
 
    QString keyParams() const;
    void setKeyParams(const QString &keyParams);
 
    QString sessionParams() const;
    void setSessionParams(const QString &sessionParams);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static bool isJingleRtpCryptoElement(const QDomElement &element);
 
private:
    QSharedDataPointer<QXmppJingleRtpCryptoElementPrivate> d;
};
 
class QXMPP_EXPORT QXmppJingleRtpEncryption
{
public:
    QXmppJingleRtpEncryption();
 
    QXMPP_PRIVATE_DECLARE_RULE_OF_SIX(QXmppJingleRtpEncryption)
 
    bool isRequired() const;
    void setRequired(bool isRequired);
 
    QVector<QXmppJingleRtpCryptoElement> cryptoElements() const;
    void setCryptoElements(const QVector<QXmppJingleRtpCryptoElement> &cryptoElements);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static bool isJingleRtpEncryption(const QDomElement &element);
 
private:
    QSharedDataPointer<QXmppJingleRtpEncryptionPrivate> d;
};
 
class QXMPP_EXPORT QXmppJingleRtpFeedbackProperty
{
public:
    QXmppJingleRtpFeedbackProperty();
 
    QXMPP_PRIVATE_DECLARE_RULE_OF_SIX(QXmppJingleRtpFeedbackProperty)
 
    QString type() const;
    void setType(const QString &type);
 
    QString subtype() const;
    void setSubtype(const QString &subtype);
 
    QVector<QXmppSdpParameter> parameters() const;
    void setParameters(const QVector<QXmppSdpParameter> &parameters);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static bool isJingleRtpFeedbackProperty(const QDomElement &element);
 
private:
    QSharedDataPointer<QXmppJingleRtpFeedbackPropertyPrivate> d;
};
 
class QXMPP_EXPORT QXmppJingleRtpFeedbackInterval
{
public:
    QXmppJingleRtpFeedbackInterval();
 
    QXMPP_PRIVATE_DECLARE_RULE_OF_SIX(QXmppJingleRtpFeedbackInterval)
 
    uint64_t value() const;
    void setValue(uint64_t value);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static bool isJingleRtpFeedbackInterval(const QDomElement &element);
 
private:
    uint64_t m_value;
};
 
class QXMPP_EXPORT QXmppJingleRtpHeaderExtensionProperty
{
public:
    enum Senders {
        Both,
        Initiator,
        Responder
    };
 
    QXmppJingleRtpHeaderExtensionProperty();
 
    QXMPP_PRIVATE_DECLARE_RULE_OF_SIX(QXmppJingleRtpHeaderExtensionProperty)
 
    uint32_t id() const;
    void setId(uint32_t id);
 
    QString uri() const;
    void setUri(const QString &uri);
 
    Senders senders() const;
    void setSenders(Senders senders);
 
    QVector<QXmppSdpParameter> parameters() const;
    void setParameters(const QVector<QXmppSdpParameter> &parameters);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static bool isJingleRtpHeaderExtensionProperty(const QDomElement &element);
 
private:
    QSharedDataPointer<QXmppJingleRtpHeaderExtensionPropertyPrivate> d;
};
 
class QXMPP_EXPORT QXmppJinglePayloadType
{
public:
    QXmppJinglePayloadType();
    QXmppJinglePayloadType(const QXmppJinglePayloadType &other);
    ~QXmppJinglePayloadType();
 
    unsigned char channels() const;
    void setChannels(unsigned char channels);
 
    unsigned int clockrate() const;
    void setClockrate(unsigned int clockrate);
 
    unsigned char id() const;
    void setId(unsigned char id);
 
    unsigned int maxptime() const;
    void setMaxptime(unsigned int maxptime);
 
    QString name() const;
    void setName(const QString &name);
 
    QMap<QString, QString> parameters() const;
    void setParameters(const QMap<QString, QString> &parameters);
 
    unsigned int ptime() const;
    void setPtime(unsigned int ptime);
 
    QVector<QXmppJingleRtpFeedbackProperty> rtpFeedbackProperties() const;
    void setRtpFeedbackProperties(const QVector<QXmppJingleRtpFeedbackProperty> &rtpFeedbackProperties);
 
    QVector<QXmppJingleRtpFeedbackInterval> rtpFeedbackIntervals() const;
    void setRtpFeedbackIntervals(const QVector<QXmppJingleRtpFeedbackInterval> &rtpFeedbackIntervals);
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    QXmppJinglePayloadType &operator=(const QXmppJinglePayloadType &other);
    bool operator==(const QXmppJinglePayloadType &other) const;
 
private:
    QSharedDataPointer<QXmppJinglePayloadTypePrivate> d;
};
 
class QXMPP_EXPORT QXmppJingleCandidate
{
public:
    enum Type {
        HostType,             
        PeerReflexiveType,    
        ServerReflexiveType,  
        RelayedType           
    };
 
    QXmppJingleCandidate();
    QXmppJingleCandidate(const QXmppJingleCandidate &other);
    QXmppJingleCandidate(QXmppJingleCandidate &&);
    ~QXmppJingleCandidate();
 
    QXmppJingleCandidate &operator=(const QXmppJingleCandidate &other);
    QXmppJingleCandidate &operator=(QXmppJingleCandidate &&);
 
    int component() const;
    void setComponent(int component);
 
    QString foundation() const;
    void setFoundation(const QString &foundation);
 
    int generation() const;
    void setGeneration(int generation);
 
    QHostAddress host() const;
    void setHost(const QHostAddress &host);
 
    QString id() const;
    void setId(const QString &id);
 
    int network() const;
    void setNetwork(int network);
 
    quint16 port() const;
    void setPort(quint16 port);
 
    int priority() const;
    void setPriority(int priority);
 
    QString protocol() const;
    void setProtocol(const QString &protocol);
 
    QXmppJingleCandidate::Type type() const;
    void setType(QXmppJingleCandidate::Type);
 
    bool isNull() const;
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
    static QXmppJingleCandidate::Type typeFromString(const QString &typeStr, bool *ok = nullptr);
    static QString typeToString(QXmppJingleCandidate::Type type);
 
private:
    QSharedDataPointer<QXmppJingleCandidatePrivate> d;
};
 
class QXMPP_EXPORT QXmppJingleIq : public QXmppIq
{
public:
    enum Action {
        ContentAccept,
        ContentAdd,
        ContentModify,
        ContentReject,
        ContentRemove,
        DescriptionInfo,
        SecurityInfo,
        SessionAccept,
        SessionInfo,
        SessionInitiate,
        SessionTerminate,
        TransportAccept,
        TransportInfo,
        TransportReject,
        TransportReplace
    };
 
    enum Creator {
        Initiator,
        Responder
    };
 
    struct RtpSessionStateActive
    {
    };
 
    struct RtpSessionStateHold
    {
    };
 
    struct RtpSessionStateUnhold
    {
    };
 
    struct RtpSessionStateMuting
    {
        bool isMute = true;
        Creator creator;
        QString name;
    };
 
    struct RtpSessionStateRinging
    {
    };
 
    using RtpSessionState = std::variant<RtpSessionStateActive, RtpSessionStateHold, RtpSessionStateUnhold, RtpSessionStateMuting, RtpSessionStateRinging>;
 
    class QXMPP_EXPORT Content
    {
    public:
        Content();
        Content(const QXmppJingleIq::Content &other);
        Content(QXmppJingleIq::Content &&);
        ~Content();
 
        Content &operator=(const Content &other);
        Content &operator=(Content &&);
 
        QString creator() const;
        void setCreator(const QString &creator);
 
        QString name() const;
        void setName(const QString &name);
 
        QString senders() const;
        void setSenders(const QString &senders);
 
        // XEP-0167: Jingle RTP Sessions
        QString descriptionMedia() const;
        void setDescriptionMedia(const QString &media);
 
        quint32 descriptionSsrc() const;
        void setDescriptionSsrc(quint32 ssrc);
 
        bool isRtpMultiplexingSupported() const;
        void setRtpMultiplexingSupported(bool isRtpMultiplexingSupported);
 
        std::optional<QXmppJingleRtpEncryption> rtpEncryption() const;
        void setRtpEncryption(const std::optional<QXmppJingleRtpEncryption> &rtpEncryption);
 
        void addPayloadType(const QXmppJinglePayloadType &payload);
        QList<QXmppJinglePayloadType> payloadTypes() const;
        void setPayloadTypes(const QList<QXmppJinglePayloadType> &payloadTypes);
 
        void addTransportCandidate(const QXmppJingleCandidate &candidate);
        QList<QXmppJingleCandidate> transportCandidates() const;
        void setTransportCandidates(const QList<QXmppJingleCandidate> &candidates);
 
        QString transportUser() const;
        void setTransportUser(const QString &user);
 
        QString transportPassword() const;
        void setTransportPassword(const QString &password);
 
        QVector<QXmppJingleRtpFeedbackProperty> rtpFeedbackProperties() const;
        void setRtpFeedbackProperties(const QVector<QXmppJingleRtpFeedbackProperty> &rtpFeedbackProperties);
 
        QVector<QXmppJingleRtpFeedbackInterval> rtpFeedbackIntervals() const;
        void setRtpFeedbackIntervals(const QVector<QXmppJingleRtpFeedbackInterval> &rtpFeedbackIntervals);
 
        QVector<QXmppJingleRtpHeaderExtensionProperty> rtpHeaderExtensionProperties() const;
        void setRtpHeaderExtensionProperties(const QVector<QXmppJingleRtpHeaderExtensionProperty> &rtpHeaderExtensionProperties);
 
        bool isRtpHeaderExtensionMixingAllowed() const;
        void setRtpHeaderExtensionMixingAllowed(bool isRtpHeaderExtensionMixingAllowed);
 
        // XEP-0320: Use of DTLS-SRTP in Jingle Sessions
        QByteArray transportFingerprint() const;
        void setTransportFingerprint(const QByteArray &fingerprint);
 
        QString transportFingerprintHash() const;
        void setTransportFingerprintHash(const QString &hash);
 
        QString transportFingerprintSetup() const;
        void setTransportFingerprintSetup(const QString &setup);
 
        void parse(const QDomElement &element);
        void toXml(QXmlStreamWriter *writer) const;
 
        bool parseSdp(const QString &sdp);
        QString toSdp() const;
 
    private:
        QSharedDataPointer<QXmppJingleIqContentPrivate> d;
    };
 
    class QXMPP_EXPORT Reason
    {
    public:
        enum Type {
            None,
            AlternativeSession,
            Busy,
            Cancel,
            ConnectivityError,
            Decline,
            Expired,
            FailedApplication,
            FailedTransport,
            GeneralError,
            Gone,
            IncompatibleParameters,
            MediaError,
            SecurityError,
            Success,
            Timeout,
            UnsupportedApplications,
            UnsupportedTransports
        };
 
        enum RtpErrorCondition {
            NoErrorCondition,
            InvalidCrypto,
            CryptoRequired
        };
 
        Reason();
 
        QString text() const;
        void setText(const QString &text);
 
        Type type() const;
        void setType(Type type);
 
        RtpErrorCondition rtpErrorCondition() const;
        void setRtpErrorCondition(RtpErrorCondition rtpErrorCondition);
 
        void parse(const QDomElement &element);
        void toXml(QXmlStreamWriter *writer) const;
 
    private:
        QString m_text;
        Type m_type;
        RtpErrorCondition m_rtpErrorCondition = NoErrorCondition;
    };
 
    QXmppJingleIq();
    QXmppJingleIq(const QXmppJingleIq &other);
    QXmppJingleIq(QXmppJingleIq &&);
    ~QXmppJingleIq() override;
 
    QXmppJingleIq &operator=(const QXmppJingleIq &other);
    QXmppJingleIq &operator=(QXmppJingleIq &&);
 
    Action action() const;
    void setAction(Action action);
 
    void addContent(const Content &content);
    QList<Content> contents() const;
    void setContents(const QList<Content> &contents);
 
    QString initiator() const;
    void setInitiator(const QString &initiator);
 
    Reason &reason();
    const Reason &reason() const;
 
    QString responder() const;
    void setResponder(const QString &responder);
 
#if QXMPP_DEPRECATED_SINCE(1, 5)
    QT_DEPRECATED_X("Use QXmpp::rtpSessionState() instead")
    bool ringing() const;
    QT_DEPRECATED_X("Use QXmpp::setRtpSessionState() instead")
    void setRinging(bool ringing);
#endif
 
    QString sid() const;
    void setSid(const QString &sid);
 
    QString mujiGroupChatJid() const;
    void setMujiGroupChatJid(const QString &mujiGroupChatJid);
 
    std::optional<RtpSessionState> rtpSessionState() const;
    void setRtpSessionState(const std::optional<RtpSessionState> &rtpSessionState);
 
    static bool isJingleIq(const QDomElement &element);
 
protected:
    void parseElementFromChild(const QDomElement &element) override;
    void toXmlElementFromChild(QXmlStreamWriter *writer) const override;
 
private:
    QSharedDataPointer<QXmppJingleIqPrivate> d;
};
 
Q_DECLARE_METATYPE(QXmppJingleIq::Reason::RtpErrorCondition)
 
#endif