tonin-client 0.14.0

Client-side primitives shared between generated tonin service clients: AuthCtx, retry/circuit-breaker config, OTel propagation. Tiny dep tree — peer services depend on this without pulling in the server framework.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! Tiny peer-service client primitives. No server-framework deps.
//!
//! # When to use
//!
//! Service B calls Service A — pull this in, **not** [`tonin-core`],
//! which drags the tonic server stack, OTLP telemetry SDK, MCP sidecar
//! runtime, JWT validation and JWKS fetching along with it. This crate
//! holds only the contract pieces a caller actually needs: auth context,
//! retry/breaker config, OTel propagation, and request coalescing.
//!
//! # Example — coalesced auth check
//!
//! ```rust,no_run
//! use tonin_client::client::CoalescingClient;
//! use tonin_client::cache::CacheConfig;
//! use std::time::Duration;
//!
//! // Wrap the tonic-generated AuthServiceClient.
//! // Coalescing is on by default; add a 500 ms TTL cache for Check.
//! // let inner = AuthServiceClient::connect("http://auth:50051").await?;
//! // let client = CoalescingClient::builder(inner)
//! //     .cache("Check", CacheConfig::new(Duration::from_millis(500), 1_000))
//! //     .build();
//! ```
//!
//! # Example — trace propagation
//!
//! ```rust,no_run
//! use tonin_client::{AuthCtx, propagate};
//! use tonic::Request;
//!
//! fn forward(inbound: &Request<()>) -> Request<()> {
//!     let caller = AuthCtx::from(inbound);
//!     let mut outbound = Request::new(());
//!     caller.propagate(&mut outbound);
//!     propagate::inject_traceparent(
//!         &mut outbound,
//!         "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01",
//!     );
//!     outbound
//! }
//! ```
//!
//! # Modules
//!
//! - [`auth`] — `AuthCtx`, `RawToken`, `PrincipalKind`, `AuthError`.
//! - [`retry`] — `RetryPolicy`, `Backoff`, `RetryableCodes`.
//! - [`breaker`] — `CircuitBreaker` config with three-state presets.
//! - [`propagate`] — W3C `traceparent` / `tracestate` injection.
//! - [`coalesce`] — `Singleflight<R>`, `KeyFn`, `DefaultKeyFn`.
//! - [`cache`] — `ResponseCache<R>`, `CacheConfig`.
//! - [`client`] — `CoalescingClient<C>`, `CoalescingClientBuilder`.
//!
//! # Sibling crates
//!
//! - <https://docs.rs/tonin> — umbrella crate for service authors.
//! - <https://docs.rs/tonin-core> — server runtime (use on the
//!   service being called, not on the caller).
//!
//! [`tonin-core`]: https://docs.rs/tonin-core

pub mod auth;
pub mod breaker;
pub mod cache;
pub mod client;
pub mod coalesce;
pub mod platform_client;
pub mod propagate;
pub mod retry;

pub use auth::{AuthCtx, AuthError, PrincipalKind, RawToken};
pub use client::CoalescingClient;
pub use platform_client::{PlatformClient, PlatformClientConfig};