Request identity
Method, canonical URL, selected headers, body, and authScope form the fingerprint used to decide whether work is equivalent.
Architecture
Core concepts
A mental model for predictable networking under concurrency and failure.
Shared ownership
Callers await one underlying task but retain independent cancellation ownership. The network operation ends when no interested caller remains.
Freshness vs overlap
Coalescing shares work that overlaps in time. Caching can serve a later caller according to an explicit freshness policy.
Bounded resilience
Retry, auth refresh, batch concurrency, reconnect, and replay all need finite limits that match the product’s failure contract.
Typed boundaries
APIRequest describes wire intent. Endpoint adds a reusable typed response contract. NetworkClient owns execution policies.
Operational visibility
Lifecycle events and telemetry hooks expose coalescing, retries, queues, batches, and realtime transitions without changing feature code.
Ready to ship?