#pragma once #include #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>>; // Reads one section of a libpq connection service file (M8.3): host, hostaddr, // port, dbname, user and sslrootcert (as ca_file). sslmode may only be verify-full // (or disable for a local socket), and connect_timeout is accepted and ignored (the // adapter has its own deadlines). Anything else (password, passfile, options, a // missing or repeated section, a repeated key, a file over 4 KiB) is refused with // config. password_file stays empty: the caller supplies it. [[nodiscard]] std::expected read_pg_service(const std::string& file, std::string_view section); // 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); // True only for a connected, idle session outside an explicit transaction. // Read-only status inspection; no query, lock or transaction is started. [[nodiscard]] bool transaction_idle() const noexcept; [[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