valkyrjaio / valkyrja-java / 30187598453

100%

push

github

[Grpc] Add gRPC as a first-class protocol alongside HTTP and CLI (#37)

# Description

Adds **gRPC as a first-class protocol** in the Valkyrja Java framework,
alongside HTTP and CLI, implementing the language-agnostic contract in
the `architecture/GRPC.md` design doc.

The design mirrors the existing HTTP/CLI ports: a worker-agnostic core
(`io.valkyrja.grpc.*`) of immutable value types, a **map-lookup
`Router`**, a seven-stage **middleware pipeline**, and a
**`ServiceHandler`** kernel entry point — everything resolved through
the container and wired by provider pairs. Messages stay agnostic
(`Iterable<Object>`); protobuf translation happens only at the
worker-adapter boundary, so the core stays portable across the
PHP/TS/Go/Python ports.

Cancellation follows the doc's cooperative, **pull-based** model: the
two-question check (`Cancellation.checkAndFinalize`) runs at every
orchestrator boundary and fast-exits by returning a cancellation
response; streaming output is checked at each step via
`call.cancellable(...)`, never a push write channel.

The grpc-java worker adapters live in the sibling entry repos (linked
below).

## Types of changes

- [ ] Improvement _(non-breaking change which improves code)_
- [ ] Bug fix _(non-breaking change which fixes an issue)_
- [x] New feature _(non-breaking change which adds functionality)_
- [ ] Deprecation _(breaking change which removes functionality)_
- [ ] Breaking change _(fix or feature that would cause existing
functionality to change)_
- [ ] Documentation improvement

## Changes

- **`io.valkyrja.grpc.message.*`** — immutable value types:
`ServiceCall`, `ServiceResponse`, `Status`/`StatusCode` (canonical gRPC
0–16), `Metadata` (case-insensitive, `-bin` binary union), `Deadline`,
`CancellationToken`, `Peer`/`AuthContext`.
- **`io.valkyrja.grpc.routing.*`** — `Route`, `RouteCollection` (direct
map lookup), `Router` (map lookup + two-question cancellation checks),
and `@GrpcService`/`@GrpcMethod`/`@GrpcMiddlew... (continued)

1838 of 1840 branches covered (99.89%)

Branch coverage included in aggregate %.

1048 of 1048 new or added lines in 69 files covered. (100.0%)

6747 of 6747 relevant lines covered (100.0%)

4.34 hits per line