session_concept.h

Go to the documentation of this file.

/*****************************************************************************
BSD 3-Clause License
 
Copyright (c) 2025, kcenon
All rights reserved.
*****************************************************************************/
 
#pragma once
 
#include "kcenon/network/detail/utils/result_types.h"
 
#include <chrono>
#include <cstdint>
#include <memory>
#include <string>
#include <string_view>
#include <typeinfo>
#include <vector>
 
namespace kcenon::network::core {
 
// Import VoidResult from network namespace for convenience
using kcenon::network::VoidResult;
 
class session_concept {
public:
    virtual ~session_concept() = default;
 
    // Non-copyable (managed via unique_ptr)
    session_concept(const session_concept&) = delete;
    session_concept& operator=(const session_concept&) = delete;
 
    // Movable
    session_concept(session_concept&&) = default;
    session_concept& operator=(session_concept&&) = default;
 
    // =========================================================================
    // Core Session Operations
    // =========================================================================
 
    [[nodiscard]] virtual auto id() const -> std::string_view = 0;
 
    [[nodiscard]] virtual auto is_connected() const -> bool = 0;
 
    [[nodiscard]] virtual auto send(std::vector<uint8_t>&& data)
        -> VoidResult = 0;
 
    virtual auto close() -> void = 0;
 
    virtual auto stop() -> void = 0;
 
    // =========================================================================
    // Type Information
    // =========================================================================
 
    [[nodiscard]] virtual auto type() const noexcept -> const std::type_info& = 0;
 
    [[nodiscard]] virtual auto get_raw() noexcept -> void* = 0;
 
    [[nodiscard]] virtual auto get_raw() const noexcept -> const void* = 0;
 
    // =========================================================================
    // Activity Tracking (optional, based on traits)
    // =========================================================================
 
    [[nodiscard]] virtual auto has_activity_tracking() const noexcept -> bool = 0;
 
    [[nodiscard]] virtual auto created_at() const
        -> std::chrono::steady_clock::time_point = 0;
 
    [[nodiscard]] virtual auto last_activity() const
        -> std::chrono::steady_clock::time_point = 0;
 
    virtual auto update_activity() -> void = 0;
 
    [[nodiscard]] virtual auto idle_duration() const -> std::chrono::milliseconds = 0;
 
protected:
    session_concept() = default;
};
 
} // namespace kcenon::network::core