@unboundcx/sdk 1.0.2 → 1.0.4

package/README.md

@@ -12,7 +12,7 @@ The official JavaScript SDK for Unbound's comprehensive communication and AI pla
 - 📞 **Voice**: Call management, conferencing, recording, transcription
 - 📹 **Video**: Video conferencing with advanced controls
 - 🤖 **AI**: Generative AI chat and text-to-speech
-- 💾 **Data**: Object management with queries and relationships  
+- 💾 **Data**: Object management with queries and relationships
 - 🔄 **Workflows**: Programmable workflow execution
 - 🔌 **Extensible**: Plugin system for transports and extensions
 - ⚡ **Performance**: Automatic transport optimization (NATS/Socket/HTTP)
@@ -45,10 +45,10 @@ import SDK from '@unboundcx/sdk';
 // Initialize the SDK
 const api = new SDK({
   namespace: 'your-namespace',
-  token: 'your-jwt-token'
+  token: 'your-jwt-token',
 });
 
-// Or using legacy positional parameters (backwards compatible)  
+// Or using legacy positional parameters (backwards compatible)
 const api = new SDK('your-namespace', null, 'your-jwt-token');
 
 // Login (gets JWT token)
@@ -57,15 +57,15 @@ const login = await api.login.login('username', 'password');
 // Send SMS
 const sms = await api.messaging.sms.send({
   from: '+1234567890',
-  to: '+0987654321', 
-  message: 'Hello from Unbound!'
+  to: '+0987654321',
+  message: 'Hello from Unbound!',
 });
 
 // Create video meeting
 const meeting = await api.video.createRoom({
   name: 'Team Meeting',
   startTime: '2024-01-15T10:00:00Z',
-  duration: 60
+  duration: 60,
 });
 ```
 
@@ -78,13 +78,13 @@ import { socketAppStore } from './stores/socket.js';
 // Initialize for browser usage
 const api = new SDK({
   namespace: 'your-namespace',
-  socketStore: socketAppStore  // Optional: for optimized WebSocket transport
+  socketStore: socketAppStore, // Optional: for optimized WebSocket transport
 });
 
 // The SDK automatically connects to your-namespace.api.unbound.cx
-const objects = await api.objects.query('contacts', { 
+const objects = await api.objects.query('contacts', {
   limit: 10,
-  orderBy: 'createdAt'
+  orderBy: 'createdAt',
 });
 ```
 
