RobinTail / express-zod-api / 17559392574

100%

push

github

Feat: Configurable query parser (#2922)

Related to #2894 
Also #1388 and #1266 

Making it easier to send arrays via query string.

I missed this change of Express 5:

<img width="969" height="211" alt="Screenshot 2025-09-08 at 10 32 19"
src="https://github.com/user-attachments/assets/20f8def9-44ce-41a0-abeb-cb3bd5135d70"
/>

They changed "extended" to "simple", so square brackets no longer works
by default.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- New Features
- Configurable query parser for Express 5: "simple" (default),
"extended", or a custom function; supports nested arrays/objects and
custom formats (e.g., comma-separated arrays).

- Documentation
- Added "Query string parser" section with usage examples; updated
Transformations example and reordered Basic features.

- Examples
- User list endpoint accepts optional roles filter and now returns each
user's role; client and API docs updated.

- Tests
- Added tests for parser configs and multiple array query formats; some
assertions switched to snapshots.

- Chores
  - Added qs as an example devDependency.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

1220 of 1262 branches covered (96.67%)

4 of 4 new or added lines in 1 file covered. (100.0%)

3945 of 3945 relevant lines covered (100.0%)

275.26 hits per line