@unboundcx/sdk 4.8.9 → 4.8.11

package/base.js

@@ -13,6 +13,31 @@
  * npm install mime-types
  */
 
+const requestBySdk = new WeakMap();
+const SDK_REQUEST = Symbol.for('unbound.sdk.request');
+
+/**
+ * Service-internal request. Not part of the public SDK surface.
+ * Named SDK methods call this; app code must not. Optional transports
+ * (e.g. Socket.IO) are used when available unless httpOnly/forceFetch.
+ *
+ * @param {object} sdk
+ * @param {string} endpoint
+ * @param {string} method
+ * @param {object} [params]
+ * @param {boolean} [forceFetch] Skip optional transports (HTTP only).
+ *   Use for file upload/download.
+ */
+export function internalRequest(sdk, endpoint, method, params = {}, forceFetch) {
+  const run =
+    requestBySdk.get(sdk) || sdk?.[SDK_REQUEST];
+  if (typeof run !== 'function') {
+    throw new Error('SDK request is not initialized');
+  }
+  const httpOnly = forceFetch === true || params?.httpOnly === true;
+  return run(endpoint, method, params, httpOnly);
+}
+
 export class BaseSDK {
   constructor(options = {}) {
     // Support both object and legacy positional parameters for backwards compatibility
@@ -35,6 +60,15 @@ export class BaseSDK {
     this.transports = new Map();
     this.debugMode = false;
     this._initializeEnvironment();
+    const run = (endpoint, method, params, forceFetch) =>
+      this.#request(endpoint, method, params, forceFetch);
+    requestBySdk.set(this, run);
+    Object.defineProperty(this, SDK_REQUEST, {
+      value: run,
+      enumerable: false,
+      configurable: false,
+      writable: false,
+    });
   }
 
   _initializeEnvironment() {
@@ -177,7 +211,13 @@ export class BaseSDK {
     }
   }
 
-  async _fetch(endpoint, method, params = {}, forceFetch = false) {
+  _fetch() {
+    throw new Error(
+      'sdk._fetch is private. Use a service method (sdk.chat, sdk.objects, ...).',
+    );
+  }
+
+  async #request(endpoint, method, params = {}, forceFetch = false) {
     const startTime = Date.now();
     const { body, query, headers = {}, returnRawResponse = false } = params;
 
@@ -410,37 +450,36 @@ export class BaseSDK {
       'application/json';
 
     if (!response.ok) {
+      // A fetch Response's `.body` is a ReadableStream, not the parsed
+      // payload — it must go through json()/text() or the API's
+      // `{ message }` envelope is lost and every error surfaces as the
+      // generic "API Error". Only NATS-transport responses carry a
+      // pre-parsed `.body`.
       let errorBody;
-      if (response?.body) {
-        errorBody = response.body;
-      } else if (response?.headers?.['content-type']) {
-        try {
-          if (
-            typeof response?.json === 'function' ||
-            typeof response?.text === 'function'
-          ) {
-            if (contentType.includes('application/json')) {
-              errorBody = await response.json();
-            } else if (contentType.includes('text/')) {
-              errorBody = await response.text();
-            }
-          } else {
-            if (contentType.includes('application/json')) {
-              errorBody = this._getJsonSafely(
-                response?.body,
-                response?.body || {},
-              );
-            } else if (contentType.includes('text/')) {
-              errorBody = response?.body || '';
-            }
+      try {
+        if (
+          typeof response?.json === 'function' ||
+          typeof response?.text === 'function'
+        ) {
+          if (contentType.includes('application/json')) {
+            errorBody = await response.json();
+          } else if (contentType.includes('text/')) {
+            errorBody = await response.text();
           }
-          if (!errorBody) {
-            errorBody = `HTTP ${response.status} ${response.statusText}`;
+        } else if (response?.body) {
+          if (contentType.includes('application/json')) {
+            errorBody = this._getJsonSafely(
+              response?.body,
+              response?.body || {},
+            );
+          } else {
+            errorBody = response.body;
           }
-        } catch (parseError) {
-          errorBody = `HTTP ${response.status} ${response.statusText}`;
         }
-      } else {
+      } catch (parseError) {
+        // fall through to the status-line fallback below
+      }
+      if (!errorBody) {
         errorBody = `HTTP ${response.status} ${response.statusText}`;
       }
 
@@ -455,7 +494,10 @@ export class BaseSDK {
       httpError.method = method;
       httpError.endpoint = endpoint;
       httpError.body = errorBody;
-      httpError.message = errorBody?.error || errorBody?.message || 'API Error';
+      httpError.message =
+        errorBody?.error ||
+        errorBody?.message ||
+        (typeof errorBody === 'string' ? errorBody : 'API Error');
 
       // Debug logging for successful HTTP requests
       if (this.debugMode) {

package/index.js

@@ -1,7 +1,7 @@
 /* eslint-disable indent */
 /* eslint-disable prettier/prettier */
 
-import { BaseSDK } from './base.js';
+import { BaseSDK, internalRequest } from './base.js';
 import { LoginService } from './services/login.js';
 import { ObjectsService } from './services/objects.js';
 import { MessagingService } from './services/messaging/MessagingService.js';
@@ -34,6 +34,7 @@ import { InboxService } from './services/inbox.js';
 import { SearchService } from './services/search.js';
 import { DirectoryService } from './services/directory.js';
 import { ChatService } from './services/chat.js';
+import { DeveloperApisService } from './services/developerApis.js';
 
 class UnboundSDK extends BaseSDK {
   constructor(options = {}) {
@@ -109,6 +110,7 @@ class UnboundSDK extends BaseSDK {
     this.search = new SearchService(this);
     this.directory = new DirectoryService(this);
     this.chat = new ChatService(this);
+    this.developerApis = new DeveloperApisService(this);
 
     // Add additional services that might be missing
     this._initializeAdditionalServices();
@@ -188,7 +190,7 @@ class UnboundSDK extends BaseSDK {
    */
   async status() {
     try {
-      const response = await this._fetch('/health', 'GET', {
+      const response = await internalRequest(this, '/health', 'GET', {
         returnRawResponse: true,
       });
 
@@ -242,7 +244,7 @@ class UnboundSDK extends BaseSDK {
    */
   async getIp() {
     // Force fetch transport (pass true as forceFetch parameter)
-    return await this._fetch('/get-ip', 'GET', {}, true);
+    return await internalRequest(this, '/get-ip', 'GET', {}, true);
   }
 }
 
@@ -293,4 +295,5 @@ export { InboxService } from './services/inbox.js';
 export { SearchService } from './services/search.js';
 export { DirectoryService } from './services/directory.js';
 export { ChatService } from './services/chat.js';
+export { DeveloperApisService } from './services/developerApis.js';
 export { BaseSDK } from './base.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.8.9",
+  "version": "4.8.11",
   "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",
@@ -52,9 +52,6 @@
       "import": "./index.js",
       "require": "./index.cjs"
     },
-    "./base": {
-      "import": "./base.js"
-    },
     "./services/*": {
       "import": "./services/*.js"
     },

package/services/ai/playbooks.js

@@ -1,3 +1,4 @@
+import { internalRequest } from '../../base.js';
 /**
  * Playbooks Service - Manage AI-driven playbook sessions for guided workflows
  */
@@ -36,7 +37,7 @@ export class PlaybooksService {
       body: { name, recordTypeId },
     };
 
-    const result = await this.sdk._fetch('/ai/playbooks', 'POST', params);
+    const result = await internalRequest(this.sdk, '/ai/playbooks', 'POST', params);
     return result;
   }
 
@@ -60,7 +61,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(`/ai/playbooks/${playbookId}`, 'GET');
+    const result = await internalRequest(this.sdk, `/ai/playbooks/${playbookId}`, 'GET');
     return result;
   }
 
@@ -92,7 +93,7 @@ export class PlaybooksService {
       query: { limit, orderBy, orderDirection, isPublished, recordTypeId },
     };
 
-    const result = await this.sdk._fetch('/ai/playbooks', 'GET', params);
+    const result = await internalRequest(this.sdk, '/ai/playbooks', 'GET', params);
     return result;
   }
 
@@ -128,7 +129,7 @@ export class PlaybooksService {
       body: { name, isPublished, recordTypeId },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/${playbookId}`,
       'PUT',
       params,
@@ -156,7 +157,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/${playbookId}`,
       'DELETE',
     );
@@ -247,7 +248,7 @@ export class PlaybooksService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/${playbookId}/goals`,
       'POST',
       params,
@@ -278,7 +279,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/${playbookId}/goals/${goalId}`,
       'GET',
     );
@@ -305,7 +306,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/${playbookId}/goals`,
       'GET',
     );
@@ -390,7 +391,7 @@ export class PlaybooksService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/goals/${goalId}`,
       'PUT',
       params,
@@ -418,7 +419,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/goals/${goalId}`,
       'DELETE',
     );
@@ -454,7 +455,7 @@ export class PlaybooksService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/${playbookId}/goals/reorder`,
       'PUT',
       params,
@@ -511,7 +512,7 @@ export class PlaybooksService {
       body: { name, description, keywords, recommendedPhase, role, signal, recordTypeId },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/ai/playbooks/goalTypes',
       'POST',
       params,
@@ -539,7 +540,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/goalTypes/${goalTypeId}`,
       'GET',
     );
@@ -574,7 +575,7 @@ export class PlaybooksService {
       query: { limit, orderBy, orderDirection, recommendedPhase, recordTypeId },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/ai/playbooks/goalTypes',
       'GET',
       params,
@@ -629,7 +630,7 @@ export class PlaybooksService {
       body: { name, description, keywords, recommendedPhase, role, signal, recordTypeId },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/goalTypes/${goalTypeId}`,
       'PUT',
       params,
@@ -657,7 +658,7 @@ export class PlaybooksService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/goalTypes/${goalTypeId}`,
       'DELETE',
     );
@@ -736,7 +737,7 @@ export class PlaybooksService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/sessions/${playbookId}`,
       'POST',
       params,
@@ -792,7 +793,7 @@ export class PlaybooksService {
     );
 
     if (sessionId) {
-      const result = await this.sdk._fetch(
+      const result = await internalRequest(this.sdk, 
         `/ai/playbooks/sessions/${sessionId}`,
         'GET',
       );
@@ -804,7 +805,7 @@ export class PlaybooksService {
     if (workerId) query.workerId = workerId;
     if (userId) query.userId = userId;
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/sessions`,
       'GET',
       { query },
@@ -882,7 +883,7 @@ export class PlaybooksService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/sessions/${sessionId}/complete`,
       'PUT',
       params,
@@ -984,7 +985,7 @@ export class PlaybooksService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/playbooks/sessions/${sessionId}/goal`,
       'POST',
       params,

package/services/ai/settings.js

@@ -1,3 +1,5 @@
+import { internalRequest } from '../../base.js';
+
 /**
  * AI Settings helpers - Manage account-level AI feature settings
  * Exposed directly on AIService as getSettings()/updateSettings()
@@ -9,7 +11,7 @@
  * @returns {Promise<Object>} { settings: { shareOcrEnabled } }
  */
 export async function getSettings(sdk) {
-  const result = await sdk._fetch('/ai/settings', 'GET');
+  const result = await internalRequest(sdk, '/ai/settings', 'GET');
   return result;
 }
 
@@ -32,6 +34,6 @@ export async function updateSettings(sdk, { shareOcrEnabled }) {
     body: { shareOcrEnabled },
   };
 
-  const result = await sdk._fetch('/ai/settings', 'PUT', params);
+  const result = await internalRequest(sdk, '/ai/settings', 'PUT', params);
   return result;
 }

package/services/ai/translate.js

@@ -1,3 +1,5 @@
+import { internalRequest } from '../../base.js';
+
 /**
  * AI Translate helper - Batch-translate arbitrary text items
  * Exposed directly on AIService as translate()
@@ -33,6 +35,6 @@ export async function translate(
     body: { items, targetLanguage, sourceLanguage, domain, context },
   };
 
-  const result = await sdk._fetch('/ai/translate', 'POST', params);
+  const result = await internalRequest(sdk, '/ai/translate', 'POST', params);
   return result;
 }

package/services/ai/vocabulary.js

@@ -1,3 +1,4 @@
+import { internalRequest } from '../../base.js';
 /**
  * Vocabulary Service - Manage account-level custom transcription vocabulary
  */
@@ -11,7 +12,7 @@ export class VocabularyService {
    * @returns {Promise<Object>} { terms: [{id, term, createdBy, createdAt}] }
    */
   async list() {
-    const result = await this.sdk._fetch('/ai/vocabulary', 'GET');
+    const result = await internalRequest(this.sdk, '/ai/vocabulary', 'GET');
     return result;
   }
 
@@ -32,7 +33,7 @@ export class VocabularyService {
       body: { term },
     };
 
-    const result = await this.sdk._fetch('/ai/vocabulary', 'POST', params);
+    const result = await internalRequest(this.sdk, '/ai/vocabulary', 'POST', params);
     return result;
   }
 
@@ -49,7 +50,7 @@ export class VocabularyService {
       },
     );
 
-    const result = await this.sdk._fetch(`/ai/vocabulary/${id}`, 'DELETE');
+    const result = await internalRequest(this.sdk, `/ai/vocabulary/${id}`, 'DELETE');
     return result;
   }
 }

package/services/ai.js

@@ -1,3 +1,4 @@
+import { internalRequest } from '../base.js';
 import { PlaybooksService } from './ai/playbooks.js';
 import { VocabularyService } from './ai/vocabulary.js';
 import { translate as translateItems } from './ai/translate.js';
@@ -175,7 +176,7 @@ export class GenerativeService {
         ),
     );
     const forceFetch = stream === true || hasLargeContent;
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/ai/generative/chat',
       'POST',
       params,
@@ -249,7 +250,7 @@ export class GenerativeService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/ai/generative/chat/clone',
       'POST',
       params,
@@ -274,7 +275,7 @@ export class GenerativeService {
       body: payload,
     };
 
-    const result = await this.sdk._fetch('/ai/summarize', 'POST', params);
+    const result = await internalRequest(this.sdk, '/ai/summarize', 'POST', params);
     return result;
   }
 
@@ -283,7 +284,7 @@ export class GenerativeService {
    * @returns {Promise<Object>} { tools: Array<{ name, label, description, configRequirements }>, count: number }
    */
   async listTools() {
-    return await this.sdk._fetch('/ai/generative/tools', 'GET');
+    return await internalRequest(this.sdk, '/ai/generative/tools', 'GET');
   }
 
   /**
@@ -307,7 +308,7 @@ export class GenerativeService {
     );
 
     const params = { query: { relatedId, scope, limit, offset } };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/ai/generative/sessions',
       'GET',
       params,
@@ -327,7 +328,7 @@ export class GenerativeService {
       { sessionId: { type: 'string', required: true } },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/generative/sessions/${sessionId}`,
       'GET',
     );
@@ -352,7 +353,7 @@ export class GenerativeService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/generative/sessions/${sessionId}`,
       'PUT',
       { body: { name, scope } },
@@ -372,7 +373,7 @@ export class GenerativeService {
       { sessionId: { type: 'string', required: true } },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/generative/sessions/${sessionId}`,
       'DELETE',
     );
@@ -419,7 +420,7 @@ export class GenerativeService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/ai/generative/playbook',
       'POST',
       params,
@@ -468,7 +469,7 @@ export class GenerativeService {
 
   //   // Force HTTP transport when streaming is enabled since NATS doesn't support streaming responses
   //   const forceFetch = stream === true;
-  //   const result = await this.sdk._fetch(
+  //   const result = await internalRequest(this.sdk, 
   //     '/ai/generative/ollama',
   //     'POST',
   //     params,
@@ -537,7 +538,7 @@ export class TextToSpeechService {
       body: ttsData,
     };
 
-    const result = await this.sdk._fetch('/ai/tts', 'POST', params);
+    const result = await internalRequest(this.sdk, '/ai/tts', 'POST', params);
     return result;
   }
 
@@ -546,7 +547,7 @@ export class TextToSpeechService {
    * @returns {Promise<Object>} { voices: Array, count: number, supportedEncodings: Array, supportedLanguages: Array }
    */
   async list() {
-    const result = await this.sdk._fetch('/ai/tts', 'GET');
+    const result = await internalRequest(this.sdk, '/ai/tts', 'GET');
     return result;
   }
 }
@@ -638,7 +639,7 @@ export class SpeechToTextService {
       },
     };
 
-    const result = await this.sdk._fetch('/ai/stt', 'POST', params);
+    const result = await internalRequest(this.sdk, '/ai/stt', 'POST', params);
     return result;
   }
 
@@ -665,7 +666,7 @@ export class SpeechToTextService {
     const body = { storageId };
     if (language !== undefined) body.language = language;
     if (encoding !== undefined) body.encoding = encoding;
-    return await this.sdk._fetch('/ai/stt/file', 'POST', { body });
+    return await internalRequest(this.sdk, '/ai/stt/file', 'POST', { body });
   }
 
   /**
@@ -858,7 +859,7 @@ export class SpeechToTextService {
       },
     };
 
-    const session = await this.sdk._fetch(
+    const session = await internalRequest(this.sdk, 
       '/ai/stt/stream',
       'POST',
       sessionParams,
@@ -908,7 +909,7 @@ export class SpeechToTextService {
       query: { includeMessages: includeMessages.toString() },
     };
 
-    const result = await this.sdk._fetch(`/ai/stt/${id}`, 'GET', params);
+    const result = await internalRequest(this.sdk, `/ai/stt/${id}`, 'GET', params);
     return result;
   }
 
@@ -945,7 +946,7 @@ export class SpeechToTextService {
       query: filters,
     };
 
-    const result = await this.sdk._fetch('/ai/stt', 'GET', params);
+    const result = await internalRequest(this.sdk, '/ai/stt', 'GET', params);
     return result;
   }
 
@@ -1039,7 +1040,7 @@ export class SpeechToTextService {
       },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/stt/stream/${sessionId}/messages`,
       'POST',
       params,
@@ -1069,7 +1070,7 @@ export class SpeechToTextService {
       body: { status, error },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/ai/stt/stream/${sessionId}/complete`,
       'PUT',
       params,
@@ -1281,7 +1282,7 @@ export class ExtractService {
       },
     };
 
-    const result = await this.sdk._fetch('/ai/extract', 'POST', requestParams);
+    const result = await internalRequest(this.sdk, '/ai/extract', 'POST', requestParams);
     return result;
   }
 }