Regarding findBy, this code has been corrected to a query in a collection class 
https://github.com/TomHAnderson/soliantconsulting-apigility/blob/master/src/SoliantConsulting/Apigility/Server/Resource/AbstractResource.php#L258

inherited from a new abstract in a paginator in a HAL collection.  All this allows for pagination links.

https://github.com/TomHAnderson/soliantconsulting-apigility/blob/master/src/SoliantConsulting/Apigility/Server/Collection/AbstractCollection.php