i_connection.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include "i_transport.h"
#include "types.h"
 
#include <chrono>
 
namespace kcenon::network::unified {
 
class i_connection : public i_transport {
public:
    ~i_connection() override = default;
 
    // Non-copyable, movable (inherited from i_transport)
    i_connection(const i_connection&) = delete;
    i_connection& operator=(const i_connection&) = delete;
    i_connection(i_connection&&) = default;
    i_connection& operator=(i_connection&&) = default;
 
    // =========================================================================
    // Connection Lifecycle Operations
    // =========================================================================
 
    [[nodiscard]] virtual auto connect(const endpoint_info& endpoint) -> VoidResult = 0;
 
    [[nodiscard]] virtual auto connect(std::string_view url) -> VoidResult = 0;
 
    virtual auto close() noexcept -> void = 0;
 
    // =========================================================================
    // Configuration Operations
    // =========================================================================
 
    virtual auto set_callbacks(connection_callbacks callbacks) -> void = 0;
 
    virtual auto set_options(connection_options options) -> void = 0;
 
    virtual auto set_timeout(std::chrono::milliseconds timeout) -> void = 0;
 
    // =========================================================================
    // State Query Operations
    // =========================================================================
 
    [[nodiscard]] virtual auto is_connecting() const noexcept -> bool = 0;
 
    virtual auto wait_for_stop() -> void = 0;
 
protected:
    i_connection() = default;
};
 
}  // namespace kcenon::network::unified