@pdfvector/client 0.0.21 → 0.0.22

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @pdfvector/client
 
+## 0.0.22
+### Patch Changes
+
+- Updated dependencies [[`3a1c66b`](https://github.com/phuctm97/pdfvector/commit/3a1c66bcdfade057be5f1b9170f8ed64934bf2a9)]:
+  - @pdfvector/instance-client@0.0.42
+
 ## 0.0.21
 ### Patch Changes
 

package/README.md

@@ -580,12 +580,10 @@ console.log(resultB.documentId); // "doc-b"
 
 ## Error Handling
 
-All errors thrown by the client are `PDFVectorError` instances — including
-transport-layer failures (DNS, connection refused, timeouts), which surface
-with `code: "NETWORK_ERROR"` and `status: 0`.
+All API errors are thrown as `ORPCError` instances with structured error information matching the server's error response shape:
 
 ```typescript
-import { createClient, PDFVectorError } from "@pdfvector/client";
+import { createClient, ORPCError } from "@pdfvector/client";
 
 const client = createClient({
   apiKey: "your-api-key",
@@ -597,24 +595,24 @@ try {
   });
   console.log(result.markdown);
 } catch (error) {
-  if (error instanceof PDFVectorError) {
+  if (error instanceof ORPCError) {
     console.error(`API Error [${error.code}]: ${error.message}`);
     console.error(`HTTP Status: ${error.status}`);
-    console.error(`User error: ${error.userError}`);
     console.error(`Error Data:`, error.data);
   } else {
+    // Network errors (DNS, connection refused, timeout) bubble up as TypeError.
     console.error("Unexpected Error:", error);
   }
 }
 ```
 
-You can also use the static type guard:
+You can branch on the error code:
 
 ```typescript
 try {
   await client.document.parse({ url: "..." });
 } catch (error) {
-  if (PDFVectorError.is(error)) {
+  if (error instanceof ORPCError) {
     switch (error.code) {
       case "UNAUTHORIZED":
         console.error("Invalid API key");
@@ -622,16 +620,6 @@ try {
       case "BAD_REQUEST":
         console.error("Validation error:", error.message);
         break;
-      case "UNPROCESSABLE_CONTENT":
-        if (error.userError) {
-          console.error("The upload is unreadable or empty — please check the document.");
-        } else {
-          console.error("The server failed to process the document:", error.message);
-        }
-        break;
-      case "NETWORK_ERROR":
-        console.error("Could not reach the server. Check your network connection.");
-        break;
       case "INTERNAL_SERVER_ERROR":
         console.error("Server error:", error.message);
         break;
@@ -646,22 +634,9 @@ try {
 |------|--------|-------------|
 | `BAD_REQUEST` | 400 | Input validation failed (e.g., missing fields, invalid URL, question too short) |
 | `UNAUTHORIZED` | 401 | Missing or invalid API key |
-| `NOT_FOUND` | 404 | Requested resource does not exist |
-| `CONFLICT` | 409 | Request conflicts with current state (e.g., duplicate operation) |
-| `UNPROCESSABLE_CONTENT` | 422 | Document could not be processed. When `error.userError === true`, the upload itself is unreadable or empty; otherwise it's a server-side parse failure. |
+| `UNPROCESSABLE_CONTENT` | 422 | Document could not be processed by the requested model tier |
 | `TOO_MANY_REQUESTS` | 429 | Rate limit exceeded |
-| `NOT_IMPLEMENTED` | 501 | Endpoint is not supported on this instance |
 | `INTERNAL_SERVER_ERROR` | 500 | Server-side failure |
-| `NETWORK_ERROR` | 0 | Transport-layer failure — the request never reached the server (DNS, connection refused, timeout, etc.). `error.data.cause` holds the underlying error. |
-
-### User vs. system errors
-
-Document-family endpoints (`document.*`, `invoice.*`, `identity.*`,
-`bankStatement.*`) surface `error.userError === true` when the failure is
-caused by the uploaded document itself (e.g. empty file, illegible image,
-password-protected, unsupported content type). Use this flag to decide whether
-to show the end user an actionable message or report a backend issue. The same
-information is also available as `error.data.userError`.
 
 ## TypeScript Support
 
@@ -670,7 +645,7 @@ The SDK is written in TypeScript and includes full type definitions:
 ```typescript
 import {
   createClient,
-  PDFVectorError,
+  ORPCError,
 } from "@pdfvector/client";
 
 import type {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdfvector/client",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "type": "module",
   "description": "Official TypeScript/JavaScript SDK for PDF Vector API",
   "license": "MIT",
@@ -23,7 +23,7 @@
   },
   "main": ".tsc/lib/index.js",
   "dependencies": {
-    "@pdfvector/instance-client": "^0.0.41"
+    "@pdfvector/instance-client": "^0.0.42"
   },
   "files": [
     ".tsc",