update the API w/ tests!
1.0.0