microlinkhq / microlink / 40558219553

82%

push

github

feat(core): add raw request and apiUrl to the client (#80)

* feat(core): add raw request and apiUrl to the client

`client.request(url, options)` sends the options verbatim as API query
params, with the client context (apiKey, endpoint) and headers routed
the same way as the product methods, and resolves the full payload:
status, data, statusCode, redirects, headers and response.

`client.apiUrl(url, options)` returns the URL that call would hit.

Both are non-enumerable, like `last`, so they stay out of the product
list, the docs pages and the CLI help.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(mql): resolve embed responses as binary

`embed` makes the API answer with the asset itself, but mql only switched
to arrayBuffer for the legacy `stream` name, so an embed call failed
parsing the image as JSON (EFATALCLIENT, Unexpected token).

The core raw `request` types now mirror mql: `response.headers` is a
Fetch `Headers`, and an `embed`/`stream` call resolves the HTTP response
with an `ArrayBuffer` body. The README documents both raw methods.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(core): reject embed and stream in the JSON request overload

`client.request<T>(url, { embed })` picked the generic overload and typed
a binary response as `MicrolinkResponse<T>`. The JSON overload now forbids
`embed`/`stream`, so those calls only match the ArrayBuffer overload.

README: `headers` travel as HTTP request headers, and `stream` resolves
binary the same way `embed` does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

894 of 1141 branches covered (78.35%)

Branch coverage included in aggregate %.

16 of 16 new or added lines in 2 files covered. (100.0%)

5175 of 6263 relevant lines covered (82.63%)

28.25 hits per line