return a clean version of the validated object, support for required properties
updated test file
updated readme