feat: add support for objects in arrays in the payload filter

[jaredhobbs]

This adds an additional key attribute to the must_include and must_exclude options processors.

Use case for this was for the payload filter. I needed to filter on particular labels. The labels array returns objects so I added a key attribute to be able to filter on a field in the object.

[shine2lay]

@jaredhobbs could you please add documentation and an entry to changelog, thanks.

[codecov]

Codecov Report

Merging #589 (7e04a81) into master (bb5034a) will decrease coverage by 0.02%.
The diff coverage is 87.50%.

❗ Current head 7e04a81 differs from pull request most recent head 2f42457. Consider uploading reports for the commit 2f42457 to get more accurate results

@@            Coverage Diff             @@
##           master     #589      +/-   ##
==========================================
- Coverage   92.79%   92.76%   -0.03%     
==========================================
  Files         104      104              
  Lines        2358     2378      +20     
  Branches      419      425       +6     
==========================================
+ Hits         2188     2206      +18     
- Misses        152      153       +1     
- Partials       18       19       +1     

Impacted Files	Coverage Δ
...lidators/options_processor/options/must_exclude.js	86.84% <78.57%> (-5.47%)	⬇️
...lidators/options_processor/options/must_include.js	94.11% <100.00%> (+1.80%)	⬆️
lib/filters/options_processor/options.js	95.00% <0.00%> (+5.00%)	⬆️

---

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 bb5034a...2f42457. Read the comment docs.

[shine2lay]

Just have one question about whether to return false or throw error, would love to get your opinion on it. The rest looks good.

[shine2lay]

LGTM

[github-actions]

🎉 This PR is included in version 2.5.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