/*
    SPDX-FileCopyrightText: 2005-2007 Joris Guisson <joris.guisson@gmail.com>

    SPDX-License-Identifier: GPL-2.0-or-later
*/

#ifndef KTUPNPROUTER_H
#define KTUPNPROUTER_H

#include <QStringList>
#include <QUrl>

#include <ktorrent_export.h>
#include <net/portlist.h>

#include <memory>

class KJob;

namespace bt
{
class HTTPRequest;
class WaitJob;

/*!
 * \headerfile upnp/upnprouter.h
 * \brief Structure describing a UPnP service found in an XML file.
 */
struct KTORRENT_EXPORT UPnPService {
    QString serviceid;
    QString servicetype;
    QString controlurl;
    QString eventsuburl;
    QString scpdurl;

    UPnPService();
    UPnPService(const UPnPService &s);

    /*!
     * Set a property of the service.
     * \param name Name of the property (matches to variable names)
     * \param value Value of the property
     */
    void setProperty(const QString &name, const QString &value);

    /*!
     * Set all strings to empty.
     */
    void clear();

    /*!
     * Assignment operator
     * \param s The service to copy
     * \return *this
     */
    UPnPService &operator=(const UPnPService &s);
};

/*!
 * \headerfile upnp/upnprouter.h
 * \brief Struct to hold the description of a UPnP device.
 */
struct KTORRENT_EXPORT UPnPDeviceDescription {
    QString friendlyName;
    QString manufacturer;
    QString modelDescription;
    QString modelName;
    QString modelNumber;

    /*!
     * Set a property of the description
     * \param name Name of the property (matches to variable names)
     * \param value Value of the property
     */
    void setProperty(const QString &name, const QString &value);
};

/*!
 * \headerfile upnp/upnprouter.h
 * \author Joris Guisson
 *
 * \brief Represents a UPnP enabled router.
 *
 * This class is also used to communicate with the router.
 */
class KTORRENT_EXPORT UPnPRouter : public QObject
{
    Q_OBJECT
public:
    /*!
     * Construct a router.
     * \param server The name of the router
     * \param location The location of it's xml description file
     * \param verbose Print lots of debug info
     */
    UPnPRouter(const QString &server, const QUrl &location, bool verbose = false);
    ~UPnPRouter() override;

    //! Disable or enable verbose logging
    void setVerbose(bool v);

    //! Get the name  of the server
    [[nodiscard]] QString getServer() const;

    //! Get the location of it's xml description
    [[nodiscard]] QUrl getLocation() const;

    //! Get the device description
    UPnPDeviceDescription &getDescription();

    //! Get the device description (const version)
    [[nodiscard]] const UPnPDeviceDescription &getDescription() const;

    //! Get the current error (null string if there is none)
    [[nodiscard]] QString getError() const;

    //! Get the router's external IP
    [[nodiscard]] QString getExternalIP() const;

    /*!
     * Download the XML File of the router.
     */
    void downloadXMLFile();

    /*!
     * Add a service to the router.
     * \param s The service
     */
    void addService(UPnPService s);

#if 0
    /*!
     * See if a port is forwarded
     * \param port The Port
     */
    void isPortForwarded(const net::Port & port);
#endif

    /*!
     * Forward a local port
     * \param port The local port to forward
     */
    void forward(const net::Port &port);

    /*!
     * Undo forwarding
     * \param port The port
     * \param waitjob When this is set the jobs needs to be added to the waitjob,
     * so we can wait for their completeion at exit
     */
    void undoForward(const net::Port &port, bt::WaitJob *waitjob = nullptr);

    /*!
        \headerfile upnp/upnprouter.h
        \brief Implements the visitor pattern for port forwarding.

        In order to iterate over all forwardings, the visitor pattern must be used.
    */
    class Visitor
    {
    public:
        virtual ~Visitor()
        {
        }

        /*!
            Called for each forwarding.
            \param port The Port
            \param pending When set to true, the forwarding is not completed yet
            \param service The UPnPService this forwarding is for
        */
        virtual void forwarding(const net::Port &port, bool pending, const UPnPService *service) = 0;
    };

    /*!
        Visit all forwardings
        \param visitor The Visitor
    */
    void visit(Visitor *visitor) const;

private:
    void forwardResult(HTTPRequest *r);
    void undoForwardResult(HTTPRequest *r);
    void getExternalIPResult(HTTPRequest *r);
    void downloadFinished(const KJob *j);

Q_SIGNALS:
    /*!
     * Internal state has changed, a forwarding succeeded or failed, or an undo forwarding succeeded or failed.
     */
    void stateChanged();

    /*!
     * Signal which indicates that the XML was downloaded successfully or not.
     * \param r The router which emitted the signal
     * \param success Whether or not it succeeded
     */
    void xmlFileDownloaded(bt::UPnPRouter *r, bool success);

private:
    class UPnPRouterPrivate;
    std::unique_ptr<UPnPRouterPrivate> d;
};

}

#endif
