feat: Add support for $geoIntersects, $near and $nearSphere queries

[matt-d-rat]

This PR adds support for the following Geospatial Query operators:

• $geoIntersects
• $near
• $nearSphere

In the case of $near and $nearSphere support has also been added for specifying the optional $minDistance and $maxDistance limits to the query.

In addition, I have made some minor updates to the validation of $geometry that is used by all of the geo-operators to ensure that we check the type and coordinates values are correct. I have also added additional grammar for legacy coordinates, validating that the numbers provided in the array syntax are valid longitude and latitude numbers.

As such the following queries no longer throw a parser error (verified through unit tests and the online PEG.js parser):

$geoIntersects

{
  "address.location": {
    "$geoIntersects": {
      "$geometry": {
        "type": "Polygon" ,
        "coordinates": [
          [
            [ 0, 0 ],
            [ 3, 6 ],
            [ 6, 1 ],
            [ 0, 0 ]
          ]
        ]
      }
    }
  }
}

$near

{
  "address.location": {
    "$near" : {
      "$geometry": {
        "type": "Point",
        "coordinates": [0,0]
      }
    }
  }
}

{
  "address.location": {
    "$near" : [1, 90]
  }
}

{
  "address.location": {
    "$near" : {
      "$geometry": {
        "type": "Point",
        "coordinates": [0,0]
      },
      "$minDistance": 1000,
      "$maxDistance": 5000
    }
  }
}

{
  "address.location": {
    "$near" : [1, 90],
    "$maxDistance": 5000,
    "$minDistance": 1000
  }
}

$nearSphere

{
  "address.location": {
    "$nearSphere" : {
      "$geometry": {
        "type": "Point",
        "coordinates": [0,0]
      }
    }
  }
}

{
  "address.location": {
    "$nearSphere" : [1, 90]
  }
}

{
  "address.location": {
    "$nearSphere" : {
      "$geometry": {
        "type": "Point",
        "coordinates": [0,0]
      },
      "$minDistance": 1000,
      "$maxDistance": 5000
    }
  }
}

{
  "address.location": {
    "$nearSphere" : [1, 90],
    "$maxDistance": 5000,
    "$minDistance": 1000
  }
}

[matt-d-rat]

@durran Assuming you are happy with the changes, would you be okay with me publishing a minor package update to npm, and updating the mongodb-query-parser to use the new version? Given the timezone differences I can ask someone on the Charts team to approve the change to the downstream repo so I am not blocked waiting for async approvals.

[shaketbaby]

LGTM 👍

[durran]

Yes! Ship it. :)