refactor: the client API to use interface and generic methods

[meling]

The redesign of the API to use functions for the client-side interface works, but is more awkward than before; we should prototype a new API based on interfaces and generic methods to understand how it feels when we get access to generic methods.