@unboundcx/sdk 1.0.0 → 1.0.1

package/README.md

@@ -20,7 +20,7 @@ The official JavaScript SDK for Unbound's comprehensive communication and AI pla
 ## Installation
 
 ```bash
-npm install @unbound/sdk
+npm install @unboundcx/sdk
 ```
 
 ### Optional Dependencies
@@ -40,7 +40,7 @@ npm install mime-types
 ### Basic Usage
 
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
 
 // Initialize the SDK
 const api = new SDK({
@@ -48,7 +48,7 @@ const api = new SDK({
   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)
@@ -72,13 +72,16 @@ const meeting = await api.video.createRoom({
 ### Client-Side Usage (Browser/Svelte)
 
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
 import { socketAppStore } from './stores/socket.js';
 
-// Initialize with socket transport for optimal performance  
-const api = new SDK('your-namespace', null, null, null, 'api.yourdomain.com', socketAppStore);
+// Initialize for browser usage
+const api = new SDK({
+  namespace: 'your-namespace',
+  socketStore: socketAppStore  // Optional: for optimized WebSocket transport
+});
 
-// The SDK will automatically use WebSocket when available, HTTP as fallback
+// The SDK automatically connects to your-namespace.api.unbound.cx
 const objects = await api.objects.query('contacts', { 
   limit: 10,
   orderBy: 'createdAt'
@@ -88,19 +91,16 @@ const objects = await api.objects.query('contacts', {
 ### Server-Side Usage (Node.js)
 
 ```javascript
-import SDK from '@unbound/sdk';
-
-// Initialize for server-side usage
-const api = new SDK('your-namespace', 'call-id', 'jwt-token', 'request-id');
+import SDK from '@unboundcx/sdk';
 
-// Server-side exclusive: Master authentication
-await api.buildMasterAuth({
-  namespace: 'target-namespace',
-  accountId: 'account-123',
-  userId: 'user-456'
+// Initialize for server-side usage  
+const api = new SDK({
+  namespace: 'your-namespace',
+  token: 'jwt-token',
+  callId: 'call-id'          // Optional: for request tracking
 });
 
-// Use NATS transport automatically when available
+// Automatically connects to your-namespace.api.unbound.cx
 const result = await api.objects.create('leads', {
   name: 'John Doe',
   email: 'john@example.com',
@@ -116,12 +116,11 @@ The SDK constructor supports both object-based and legacy positional parameters:
 
 ```javascript
 const api = new SDK({
-  namespace: 'your-namespace',    // Required: API namespace
+  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
-  url: 'api.example.com',         // Optional: Custom API URL (browser only)
-  socketStore: socketAppStore     // Optional: Socket.io store (Svelte/browser)
+  socketStore: socketAppStore     // Optional: Socket.io store (browser only)
 });
 ```
 
@@ -132,16 +131,14 @@ const api = new SDK(
   'your-namespace',    // namespace
   'call-123',          // callId  
   'jwt-token',         // token
-  'request-456',       // fwRequestId
-  'api.example.com',   // url (browser only)
-  socketAppStore       // socketStore (browser only)
+  'request-456'        // fwRequestId
 );
 ```
 
 ### Factory Function
 
 ```javascript
-import { createSDK } from '@unbound/sdk';
+import { createSDK } from '@unboundcx/sdk';
 
 const api = createSDK({
   namespace: 'your-namespace',
@@ -318,7 +315,7 @@ The SDK automatically optimizes transport based on environment:
 ### Custom Transports
 
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
 
 class CustomTransport {
   constructor(config) {
@@ -338,47 +335,60 @@ class CustomTransport {
   }
 }
 
-const api = new SDK('namespace', null, 'token');
+const api = new SDK({ namespace: 'namespace', token: 'token' });
 api.addTransport(new CustomTransport({}));
 ```
 
 ## Extensions
 
-### Internal SDK (Server-side only)
+### Custom Extensions
 
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
+
+const api = new SDK({ namespace: 'namespace' });
 
-const api = new SDK('namespace');
+// Add custom functionality via extensions
+api.extend({
+  customMethod: function() {
+    return this.objects.query('custom', {});
+  }
+});
 
-// Now has access to internal APIs
-await api.buildMasterAuth({ accountId: '123', userId: '456' });
-await api.internal.sip.router('+1234567890', '+0987654321');
+// Use custom method
+await api.customMethod();
 ```
 
 ## Environment Support
 
 ### Node.js
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
 
 // Automatic environment detection
-const api = new SDK(process.env.UNBOUND_NAMESPACE);
+const api = new SDK({ namespace: process.env.UNBOUND_NAMESPACE });
 ```
 
 ### Browser/Webpack
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
 
-const api = new SDK('namespace', null, null, null, 'api.yourdomain.com');
+const api = new SDK({
+  namespace: 'your-namespace'
+});
+// Automatically connects to your-namespace.api.unbound.cx
 ```
 
 ### Svelte
 ```javascript
-import SDK from '@unbound/sdk';
+import SDK from '@unboundcx/sdk';
 import { socketAppStore } from '$lib/stores/socket.js';
 
-const api = new SDK('namespace', null, null, null, 'api.yourdomain.com', socketAppStore);
+const api = new SDK({
+  namespace: 'your-namespace',
+  socketStore: socketAppStore  // Enables WebSocket transport
+});
+// Automatically connects to your-namespace.api.unbound.cx
 ```
 
 ## Error Handling
@@ -400,9 +410,9 @@ try {
 The SDK includes TypeScript definitions:
 
 ```typescript
-import SDK, { MessagingService, VideoService } from '@unbound/sdk';
+import SDK, { MessagingService, VideoService } from '@unboundcx/sdk';
 
-const api: SDK = new SDK('namespace', null, 'token');
+const api: SDK = new SDK({ namespace: 'namespace', token: 'token' });
 
 // Full type safety
 const sms: any = await api.messaging.sms.send({

package/base.js

@@ -36,16 +36,18 @@ export class BaseSDK {
   }
 
   _initializeEnvironment() {
+    const defaultDomain = 'api.unbound.cx';
+    
     if (typeof window === 'undefined') {
       // Server-side (Node.js)
       this.environment = 'node';
       this.baseURL = `https://${this.namespace ? this.namespace : 'login'}.${
-        process.env?.API_BASE_URL
+        process.env?.API_BASE_URL || defaultDomain
       }`;
     } else {
       // Client-side (browser)
       this.environment = 'browser';
-      this.baseUrl = this.baseUrl || process?.env?.API_BASE_URL;
+      this.baseUrl = this.baseUrl || process?.env?.API_BASE_URL || defaultDomain;
       if (this.baseUrl && !this.baseUrl.startsWith('api.')) {
         this.baseUrl = `api.${this.baseUrl}`;
       }
@@ -59,10 +61,11 @@ 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
+        process.env?.API_BASE_URL || defaultDomain
       }`;
     } else {
       this.fullUrl = `https://${this.namespace}.${this.baseUrl}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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",
@@ -85,4 +85,4 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   }
-}
+}