endpoint.hpp

#pragma once

#include <string>
#include <vector>
#include <memory>

#ifndef ARBITER_IS_AMALGAMATION

#include <arbiter/util/http.hpp>

#endif

#ifdef ARBITER_CUSTOM_NAMESPACE
namespace ARBITER_CUSTOM_NAMESPACE
{
#endif

namespace arbiter
{

namespace drivers { class Http; }

class Driver;

class Endpoint
{
    // Only Arbiter may construct.
    friend class Arbiter;

public:
    std::string root() const;

    std::string prefixedRoot() const;

    // Driver passthroughs.

    std::string type() const;

    bool isRemote() const;

    bool isLocal() const;

    bool isHttpDerived() const;

    std::string get(std::string subpath) const;

    std::unique_ptr<std::string> tryGet(std::string subpath) const;

    std::vector<char> getBinary(std::string subpath) const;

    std::unique_ptr<std::vector<char>> tryGetBinary(std::string subpath) const;

    std::size_t getSize(std::string subpath) const;

    std::unique_ptr<std::size_t> tryGetSize(std::string subpath) const;

    void put(std::string subpath, const std::string& data) const;

    void put(std::string subpath, const std::vector<char>& data) const;

    // HTTP-specific passthroughs.

    std::string get(
            std::string subpath,
            http::Headers headers,
            http::Query = http::Query()) const;

    std::unique_ptr<std::string> tryGet(
            std::string subpath,
            http::Headers headers,
            http::Query = http::Query()) const;

    std::vector<char> getBinary(
            std::string path,
            http::Headers headers,
            http::Query query = http::Query()) const;

    std::unique_ptr<std::vector<char>> tryGetBinary(
            std::string path,
            http::Headers headers,
            http::Query query = http::Query()) const;

    void put(
            std::string path,
            const std::string& data,
            http::Headers headers,
            http::Query query = http::Query()) const;

    void put(
            std::string path,
            const std::vector<char>& data,
            http::Headers headers,
            http::Query query = http::Query()) const;

    // Endpoint specifics.

    std::string fullPath(const std::string& subpath) const;

    std::string prefixedFullPath(const std::string& subpath) const;

    Endpoint getSubEndpoint(std::string subpath) const;

private:
    Endpoint(const Driver& driver, std::string root);

    // If `isRemote()`, returns the type and delimiter, otherwise returns an
    // empty string.
    std::string softPrefix() const;

    const drivers::Http* tryGetHttpDriver() const;
    const drivers::Http& getHttpDriver() const;

    const Driver& m_driver;
    std::string m_root;
};

} // namespace arbiter

#ifdef ARBITER_CUSTOM_NAMESPACE
}
#endif