API Reference livery v#0.2.0

View Source

Modules

Public Livery facade.

Access-log middleware.

Internal behaviour implemented by livery_h1, livery_h2, livery_h3, and livery_test_adapter.

Alt-Svc advertising middleware.

OTP application callback for Livery. Starts livery_sup at boot.

JWT verification against a JWK set.

Bearer-token authentication middleware.

OAuth 2.0 token introspection middleware (RFC 7662).

JWKS fetching, parsing, and caching with key rotation.

OIDC provider discovery.

Signed session-cookie middleware.

Streaming request-body reader.

Body-size cap middleware.

A composable HTTP client: the outbound twin of the server middleware.

Behaviour for an outbound HTTP transport, the client-side dual of livery_adapter.

Client layer: spread requests across a pool of endpoints.

Owns the ETS table backing the client load balancers.

Client layer: a circuit breaker.

Owns the ETS table backing the client circuit breakers.

Client layer: cap in-flight requests.

Behaviour for resolving a balance pool's endpoints.

The default discovery provider: a fixed list of endpoints.

Default client adapter: hackney.

Client layer: retry failed requests with exponential backoff.

Client layer: bound a request to a deadline.

Content-coding codec behaviour and registry.

Built-in deflate content-coding over OTP zlib.

Built-in gzip content-coding over OTP zlib.

Shared OTP zlib streaming backend for the gzip and deflate codecs.

Response-compression middleware.

Concurrency-limit / load-shedding middleware (admission control).

CORS middleware.

Internal helper for delivering a client-disconnect signal.

Graceful shutdown.

ETag / conditional-GET middleware.

Request extractors.

HTTP/1.1 adapter on top of the h1 library.

HTTP/2 adapter on top of the h2 library.

HTTP/3 adapter on top of the quic library's quic_h3 subsystem.

Health and readiness handlers.

HTTP server metrics middleware powered by the instrument library.

Tracing middleware powered by the instrument library.

MCP Streamable HTTP handler.

Prometheus /metrics handler.

Tower-style middleware pipeline.

Streaming multipart/form-data parser (RFC 7578).

OpenAPI 3.1 document generation from route metadata.

Request validation against a JSON-Schema subset, plus a middleware that rejects malformed request bodies with 422.

Per-key rate-limiting / throttling middleware (token bucket).

Owner and store for livery_ratelimit token buckets.

Request accessors and builders.

Per-request worker.

Per-request worker registry and concurrency cap.

Request-ID middleware.

Response constructors and accessors.

Radix-style path-segment router.

Security-headers middleware.

Service runtime.

Static-directory file handler.

Top-level Livery supervisor.

In-memory adapter used by tests and the parity suite.

Per-request deadline middleware.

WebSocket integration on top of the ws library.

ws_transport implementation over an HTTP/2 stream.

ws_transport implementation over an HTTP/3 (QUIC) stream.

WebTransport integration on top of the webtransport library.