ClientManager.hpp

/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
 *
 * Copyright (C) 2025 Marco Craveiro <marco.craveiro@gmail.com>
 *
 * 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, write to the Free Software Foundation, Inc., 51
 * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 */
#ifndef ORES_QT_CLIENT_MANAGER_HPP
#define ORES_QT_CLIENT_MANAGER_HPP
 
#include <atomic>
#include <chrono>
#include <memory>
#include <optional>
#include <string>
#include <thread>
#include <filesystem>
#include <boost/asio/io_context.hpp>
#include <boost/asio/executor_work_guard.hpp>
#include <boost/uuid/uuid.hpp>
#include <QObject>
#include <QDateTime>
#include "ores.comms/net/client.hpp"
#include "ores.comms/net/client_session.hpp"
#include "ores.comms/service/remote_event_adapter.hpp"
#include "ores.comms/recording/session_recorder.hpp"
#include "ores.comms/service/telemetry_streaming_service.hpp"
#include "ores.eventing/service/event_bus.hpp"
#include "ores.logging/make_logger.hpp"
#include "ores.iam/domain/session.hpp"
 
namespace ores::qt {
 
struct BootstrapBundleInfo {
    QString code;
    QString name;
    QString description;
};
 
struct LoginResult {
    bool success = false;
    QString error_message;
    bool password_reset_required = false;
    bool bootstrap_mode = false;  
    std::vector<BootstrapBundleInfo> available_bundles;  
};
 
struct SignupResult {
    bool success = false;
    QString error_message;
    QString username;
};
 
struct SessionListResult {
    std::vector<iam::domain::session> sessions;
    std::uint32_t total_count = 0;
};
 
class ClientManager : public QObject {
    Q_OBJECT
 
private:
    inline static std::string_view logger_name =
        "ores.qt.client_manager";
 
    [[nodiscard]] static auto& lg() {
        using namespace ores::logging;
        static auto instance = make_logger(logger_name);
        return instance;
    }
 
public:
    explicit ClientManager(std::shared_ptr<eventing::service::event_bus> event_bus,
                           QObject* parent = nullptr);
    ~ClientManager() override;
 
    LoginResult connect(const std::string& host, std::uint16_t port);
 
    LoginResult login(const std::string& username, const std::string& password);
 
    LoginResult connectAndLogin(
        const std::string& host,
        std::uint16_t port,
        const std::string& username,
        const std::string& password);
 
    LoginResult testConnection(
        const std::string& host,
        std::uint16_t port,
        const std::string& username,
        const std::string& password);
 
    SignupResult signup(
        const std::string& host,
        std::uint16_t port,
        const std::string& username,
        const std::string& email,
        const std::string& password);
 
    void disconnect();
 
    bool logout();
 
    bool isConnected() const;
 
    [[deprecated("Permission checks are now server-side via RBAC")]]
    bool isAdmin() const;
 
    bool isLoggedIn() const { return session_.is_logged_in(); }
 
    std::string currentUsername() const { return session_.username(); }
 
    std::string currentEmail() const { return session_.email(); }
 
    void setCurrentEmail(const std::string& email) { session_.set_email(email); }
 
    std::optional<boost::uuids::uuid> accountId() const { return session_.account_id(); }
 
    std::string serverAddress() const {
        if (!isConnected()) {
            return "";
        }
        return connected_host_ + ":" + std::to_string(connected_port_);
    }
 
    std::string connectedHost() const {
        if (!isConnected()) {
            return "";
        }
        return connected_host_;
    }
 
    std::uint16_t connectedPort() const {
        if (!isConnected()) {
            return 0;
        }
        return connected_port_;
    }
 
    std::expected<comms::messaging::frame, ores::utility::serialization::error_code>
    sendRequest(comms::messaging::frame request);
 
    template <typename RequestType>
        requires comms::messaging::has_message_traits<RequestType>
    auto process_request(RequestType request) {
        return session_.process_request(std::move(request));
    }
 
    template <typename RequestType>
        requires comms::messaging::has_message_traits<RequestType>
    auto process_authenticated_request(RequestType request) {
        return session_.process_authenticated_request(std::move(request));
    }
 
