updates to file structure
file with example usage
refactor validations, started refactoring error messages
move to karma test runner
some clean up
refactor the shit out of this!