@unboundcx/sdk 2.6.4 → 2.6.5

package/base.js

@@ -84,6 +84,11 @@ export class BaseSDK {
       throw new Error('Transport must have a request method');
     }
 
+    // Transport plugins must follow these rules:
+    // 1. RETURN API responses normally (including error status codes like 400, 500)
+    // 2. ONLY THROW exceptions for transport mechanism failures (connection issues, plugin errors)
+    // This ensures API errors flow through unchanged, same as built-in fetch
+
     const priority = transport.getPriority ? transport.getPriority() : 50;
     const name = transport.name || `transport_${Date.now()}`;
 
@@ -187,15 +192,23 @@ export class BaseSDK {
         
         return result;
       } catch (err) {
-        // Debug logging for transport plugin failures
+        // IMPORTANT: This catch block should ONLY handle transport-level failures
+        // (e.g., WebSocket disconnected, plugin unavailable, network errors)
+        // 
+        // Transport plugins should:
+        // - RETURN API error responses normally (400, 500, etc.) as response objects
+        // - ONLY THROW for transport mechanism failures
+        //
+        // This ensures API errors are passed through unchanged, just like built-in fetch
+        
         if (this.debugMode) {
-          console.log(`API :: ${transport.name} :: ${method.toUpperCase()} :: ${endpoint} :: ERROR :: ${err.message}`);
+          console.log(`API :: Transport ${transport.name} failure :: ${method.toUpperCase()} :: ${endpoint} :: ${err.message}`);
         }
         console.warn(
-          `Transport ${transport.name} failed, falling back to HTTP:`,
+          `Transport ${transport.name} mechanism failed, falling back to HTTP:`,
           err.message,
         );
-        // Fall through to HTTP
+        // Fall through to built-in HTTP fetch
       }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "2.6.4",
+  "version": "2.6.5",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",