kayto_ts 0.1.9 → 0.1.11

package/README.md

@@ -2,7 +2,9 @@
 
 [📦 npm: kayto_ts](https://www.npmjs.com/package/kayto_ts)
 
-🚀 Build robust API integrations faster with `kayto_ts`.
+`kayto_ts` is a type-safe HTTP client that works in pair with `kayto` 🦀 (Rust).
+
+`kayto` generates `schema.ts` from your OpenAPI spec, and `kayto_ts` uses that schema to provide strongly-typed requests, responses, and hooks across any TypeScript platform: browser, Bun, Node.js, Deno, and more.
 
 - 🔒 End-to-end type safety for `method + path + params + body + response`
 - ⚡ Zero-boilerplate HTTP client usage with generated schema types
@@ -224,6 +226,66 @@ const clientWithHooks = clientApi<CatsEndpoints>({
 });
 ```
 
+## Success Handling (Cats API)
+
+```ts
+async function fetchCatsUI() {
+  let loading = true;
+
+  try {
+    const result = await client.get("/api/cats");
+
+    if (!result.ok) {
+      throw result.error;
+    }
+
+    const cats = result.responses[200];
+
+    if (!cats) {
+      throw new Error("Cats response is empty");
+    }
+
+    return cats;
+  } catch (error) {
+    // UI can show toast/snackbar here
+    throw error;
+  } finally {
+    loading = false;
+  }
+}
+```
+
+```ts
+async function createCatUI() {
+  let loading = true;
+
+  try {
+    const result = await client.post("/api/cats", {
+      body: {
+        name: "Milo",
+        age: 2,
+      },
+    });
+
+    if (!result.ok) {
+      throw result.error;
+    }
+
+    const created = result.responses[201] ?? result.responses[200];
+
+    if (!created) {
+      throw new Error("Create cat payload is empty");
+    }
+
+    return created;
+  } catch (error) {
+    throw error;
+  } finally {
+    loading = false;
+  }
+}
+```
+
 ## Error Handling
 
 All requests return a discriminated union:

package/package.json

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