dangernoodle-io / breadboard / 24966884875

100%

push

github

feat(bb_http): route descriptor types + registry for openapi spec emission (#95)

* feat(bb_http): route descriptor types + registry for openapi spec emission

Adds bb_route_t descriptor carrying OpenAPI metadata (path, method, tag,
summary, request/response schemas as JSON Schema fragments) and a
process-wide registry populated by bb_http_register_described_route. The
existing imperative bb_http_register_route is unchanged; the new function
is additive and consumers migrate one route at a time.

Lays the groundwork for the upcoming bb_openapi component (runtime
/api/openapi.json emitter + build-time codegen tool).

- bb_http.h: bb_route_response_t, bb_route_t,
  bb_http_register_described_route, bb_http_route_registry_foreach,
  _clear, _count.
- route_registry.c: small static array (cap 64), no allocation.
- platform/host/bb_http/bb_http_host.c: host stubs for server functions
  so native tests compile without esp-idf.
- host test for registry add/clear/count.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test(bb_http): cover route registry edge paths

Adds coverage for the three remaining branches in
bb_http_register_described_route: null-route rejection, propagation of
underlying register_route failure (descriptor not added), and overflow
handling at registry cap. Restores the patch to 100% coverage.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* test(bb_http): cover null-path overflow log branch

the ternary `route->path ? route->path : "(null)"` in the overflow
log path had its false side uncovered. adds a test that fills the
registry then attempts to register a descriptor with a null path,
exercising the guard. restores 100% branch coverage.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

95 of 95 branches covered (100.0%)

Branch coverage included in aggregate %.

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

134 of 134 relevant lines covered (100.0%)

267.46 hits per line