Changes API to use object literal and avoid magic primitives.
Adds proper returns to methods
Updates changelog
v1.0.0