kayto_ts 0.1.13 → 0.1.14

package/README.md

@@ -305,6 +305,8 @@ All requests return a discriminated union:
 You can handle errors by `kind`, but it is optional.
 You can also handle them generically via `message` / `status` / `cause` without branching by `kind`.
 
+For `http` errors, `error.data` contains the parsed backend payload and is typed from the endpoint's non-2xx responses (for example `400`, `404`, `422`).
+
 ```ts
 const result = await client.get("/api/cats");
 
@@ -343,6 +345,7 @@ if (!result.ok) {
       break;
     case "http":
       console.error("HTTP error", result.error.status);
+      console.error("Backend payload", result.error.data);
       break;
     default:
       console.error(result.error.message, result.error.cause);

package/dist/index.js

@@ -100,7 +100,7 @@ export function clientApi(config = {}) {
         if (!response.ok) {
             return {
                 ok: false,
-                error: makeClientError("http", `Request failed with status ${response.status}`, undefined, response.status),
+                error: makeClientError("http", `Request failed with status ${response.status}`, undefined, response.status, bodyResult.result),
                 response,
             };
         }

package/dist/types.d.ts

@@ -20,13 +20,32 @@ export type EndpointResult<E> = {
     responses: EndpointResponseMap<E>;
 };
 export type ErrorKind = "network" | "timeout" | "aborted" | "http" | "parse" | "hook";
-export type ClientError = {
+type ErrorStatusCode<R extends Record<PropertyKey, unknown>> = Exclude<Extract<keyof R, number>, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226>;
+type HttpErrorDataByStatus<R extends Record<PropertyKey, unknown>> = {
+    [S in ErrorStatusCode<R>]: [R[S]] extends [never] ? never : {
+        status: S;
+        data: R[S];
+    };
+}[ErrorStatusCode<R>];
+type HttpErrorPayload<E> = [EndpointResponses<E>] extends [never] ? {
+    status: number;
+    data?: unknown;
+} : [HttpErrorDataByStatus<EndpointResponses<E>>] extends [never] ? {
+    status: number;
+    data?: unknown;
+} : HttpErrorDataByStatus<EndpointResponses<E>>;
+export type ClientError<E = unknown> = {
     kind: ErrorKind;
     message: string;
     cause?: unknown;
+} & ({
+    kind: "network" | "timeout" | "aborted" | "parse" | "hook";
     status?: number;
-};
-export type FetchResult<E, Err = ClientError> = {
+    data?: undefined;
+} | ({
+    kind: "http";
+} & HttpErrorPayload<E>));
+export type FetchResult<E, Err = ClientError<E>> = {
     ok: true;
     responses: EndpointResponseMap<E>;
     response: Response;
@@ -81,3 +100,4 @@ export type ClientHooks = {
 export type ClientConfig = ClientHooks & {
     baseUrl?: string;
 };
+export {};

package/dist/utils.d.ts

@@ -6,7 +6,7 @@ export declare const HTTP_METHOD: {
     readonly patch: "PATCH";
     readonly delete: "DELETE";
 };
-export declare function makeClientError(kind: ErrorKind, message: string, cause?: unknown, status?: number): ClientError;
+export declare function makeClientError<E = unknown>(kind: ErrorKind, message: string, cause?: unknown, status?: number, data?: unknown): ClientError<E>;
 export declare function createFetchSignal(options: RequestOptions): {
     signal?: AbortSignal;
     cleanup: () => void;

package/dist/utils.js

@@ -6,7 +6,16 @@ export const HTTP_METHOD = {
     patch: "PATCH",
     delete: "DELETE",
 };
-export function makeClientError(kind, message, cause, status) {
+export function makeClientError(kind, message, cause, status, data) {
+    if (kind === "http") {
+        return {
+            kind,
+            message,
+            cause,
+            status: status ?? 0,
+            data,
+        };
+    }
     return { kind, message, cause, status };
 }
 export function createFetchSignal(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kayto_ts",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Type-safe HTTP client for working with kayto-generated endpoint schemas.",
   "repository": {
     "type": "git",