Source filters

Context

After seeing the customers using CARTO.js v4 in the wild, we’ve realized that they struggle when it comes to filtering sources. Right now, they have to add helper functions to translate their widgets filters to a source node. This doesn’t scalate.

We need to add another object to ease source nodes filtering:

• Filter by category, like in SELECT * FROM wadus WHERE hood IN ['brooklyn', 'queens].
• Filter by range, like in SELECT * FROM wadus WHERE price >= 34 AND price <= 100

Source nodes should be allowed to be filtered by several filters. The way to do it and what do we allow (ANDs, ORs) is to be discussed in the task of API definition.

Tasks

• Define the API: define the API first and ask the team for review. Respect the existing API style.
• Implement filtering to source nodes. Use wrapping* to enable filtering in complex SQL source nodes.
• Specs.
• Add documentation:
  • Reference docs in JSDoc.
  • New example.
  • Revamp / upgrade existing references to filtering. The most likely place to add help about this is in dataviews docs.
• Add example in examples section.

### Remarks

• Respect existing API:

[stevelewis99]

This looks totally awesome, everyone. VAMOS!

[rubenmoya]

Available in version 4.0.16 🚀