@unboundcx/sdk 4.8.10 → 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;
 

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.10",
+  "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;
   }
 }