microlinkhq / microlink / 32695664546

77%

push

github

fix: report the real reason behind a failed request (#21)

* fix(mql): surface the real cause of network errors

An EFATALCLIENT raised by a transport failure reported ky's wrapper
message ("Request failed due to a network error: GET <url>"), hiding the
actual reason. Walk the cause chain down to the root error so the message
carries it (getaddrinfo ENOTFOUND, other side closed, bad port, ...) and
keep the original error reachable through `error.cause`.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018iuvRoqnZPNpEUDwLfAn8F

* fix(core): report the real reason behind a failed request

The API keeps `message` as a generic pointer ("The request has been not
processed. See the errors above to know why.") and puts the actionable
reason per field under `data`. The CLI printed the pointer, so the reason
never reached the terminal. Print the `data` reasons instead, and paint
4xx failures orange to separate a request the caller can fix from a
server or transport failure they cannot.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018iuvRoqnZPNpEUDwLfAn8F

* feat(core): link the error code to its documentation

`more` printed a bare URL. Terminals that speak OSC 8 now get `Read more`
pointing at the docs page, and the request URL becomes clickable without
changing the text, so copy-paste keeps working. Everywhere else prints
the URL exactly as before.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018iuvRoqnZPNpEUDwLfAn8F

* fix(core): align every reason under the failure label

A response reporting more than one field printed the extra reasons at a
fixed indent, which only lined up for a five letter status. Derive the
indent from the label instead.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/sessio... (continued)

513 of 685 branches covered (74.89%)

Branch coverage included in aggregate %.

44 of 52 new or added lines in 3 files covered. (84.62%)

3453 of 4336 relevant lines covered (79.64%)

12.75 hits per line