voice-router-dev 0.8.2 → 0.8.3

package/dist/index.js

@@ -234,6 +234,9 @@ __export(src_exports, {
   transcriptionsGet: () => transcriptionsGet,
   transcriptionsList: () => transcriptionsList,
   transcriptionsListFiles: () => transcriptionsListFiles,
+  webHooksCreate: () => webHooksCreate,
+  webHooksDelete: () => webHooksDelete,
+  webHooksList: () => webHooksList,
   zodToFieldConfigs: () => zodToFieldConfigs
 });
 module.exports = __toCommonJS(src_exports);
@@ -2922,6 +2925,12 @@ var ERROR_CODES = {
   CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT",
   /** Invalid input provided to API */
   INVALID_INPUT: "INVALID_INPUT",
+  /** Authentication failed (invalid or missing API key) */
+  AUTHENTICATION_ERROR: "AUTHENTICATION_ERROR",
+  /** Rate limit exceeded */
+  RATE_LIMIT: "RATE_LIMIT",
+  /** Provider server error (5xx) */
+  SERVER_ERROR: "SERVER_ERROR",
   /** Requested operation not supported by provider */
   NOT_SUPPORTED: "NOT_SUPPORTED",
   /** No transcription results available */
@@ -2936,6 +2945,9 @@ var ERROR_MESSAGES = {
   TRANSCRIPTION_ERROR: "Transcription processing failed",
   CONNECTION_TIMEOUT: "Connection attempt timed out",
   INVALID_INPUT: "Invalid input provided",
+  AUTHENTICATION_ERROR: "Authentication failed (invalid or missing API key)",
+  RATE_LIMIT: "Rate limit exceeded",
+  SERVER_ERROR: "Provider server error",
   NOT_SUPPORTED: "Operation not supported by this provider",
   NO_RESULTS: "No transcription results available",
   UNKNOWN_ERROR: "An unknown error occurred"
@@ -2947,6 +2959,36 @@ function createError(code, customMessage, details) {
     details
   };
 }
+function httpStatusToErrorCode(status) {
+  switch (status) {
+    case 400:
+    case 404:
+    case 422:
+      return ERROR_CODES.INVALID_INPUT;
+    case 401:
+    case 403:
+      return ERROR_CODES.AUTHENTICATION_ERROR;
+    case 408:
+      return ERROR_CODES.CONNECTION_TIMEOUT;
+    case 429:
+      return ERROR_CODES.RATE_LIMIT;
+    default:
+      if (status >= 500) return ERROR_CODES.SERVER_ERROR;
+      return ERROR_CODES.UNKNOWN_ERROR;
+  }
+}
+function extractProviderMessage(data) {
+  if (!data || typeof data !== "object") {
+    return typeof data === "string" ? data : void 0;
+  }
+  const d = data;
+  if (d.error && typeof d.error === "object" && d.error.message) return String(d.error.message);
+  if (typeof d.error === "string") return d.error;
+  if (d.detail && typeof d.detail === "object" && d.detail.message) return String(d.detail.message);
+  if (typeof d.message === "string") return d.message;
+  if (typeof d.err_msg === "string") return d.err_msg;
+  return void 0;
+}
 
 // src/adapters/base-adapter.ts
 var BaseAdapter = class {
@@ -2965,12 +3007,15 @@ var BaseAdapter = class {
     const httpStatus = statusCode || err.statusCode || err.response?.status;
     const httpStatusText = err.response?.statusText;
     const responseData = err.response?.data;
+    const errorCode = code || (httpStatus ? httpStatusToErrorCode(httpStatus) : void 0) || ERROR_CODES.UNKNOWN_ERROR;
+    const providerMessage = extractProviderMessage(responseData);
+    const message = providerMessage || err.message || "An unknown error occurred";
     return {
       success: false,
       provider: this.name,
       error: {
-        code: code || err.code || ERROR_CODES.UNKNOWN_ERROR,
-        message: err.message || "An unknown error occurred",
+        code: errorCode,
+        message,
         statusCode: httpStatus,
         details: {
           // Include full error object
@@ -5611,14 +5656,61 @@ var AssemblyAIAdapter = class extends BaseAdapter {
     this.wsBaseUrl = "wss://streaming.assemblyai.com/v3/ws";
   }
   // v3 Universal Streaming endpoint
+  /**
+   * Get regional hosts for AssemblyAI
+   *
+   * @param region - Regional endpoint identifier
+   * @returns Object with api and streaming hosts
+   */
+  getRegionalHosts(region) {
+    if (region === "eu") {
+      return { api: "api.eu.assemblyai.com", streaming: "streaming.eu.assemblyai.com" };
+    }
+    return { api: "api.assemblyai.com", streaming: "streaming.assemblyai.com" };
+  }
   initialize(config) {
     super.initialize(config);
-    if (config.wsBaseUrl) {
-      this.wsBaseUrl = config.wsBaseUrl;
-    } else if (config.baseUrl) {
-      this.wsBaseUrl = `${this.deriveWsUrl(config.baseUrl)}/v3/ws`;
+    const hosts = this.getRegionalHosts(config.region);
+    this.baseUrl = config.baseUrl || `https://${hosts.api}`;
+    this.wsBaseUrl = config.wsBaseUrl || (config.baseUrl ? `${this.deriveWsUrl(config.baseUrl)}/v3/ws` : `wss://${hosts.streaming}/v3/ws`);
+  }
+  /**
+   * Change the regional endpoint dynamically
+   *
+   * Useful for switching between US and EU endpoints without reinitializing.
+   * Affects both REST API and WebSocket streaming endpoints.
+   *
+   * @param region - New regional endpoint to use (`us` or `eu`)
+   *
+   * @example Switch to EU region
+   * ```typescript
+   * import { AssemblyAIRegion } from 'voice-router-dev/constants'
+   *
+   * adapter.setRegion(AssemblyAIRegion.eu)
+   * await adapter.transcribe(audio) // Uses EU endpoint
+   * ```
+   */
+  setRegion(region) {
+    this.validateConfig();
+    if (!this.config.baseUrl) {
+      const hosts = this.getRegionalHosts(region);
+      this.baseUrl = `https://${hosts.api}`;
+      if (!this.config.wsBaseUrl) {
+        this.wsBaseUrl = `wss://${hosts.streaming}/v3/ws`;
+      }
     }
   }
+  /**
+   * Get the current regional endpoints being used
+   *
+   * @returns Object with current API and WebSocket URLs
+   */
+  getRegion() {
+    return {
+      api: this.baseUrl,
+      websocket: this.wsBaseUrl
+    };
+  }
   /**
    * Get axios config for generated API client functions
    * Configures headers and base URL using authorization header
@@ -7676,6 +7768,18 @@ var transcriptionsListFiles = (id, params, options) => {
     params: { ...params, ...options?.params }
   });
 };
+var webHooksList = (params, options) => {
+  return import_axios4.default.get(`/webhooks`, {
+    ...options,
+    params: { ...params, ...options?.params }
+  });
+};
+var webHooksCreate = (webHook, options) => {
+  return import_axios4.default.post(`/webhooks`, webHook, options);
+};
+var webHooksDelete = (id, options) => {
+  return import_axios4.default.delete(`/webhooks/${id}`, options);
+};
 
 // src/adapters/azure-stt-adapter.ts
 var AzureSTTAdapter = class extends BaseAdapter {
@@ -7748,19 +7852,8 @@ var AzureSTTAdapter = class extends BaseAdapter {
         this.getAxiosConfig()
       );
       const transcription = response.data;
-      return {
-        success: true,
-        provider: this.name,
-        data: {
-          id: transcription.self?.split("/").pop() || "",
-          text: "",
-          // Will be populated after polling
-          status: this.normalizeStatus(transcription.status),
-          language: transcription.locale,
-          createdAt: transcription.createdDateTime
-        },
-        raw: transcription
-      };
+      const transcriptId = transcription.self?.split("/").pop() || "";
+      return await this.pollForCompletion(transcriptId);
     } catch (error) {
       return this.createErrorResponse(error);
     }
@@ -7918,6 +8011,50 @@ var AzureSTTAdapter = class extends BaseAdapter {
       };
     }
   }
+  /**
+   * Register a subscription-wide webhook for transcription events
+   *
+   * Azure webhooks are subscription-wide (not per-transcription).
+   * Call this once during setup to receive callbacks for all transcription events.
+   * The webhook URL will receive POST requests for transcription lifecycle events.
+   *
+   * @param url - The webhook URL to receive events
+   * @param options - Optional: event filters and display name
+   * @returns Created webhook object
+   */
+  async registerWebhook(url, options) {
+    this.validateConfig();
+    const webhook = {
+      webUrl: url,
+      displayName: options?.displayName || "SDK Webhook",
+      events: options?.events || {
+        transcriptionCreation: true,
+        transcriptionProcessing: true,
+        transcriptionCompletion: true
+      }
+    };
+    const response = await webHooksCreate(webhook, this.getAxiosConfig());
+    return response.data;
+  }
+  /**
+   * Unregister a subscription-wide webhook by ID
+   *
+   * @param webhookId - The webhook ID to delete
+   */
+  async unregisterWebhook(webhookId) {
+    this.validateConfig();
+    await webHooksDelete(webhookId, this.getAxiosConfig());
+  }
+  /**
+   * List all registered webhooks for the subscription
+   *
+   * @returns Array of registered webhooks
+   */
+  async listWebhooks() {
+    this.validateConfig();
+    const response = await webHooksList(void 0, this.getAxiosConfig());
+    return [...response.data.values || []];
+  }
   /**
    * Map unified status to Azure status format using generated enum
    */
@@ -8674,6 +8811,20 @@ function createOpenAIWhisperAdapter(config) {
 // src/adapters/speechmatics-adapter.ts
 var import_axios8 = __toESM(require("axios"));
 
+// src/generated/speechmatics/schema/notificationConfigContentsItem.ts
+var NotificationConfigContentsItem = {
+  jobinfo: "jobinfo",
+  transcript: "transcript",
+  "transcriptjson-v2": "transcript.json-v2",
+  transcripttxt: "transcript.txt",
+  transcriptsrt: "transcript.srt",
+  alignment: "alignment",
+  alignmentword_start_and_end: "alignment.word_start_and_end",
+  alignmentone_per_line: "alignment.one_per_line",
+  data: "data",
+  text: "text"
+};
+
 // src/generated/speechmatics/schema/transcriptionConfigDiarization.ts
 var TranscriptionConfigDiarization = {
   none: "none",
@@ -8830,6 +8981,14 @@ var SpeechmaticsAdapter = class extends BaseAdapter {
           content: word
         }));
       }
+      if (options?.webhookUrl) {
+        jobConfig.notification_config = [
+          {
+            url: options.webhookUrl,
+            contents: [NotificationConfigContentsItem.transcript]
+          }
+        ];
+      }
       let requestBody;
       let headers = {};
       if (audio.type === "url") {
@@ -8855,16 +9014,20 @@ var SpeechmaticsAdapter = class extends BaseAdapter {
         };
       }
       const response = await this.client.post("/jobs", requestBody, { headers });
-      return {
-        success: true,
-        provider: this.name,
-        data: {
-          id: response.data.id,
-          text: "",
-          status: "queued"
-        },
-        raw: response.data
-      };
+      const jobId = response.data.id;
+      if (options?.webhookUrl) {
+        return {
+          success: true,
+          provider: this.name,
+          data: {
+            id: jobId,
+            text: "",
+            status: "queued"
+          },
+          raw: response.data
+        };
+      }
+      return await this.pollForCompletion(jobId);
     } catch (error) {
       return this.createErrorResponse(error);
     }
@@ -32165,7 +32328,7 @@ var createRealtimeClientSecretBody = import_zod6.z.object({
           format: import_zod6.z.discriminatedUnion("type", [
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-              rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+              rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
             }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -32264,7 +32427,7 @@ var createRealtimeClientSecretBody = import_zod6.z.object({
           format: import_zod6.z.discriminatedUnion("type", [
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-              rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+              rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
             }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -32474,7 +32637,7 @@ var createRealtimeClientSecretBody = import_zod6.z.object({
           format: import_zod6.z.discriminatedUnion("type", [
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-              rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+              rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
             }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -32644,7 +32807,7 @@ var createRealtimeClientSecretResponse = import_zod6.z.object({
           format: import_zod6.z.discriminatedUnion("type", [
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-              rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+              rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
             }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -32743,7 +32906,7 @@ var createRealtimeClientSecretResponse = import_zod6.z.object({
           format: import_zod6.z.discriminatedUnion("type", [
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-              rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+              rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
             }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -32962,7 +33125,7 @@ var createRealtimeClientSecretResponse = import_zod6.z.object({
           format: import_zod6.z.discriminatedUnion("type", [
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-              rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+              rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
             }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
             import_zod6.z.object({
               type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -33191,7 +33354,7 @@ var createRealtimeSessionResponse = import_zod6.z.object({
       format: import_zod6.z.discriminatedUnion("type", [
         import_zod6.z.object({
           type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-          rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+          rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
         }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
         import_zod6.z.object({
           type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -33235,7 +33398,7 @@ var createRealtimeSessionResponse = import_zod6.z.object({
       format: import_zod6.z.discriminatedUnion("type", [
         import_zod6.z.object({
           type: import_zod6.z.enum(["audio/pcm"]).describe("The audio format. Always `audio/pcm`."),
-          rate: import_zod6.z.literal(24e3).optional().describe("The sample rate of the audio. Always `24000`.")
+          rate: import_zod6.z.literal(24e3).describe("The sample rate of the audio. Always `24000`.")
         }).describe("The PCM audio format. Only a 24kHz sample rate is supported."),
         import_zod6.z.object({
           type: import_zod6.z.enum(["audio/pcmu"]).describe("The audio format. Always `audio/pcmu`.")
@@ -38333,20 +38496,6 @@ var LanguagePackInfoWritingDirection = {
   "right-to-left": "right-to-left"
 };
 
-// src/generated/speechmatics/schema/notificationConfigContentsItem.ts
-var NotificationConfigContentsItem = {
-  jobinfo: "jobinfo",
-  transcript: "transcript",
-  "transcriptjson-v2": "transcript.json-v2",
-  transcripttxt: "transcript.txt",
-  transcriptsrt: "transcript.srt",
-  alignment: "alignment",
-  alignmentword_start_and_end: "alignment.word_start_and_end",
-  alignmentone_per_line: "alignment.one_per_line",
-  data: "data",
-  text: "text"
-};
-
 // src/generated/speechmatics/schema/notificationConfigMethod.ts
 var NotificationConfigMethod = {
   post: "post",
@@ -40279,6 +40428,9 @@ var deleteTranscriptByIdResponse = import_zod13.z.any();
   transcriptionsGet,
   transcriptionsList,
   transcriptionsListFiles,
+  webHooksCreate,
+  webHooksDelete,
+  webHooksList,
   zodToFieldConfigs
 });
 //# sourceMappingURL=index.js.map