Implement XEP-0357: Push Notifications enable/disable IQ (#271)

Co-authored-by: Robert Maerkisch <zatroxde@protonmail.ch>
Co-authored-by: Linus Jahn <lnj@kaidan.im>

5 files changed, 261 insertions, 0 deletions

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 489ccd0b..3ca3f85e 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -43,6 +43,7 @@ set(INSTALL_HEADER_FILES
     base/QXmppPresence.h
     base/QXmppPubSubIq.h
     base/QXmppPubSubItem.h
+    base/QXmppPushEnableIq.h
     base/QXmppRegisterIq.h
     base/QXmppResultSet.h
     base/QXmppRosterIq.h
@@ -123,6 +124,7 @@ set(SOURCE_FILES
     base/QXmppPresence.cpp
     base/QXmppPubSubIq.cpp
     base/QXmppPubSubItem.cpp
+    base/QXmppPushEnableIq.cpp
     base/QXmppRegisterIq.cpp
     base/QXmppResultSet.cpp
     base/QXmppRosterIq.cpp
diff --git a/src/base/QXmppConstants.cpp b/src/base/QXmppConstants.cpp
index bd813ea6..9cfd532c 100644
--- a/src/base/QXmppConstants.cpp
+++ b/src/base/QXmppConstants.cpp
@@ -139,6 +139,8 @@ const char* ns_chat_markers = "urn:xmpp:chat-markers:0";
 const char* ns_message_processing_hints = "urn:xmpp:hints";
 // XEP-0352: Client State Indication
 const char* ns_csi = "urn:xmpp:csi:0";
+// XEP-0357: Push Notifications
+const char* ns_push = "urn:xmpp:push:0";
 // XEP-0359: Unique and Stable Stanza IDs
 const char* ns_sid = "urn:xmpp:sid:0";
 // XEP-0363: HTTP File Upload
diff --git a/src/base/QXmppConstants_p.h b/src/base/QXmppConstants_p.h
index 23b0fcdd..3cc2ca67 100644
--- a/src/base/QXmppConstants_p.h
+++ b/src/base/QXmppConstants_p.h
@@ -151,6 +151,8 @@ extern const char* ns_chat_markers;
 extern const char* ns_message_processing_hints;
 // XEP-0352: Client State Indication
 extern const char* ns_csi;
+// XEP-0357: Push Notifications
+extern const char* ns_push;
 // XEP-0359: Unique and Stable Stanza IDs
 extern const char* ns_sid;
 // XEP-0363: HTTP File Upload
diff --git a/src/base/QXmppPushEnableIq.cpp b/src/base/QXmppPushEnableIq.cpp
new file mode 100644
index 00000000..f367566e
--- /dev/null
+++ b/src/base/QXmppPushEnableIq.cpp
@@ -0,0 +1,179 @@
+/*
+ * Copyright (C) 2008-2020 The QXmpp developers
+ *
+ * Author:
+ *  Robert Märkisch
+ *  Linus Jahn
+ *  Jonah Brüchert
+ *
+ * Source:
+ *  https://github.com/qxmpp-project/qxmpp
+ *
+ * This file is a part of QXmpp library.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ */
+
+#include "QXmppPushEnableIq.h"
+
+#include "QXmppConstants_p.h"
+#include "QXmppDataForm.h"
+
+#include <QDomElement>
+
+class QXmppPushEnableIqPrivate : public QSharedData
+{
+public:
+    QString node;
+    QString jid;
+    QXmppPushEnableIq::Mode mode;
+    QXmppDataForm dataForm;
+};
+
+QXmppPushEnableIq::QXmppPushEnableIq()
+    : d(new QXmppPushEnableIqPrivate())
+{
+}
+
+QXmppPushEnableIq::QXmppPushEnableIq(const QXmppPushEnableIq &) = default;
+QXmppPushEnableIq::~QXmppPushEnableIq() = default;
+QXmppPushEnableIq &QXmppPushEnableIq::operator=(const QXmppPushEnableIq &) = default;
+
+///
+/// \brief Returns the jid of the app server
+///
+QString QXmppPushEnableIq::jid() const
+{
+    return d->jid;
+}
+
+///
+/// \brief Sets the jid of the app server
+///
+void QXmppPushEnableIq::setJid(const QString &jid)
+{
+    d->jid = jid;
+}
+
+///
+/// \brief Returns the pubsub node on the app server used by the IQ
+///
+QString QXmppPushEnableIq::node() const
+{
+    return d->node;
+}
+
+///
+/// \brief Set the pubsub note on the app server to be used by the IQ
+///
+void QXmppPushEnableIq::setNode(const QString &node)
+{
+    d->node = node;
+}
+
+///
+/// \brief Returns the mode
+///
+QXmppPushEnableIq::Mode QXmppPushEnableIq::mode()
+{
+    return d->mode;
+}
+
+///
+/// \brief Set whether the IQ should enable or disable push notifications
+///
+void QXmppPushEnableIq::setMode(QXmppPushEnableIq::Mode mode)
+{
+    d->mode = mode;
+}
+
+///
+/// \brief Returns the data form containing the publish options which the user
+/// server Should send to the app server.
+///
+/// It is only available for enable IQs.
+///
+QXmppDataForm QXmppPushEnableIq::dataForm() const
+{
+    return d->dataForm;
+}
+
+///
+/// \brief Sets the data form containing the publish options which the user
+/// server Should send to the app server.
+///
+///  It should only be set for enable IQs.
+///
+void QXmppPushEnableIq::setDataForm(const QXmppDataForm &form)
+{
+    d->dataForm = form;
+}
+
+///
+/// \brief Checks whether a QDomElement is a push notification enable / disable
+/// IQ.
+///
+bool QXmppPushEnableIq::isPushEnableIq(const QDomElement &element)
+{
+    auto childElement = element.firstChildElement();
+    return childElement.namespaceURI() == ns_push &&
+        (childElement.tagName() == QStringLiteral("enable") || childElement.tagName() == QStringLiteral("disable"));
+}
+
+/// \cond
+void QXmppPushEnableIq::parseElementFromChild(const QDomElement &element)
+{
+    QDomElement childElement = element.firstChildElement();
+    while (!childElement.isNull()) {
+        if (childElement.namespaceURI() == ns_push) {
+            if (childElement.tagName() == QStringLiteral("enable")) {
+                d->mode = Enable;
+
+                auto dataFormElement = childElement.firstChildElement("x");
+                if (!dataFormElement.isNull() && dataFormElement.namespaceURI() == ns_data) {
+                    QXmppDataForm dataForm;
+                    dataForm.parse(dataFormElement);
+                    d->dataForm = dataForm;
+                }
+            } else {
+                d->mode = Disable;
+            }
+            d->jid = childElement.attribute(QStringLiteral("jid"));
+            d->node = childElement.attribute(QStringLiteral("node"));
+            break;
+        }
+
+        childElement = childElement.nextSiblingElement();
+    }
+}
+
+void QXmppPushEnableIq::toXmlElementFromChild(QXmlStreamWriter *writer) const
+{
+    switch (d->mode) {
+    case Enable:
+        writer->writeStartElement(QStringLiteral("enable"));
+        break;
+    case Disable:
+        writer->writeStartElement(QStringLiteral("disable"));
+        break;
+    }
+
+    writer->writeDefaultNamespace(ns_push);
+    writer->writeAttribute(QStringLiteral("jid"), d->jid);
+    writer->writeAttribute(QStringLiteral("node"), d->node);
+
+    if (d->mode == Enable) {
+        d->dataForm.toXml(writer);
+    }
+    writer->writeEndElement();
+}
+/// \endcond
diff --git a/src/base/QXmppPushEnableIq.h b/src/base/QXmppPushEnableIq.h
new file mode 100644
index 00000000..d6bd0735
--- /dev/null
+++ b/src/base/QXmppPushEnableIq.h
@@ -0,0 +1,76 @@
+/*
+ * Copyright (C) 2008-2020 The QXmpp developers
+ *
+ * Author:
+ *  Robert Märkisch
+ *  Linus Jahn
+ *  Jonah Brüchert
+ *
+ * Source:
+ *  https://github.com/qxmpp-project/qxmpp
+ *
+ * This file is a part of QXmpp library.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ */
+
+#pragma once
+
+#include <QXmppIq.h>
+
+class QXmppPushEnableIqPrivate;
+class QXmppDataForm;
+
+///
+/// \brief This class represents an IQ to enable or disablepush notifications
+/// on the user server.
+///
+class QXMPP_EXPORT QXmppPushEnableIq : public QXmppIq
+{
+public:
+    QXmppPushEnableIq();
+    QXmppPushEnableIq(const QXmppPushEnableIq &);
+    ~QXmppPushEnableIq();
+    QXmppPushEnableIq &operator=(const QXmppPushEnableIq &);
+
+    ///
+    /// \brief The Mode enum describes whether the IQ should enable or disable
+    /// push notifications
+    ///
+    enum Mode : bool {
+        Enable = true,
+        Disable = false
+    };
+
+    QString jid() const;
+    void setJid(const QString &jid);
+
+    QString node() const;
+    void setNode(const QString &node);
+
+    void setMode(Mode mode);
+    Mode mode();
+
+    QXmppDataForm dataForm() const;
+    void setDataForm(const QXmppDataForm &form);
+
+    static bool isPushEnableIq(const QDomElement &element);
+
+protected:
+    /// \cond
+    void parseElementFromChild(const QDomElement &element) override;
+    void toXmlElementFromChild(QXmlStreamWriter *writer) const override;
+    /// \endcond
+
+private:
+    QSharedDataPointer<QXmppPushEnableIqPrivate> d;
+};