ResourceRuntime.hpp

Go to the documentation of this file.

#pragma once
 
#include "LanguageResources.hpp"
#include "LayeredDataSource.hpp"
#include "ResourcePaths.hpp"
 
#include <memory>
#include <mutex>
#include <vector>
 
namespace monopoly::data
{
    struct ResourceContext
    {
        BoardEdition board{ BoardEdition::Usa };
        LanguageId language{ LanguageId::EnglishUs };
    };
 
    // Check every required bank before startup, then validate LANG through the
    // real runtime. This checks installation structure, not gameplay fidelity.
    // No live resource snapshot is replaced by this inspection.
    [[nodiscard]] std::vector<DataError> inspectResourceInstallation(
        const ResourcePaths& paths,
        ResourceContext context = {},
        ArchiveOpenOptions options = {});
 
 
    // Le registre et LANG partagent les memes archives. Les consommateurs
    // conservent ce snapshot pour garder les banques utilisables, meme apres
    // un remplacement ou l'arret du service. Aucun clear/unmount premature.
    class ResourceSnapshot final
    {
    public:
        // Format-agnostic DATA access for gameplay/runtime consumers.
        [[nodiscard]] const DataSource& data() const noexcept;
 
        // Legacy archive registry stays exposed only for archive-specific
        // lifecycle/language compatibility while native backends are introduced.
        [[nodiscard]] const DataBankRegistry& banks() const noexcept;
        [[nodiscard]] std::shared_ptr<const LanguageSnapshot>
        language() const noexcept;
        [[nodiscard]] ResourceContext context() const noexcept;
        [[nodiscard]] const ResourcePaths& paths() const noexcept;
 
    private:
        friend class ResourceRuntime;
        ResourceSnapshot(ResourcePaths paths, ResourceContext context);
 
        ResourcePaths paths_;
        ResourceContext context_;
        std::shared_ptr<DataBankRegistry> banks_;
        std::shared_ptr<const DataSource> data_;
        LanguageService language_;
    };
 
 
    class ResourceRuntime final
    {
    public:
        // MainExtendedInitialization : cinq banques core, puis LANG 9/5/10.
        // Tout echec conserve exactement le snapshot actif precedent.
        [[nodiscard]] std::expected<void, DataError> initialize(
            ResourcePaths paths,
            ResourceContext context = {},
            ArchiveOpenOptions options = {},
            std::span<const DataSourceOverride> overrides = {});
 
        [[nodiscard]] std::shared_ptr<const ResourceSnapshot>
        snapshot() const noexcept;
        void shutdown() noexcept;
 
    private:
        mutable std::mutex mutex_;
        std::shared_ptr<const ResourceSnapshot> active_;
    };
}