@unboundcx/sdk-internal 1.0.0 → 1.0.1

package/README.md

@@ -16,6 +16,7 @@ npm install @unbound/sdk-internal
 ```
 
 **Requirements:**
+
 - `@unbound/sdk` ^1.0.0
 - Node.js environment (browser usage not supported)
 
@@ -30,17 +31,17 @@ import InternalSDK from '@unbound/sdk-internal';
 const api = new SDK({
   namespace: 'namespace',
   callId: 'call-id',
-  token: 'jwt-token'
+  token: 'jwt-token',
 });
 
 // Extend with internal functionality
 api.use(InternalSDK);
 
 // Now has access to internal methods
-await api.buildMasterAuth({ 
+await api.buildMasterAuth({
   namespace: 'target-namespace',
-  accountId: 'account-123', 
-  userId: 'user-456' 
+  accountId: 'account-123',
+  userId: 'user-456',
 });
 ```
 
@@ -65,9 +66,9 @@ Build master authentication tokens for cross-account access:
 
 ```javascript
 const token = await api.buildMasterAuth({
-  namespace: 'target-namespace',  // Target namespace
-  accountId: 'account-123',       // Target account ID
-  userId: 'user-456'             // Target user ID
+  namespace: 'target-namespace', // Target namespace
+  accountId: 'account-123', // Target account ID
+  userId: 'user-456', // Target user ID
 });
 
 // Token is automatically set on the SDK instance
@@ -79,26 +80,31 @@ console.log(api.token); // JWT token for the target account/user
 Administrative SIP functions for call routing and registration:
 
 #### Router
+
 ```javascript
 await api.internal.sip.router(
-  '+1234567890',    // to
-  '+0987654321',    // from  
-  'call-123',       // callId
-  { /* auth */ },   // auth object
-  'inbound'         // peerDirection
+  '+1234567890', // to
+  '+0987654321', // from
+  'call-123', // callId
+  {
+    /* auth */
+  }, // auth object
+  'inbound', // peerDirection
 );
 ```
 
 #### Server Management
+
 ```javascript
 const server = await api.internal.sip.getServer(
-  'voice',          // type
-  'us-east-1',      // regionCode
-  'call-123'        // callId
+  'voice', // type
+  'us-east-1', // regionCode
+  'call-123', // callId
 );
 ```
 
 #### Registration Management
+
 ```javascript
 // Register SIP endpoint
 await api.internal.sip.register({
@@ -113,7 +119,7 @@ await api.internal.sip.register({
   contact: 'sip:user@example.com',
   domain: 'sip.example.com',
   userAgent: 'Unbound-SIP/1.0',
-  expiresAt: Date.now() + 3600000 // 1 hour from now
+  expiresAt: Date.now() + 3600000, // 1 hour from now
 });
 
 // Unregister SIP endpoint
@@ -121,6 +127,7 @@ await api.internal.sip.unregister('call-123', 'user123', 'account-123');
 ```
 
 #### Authentication Validation
+
 ```javascript
 await api.internal.sip.validate({
   method: 'INVITE',
@@ -135,17 +142,20 @@ await api.internal.sip.validate({
   authType: 'digest',
   ip: '192.168.1.100',
   peerDirection: 'inbound',
-  location: 'us-east-1'
+  location: 'us-east-1',
 });
 ```
 
 #### Logging
+
 ```javascript
 await api.internal.sip.log({
   callId: 'call-123',
   level: 'info',
   message: 'Call established',
-  data: { /* additional data */ }
+  data: {
+    /* additional data */
+  },
 });
 ```
 
@@ -154,8 +164,9 @@ await api.internal.sip.log({
 This package is designed for **Node.js environments only** and will throw errors when used in browser environments. The internal APIs require server-side authentication and access patterns.
 
 ### Supported Environments
+
 - ✅ Node.js servers
-- ✅ AWS Lambda functions  
+- ✅ AWS Lambda functions
 - ✅ Docker containers
 - ✅ Kubernetes pods
 - ❌ Browser applications
@@ -164,16 +175,19 @@ This package is designed for **Node.js environments only** and will throw errors
 ## Security Considerations
 
 ### Access Control
+
 - All internal APIs require elevated authentication
 - Methods may bypass normal user permission checks
 - Use with extreme caution in production environments
 
 ### Authentication
+
 - Requires valid JWT tokens with administrative privileges
 - `buildMasterAuth` provides cross-account access capabilities
 - Always validate target accounts/users before authentication
 
 ### Network Security
+
 - Internal APIs may be accessible only from specific IP ranges
 - SIP functions interact with core telephony infrastructure
 - Audit all usage for security compliance
@@ -182,9 +196,9 @@ This package is designed for **Node.js environments only** and will throw errors
 
 ```javascript
 try {
-  await api.buildMasterAuth({ 
+  await api.buildMasterAuth({
     namespace: 'invalid-namespace',
-    accountId: 'invalid-account' 
+    accountId: 'invalid-account',
   });
 } catch (error) {
   if (error.message.includes('Master authentication failed')) {
@@ -198,6 +212,7 @@ try {
 ## Development
 
 ### Setup
+
 ```bash
 git clone https://github.com/unbound/sdk-js-internal.git
 cd sdk-js-internal
@@ -205,12 +220,14 @@ npm install
 ```
 
 ### Testing
+
 ```bash
 npm test              # Run tests
-npm run test:watch    # Watch mode  
+npm run test:watch    # Watch mode
 ```
 
 ### Building
+
 ```bash
 npm run build         # Build for production
 npm run lint          # Check code style
@@ -228,6 +245,7 @@ Internal package contributions require:
 ## Support
 
 For internal support:
+
 - 📧 [Internal Support](mailto:internal-support@unbound.cx)
 - 📚 [Internal Documentation](https://internal-docs.unbound.cx/sdk)
 - 🚨 [Security Issues](mailto:security@unbound.cx)
@@ -236,4 +254,4 @@ For internal support:
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-**Note**: While the code is MIT licensed, access to Unbound's internal APIs requires proper authentication and authorization.
+**Note**: While the code is MIT licensed, access to Unbound's internal APIs requires proper authentication and authorization.

package/index.js

@@ -8,8 +8,9 @@ import { InternalServersService } from './services/servers.js';
 import { InternalSocketService } from './services/socket.js';
 
 export class InternalSDK {
-  constructor(sdk) {
+  constructor(sdk, buildMasterApiAuthFn) {
     this.sdk = sdk;
+    this.buildMasterApiAuthFn = buildMasterApiAuthFn;
     this.sip = new InternalSipService(sdk);
     this.email = new InternalEmailService(sdk);
     this.programmableVoice = new InternalProgrammableVoiceService(sdk);
@@ -20,14 +21,25 @@ export class InternalSDK {
   // Master auth method - only available in Node.js
   async buildMasterAuth({ namespace, accountId, userId }) {
     if (typeof window !== 'undefined') {
-      throw new Error('buildMasterAuth is only available in Node.js environment');
+      throw new Error(
+        'buildMasterAuth is only available in Node.js environment',
+      );
     }
-    
-    const { buildMasterApiAuth } = await import('../src/utils/index.js');
+
+    if (!this.buildMasterApiAuthFn) {
+      throw new Error(
+        'buildMasterApiAuth function not provided to InternalSDK constructor',
+      );
+    }
+
     if (namespace) {
       this.sdk.setNamespace(namespace);
     }
-    const auth = await buildMasterApiAuth(this.sdk.namespace, accountId, userId);
+    const auth = await this.buildMasterApiAuthFn(
+      this.sdk.namespace,
+      accountId,
+      userId,
+    );
     if (auth?.token?.jwt) {
       this.sdk.token = auth.token.jwt;
     }
@@ -36,12 +48,12 @@ export class InternalSDK {
 }
 
 // Extension pattern for the main SDK
-export function install(sdk) {
-  const internal = new InternalSDK(sdk);
-  
+export function install(sdk, buildMasterApiAuthFn) {
+  const internal = new InternalSDK(sdk, buildMasterApiAuthFn);
+
   // Add buildMasterAuth to the main SDK instance
   sdk.buildMasterAuth = internal.buildMasterAuth.bind(internal);
-  
+
   // Add internal services
   sdk.internal = {
     sip: internal.sip,
@@ -58,6 +70,13 @@ export default { install };
 // Individual service exports
 export { InternalSipService } from './services/sip.js';
 export { InternalEmailService } from './services/email.js';
-export { InternalProgrammableVoiceService, VoiceChannelService, TranscriptionService } from './services/programmableVoice.js';
-export { InternalServersService, AwsServersService } from './services/servers.js';
-export { InternalSocketService } from './services/socket.js';
+export {
+  InternalProgrammableVoiceService,
+  VoiceChannelService,
+  TranscriptionService,
+} from './services/programmableVoice.js';
+export {
+  InternalServersService,
+  AwsServersService,
+} from './services/servers.js';
+export { InternalSocketService } from './services/socket.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk-internal",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Internal SDK extension for Unbound - Provides access to internal APIs and administrative functions",
   "main": "index.js",
   "type": "module",
@@ -47,7 +47,7 @@
   },
   "scripts": {
     "build": "echo 'Build complete - ESM modules ready'",
-    "test": "echo 'Tests would run here'", 
+    "test": "echo 'Tests would run here'",
     "lint": "echo 'Linting would run here'",
     "prepublishOnly": "npm run build"
   },
@@ -60,4 +60,4 @@
     "registry": "https://registry.npmjs.org/",
     "access": "restricted"
   }
-}
+}

package/services/email.js

@@ -59,4 +59,4 @@ export class InternalEmailService {
     );
     return result;
   }
-}
+}

package/services/programmableVoice.js

@@ -17,7 +17,11 @@ export class InternalProgrammableVoiceService {
       body: streamData,
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/streamProxy', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/streamProxy',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -33,7 +37,11 @@ export class InternalProgrammableVoiceService {
       body: webhookData,
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/proxy', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/proxy',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -61,7 +69,11 @@ export class InternalProgrammableVoiceService {
       },
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/setVariable', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/setVariable',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -87,7 +99,11 @@ export class InternalProgrammableVoiceService {
       },
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/getVariable', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/getVariable',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -101,7 +117,7 @@ export class InternalProgrammableVoiceService {
     loopCount,
     engagementSessionId,
     voiceChannelId,
-    serverId
+    serverId,
   }) {
     this.sdk.validateParams(
       { meetingId },
@@ -126,7 +142,8 @@ export class InternalProgrammableVoiceService {
     if (callerIdNumber) meetingData.callerIdNumber = callerIdNumber;
     if (channelId) meetingData.channelId = channelId;
     if (loopCount) meetingData.loopCount = loopCount;
-    if (engagementSessionId) meetingData.engagementSessionId = engagementSessionId;
+    if (engagementSessionId)
+      meetingData.engagementSessionId = engagementSessionId;
     if (voiceChannelId) meetingData.voiceChannelId = voiceChannelId;
     if (serverId) meetingData.serverId = serverId;
 
@@ -134,7 +151,11 @@ export class InternalProgrammableVoiceService {
       body: meetingData,
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/joinMeetingRoom', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/joinMeetingRoom',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -151,7 +172,11 @@ export class InternalProgrammableVoiceService {
       body: sessionData,
     };
 
-    const result = await this.sdk._fetch(`/internal/programmableVoice/${location}`, 'POST', params);
+    const result = await this.sdk._fetch(
+      `/internal/programmableVoice/${location}`,
+      'POST',
+      params,
+    );
     return result;
   }
 }
@@ -223,7 +248,11 @@ export class VoiceChannelService {
       },
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/voiceChannel', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/voiceChannel',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -293,7 +322,11 @@ export class VoiceChannelService {
       },
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/voiceChannel', 'PUT', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/voiceChannel',
+      'PUT',
+      params,
+    );
     return result;
   }
 }
@@ -311,7 +344,7 @@ export class TranscriptionService {
     direction,
     role,
     userId,
-    playbookId
+    playbookId,
   }) {
     this.sdk.validateParams(
       { voiceChannelId, engagementSessionId, accountId },
@@ -327,7 +360,11 @@ export class TranscriptionService {
       },
     );
 
-    const transcriptionData = { voiceChannelId, engagementSessionId, accountId };
+    const transcriptionData = {
+      voiceChannelId,
+      engagementSessionId,
+      accountId,
+    };
     if (name) transcriptionData.name = name;
     if (direction) transcriptionData.direction = direction;
     if (role) transcriptionData.role = role;
@@ -338,7 +375,11 @@ export class TranscriptionService {
       body: transcriptionData,
     };
 
-    const result = await this.sdk._fetch('/internal/programmableVoice/transcription/', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/programmableVoice/transcription/',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -355,7 +396,11 @@ export class TranscriptionService {
       body: completionData,
     };
 
-    const result = await this.sdk._fetch(`/internal/programmableVoice/transcription/${id}`, 'PUT', params);
+    const result = await this.sdk._fetch(
+      `/internal/programmableVoice/transcription/${id}`,
+      'PUT',
+      params,
+    );
     return result;
   }
 
@@ -372,7 +417,11 @@ export class TranscriptionService {
       body: messageData,
     };
 
-    const result = await this.sdk._fetch(`/internal/programmableVoice/transcription/${id}`, 'POST', params);
+    const result = await this.sdk._fetch(
+      `/internal/programmableVoice/transcription/${id}`,
+      'POST',
+      params,
+    );
     return result;
   }
-}
+}

package/services/servers.js

@@ -14,7 +14,7 @@ export class InternalServersService {
     podName,
     namespace,
     K8S_SERVICE_NAME,
-    K8S_DEPLOYMENT_TYPE
+    K8S_DEPLOYMENT_TYPE,
   }) {
     this.sdk.validateParams(
       { type, region },
@@ -40,7 +40,8 @@ export class InternalServersService {
     if (podName) serverData.podName = podName;
     if (namespace) serverData.namespace = namespace;
     if (K8S_SERVICE_NAME) serverData.K8S_SERVICE_NAME = K8S_SERVICE_NAME;
-    if (K8S_DEPLOYMENT_TYPE) serverData.K8S_DEPLOYMENT_TYPE = K8S_DEPLOYMENT_TYPE;
+    if (K8S_DEPLOYMENT_TYPE)
+      serverData.K8S_DEPLOYMENT_TYPE = K8S_DEPLOYMENT_TYPE;
 
     const params = {
       body: serverData,
@@ -63,9 +64,18 @@ export class InternalServersService {
 
     // Validate status if provided
     if (status) {
-      const validStatuses = ['booting', 'ready', 'maintenance', 'error', 'stopped', 'stopping'];
+      const validStatuses = [
+        'booting',
+        'ready',
+        'maintenance',
+        'error',
+        'stopped',
+        'stopping',
+      ];
       if (!validStatuses.includes(status)) {
-        throw new Error(`Invalid status. Must be one of: ${validStatuses.join(', ')}`);
+        throw new Error(
+          `Invalid status. Must be one of: ${validStatuses.join(', ')}`,
+        );
       }
     }
 
@@ -78,7 +88,11 @@ export class InternalServersService {
       body: updateData,
     };
 
-    const result = await this.sdk._fetch(`/internal/servers/${id}`, 'PUT', params);
+    const result = await this.sdk._fetch(
+      `/internal/servers/${id}`,
+      'PUT',
+      params,
+    );
     return result;
   }
 
@@ -102,7 +116,10 @@ export class InternalServersService {
       },
     );
 
-    const result = await this.sdk._fetch(`/internal/servers/${id}/shutdownCheck`, 'GET');
+    const result = await this.sdk._fetch(
+      `/internal/servers/${id}/shutdownCheck`,
+      'GET',
+    );
     return result;
   }
 }
@@ -124,7 +141,11 @@ export class AwsServersService {
       body: assignmentData,
     };
 
-    const result = await this.sdk._fetch('/internal/servers/aws/assignElasticIp', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/servers/aws/assignElasticIp',
+      'POST',
+      params,
+    );
     return result;
   }
-}
+}

package/services/sip.js

@@ -246,4 +246,4 @@ export class InternalSipService {
     );
     return result;
   }
-}
+}

package/services/socket.js

@@ -13,7 +13,7 @@ export class InternalSocketService {
     serverId,
     clientIp,
     clientOs,
-    clientBrowser
+    clientBrowser,
   }) {
     this.sdk.validateParams(
       { socketId, accountCode, accountId, serverId },
@@ -43,7 +43,11 @@ export class InternalSocketService {
       body: connectionData,
     };
 
-    const result = await this.sdk._fetch('/internal/socket/connection', 'POST', params);
+    const result = await this.sdk._fetch(
+      '/internal/socket/connection',
+      'POST',
+      params,
+    );
     return result;
   }
 
@@ -69,7 +73,11 @@ export class InternalSocketService {
       body: updateData,
     };
 
-    const result = await this.sdk._fetch(`/internal/socket/connection/${id}`, 'PUT', params);
+    const result = await this.sdk._fetch(
+      `/internal/socket/connection/${id}`,
+      'PUT',
+      params,
+    );
     return result;
   }
 
@@ -81,7 +89,10 @@ export class InternalSocketService {
       },
     );
 
-    const result = await this.sdk._fetch(`/internal/socket/connection/${id}`, 'DELETE');
+    const result = await this.sdk._fetch(
+      `/internal/socket/connection/${id}`,
+      'DELETE',
+    );
     return result;
   }
 
@@ -97,7 +108,11 @@ export class InternalSocketService {
       body: { serverId },
     };
 
-    const result = await this.sdk._fetch('/internal/socket/connection/byServerId', 'DELETE', params);
+    const result = await this.sdk._fetch(
+      '/internal/socket/connection/byServerId',
+      'DELETE',
+      params,
+    );
     return result;
   }
-}
+}