Return the whole response object from the methods

[JGAntunes]

The current js-client API implementation is restrictive in the sense that it only exposes the response body and an error if that's the case. Coming from discussions in #285 #39 #156 I feel like it would make sense and there's enough room to add some sort of support for our methods to return the whole response object.

I realise this could easily be a breaking change, but maybe we could come up with a strategy where that wouldn't be the case?

[erezrokah]

I agreed we should return a more descriptive object.

We could support pagination in a non breaking way by letting users pass another argument like retreiveAll or something similar, but that feels like a hack.