following @beloglazov comments - better and idiomatic usage of defn-
with better naming, thus getting a clearer cut between the public and
the private APIs of this namespace.