    template <typename RequestType>
        requires comms::messaging::has_message_traits<RequestType>
    auto process_admin_request(RequestType request) {
        return session_.process_admin_request(std::move(request));
    }
 
    comms::net::client_session& session() { return session_; }
 
    std::optional<SessionListResult> listSessions(
        const boost::uuids::uuid& accountId,
        std::uint32_t limit = 100,
        std::uint32_t offset = 0);
 
    std::optional<std::vector<iam::domain::session>> getActiveSessions();
 
    std::shared_ptr<comms::net::client> getClient() const { return client_; }
 
    boost::asio::any_io_executor getExecutor() {
        return io_context_->get_executor();
    }
 
    void subscribeToEvent(const std::string& eventType);
 
    void unsubscribeFromEvent(const std::string& eventType);
 
    void setSupportedCompression(std::uint8_t compression) {
        supported_compression_ = compression;
    }
 
    // =========================================================================
    // Session Recording
    // =========================================================================
 
    bool enableRecording(const std::filesystem::path& outputDirectory);
 
    void disableRecording();
 
    bool isRecording() const;
 
    std::filesystem::path recordingFilePath() const;
 
    void setRecordingDirectory(const std::filesystem::path& directory) {
        recording_directory_ = directory;
    }
 
    std::filesystem::path recordingDirectory() const {
        return recording_directory_;
    }
 
    // =========================================================================
    // Telemetry Streaming
    // =========================================================================
 
    void enableStreaming(const comms::service::telemetry_streaming_options& options);
 
    void disableStreaming();
 
    bool isStreaming() const;
 
    std::size_t streamingPendingCount() const;
 
    std::uint64_t streamingTotalSent() const;
 
    std::uint64_t streamingTotalDropped() const;
 
signals:
    void connected();
    void loggedIn();
    void disconnected();
    void reconnecting();
    void reconnected();
    void connectionError(const QString& message);
 
    void notificationReceived(const QString& eventType, const QDateTime& timestamp,
                              const QStringList& entityIds);
 
    void recordingStarted(const QString& filePath);
 
    void recordingStopped();
 
    void streamingStarted();
 
    void streamingStopped();
 
private:
    void setupIO();
    void cleanupIO();
 
private:
    // Persistent IO infrastructure
    std::unique_ptr<boost::asio::io_context> io_context_;
    std::unique_ptr<boost::asio::executor_work_guard<
        boost::asio::io_context::executor_type>> work_guard_;
    std::unique_ptr<std::thread> io_thread_;
 
    // Transient client (owned by ClientManager, attached to session_)
    std::shared_ptr<comms::net::client> client_;
 
    // Client session for auth-aware request handling and session state
    comms::net::client_session session_;
 
    // Event bus for publishing connection events (passed to client)
    std::shared_ptr<eventing::service::event_bus> event_bus_;
 
    // Connection details for event publishing
    std::string connected_host_;
    std::uint16_t connected_port_{0};
 
    // Compression support bitmask (default: all compression types)
    std::uint8_t supported_compression_{0x07}; // COMPRESSION_SUPPORT_ALL
 
    // Session recording output directory
    std::filesystem::path recording_directory_;
 
    // Whether recording is enabled (can be set before connection)
    bool recording_enabled_{false};
 
    // Telemetry streaming service
    std::unique_ptr<comms::service::telemetry_streaming_service> telemetry_streaming_;
 
    // Streaming options (stored when enabled before connection)
    std::optional<comms::service::telemetry_streaming_options> pending_streaming_options_;
 
    // Whether streaming is enabled (can be set before connection)
    bool streaming_enabled_{false};
 
    // Flag to distinguish user-initiated disconnect from connection loss
    // Set to true when user clicks disconnect, checked before emitting reconnecting signal
    std::atomic<bool> user_disconnecting_{false};
 
    // Stored credentials for re-authentication after reconnection
    // Note: storing password in memory is acceptable for desktop apps since
    // the password was already in memory during initial login
    std::string stored_username_;
    std::string stored_password_;
};
 
}
 
#endif