@unboundcx/sdk-internal 2.2.0 → 2.3.0

package/index.js

@@ -9,6 +9,9 @@ import { InternalSocketService } from './services/socket.js';
 import { InternalMasterAuthService } from './services/masterAuth.js';
 import { InternalBrandingService } from './services/branding.js';
 import { InternalPhoneNumbersService } from './services/phoneNumbers.js';
+import { InternalVideoService } from './services/video.js';
+import { InternalVoicemailService } from './services/voicemail.js';
+import { InternalVoiceService } from './services/voice.js';
 import { buildObjectEventV2 } from './utils/buildObjectEventV2.js';
 
 export class InternalSDK {
@@ -25,6 +28,9 @@ export class InternalSDK {
     this.masterAuth = new InternalMasterAuthService(sdk);
     this.branding = new InternalBrandingService(sdk);
     this.phoneNumbers = new InternalPhoneNumbersService(sdk);
+    this.video = new InternalVideoService(sdk);
+    this.voicemail = new InternalVoicemailService(sdk);
+    this.voice = new InternalVoiceService(sdk);
 
     // Proxy all base SDK properties and methods
     this._proxyBaseSDK();
@@ -98,6 +104,34 @@ export class InternalSDK {
     }
     return this.sdk.token;
   }
+
+  /**
+   * Governed escape hatch for internal routes reached by path-as-data
+   * mechanisms (e.g. a voice-app webhook command that carries its target
+   * `url` at runtime), where a typed per-route method isn't possible
+   * because the caller doesn't know the route ahead of time. This is the
+   * ONLY sanctioned way to hit an internal route this way — if you know
+   * the route at write time, add (or use) a typed method on the matching
+   * service instead of calling this directly.
+   *
+   * @param {string} path - Must start with '/internal/'.
+   * @param {object} body
+   * @param {object} [options]
+   * @param {number} [options.timeoutMs]
+   */
+  async post(path, body, { timeoutMs } = {}) {
+    if (typeof path !== 'string' || !path.startsWith('/internal/')) {
+      throw new Error(
+        `InternalSDK.post: path must be a string starting with '/internal/', got: ${path}`,
+      );
+    }
+
+    const params = { body };
+    if (timeoutMs) params.timeoutMs = timeoutMs;
+
+    const result = await this.sdk._fetch(path, 'POST', params);
+    return result;
+  }
 }
 
 // Extension pattern for the main SDK
@@ -127,4 +161,7 @@ export { InternalSocketService } from './services/socket.js';
 export { InternalMasterAuthService } from './services/masterAuth.js';
 export { InternalBrandingService } from './services/branding.js';
 export { InternalPhoneNumbersService } from './services/phoneNumbers.js';
+export { InternalVideoService } from './services/video.js';
+export { InternalVoicemailService } from './services/voicemail.js';
+export { InternalVoiceService } from './services/voice.js';
 export { buildObjectEventV2 } from './utils/buildObjectEventV2.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk-internal",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Internal SDK extension for Unbound - Provides access to internal APIs and administrative functions",
   "main": "index.js",
   "type": "module",

package/services/video.js

