dangernoodle-io / breadboard / 25289699009

100%

push

github

feat: add streaming JSON array response API (bb_http_resp_json_arr_*) (#196)

New public API for handlers emitting JSON arrays without building the full
tree in memory. On ESP-IDF, items stream in true chunked chunks (only one
per-item subtree in memory). On Arduino/host, items buffer for compatibility.
Same external behavior; single API for all platforms.

- bb_http_resp_json_arr_begin: open array and Content-Type header
- bb_http_resp_json_arr_emit: append one item (caller retains ownership)
- bb_http_resp_json_arr_end: close array and finish response

Stream holds sticky-error semantics: first failed emit poisons the stream;
end() returns that error and always closes the response. Single-use (_open
guard prevents re-use after end).

Implementations:
- ESP-IDF: true streaming via chunked transfer-encoding
- Arduino: buffered array (single client.write rule)
- Host: buffered array (test backend)

Tests added: 12 host tests covering null-arg rejection, state guards,
sticky-error behavior, empty/single/multi-item streams.

CLAUDE.md note added: prefer streaming API over building large trees for
handlers emitting N small objects.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

336 of 336 branches covered (100.0%)

Branch coverage included in aggregate %.

557 of 557 relevant lines covered (100.0%)

509.81 hits per line