Skip to content

feat(transcode): complete google.api.http request/response mapping #23

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
polaz merged 3 commits into from
Jun 19, 2026
Merged

feat(transcode): complete google.api.http request/response mapping #23

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0f0fdae
feat(transcode): complete google.api.http request/response mapping
polaz Jun 19, 2026
2ce918c
test(transcode): add regression test for unsigned 32-bit query coercion
polaz Jun 19, 2026
a62da0f
fix(transcode): tighten query coercion and surface mapping errors
polaz Jun 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,9 @@ Works with **any** gRPC service via proto descriptor files. No code generation,

## Features

- **Dynamic REST routes** from proto descriptors using `google.api.http` annotations (path params + JSON body)
- **Dynamic REST routes** from proto descriptors using `google.api.http` annotations
- **Full request mapping**: path params, query parameters (typed + repeated + nested), and `body` (`*` / named field / none)
- **`response_body`** to return a single response subfield, and **`additional_bindings`** for multiple routes per RPC
- **Auto-generated OpenAPI** documentation from proto messages, served at `/openapi.json`
- **Server-streaming** RPC → chunked HTTP responses
- **gRPC → HTTP status mapping** following the standard `google.rpc.Code` table
Expand All @@ -32,7 +34,6 @@ These have config scaffolding in place but are not yet enforced by the proxy. Tr
- **JWT auth**: validation with JWKS auto-discovery + route-level policies
- **OIDC discovery**: `/.well-known/openid-configuration` + JWKS endpoint for IdP proxies
- **Forward-auth / external AuthZ / BFF sessions**
- **Transcoding completeness**: query-parameter binding, `response_body`, `additional_bindings`
- **Context propagation**: W3C trace-context and deadline (`grpc-timeout`) across the REST↔gRPC boundary

## Quick Start
Expand Down Expand Up @@ -159,7 +160,7 @@ async fn main() -> anyhow::Result<()> {

1. Load the proto descriptor from a pre-compiled descriptor file
2. Parse `google.api.http` annotations → generate REST routes
3. Incoming HTTP request → transcode to gRPC (path params + JSON body → protobuf)
3. Incoming HTTP request → transcode to gRPC (path params + query params + JSON body → protobuf)
4. Forward to the upstream gRPC service
5. Response protobuf → transcode to JSON
6. Serve the OpenAPI spec at `/openapi.json`
Expand Down
Loading