created find methods
added phpdoc
added tests for new find methods
version bump
updated deps