/* * Komplex Wallpaper Engine * Copyright (C) 2026 @DigitalArtifex * https://digitalartifex.dev - https://github.com/DigitalArtifex * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see */ #ifndef WALLPAPERPAGINATOR_H #define WALLPAPERPAGINATOR_H #include #include #include #include #include #include #include #include #include #include "common/logging.h" #include "common/paginator.h" #include "common/wallpapercache.h" #include "common/coreservices.h" /** * @brief The WallpaperPaginator class * Most of the media endpoints for the Komplex API have the same data structure so * child classes can make use of this generic controller where possible */ class KOMPLEX_EXPORT WallpaperPaginator : public Paginator { Q_OBJECT public: explicit WallpaperPaginator(QObject *parent = nullptr) : Paginator(parent) { SlidingCacheController *controller = this->controller(); controller->setFetch( std::bind(&WallpaperPaginator::fetch, this, std::placeholders::_1, std::placeholders::_2) ); } /** * @brief uri * URI of the API Endpoint. This is set by the child class * @return */ [[nodiscard]] auto uri() const -> QString { return m_uri; } /** * @brief query * Current query string, if the API Endpoint supports queries * @return */ [[nodiscard]] auto query() const -> QString { return m_query; } /** * @brief setQuery * Sets the new query string and updates the controller * @param query */ auto setQuery(const QString &query) -> void { if(query == m_query) { return; } m_query = query; Q_EMIT queryChanged(); reset(); setOffset(0); } signals: /** * @brief uriChanged */ auto uriChanged() -> void; /** * @brief queryChanged */ auto queryChanged() -> void; protected: /** * @brief fetch * Used to fetch results from the API endpoint * for the CacheController. It is intended to be passed * to the Cache Controller not meant to be called directly. * @param offset Offset index to start the results from * @param limit Number of results to attempt to fetch * @return FetchResult */ [[nodiscard]] auto fetch( qsizetype offset, qsizetype limit ) const -> FetchResult { LOG_ERROR_X(m_uri.isEmpty(), "WallpaperPaginator::fetch", "Uri not set", {} ); QUrl url( QString::fromUtf8("%1/%2/%3").arg( KOMPLEX_API_HOST, KOMPLEX_API_VERSION, m_uri ) ); QNetworkRequest request(url); request.setHeaders( QHttpHeaders::fromMultiMap( { { QByteArray("Query"), m_query.toUtf8() }, { QByteArray("Offset"), QString::number(offset).toUtf8() }, { QByteArray("Limit"), QString::number(limit).toUtf8() }, { QByteArray("SessionToken"), CoreServices::sessionToken() } } ) ); QNetworkReply *reply = getNetworkReply(request); if(reply == nullptr) { return {}; } QJsonDocument document = getDocument(reply); QJsonObject rootObject = document.object(); const QJsonArray resultsArray = rootObject.value(QString::fromUtf8("results")).toArray(); QList fetchedResults; for(const auto result : resultsArray) { if(!result.isObject()) { continue; } QJsonObject resultObject = result.toObject(); fetchedResults.append( { resultObject.value(QString::fromUtf8("uuid")).toString(), resultObject.value(QString::fromUtf8("title")).toString(), resultObject.value(QString::fromUtf8("author")).toString(), resultObject.value(QString::fromUtf8("author_id")).toString(), resultObject.value(QString::fromUtf8("description")).toString(), resultObject.value(QString::fromUtf8("thumbnail")).toString(), QDateTime::fromString( resultObject.value(QString::fromUtf8("creation")).toString(), QString::fromUtf8("yyyy-MM-dd HH:mm:ss") ), resultObject.value(QString::fromUtf8("price")).toDouble(), resultObject.value(QString::fromUtf8("currency")).toString(), static_cast( resultObject.value(QString::fromUtf8("downloadCount") ).toInteger()), static_cast( resultObject.value(QString::fromUtf8("description") ).toInt()), } ); } FetchResult result { static_cast(rootObject.value(QString::fromUtf8("total_results")).toInteger()), fetchedResults.count(), std::move(fetchedResults) }; return std::move(result); } /** * @brief getNetworkReply * Processes the request and blocks until completion. * @param request * @return */ [[nodiscard]] auto getNetworkReply(const QNetworkRequest &request) const -> QNetworkReply* { QEventLoop loop; QWeakPointer managerReference = CoreServices::networkAccessManager(); QSharedPointer manager = managerReference.toStrongRef(); LOG_ERROR_X(!manager, "NewestPacksPaginator::getNetworkReply", "Network manager reference has already been deleted", nullptr ); QNetworkReply *reply = manager->post(request, nullptr); QObject::connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit); QObject::connect(reply, &QNetworkReply::errorOccurred, &loop, [&loop](QNetworkReply::NetworkError error) -> void { loop.quit(); } ); if(!reply->isFinished()) { loop.exec(); } LOG_ERROR_X(reply->error() != QNetworkReply::NoError, "NewestPacksPaginator::getNetworkReply", reply->errorString().toStdString().c_str(), nullptr ); return reply; } /** * @brief getDocument * Extracts the JSON document from the server reply * @param reply * @return */ [[nodiscard]] auto getDocument(QNetworkReply *reply) const -> QJsonDocument { QJsonParseError documentError; QJsonDocument document = QJsonDocument::fromJson(reply->readAll(), &documentError); LOG_ERROR_X(documentError.error != QJsonParseError::NoError, "NewestPacksPaginator::getDocument", documentError.errorString().toStdString().c_str(), {} ); return document; } /** * @brief setUri * Sets the API Endpoint URI to fetch from * @param uri */ auto setUri(const QString &uri) -> void { if(uri == m_uri) { return; } m_uri = uri; Q_EMIT uriChanged(); } private: /** * @brief m_uri * API Endpoint URI */ QString m_uri; /** * @brief m_query * The query string used in fetch operations */ QString m_query; }; #endif // WALLPAPERPAGINATOR_H