added tests, based on what used to be comments.
next iteration of api. more express-like