@unboundcx/sdk 4.8.4 → 4.8.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.8.4",
+  "version": "4.8.6",
   "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",

package/services/ai.js

@@ -642,6 +642,32 @@ export class SpeechToTextService {
     return result;
   }
 
+  /**
+   * Synchronously transcribe a stored audio file (batch STT).
+   * Counterpart to stream(): give it a storage file id, get the transcript
+   * back in the response (typically ~1-3s for voicemail-length audio).
+   *
+   * @param {Object} options
+   * @param {string} options.storageId - Storage file id of the audio (WAV by default).
+   * @param {string} [options.language] - Language hint (default 'en').
+   * @param {string} [options.encoding] - Audio encoding (default 'WAV').
+   * @returns {Promise<{transcription: string|null, language: string|null, duration: number|null}>}
+   */
+  async file({ storageId, language, encoding } = {}) {
+    this.sdk.validateParams(
+      { storageId, language, encoding },
+      {
+        storageId: { type: 'string', required: true },
+        language: { type: 'string', required: false },
+        encoding: { type: 'string', required: false },
+      },
+    );
+    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 });
+  }
+
   /**
    * Create a real-time streaming transcription session
    * Returns an EventEmitter-based stream for sending audio and receiving transcripts

package/services/inbox.js

@@ -91,4 +91,24 @@ export class InboxService {
     const result = await this.sdk._fetch('/inbox/stats', 'GET');
     return result;
   }
+
+  /**
+   * Trigger transcription for a voicemail that has a recording but no
+   * transcript (fire-and-forget server-side; poll the record for the
+   * resulting `transcription` / `transcriptionStatus`).
+   *
+   * @param {string} voicemailMessageId
+   * @returns {Promise<{accepted?: boolean, skipped?: boolean}>}
+   */
+  async transcribeVoicemail(voicemailMessageId) {
+    this.sdk.validateParams(
+      { voicemailMessageId },
+      { voicemailMessageId: { type: 'string', required: true } },
+    );
+    return await this.sdk._fetch(
+      `/inbox/voicemail/${voicemailMessageId}/transcribe`,
+      'POST',
+      { body: {} },
+    );
+  }
 }