RobinTail / express-zod-api / 31025711493

100%

push

github

fix: key request body components by depicted body schema (#3603)

Fixes #3601.

## Summary

With `composition: "components"`, two endpoints built from the **same**
input schema instance shared a single request body component. Because
path parameters are excluded from the request body per route, the
depicted bodies differed, yet the component cache was keyed on the raw
schema instance — so the first route won and both operations `$ref`d a
component describing only one of the bodies.

`depictBody` now keys the cache on `JSON.stringify(pure)` (the
post-exclusion body schema), mirroring the existing precedent for
parameter components (`depictParams`). Each route therefore references a
component describing its own body, while identical bodies across routes
still dedup to one component.

## Changes

- `express-zod-api/src/documentation-helpers.ts` — key body components
on the serialized body instead of the schema instance; drop the
now-unused `schema` parameter.
- `express-zod-api/src/documentation.ts` — stop passing `schema:
inputSchema` to `depictBody`.
- `express-zod-api/tests/documentation.spec.ts` — new `Issue #3601`
block covering: two routes sharing one schema instance get distinct
correct bodies; identical bodies still dedup; the alias-route variant
(one endpoint mounted at two paths).
- `express-zod-api/tests/documentation-helpers.spec.ts` — drop the
now-unused `schema: ez.raw()` args (and `ez` import).
- `CHANGELOG.md` — bug-fix entry under `v29.1.2`.

No public API change, so no migration rule needed.

<!-- PULLFROG_DIVIDER_DO_NOT_REMOVE_PLZ -->
<sup><a href="https://pullfrog.com"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://pullfrog.com/logos/frog-white-full-18px.png"><img
src="https://pullfrog.com/logos/frog-green-full-18px.png" width="9px"
height="9px" style="vertical-align: middle; "
alt="Pullfrog"></picture></a>&nbsp;&nbsp;｜ [View workflow
run](https://github.com/RobinTail/express-zod-api/actions/runs/31019755900/job... (continued)

1056 of 1107 branches covered (95.39%)

1514 of 1514 relevant lines covered (100.0%)

577.52 hits per line