BionxControl/nodes/util/ntxmaptor.h

#ifndef NTX_MAPTOR_H
#define NTX_MAPTOR_H

#include "ntxmapindex.h"

#include <vector>
#include <string>
#include <optional>
#include <stdexcept>
#include <memory>
#include <algorithm>
#include <utility>

namespace ntx
{

  /**
   * @brief Generischer Maptor (Vector + Map), adaptiert an das NtxIPayload-Interface.
   * 
   * Entfernt die STL-Container-Schnittstelle (push_back, begin, end, etc.) zugunsten
   * der expliziten Payload-Methodik (setProperty, getProperty, etc.).
   */
  template <typename T>
  class NtxMaptor
  {
  public:

    using NtxMapIndexPtr = std::shared_ptr<NtxMapIndex>;
    
    // Zugriff auf Iteratoren für Range-Based Loops (via valuesBegin/End)
    using iterator = typename std::vector<T>::iterator;
    using const_iterator = typename std::vector<T>::const_iterator;

    // --- Konstruktoren ---

    NtxMaptor()
      : m_index(std::make_shared<NtxMapIndex>())
    {
    }

    explicit NtxMaptor(const NtxMapIndexPtr& index)
    {
      if (!index)
        throw std::invalid_argument("NtxMaptor: index must not be null");
      m_index = index;
    }

    NtxMaptor(const NtxMaptor&) = default;
    NtxMaptor& operator=(const NtxMaptor&) = default;
    NtxMaptor(NtxMaptor&&) noexcept = default;
    NtxMaptor& operator=(NtxMaptor&&) noexcept = default;

    virtual ~NtxMaptor() = default;

    // =========================================================================
    // NtxIPayload Interface-Adaption
    // =========================================================================

    // --- Kapazität ---

    [[nodiscard]] size_t getPropertyCount() const noexcept
    {
      return m_data.size();
    }

    void clearProperties()
    {
      m_data.clear();
      m_index->clear();
    }

    // --- Key-basierter Zugriff ---

    bool hasProperty(const std::string& key) const
    {
      return m_index->containsKey(key);
    }

    /**
     * @brief Setzt oder fügt einen Wert hinzu (Upsert).
     * Wenn der Key existiert, wird der Wert überschrieben.
     * Wenn nicht, wird er angehängt.
     */
    void setProperty(const std::string& key, const T& value)
    {
      auto idx = m_index->indexOf(key);
      if (idx)
      {
        m_data[*idx] = value;
      }
      else
      {
        m_index->addKey(key, m_data.size());
        m_data.push_back(value);
      }
    }

    // "Deducing this" für const/non-const getProperty(key)
    template <typename Self>
    auto&& getProperty(this Self&& self, const std::string& key)
    {
      auto idx = self.m_index->indexOf(key);
      if (!idx)
        throw std::out_of_range("NtxMaptor: Key not found: " + key);
      return std::forward<Self>(self).m_data[*idx];
    }

    void removeProperty(const std::string& key)
    {
      auto idx = m_index->indexOf(key);
      if (!idx)
        return;

      size_t index = *idx;
      // Index entfernen und nachfolgende Indizes im Index-Objekt korrigieren
      m_index->removeAt(index);
      // Daten aus Vektor entfernen
      m_data.erase(m_data.begin() + static_cast<std::ptrdiff_t>(index));
    }

    // --- Index-basierter Zugriff ---

    bool hasProperty(size_t index) const
    {
      return index < m_data.size();
    }

    void setProperty(size_t index, const T& value)
    {
      if (index >= m_data.size())
      {
        throw std::out_of_range("NtxMaptor: Index out of range");
      }
      m_data[index] = value;
    }

    // "Deducing this" für const/non-const getProperty(index)
    template <typename Self>
    auto&& getProperty(this Self&& self, size_t index)
    {
      return std::forward<Self>(self).m_data.at(index);
    }

    // --- Iteratoren (NtxIPayload Style) ---

    // Erlaubt das Iterieren über die internen Werte
    template <typename Self>
    auto begin(this Self&& self) { return std::forward<Self>(self).m_data.begin(); }

    template <typename Self>
    auto end(this Self&& self) { return std::forward<Self>(self).m_data.end(); }

    
    // =========================================================================
    // Erweiterte Index-Funktionen (Alias, Replace)
    // Diese bleiben erhalten, da sie spezifische NtxMapIndex Features sind
    // =========================================================================

    bool replaceKey(const std::string& oldKey, const std::string& newKey)
    {
      return m_index->replaceKey(oldKey, newKey);
    }

    bool addAlias(const std::string& key, const std::string& alias)
    {
      return m_index->addAlias(key, alias);
    }
  
  private:

    std::vector<T> m_data;
    NtxMapIndexPtr m_index;
  };

} // namespace ntx

#endif // NTX_MAPTOR_H