Choose GET route by default in case of double route

[Yoann-Abbes]

What does this PR do?

This PR changes the way we get the correct route if there is several of them.

Before this PR:
The SDK checked the size of the url, and chose the shortest.
If they had the same size, it chose the POST route.
And you could not force the verb in your request.

Now:
Same thing, except it chooses the GET route.
Plus, you can force the verb with the option {verb: 'POST'}

How should this be manually tested?

Install this version of the sdk npm install git://github.com/kuzzleio/sdk-javascript#handle-double-routes
Run Kuzzle in debug mod.
Run this script

const { Kuzzle, Http } = require('kuzzle-sdk');

const kuzzle = new Kuzzle(
  new Http(`localhost`, { port: 7512})
);

async function main () {
const doc1 = { capacity: 4 };
const doc2 = { capacity: 7 };

    try {
	await kuzzle.connect();
	await kuzzle.document.createOrReplace('nyc-open-data', 'yellow-taxi', 'some-id', doc1);
	await kuzzle.document.createOrReplace('nyc-open-data', 'yellow-taxi', 'some-other-id', doc2);

  const response = await kuzzle.document.mGet(
    'nyc-open-data',
    'yellow-taxi',
      ['some-id', 'some-other-id']
//   ,{verb: 'POST'}
  );

  console.log(response);

} catch (error) {
  console.error(error.message);
}
}

main()

You will see in the logs that the route verb was GET

Now uncomment the line // ,{verb: 'POST'}
The route will be in POST.

You can do the same with mGetUsers

Other changes

Adapt doc snippet test for getAllStats and getLastStats, because of the new properties order of the response object recently defined

Boyscout

[Yoann-Abbes]

I've tested it by running Kuzzle with this branch kuzzleio/kuzzle#1519
It works and tests are ok

[codecov]

Codecov Report

Merging #465 into 7-dev will increase coverage by 0.01%.
The diff coverage is 100%.

@@            Coverage Diff             @@
##            7-dev     #465      +/-   ##
==========================================
+ Coverage   95.56%   95.57%   +0.01%     
==========================================
  Files          32       32              
  Lines        1307     1312       +5     
==========================================
+ Hits         1249     1254       +5     
  Misses         58       58

Impacted Files	Coverage Δ
src/protocols/http.js	90.78% <100%> (+0.31%)	⬆️
src/controllers/document.js	95.45% <100%> (ø)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 391c5c1...ada96e4. Read the comment docs.

[scottinet]

just a few documentation problems to fix and this PR will be gtg

[scottinet]

This shouldn't be part of the route description, but should instead be a dedicated sub-chapter for the verb option below.

Something such as:

#### verb

When instantiated with a HTTP protocol object, the SDK uses the GET API by default for this API route.
You can set the `verb` option to `POST` to force the SDK to use the POST API instead.

[Aschen]

I know it's not directly related to this PR but here the options object should not be mutated because the user may want to re-use it across subsequent calls

[Yoann-Abbes]

@Aschen despite our discussions, everything is OK