@@ -93,18 +93,18 @@ const objects = await api.objects.query('contacts', {
 ```javascript
 import SDK from '@unboundcx/sdk';
 
-// Initialize for server-side usage  
+// Initialize for server-side usage
 const api = new SDK({
   namespace: 'your-namespace',
   token: 'jwt-token',
-  callId: 'call-id'          // Optional: for request tracking
+  callId: 'call-id', // Optional: for request tracking
 });
 
 // Automatically connects to your-namespace.api.unbound.cx
 const result = await api.objects.create('leads', {
   name: 'John Doe',
   email: 'john@example.com',
-  phone: '+1234567890'
+  phone: '+1234567890',
 });
 ```
 
@@ -116,11 +116,11 @@ The SDK constructor supports both object-based and legacy positional parameters:
 
 ```javascript
 const api = new SDK({
-  namespace: 'your-namespace',    // Required: Your Unbound namespace
-  token: 'jwt-token',             // Optional: JWT authentication token
-  callId: 'call-123',             // Optional: Call tracking ID
-  fwRequestId: 'request-456',     // Optional: Request forwarding ID
-  socketStore: socketAppStore     // Optional: Socket.io store (browser only)
+  namespace: 'your-namespace', // Required: Your Unbound namespace
+  token: 'jwt-token', // Optional: JWT authentication token
+  callId: 'call-123', // Optional: Call tracking ID
+  fwRequestId: 'request-456', // Optional: Request forwarding ID
+  socketStore: socketAppStore, // Optional: Socket.io store (browser only)
 });
 ```
 
@@ -128,10 +128,10 @@ const api = new SDK({
 
 ```javascript
 const api = new SDK(
-  'your-namespace',    // namespace
-  'call-123',          // callId  
-  'jwt-token',         // token
-  'request-456'        // fwRequestId
+  'your-namespace', // namespace
+  'call-123', // callId
+  'jwt-token', // token
+  'request-456', // fwRequestId
 );
 ```
 
@@ -142,7 +142,7 @@ import { createSDK } from '@unboundcx/sdk';
 
 const api = createSDK({
   namespace: 'your-namespace',
-  token: 'jwt-token'
+  token: 'jwt-token',
 });
 ```
 
@@ -151,6 +151,7 @@ const api = createSDK({
 ### Core Services
 
 #### Authentication (`api.login`)
+
 ```javascript
 // Login and get session
 await api.login.login('username', 'password');
@@ -159,10 +160,14 @@ await api.login.validate();
 await api.login.changePassword('current', 'new');
 ```
 
-#### Objects (`api.objects`) 
+#### Objects (`api.objects`)
+
 ```javascript
 // CRUD operations on data objects
-await api.objects.create('contacts', { name: 'John', email: 'john@example.com' });
+await api.objects.create('contacts', {
+  name: 'John',
+  email: 'john@example.com',
+});
 await api.objects.query('contacts', { limit: 10 });
 await api.objects.byId('contact-123');
 await api.objects.updateById('contacts', 'contact-123', { name: 'Jane' });
@@ -172,39 +177,41 @@ await api.objects.list(); // List all object types
 ```
 
 #### Messaging (`api.messaging`)
+
 ```javascript
 // SMS/MMS
 await api.messaging.sms.send({
   from: '+1234567890',
   to: '+0987654321',
   message: 'Hello!',
-  mediaUrls: ['https://example.com/image.jpg']
+  mediaUrls: ['https://example.com/image.jpg'],
 });
 
-// Email  
+// Email
 await api.messaging.email.send({
   from: 'sender@example.com',
-  to: 'recipient@example.com', 
+  to: 'recipient@example.com',
   subject: 'Hello',
-  htmlBody: '<h1>Hello World!</h1>'
+  htmlBody: '<h1>Hello World!</h1>',
 });
 
 // Templates
 await api.messaging.sms.templates.create({
   name: 'welcome',
   message: 'Welcome {{name}}!',
-  variables: { name: 'string' }
+  variables: { name: 'string' },
 });
 
 // Campaign Management
 await api.messaging.campaigns.tollFree.create({
   companyName: 'Acme Corp',
   phoneNumber: '+1234567890',
-  description: 'Marketing campaign'
+  description: 'Marketing campaign',
 });
 ```
 
 #### Video Conferencing (`api.video`)
+
 ```javascript
 // Room Management
 const room = await api.video.createRoom({
@@ -212,7 +219,7 @@ const room = await api.video.createRoom({
   password: 'secret123',
   startTime: '2024-01-15T10:00:00Z',
   waitingRoom: true,
-  hosts: ['user@example.com']
+  hosts: ['user@example.com'],
 });
 
 // Join meeting
@@ -225,18 +232,19 @@ await api.video.removeParticipant(room.id, 'participant-id');
 // Analytics
 const analytics = await api.video.getMeetingAnalytics(room.id, {
   startTime: '2024-01-15T10:00:00Z',
-  endTime: '2024-01-15T11:00:00Z'
+  endTime: '2024-01-15T11:00:00Z',
 });
 ```
 
 #### Voice Calling (`api.voice`)
+
 ```javascript
 // Make calls
 const call = await api.voice.createCall({
   to: '+1234567890',
   from: '+0987654321',
   record: true,
-  transcribe: true
+  transcribe: true,
 });
 
 // Call controls
@@ -252,32 +260,34 @@ await api.voice.joinConference(call.callControlId, conference.id);
 ```
 
 #### AI Services (`api.ai`)
+
 ```javascript
 // Generative AI
 const response = await api.ai.generative.chat({
   messages: [{ role: 'user', content: 'Hello AI!' }],
   model: 'gpt-4',
   temperature: 0.7,
-  method: 'openai'
+  method: 'openai',
 });
 
 // Text-to-Speech
 const audio = await api.ai.tts.create({
   text: 'Hello, this is a test message',
   voice: 'en-US-Standard-A',
-  audioEncoding: 'MP3'
+  audioEncoding: 'MP3',
 });
 ```
 
 ### Utility Services
 
 #### File Storage (`api.storage`)
+
 ```javascript
 // Upload files
 const files = await api.storage.uploadFiles(fileData, {
   classification: 'documents',
   isPublic: false,
-  expireAfter: '30d'
+  expireAfter: '30d',
 });
 
 // Get files
@@ -286,21 +296,22 @@ await api.storage.deleteFile(files[0].storageId);
 ```
 
 #### Workflows (`api.workflows`)
+
 ```javascript
 // Workflow items
 await api.workflows.items.create({
   workflowVersionId: 'wf-123',
   category: 'communication',
   type: 'sendEmail',
-  settings: { template: 'welcome' }
+  settings: { template: 'welcome' },
 });
 
 // Connections
 await api.workflows.connections.create({
   workflowItemId: 'item-1',
   workflowItemPortId: 'output',
-  inWorkflowItemId: 'item-2', 
-  inWorkflowItemPortId: 'input'
+  inWorkflowItemId: 'item-2',
+  inWorkflowItemPortId: 'input',
 });
 ```
 
@@ -309,7 +320,7 @@ await api.workflows.connections.create({
 The SDK automatically optimizes transport based on environment:
 
 - **Node.js**: NATS → HTTP fallback
-- **Browser**: WebSocket → HTTP fallback  
+- **Browser**: WebSocket → HTTP fallback
 - **Always available**: HTTP fetch
 
 ### Custom Transports
@@ -322,13 +333,15 @@ class CustomTransport {
     this.config = config;
     this.name = 'custom';
   }
-  
-  getPriority() { return 10; } // Lower = higher priority
-  
+
+  getPriority() {
+    return 10;
+  } // Lower = higher priority
+
   async isAvailable() {
     return true; // Check if transport is ready
   }
-  
+
   async request(endpoint, method, params, options) {
     // Custom transport logic
     return response;
@@ -350,9 +363,9 @@ const api = new SDK({ namespace: 'namespace' });
 
 // Add custom functionality via extensions
 api.extend({
-  customMethod: function() {
+  customMethod: function () {
     return this.objects.query('custom', {});
-  }
+  },
 });
 
 // Use custom method
@@ -362,6 +375,7 @@ await api.customMethod();
 ## Environment Support
 
 ### Node.js
+
 ```javascript
 import SDK from '@unboundcx/sdk';
 
@@ -370,23 +384,25 @@ const api = new SDK({ namespace: process.env.UNBOUND_NAMESPACE });
 ```
 
 ### Browser/Webpack
+
 ```javascript
 import SDK from '@unboundcx/sdk';
 
 const api = new SDK({
-  namespace: 'your-namespace'
+  namespace: 'your-namespace',
 });
 // Automatically connects to your-namespace.api.unbound.cx
 ```
 
 ### Svelte
+
 ```javascript
 import SDK from '@unboundcx/sdk';
 import { socketAppStore } from '$lib/stores/socket.js';
 
 const api = new SDK({
   namespace: 'your-namespace',
-  socketStore: socketAppStore  // Enables WebSocket transport
+  socketStore: socketAppStore, // Enables WebSocket transport
 });
 // Automatically connects to your-namespace.api.unbound.cx
 ```
@@ -397,10 +413,10 @@ const api = new SDK({
 try {
   await api.messaging.sms.send({ to: 'invalid' });
 } catch (error) {
-  console.log(error.name);    // 'API :: Error :: https :: POST :: /messaging/sms :: ...'
+  console.log(error.name); // 'API :: Error :: https :: POST :: /messaging/sms :: ...'
   console.log(error.message); // 'Invalid phone number format'
-  console.log(error.status);  // 400
-  console.log(error.method);  // 'POST'
+  console.log(error.status); // 400
+  console.log(error.method); // 'POST'
   console.log(error.endpoint); // '/messaging/sms'
 }
 ```
@@ -417,14 +433,15 @@ const api: SDK = new SDK({ namespace: 'namespace', token: 'token' });
 // Full type safety
 const sms: any = await api.messaging.sms.send({
   from: '+1234567890',
-  to: '+0987654321', 
-  message: 'Hello TypeScript!'
+  to: '+0987654321',
+  message: 'Hello TypeScript!',
 });
 ```
 
 ## Development
 
 ### Setup
+
 ```bash
 git clone https://github.com/unbound/sdk-js.git
 cd sdk-js
@@ -432,6 +449,7 @@ npm install
 ```
 
 ### Testing
+
 ```bash
 npm test                # Run all tests
 npm run test:unit       # Unit tests only
@@ -440,6 +458,7 @@ npm run test:watch      # Watch mode
 ```
 
 ### Building
+
 ```bash
 npm run build           # Build for production
 npm run lint            # Check code style
@@ -463,4 +482,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 📚 [Documentation](https://docs.unbound.cx/sdk)
 - 🐛 [Issue Tracker](https://github.com/unbound/sdk-js/issues)
 - 💬 [Community Forum](https://community.unbound.cx)
-- 📧 [Email Support](mailto:support@unbound.cx)
+- 📧 [Email Support](mailto:support@unbound.cx)

package/base.js

@@ -3,7 +3,7 @@
 
 /*
  * Base SDK Class with Transport Plugin System
- * 
+ *
  * Optional Dependencies:
  * - mime-types: For accurate MIME type detection (automatically imported if available)
  *
@@ -30,14 +30,14 @@ export class BaseSDK {
       this.token = token;
       this.fwRequestId = fwRequestId;
     }
-    
+
     this.transports = new Map();
     this._initializeEnvironment();
   }
 
   _initializeEnvironment() {
     const defaultDomain = 'api.unbound.cx';
-    
+
     if (typeof window === 'undefined') {
       // Server-side (Node.js)
       this.environment = 'node';
@@ -47,7 +47,8 @@ export class BaseSDK {
     } else {
       // Client-side (browser)
       this.environment = 'browser';
-      this.baseUrl = this.baseUrl || process?.env?.API_BASE_URL || defaultDomain;
+      this.baseUrl =
+        this.baseUrl || process?.env?.API_BASE_URL || defaultDomain;
       if (this.baseUrl && !this.baseUrl.startsWith('api.')) {
         this.baseUrl = `api.${this.baseUrl}`;
       }
@@ -62,7 +63,7 @@ export class BaseSDK {
   setNamespace(namespace) {
     this.namespace = namespace;
     const defaultDomain = 'api.unbound.cx';
-    
+
     if (this.environment === 'node') {
       this.baseURL = `https://${this.namespace ? this.namespace : 'login'}.${
         process.env?.API_BASE_URL || defaultDomain
@@ -76,13 +77,13 @@ export class BaseSDK {
     if (!transport || typeof transport.request !== 'function') {
       throw new Error('Transport must have a request method');
     }
-    
+
     const priority = transport.getPriority ? transport.getPriority() : 50;
     const name = transport.name || `transport_${Date.now()}`;
-    
+
     this.transports.set(name, {
       transport,
-      priority
+      priority,
     });
   }
 
@@ -96,16 +97,20 @@ export class BaseSDK {
     }
 
     // Sort transports by priority (lower number = higher priority)
-    const sortedTransports = Array.from(this.transports.values())
-      .sort((a, b) => a.priority - b.priority);
+    const sortedTransports = Array.from(this.transports.values()).sort(
+      (a, b) => a.priority - b.priority,
+    );
 
     for (const { transport } of sortedTransports) {
       try {
-        if (transport.isAvailable && await transport.isAvailable()) {
+        if (transport.isAvailable && (await transport.isAvailable())) {
           return transport;
         }
       } catch (err) {
-        console.debug(`Transport ${transport.name} not available:`, err.message);
+        console.debug(
+          `Transport ${transport.name} not available:`,
+          err.message,
+        );
         continue;
       }
     }
@@ -169,7 +174,10 @@ export class BaseSDK {
         });
         return result;
       } catch (err) {
-        console.warn(`Transport ${transport.name} failed, falling back to HTTP:`, err.message);
+        console.warn(
+          `Transport ${transport.name} failed, falling back to HTTP:`,
+          err.message,
+        );
         // Fall through to HTTP
       }
     }
@@ -180,7 +188,7 @@ export class BaseSDK {
 
   async _httpRequest(endpoint, method, params = {}) {
     const { body, query, headers = {} } = params;
-    
+
     const options = {
       method,
       headers: {
@@ -257,10 +265,10 @@ export class BaseSDK {
         statusText: response?.statusText,
       };
     }
-    
+
     console.log(
       `API :: https :: ${method} :: ${endpoint} :: ${responseRequestId}`,
     );
     return bodyResponse;
   }
-}
+}

package/index.js

@@ -35,35 +35,36 @@ class UnboundSDK extends BaseSDK {
       const fwRequestId = arguments[3];
       const url = arguments[4];
       const socketStore = arguments[5];
-      
+
       super({ namespace, callId, token, fwRequestId });
-      
+
       // Handle client-side specific parameters
       if (url) {
         this.baseUrl = url;
         this._initializeEnvironment();
       }
-      
+
       if (socketStore) {
         this.socketStore = socketStore;
       }
     } else {
       // New object-based parameters
-      const { namespace, callId, token, fwRequestId, url, socketStore } = options;
-      
+      const { namespace, callId, token, fwRequestId, url, socketStore } =
+        options;
+
       super({ namespace, callId, token, fwRequestId });
-      
+
       // Handle client-side specific parameters
       if (url) {
         this.baseUrl = url;
         this._initializeEnvironment();
       }
-      
+
       if (socketStore) {
         this.socketStore = socketStore;
       }
     }
-    
+
     // Initialize all service modules
     this.login = new LoginService(this);
     this.objects = new ObjectsService(this);
@@ -86,7 +87,7 @@ class UnboundSDK extends BaseSDK {
     this.phoneNumbers = new PhoneNumbersService(this);
     this.recordTypes = new RecordTypesService(this);
     this.generateId = new GenerateIdService(this);
-    
+
     // Add additional services that might be missing
     this._initializeAdditionalServices();
   }
@@ -112,10 +113,13 @@ class UnboundSDK extends BaseSDK {
     if (typeof extension === 'function') {
       // Extension is a class constructor
       const instance = new extension(this);
-      
+
       // Merge extension methods/properties into this SDK
       for (const key in instance) {
-        if (instance.hasOwnProperty(key) && typeof instance[key] !== 'undefined') {
+        if (
+          instance.hasOwnProperty(key) &&
+          typeof instance[key] !== 'undefined'
+        ) {
           this[key] = instance[key];
         }
       }
@@ -143,7 +147,9 @@ class UnboundSDK extends BaseSDK {
   async buildMasterAuth({ namespace, accountId, userId }) {
     // This method should only be available in Node.js environment
     // and will be added via internal SDK extension
-    throw new Error('buildMasterAuth is only available with the internal SDK extension. Please use: sdk.use(InternalExtension)');
+    throw new Error(
+      'buildMasterAuth is only available with the internal SDK extension. Please use: sdk.use(InternalExtension)',
+    );
   }
 }
 
@@ -175,7 +181,13 @@ export { SipEndpointsService } from './services/sipEndpoints.js';
 export { ExternalOAuthService } from './services/externalOAuth.js';
 export { GoogleCalendarService } from './services/googleCalendar.js';
 export { EnrollService } from './services/enroll.js';
-export { PhoneNumbersService, PhoneNumberCarrierService } from './services/phoneNumbers.js';
-export { RecordTypesService, UserRecordTypeDefaultsService } from './services/recordTypes.js';
+export {
+  PhoneNumbersService,
+  PhoneNumberCarrierService,
+} from './services/phoneNumbers.js';
+export {
+  RecordTypesService,
+  UserRecordTypeDefaultsService,
+} from './services/recordTypes.js';
 export { GenerateIdService } from './services/generateId.js';
-export { BaseSDK } from './base.js';
+export { BaseSDK } from './base.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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",
@@ -30,7 +30,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/unbound/sdk-js.git"
+    "url": "git+https://github.com/unbound/sdk-js.git"
   },
   "bugs": {
     "url": "https://github.com/unbound/sdk-js/issues"