@zapyapi/sdk 1.0.0-beta.5 → 1.0.0-beta.6

package/README.md

@@ -202,12 +202,16 @@ await client.webhooks.deleteConfig();
 
 ## Error Handling
 
+The SDK provides detailed error classes for different failure scenarios:
+
 ```typescript
 import {
   ZapyClient,
   ZapyApiError,
   AuthenticationError,
   RateLimitError,
+  NetworkError,
+  TimeoutError,
   ValidationError,
 } from '@zapyapi/sdk';
 
@@ -217,17 +221,46 @@ try {
     text: 'Hello!',
   });
 } catch (error) {
-  if (error instanceof AuthenticationError) {
+  if (error instanceof TimeoutError) {
+    // Request timed out
+    console.error(`Request timed out after ${error.timeout}ms`);
+    console.error(`Request: ${error.method} ${error.url}`);
+  } else if (error instanceof NetworkError) {
+    // Network failure (no response received)
+    console.error(`Network error: ${error.message}`);
+    console.error(`Error code: ${error.code}`); // e.g., ECONNREFUSED
+  } else if (error instanceof AuthenticationError) {
     console.error('Invalid API key');
   } else if (error instanceof RateLimitError) {
     console.error(`Rate limited. Retry after: ${error.retryAfter}ms`);
+    console.error(`Retry at: ${error.getRetryAfterDate()}`);
   } else if (error instanceof ZapyApiError) {
     console.error(`API Error [${error.code}]: ${error.message}`);
+    console.error(`Status: ${error.statusCode}`);
     console.error(`Request ID: ${error.requestId}`);
+    console.error(`Request: ${error.method} ${error.url}`);
+
+    // For debugging/logging
+    console.error(error.toDetailedString());
+    // Or serialize to JSON
+    console.error(JSON.stringify(error.toJSON(), null, 2));
   }
 }
 ```
 
+### Error Classes
+
+| Error Class | Description |
+|-------------|-------------|
+| `ZapyError` | Base error class for all SDK errors |
+| `ZapyApiError` | API returned an error response (4xx, 5xx) |
+| `AuthenticationError` | Invalid or missing API key (401) |
+| `RateLimitError` | Rate limit exceeded (429) |
+| `NetworkError` | Network failure, no response received |
+| `TimeoutError` | Request timed out |
+| `ValidationError` | Input validation failed |
+| `InstanceNotFoundError` | Instance not found (404) |
+
 ## Utilities
 
 ```typescript

package/index.cjs

@@ -3,7 +3,7 @@
 var axios = require('axios');
 
 /** SDK version - auto-generated from package.json */
-const SDK_VERSION = '1.0.0-beta.5';
+const SDK_VERSION = '1.0.0-beta.6';
 
 /**
  * Custom error classes for @zapyapi/sdk

package/index.js

@@ -1,7 +1,7 @@
 import axios from 'axios';
 
 /** SDK version - auto-generated from package.json */
-const SDK_VERSION = '1.0.0-beta.5';
+const SDK_VERSION = '1.0.0-beta.6';
 
 /**
  * Custom error classes for @zapyapi/sdk

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapyapi/sdk",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.6",
   "description": "Official TypeScript SDK for ZapyAPI - WhatsApp API",
   "type": "module",
   "main": "./index.cjs",

package/src/version.d.ts

@@ -1,3 +1,3 @@
 /** SDK version - auto-generated from package.json */
-export declare const SDK_VERSION = "1.0.0-beta.5";
+export declare const SDK_VERSION = "1.0.0-beta.6";
 //# sourceMappingURL=version.d.ts.map