A tiny, type-safe client classifier with User-Agent, Client Hints, and HTTP header support.
client-parser is a software package created to make a real workflow clearer, faster, and easier to trust. It turns a focused product idea into something people can use, evaluate, and understand without needing to inspect the source code.
Why client-parser exists
Analytics and diagnostics need a normalized view of client strings and hints, while many parsers are heavy or encourage unsafe use of inherently heuristic data.
The goal is not simply to add another tool. client-parser is designed to reduce the friction around that problem and give people a more dependable way to complete the work.
What it delivers
- Consumers can classify common client strings.
- Enrich results with available hints.
- Distinguish bots/devices/browsers for analytics or presentation.
- Inspect parsing behavior interactively.
The experience
A tiny, type-safe client classifier with User-Agent, Client Hints, and HTTP header support.
The project brings the important parts of the workflow into one coherent experience. Its interface and behavior are shaped around the people using it, while the implementation stays focused on predictable results and honest feedback.
What to know
Every product has boundaries. These are the most important considerations for client-parser:
- User-Agent classification is heuristic and spoofable.
- Client Hints availability varies and may be privacy-restricted.
- Results cannot safely drive authentication, authorization, or capability decisions.
These limitations are presented openly so visitors can understand where the project works well, what it depends on, and what may change in future versions.
Current status
Pre-1.0 package. The current release demonstrates the core value of the project and the main end-to-end experience.
My role was library design and package engineering, covering typed apis, compatibility, and package distribution. The related case study explains the decisions and delivery process in greater depth for visitors who want the engineering story behind the product.