C_clientList.hpp

/*
 * Copyright 2026 Guillaume Guillet
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef _FGE_C_CLIENTLIST_HPP_INCLUDED
#define _FGE_C_CLIENTLIST_HPP_INCLUDED
 
#include "FastEngine/fge_extern.hpp"
#include "C_client.hpp"
#include "C_protocol.hpp"
#include "FastEngine/C_accessLock.hpp"
#include <deque>
#include <memory>
#include <mutex>
#include <unordered_map>
 
namespace fge::net
{
 
class SocketUdp;
 
using ClientSharedPtr = std::shared_ptr<Client>;

class FGE_API ClientList
{
public:
    struct Event
    {
        enum class Types : uint8_t
        {
            EVT_DELCLIENT = 0,
            EVT_NEWCLIENT
        };
        using Types_t = std::underlying_type_t<Types>;
 
        inline Event(Types eventType, Identity const& clientId) :
                _event(eventType),
                _id(clientId)
        {}
 
        Types _event;
        Identity _id;
    };
 
    using DataList = std::unordered_map<Identity, ClientSharedPtr, IdentityHash>;
    using EventList = std::deque<Event>;
 
    ClientList() = default;
    ClientList(ClientList const& r);
    ClientList(ClientList&& r) noexcept;
    ~ClientList() = default;
 
    ClientList& operator=(ClientList const& r);
    ClientList& operator=(ClientList&& r) noexcept;

    void clear();

    void sendToAll(SocketUdp& socket, Packet& pck) const;
    void sendToAll(TransmitPacketPtr const& pck) const;
 
    bool moveTo(ClientList& targetList, Identity const& id);
    void add(Identity const& id, ClientSharedPtr const& newClient);
    void remove(Identity const& id);
    DataList::iterator remove(DataList::const_iterator itPos, AccessLock<std::recursive_mutex> const& lock);

    ClientSharedPtr get(Identity const& id) const;

    AccessLock<std::recursive_mutex> acquireLock() const;

    DataList::iterator begin(AccessLock<std::recursive_mutex> const& lock);
    DataList::const_iterator begin(AccessLock<std::recursive_mutex> const& lock) const;
    DataList::iterator end(AccessLock<std::recursive_mutex> const& lock);
    DataList::const_iterator end(AccessLock<std::recursive_mutex> const& lock) const;

    std::size_t getSize() const;

    void watchEvent(bool on);
    bool isWatchingEvent() const;

    void pushClientEvent(Event const& evt);
    Event const& getClientEvent(std::size_t index) const;
    std::size_t getClientEventSize() const;
    void clearClientEvent();
 
private:
    DataList g_data;
    EventList g_events;
    mutable std::recursive_mutex g_mutex;
    bool g_enableClientEventsFlag = false;
};
 
} // namespace fge::net
 
 
#endif // _FGE_C_CLIENTLIST_HPP_INCLUDED