6. Handling Responses¶

Raw Response¶

submitRaw() returns a RawHttpResponse.

const response = await client.get('/players/7281').submitRaw();
const status = response.status;
const body = response.body;                 // string
const contentType = response.headers['content-type'];

Response header names are lowercase.

Typed JSON Response¶

submit<T>() decodes the response as JSON and returns an HttpResponse<T>.

const response = await client.get('/players/7281').submit<PlayerProfile>();
const profile = response.body;     // the decoded object
const raw = response.rawBody;      // the original response text

If status is 400 or above, it throws ZLinkFrameworkException(requestFailed).
A body JSON decode failure is reported as ZLinkFrameworkException(payloadDecodeFailed).
JSON parsing applies prototype-pollution (__proto__/constructor/prototype) defenses.

Status Handling Summary¶

Path	4xx/5xx
`submitRaw()`	returns the status as-is (no exception)
`submit<T>()`	`requestFailed` exception
`fetch<T>()`	validates the same as `submit<T>()`, returning only the decoded body as `Promise<T>`

const profile = await client.get('/players/7281').fetch<PlayerProfile>();
// An async convenience surface for when you just need the body, with no response wrapper.

Next: Async →