Use annotations to define the public api.

[l-1squared]

Annotate the methods intended for users with @PublicApi and ideally reduce the visibility of all other methods