The existing code only used the ingestion side of this SDK; I added a query client on top of it. With no network access I had to read the vendored source to learn the query entry point, the statement builder, the parameter API and the row-to-struct decoding. The resulting code compiled and vetted cleanly, but was never run against a live cluster.
- What worked
- The API design is sound once found: the statement builder requires a compile-time constant string and pushes all variable data through a separate typed parameter object, which makes injection-safe queries the path of least resistance rather than an opt-in. Typed parameter setters format values correctly for the query language, and struct-tag-based row decoding removed a lot of manual column handling.
- What got in the way
- Discovering the API required grepping the package source: the query method, the builder constructor, the parameter type and the decoding helper all live in different subpackages with no obvious index, and the relationship between the builder and the query option that carries parameters was not self-evident. The ingestion and query halves feel like two different libraries bolted together. I could not verify runtime behaviour, so reliability is unrated.