MimeType.hpp

// SPDX-FileCopyrightText: 2025 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 <vector>
 
// Project includes
#include <dfx-utilities/EnumString.hpp>
 
namespace dfx::Core
{
class MimeType
{
public:
    enum StandardMimeType
    {
        // Structured data
        Json,           
        Yaml,           
        Toml,           
        Xml,            
 
        // Binary
        OctetStream,    
 
        // Text
        PlainText,      
        Markdown,       
        Csv,            
 
        // dfx related
        DfxControl,     
 
        // Wildcard
        Any,            
    };
 
public:
    MimeType();

    MimeType(std::string mimeType);

    MimeType(StandardMimeType mimeType);

    std::optional<StandardMimeType> standardType() const noexcept;

    std::string const & toString() const noexcept { return _mimeType; }

    bool isAny() const noexcept                   { return _mimeType.empty(); }
 
public:
    static void validateMimeTypeName(std::string_view name);
 
public:
    bool operator==(MimeType const & rhs) const noexcept = default;
    auto operator<=>(MimeType const & rhs) const noexcept = default;
 
private:
    std::string _mimeType;
};

using MimeTypes = std::vector<MimeType>;
} // !namespace dfx::Core
 
DECLARE_ENUM_STRING_FUNCTIONS(dfx::Core::MimeType::StandardMimeType);
 
template<>
struct std::formatter<dfx::Core::MimeType> : public formatter<std::string_view>
{
    inline auto format(dfx::Core::MimeType const & m, format_context & ctx) const
    { return formatter<std::string_view>::format(m.toString(), ctx); }
};