Endpoint.hpp

// SPDX-FileCopyrightText: 2026 Vincent Leroy
// SPDX-License-Identifier: MIT
//
// This file is part of dfx.
//
// Licensed under the MIT License. See the LICENSE file in the project root
// for full license information.
 
#pragma once
 
// Standard includes
#include <string>
 
// Project includes
#include <dfx-utilities/EnumString.hpp>
 
namespace dfx::Core
{
class Port;
class Node;
using NodePtr = std::shared_ptr<Node>;
 
class Endpoint
{
public:
    enum class Location
    {
        Local,  
        Remote, 
    };
 
public:
    struct Descriptor
    {
        std::string scheme;  
        std::string address; 
        std::string node;    
        std::string port;    
    };
 
public:
    explicit Endpoint(Port & port);

    explicit Endpoint(std::string scheme, std::string address, std::string node, std::string port);

    Location location() const noexcept       { return _location; }

    Descriptor const & desc() const noexcept { return _desc; }

    Port * port() const noexcept             { return _port; }

    NodePtr node() const noexcept;

    bool isLocal() const noexcept  { return _location == Location::Local; }

    bool isRemote() const noexcept { return _location == Location::Remote; }

    std::string toString(bool forceUriFormat = false) const;
 
private:
    Location _location = Location::Local;
    Port * _port = nullptr;
    Descriptor _desc;
};
} // !namespace dfx::Core
 
DFX_DECLARE_ENUM_STRING_FUNCTIONS(dfx::Core::Endpoint::Location);