Net Client (Request-State API Client)

A framework-agnostic, fetch-based API client that gives you per-request loading, data, and error state — without React Query, Axios, or magic.

Built out of real pain.

---

Why this exists

Handling API calls is one of the most repetitive and messy parts of building apps.

Most codebases end up with:

• global loading flags that break with concurrent requests
• Axios responses typed as any
• callbacks everywhere
• hooks doing transport + state + UI
• logic that works in React but not on the server

HTTP clients return Promises.
Apps need request state.

This library separates the two.

---

Core idea

Instead of this:

await fetch(...)

You get this:

request.run()
request.loading
request.data
request.error

Each API call becomes a stateful request controller.

---

What this library is (and isn’t)

It is

• fetch-based
• Bun / Node / Browser compatible
• framework-agnostic
• per-request state (loading / data / error)
• usable in React and server scripts
• explicit and predictable

It is not

• a React-only library
• a caching framework
• a replacement for React Query
• Axios with a different name
• opinionated about UI or toasts

---

Architecture

HttpClient        → HTTP transport (fetch, headers, errors)
createRequest     → per-request state controller
Your app          → UI / hooks / logs