@kortexya/reasoninglayer 3.1.0 → 4.0.0

package/README.md

@@ -211,6 +211,7 @@ import {
   RateLimitError,
   TimeoutError,
   NetworkError,
+  ResponseShapeError,
 } from '@kortexya/reasoninglayer';
 
 try {
@@ -224,10 +225,25 @@ try {
     console.log(`Timed out after ${error.timeoutMs}ms`);
   } else if (error instanceof NetworkError) {
     console.log('Connection failed:', error.message);
+  } else if (error instanceof ResponseShapeError) {
+    // A 2xx the SDK cannot read: `field` names what the body lacks
+    // (`items`, `items[3].sort_suggestions`); undefined when it was not JSON.
+    console.log(`${error.method} ${error.path} answered ${error.status}`, error.field);
   }
 }
 ```
 
+Error hierarchy:
+
+```
+ReasoningLayerError
+  +-- ApiError (HTTP 4xx/5xx: status, errorCode, body, headers) and its subclasses
+  +-- TimeoutError
+  +-- ValidationError
+  +-- NetworkError
+  +-- ResponseShapeError (a 2xx body the SDK cannot read: status, method, path, field, body)
+```
+
 ## Builders
 
 The SDK provides builder functions for constructing API request values with full type safety:
@@ -300,7 +316,7 @@ pnpm run docs:build             # Build documentation site
 
 | SDK Version | Min Backend Version | Node | Browser |
 | ----------- | ------------------- | ---- | ------- |
-| 1.4.0       | Latest              | 18+  | ES2022+ |
+| 4.0.0       | engine `5cef4fa34`  | 20+  | ES2022+ |
 
 ## License