@@ -0,0 +1,111 @@
+export class InternalVideoService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Meet PSTN bridge join (D2/D3/D10). Called by media-manager's `webhook`
+   * v2 command from the meetDialIn app once the caller has DTMF'd a
+   * meetingId + PIN. Matches
+   * app1-api/src/services/INTERNAL/video/controllers/meetJoin.js.
+   *
+   * POST /internal/video/meetJoin
+   * Body: { callId, from, variables: { meetingId, meetingPin, attempt? } }
+   */
+  async meetJoin({ callId, from, variables }) {
+    this.sdk.validateParams(
+      { callId },
+      {
+        callId: { type: 'string', required: true },
+        from: { type: 'string', required: false },
+        variables: { type: 'object', required: false },
+      },
+    );
+
+    const body = { callId };
+    if (from) body.from = from;
+    if (variables) body.variables = variables;
+
+    const params = {
+      body,
+    };
+
+    const result = await this.sdk._fetch(
+      '/internal/video/meetJoin',
+      'POST',
+      params,
+    );
+    return result;
+  }
+
+  /**
+   * Meet PSTN bridge D9 (phone-hangs-up teardown). POST when a callId ==
+   * sipCallId leg observed on an active Meet participant ends. Matches
+   * app1-api/src/services/INTERNAL/video/controllers/meetCallEnded.js.
+   *
+   * POST /internal/video/meetCallEnded
+   * Body: { sipCallId, accountId }
+   */
+  async meetCallEnded({ sipCallId, accountId }) {
+    this.sdk.validateParams(
+      { sipCallId, accountId },
+      {
+        sipCallId: { type: 'string', required: true },
+        accountId: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: { sipCallId, accountId },
+    };
+
+    const result = await this.sdk._fetch(
+      '/internal/video/meetCallEnded',
+      'POST',
+      params,
+    );
+    return result;
+  }
+
+  /**
+   * Meet PSTN bridge dial-out status callback. media-manager's
+   * DialEventHandler posts here (fire-and-forget) for pre-answer progress
+   * ('trying' | 'ringing' | 'answered') and terminal 'failed' outcomes on a
+   * standalone-outbound leg placed via placeOutboundCall's statusWebhook.
+   * Matches
+   * app1-api/src/services/INTERNAL/video/controllers/meetOutboundStatus.js.
+   *
+   * The api controller is intentionally tolerant of unknown/extra fields
+   * (it only requires participantId, roomId, event), so this method passes
+   * the payload through as-is rather than enumerating every static field —
+   * add a typed field here if a fixed shape solidifies.
+   *
+   * POST /internal/video/meetOutboundStatus
+   * Body: { event, callId, requestId, participantId, roomId, reason? }
+   */
+  async meetOutboundStatus(payload) {
+    this.sdk.validateParams(
+      { payload },
+      {
+        payload: { type: 'object', required: true },
+      },
+    );
+    const { event, participantId, roomId } = payload || {};
+    if (!event || !participantId || !roomId) {
+      throw new Error(
+        'meetOutboundStatus requires event, participantId, and roomId.',
+      );
+    }
+
+    const params = {
+      body: payload,
+    };
+
+    const result = await this.sdk._fetch(
+      '/internal/video/meetOutboundStatus',
+      'POST',
+      params,
+    );
+    return result;
+  }
+}

package/services/voice.js

@@ -0,0 +1,39 @@
+export class InternalVoiceService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Bulk write endpoint for the CDR discrete-event timeline (WP6.5).
+   * Emitters (sip-processor / media-manager / task-router) call this to
+   * report events; fire-and-forget semantics are the CALLER's job, not
+   * this method's. Matches
+   * app1-api/src/services/INTERNAL/voice/controllers/createCdrEvents.js.
+   *
+   * POST /internal/voice/cdrEvents
+   * Body: {
+   *   accountId,
+   *   events: [{ cdrId, sipCallId?, eventType, ts, actorType, actorId?, data? }]
+   * } -- max 50 events per request (enforced by the api).
+   */
+  async createCdrEvents({ accountId, events }) {
+    this.sdk.validateParams(
+      { accountId, events },
+      {
+        accountId: { type: 'string', required: true },
+        events: { type: 'array', required: true },
+      },
+    );
+
+    const params = {
+      body: { accountId, events },
+    };
+
+    const result = await this.sdk._fetch(
+      '/internal/voice/cdrEvents',
+      'POST',
+      params,
+    );
+    return result;
+  }
+}

package/services/voicemail.js

@@ -0,0 +1,47 @@
+export class InternalVoicemailService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * app1-transcription reports the result of a batch voicemail
+   * transcription here after POST /transcription/voicemail finishes
+   * (success or failure). Matches
+   * app1-api/src/services/INTERNAL/voicemail/controllers/transcriptionComplete.js.
+   *
+   * POST /internal/voicemail/transcription
+   * Body: { accountId, voicemailMessageId, transcription, transcriptionStatus }
+   */
+  async transcriptionComplete({
+    accountId,
+    voicemailMessageId,
+    transcription,
+    transcriptionStatus,
+  }) {
+    this.sdk.validateParams(
+      { accountId, voicemailMessageId, transcriptionStatus },
+      {
+        accountId: { type: 'string', required: true },
+        voicemailMessageId: { type: 'string', required: true },
+        transcription: { type: 'string', required: false },
+        transcriptionStatus: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: {
+        accountId,
+        voicemailMessageId,
+        transcription,
+        transcriptionStatus,
+      },
+    };
+
+    const result = await this.sdk._fetch(
+      '/internal/voicemail/transcription',
+      'POST',
+      params,
+    );
+    return result;
+  }
+}