spudpack.h

#ifndef SPUDPLATE_SPUDPACK_H
#define SPUDPLATE_SPUDPACK_H
 
#include <cstddef>
#include <cstdint>
#include <filesystem>
#include <optional>
#include <stdexcept>
#include <string>
#include <string_view>
#include <vector>
 
namespace spudplate {
 
struct SpudpackAsset {
    std::string path;                
    std::uint16_t mode;              
    std::vector<std::uint8_t> data;  
};
 
struct SpudpackDep {
    std::string name;                
    std::vector<std::uint8_t> bytes; 
    std::uint32_t version_tag{1};    
};
 
struct Spudpack {
    std::string source;                       
    std::vector<std::uint8_t> program_bytes;  
    std::vector<SpudpackAsset> assets;        
    std::vector<SpudpackDep> deps;            
    std::uint8_t version{4};                  
    std::uint32_t version_tag{1};             
};
 
class SpudpackError : public std::runtime_error {
  public:
    SpudpackError(std::string message, std::optional<std::size_t> offset = std::nullopt);
    std::optional<std::size_t> offset() const noexcept { return offset_; }
 
  private:
    std::optional<std::size_t> offset_;
};
 
std::vector<std::uint8_t> spudpack_encode(const Spudpack& pack);
 
Spudpack spudpack_decode(const std::uint8_t* data, std::size_t size);
 
void spudpack_write_file(const std::filesystem::path& path, const Spudpack& pack);
 
Spudpack spudpack_read_file(const std::filesystem::path& path);
 
std::string normalize_asset_path(std::string_view raw);
 
bool is_normalized_asset_path(std::string_view path) noexcept;
 
bool is_valid_dep_name(std::string_view name) noexcept;
 
inline constexpr std::string_view kArchiveDir = ".archive";
 
std::filesystem::path archive_path_for(const std::filesystem::path& install_root,
                                       std::string_view name,
                                       std::uint32_t version_tag);
 
}  // namespace spudplate
 
#endif  // SPUDPLATE_SPUDPACK_H