#pragma once #include #include #include #include #include #include #include #include #include namespace evo::persistence { enum class PgError : std::uint8_t { config, connect, version, sql, unknown, bounds, closed }; struct PgFailure { PgError kind{}; std::array sqlstate{}; // Sanitized SQLSTATE only, never server text. }; struct PgOptions { std::string host, hostaddr, port, database, user, password_file, ca_file; }; using PgRows = std::vector>>; // Linux I/O-owner adapter. Query text is trusted application SQL, values are parameters. // No automatic retry. unknown means the command may have executed; connection is closed. class Postgres { public: ~Postgres(); Postgres(const Postgres&) = delete; Postgres& operator=(const Postgres&) = delete; [[nodiscard]] static std::expected, PgFailure> connect(const PgOptions& options, std::chrono::milliseconds timeout); [[nodiscard]] std::expected query(const std::string& sql, std::span parameters, std::chrono::milliseconds timeout); private: struct Impl; explicit Postgres(std::unique_ptr impl); std::unique_ptr impl_; }; } // namespace evo::persistence