voice-router-dev 0.1.7 → 0.1.8

package/dist/index.d.mts

@@ -40,6 +40,18 @@ type AudioChannels = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
  * Supported transcription providers
  */
 type TranscriptionProvider = "gladia" | "assemblyai" | "deepgram" | "azure-stt" | "openai-whisper" | "speechmatics";
+/**
+ * Providers that support real-time streaming transcription
+ */
+type StreamingProvider = "gladia" | "deepgram" | "assemblyai";
+/**
+ * Providers that only support batch/async transcription
+ */
+type BatchOnlyProvider = "azure-stt" | "openai-whisper" | "speechmatics";
+/**
+ * WebSocket session status for streaming transcription
+ */
+type SessionStatus = "connecting" | "open" | "closing" | "closed";
 /**
  * Provider capabilities - indicates which features each provider supports
  */
@@ -327,6 +339,39 @@ interface StreamingSession {
     createdAt: Date;
 }
 
+/**
+ * Standardized error handling utilities for Voice Router SDK
+ *
+ * Provides consistent error codes, messages, and formatting across all adapters.
+ */
+/**
+ * Standard error codes used across all providers
+ *
+ * These codes provide a consistent error taxonomy regardless of which
+ * provider is being used.
+ */
+declare const ERROR_CODES: {
+    /** Failed to parse API response or WebSocket message */
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    /** WebSocket connection error */
+    readonly WEBSOCKET_ERROR: "WEBSOCKET_ERROR";
+    /** Async transcription job did not complete within timeout */
+    readonly POLLING_TIMEOUT: "POLLING_TIMEOUT";
+    /** Transcription processing failed on provider side */
+    readonly TRANSCRIPTION_ERROR: "TRANSCRIPTION_ERROR";
+    /** Connection attempt timed out */
+    readonly CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT";
+    /** Invalid input provided to API */
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    /** Requested operation not supported by provider */
+    readonly NOT_SUPPORTED: "NOT_SUPPORTED";
+    /** No transcription results available */
+    readonly NO_RESULTS: "NO_RESULTS";
+    /** Unspecified or unknown error */
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+
 /**
  * Base adapter interface for transcription providers
  * All provider adapters must implement this interface
@@ -444,18 +489,51 @@ interface TranscriptionAdapter {
 declare abstract class BaseAdapter implements TranscriptionAdapter {
     abstract readonly name: TranscriptionProvider;
     abstract readonly capabilities: ProviderCapabilities;
+    /**
+     * Base URL for provider API (must be defined by subclass)
+     */
+    protected abstract baseUrl: string;
     protected config?: ProviderConfig;
     initialize(config: ProviderConfig): void;
     abstract transcribe(audio: AudioInput, options?: TranscribeOptions): Promise<UnifiedTranscriptResponse>;
     abstract getTranscript(transcriptId: string): Promise<UnifiedTranscriptResponse>;
     /**
-     * Helper method to create error responses
+     * Helper method to create error responses with stack traces
+     *
+     * @param error - Error object or unknown error
+     * @param statusCode - Optional HTTP status code
+     * @param code - Optional error code (defaults to extracted or UNKNOWN_ERROR)
      */
-    protected createErrorResponse(error: Error | unknown, statusCode?: number): UnifiedTranscriptResponse;
+    protected createErrorResponse(error: Error | unknown, statusCode?: number, code?: ErrorCode): UnifiedTranscriptResponse;
     /**
      * Helper method to validate configuration
      */
     protected validateConfig(): void;
+    /**
+     * Build axios config for generated API client functions
+     *
+     * @param authHeaderName - Header name for API key (e.g., "Authorization", "x-gladia-key")
+     * @param authHeaderValue - Optional function to format auth header value (defaults to raw API key)
+     * @returns Axios config object
+     */
+    protected getAxiosConfig(authHeaderName?: string, authHeaderValue?: (apiKey: string) => string): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
+    /**
+     * Generic polling helper for async transcription jobs
+     *
+     * Polls getTranscript() until job completes or times out.
+     *
+     * @param transcriptId - Job/transcript ID to poll
+     * @param options - Polling configuration
+     * @returns Final transcription result
+     */
+    protected pollForCompletion(transcriptId: string, options?: {
+        maxAttempts?: number;
+        intervalMs?: number;
+    }): Promise<UnifiedTranscriptResponse>;
 }
 
 /**
@@ -648,13 +726,23 @@ interface LanguageConfig {
 
  * OpenAPI spec version: 1.0.0
  */
-type ListenV1EncodingParameter = (typeof ListenV1EncodingParameter)[keyof typeof ListenV1EncodingParameter];
+/**
+ * ListenV1EncodingParameter type definition
+ */
+/**
+ * ListenV1EncodingParameter type definition
+ */
+/**
+ * ListenV1EncodingParameter type definition
+ */
+/**
+ * ListenV1EncodingParameter type definition
+ */
+type ListenV1EncodingParameter = typeof ListenV1EncodingParameter[keyof typeof ListenV1EncodingParameter];
 declare const ListenV1EncodingParameter: {
     readonly linear16: "linear16";
     readonly flac: "flac";
     readonly mulaw: "mulaw";
-    readonly "amr-nb": "amr-nb";
-    readonly "amr-wb": "amr-wb";
     readonly opus: "opus";
     readonly speex: "speex";
     readonly g729: "g729";
@@ -757,11 +845,11 @@ type ProviderStreamingOptions = ({
 /**
  * Type-safe streaming options for a specific provider
  */
-type StreamingOptionsForProvider<P extends "gladia" | "deepgram" | "assemblyai"> = P extends "gladia" ? GladiaStreamingOptions : P extends "deepgram" ? DeepgramStreamingOptions : P extends "assemblyai" ? AssemblyAIStreamingOptions : never;
+type StreamingOptionsForProvider<P extends StreamingProvider> = P extends "gladia" ? GladiaStreamingOptions : P extends "deepgram" ? DeepgramStreamingOptions : P extends "assemblyai" ? AssemblyAIStreamingOptions : never;
 /**
  * Type-safe transcribeStream parameters for a specific provider
  */
-interface TranscribeStreamParams<P extends "gladia" | "deepgram" | "assemblyai"> {
+interface TranscribeStreamParams<P extends StreamingProvider> {
     /** Streaming options specific to this provider */
     options?: StreamingOptionsForProvider<P> & {
         provider: P;
@@ -1084,12 +1172,16 @@ declare function createVoiceRouter(config: VoiceRouterConfig, adapters?: Transcr
 declare class GladiaAdapter extends BaseAdapter {
     readonly name: "gladia";
     readonly capabilities: ProviderCapabilities;
-    private baseUrl;
+    protected baseUrl: string;
     /**
      * Get axios config for generated API client functions
-     * Configures headers and base URL
+     * Configures headers and base URL using Gladia's x-gladia-key header
      */
-    private getAxiosConfig;
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1181,7 +1273,6 @@ declare class GladiaAdapter extends BaseAdapter {
     /**
      * Poll for transcription completion
      */
-    private pollForCompletion;
     /**
      * Stream audio for real-time transcription
      *
@@ -1287,13 +1378,17 @@ declare function createGladiaAdapter(config: ProviderConfig): GladiaAdapter;
 declare class AssemblyAIAdapter extends BaseAdapter {
     readonly name: "assemblyai";
     readonly capabilities: ProviderCapabilities;
-    private baseUrl;
+    protected baseUrl: string;
     private wsBaseUrl;
     /**
      * Get axios config for generated API client functions
-     * Configures headers and base URL
+     * Configures headers and base URL using authorization header
      */
-    private getAxiosConfig;
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1386,10 +1481,6 @@ declare class AssemblyAIAdapter extends BaseAdapter {
      * Extract utterances from AssemblyAI response
      */
     private extractUtterances;
-    /**
-     * Poll for transcription completion
-     */
-    private pollForCompletion;
     /**
      * Stream audio for real-time transcription
      *
@@ -1496,7 +1587,7 @@ declare class DeepgramAdapter extends BaseAdapter {
     readonly name: "deepgram";
     readonly capabilities: ProviderCapabilities;
     private client?;
-    private baseUrl;
+    protected baseUrl: string;
     private wsBaseUrl;
     initialize(config: ProviderConfig): void;
     /**
@@ -1706,12 +1797,20 @@ declare function createDeepgramAdapter(config: ProviderConfig): DeepgramAdapter;
 declare class AzureSTTAdapter extends BaseAdapter {
     readonly name: "azure-stt";
     readonly capabilities: ProviderCapabilities;
-    private client?;
     private region?;
-    private baseUrl?;
+    protected baseUrl: string;
     initialize(config: ProviderConfig & {
         region?: string;
     }): void;
+    /**
+     * Get axios config for generated API client functions
+     * Configures headers and base URL using Azure subscription key
+     */
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1845,9 +1944,16 @@ declare function createAzureSTTAdapter(config: ProviderConfig & {
 declare class OpenAIWhisperAdapter extends BaseAdapter {
     readonly name: "openai-whisper";
     readonly capabilities: ProviderCapabilities;
-    private client?;
-    private baseUrl;
-    initialize(config: ProviderConfig): void;
+    protected baseUrl: string;
+    /**
+     * Get axios config for generated API client functions
+     * Configures headers and base URL using Bearer token authorization
+     */
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1972,7 +2078,7 @@ declare class SpeechmaticsAdapter extends BaseAdapter {
     readonly name: "speechmatics";
     readonly capabilities: ProviderCapabilities;
     private client?;
-    private baseUrl;
+    protected baseUrl: string;
     initialize(config: ProviderConfig): void;
     /**
      * Submit audio for transcription
@@ -11082,4 +11188,4 @@ declare namespace index {
   export { index_AudioIntelligenceModelStatus as AudioIntelligenceModelStatus, type index_AutoHighlightResult as AutoHighlightResult, type index_AutoHighlightsResult as AutoHighlightsResult, type index_BadRequestResponse as BadRequestResponse, type index_CannotAccessUploadedFileResponse as CannotAccessUploadedFileResponse, type index_Chapter as Chapter, type index_ContentSafetyLabel as ContentSafetyLabel, type index_ContentSafetyLabelResult as ContentSafetyLabelResult, type index_ContentSafetyLabelsResult as ContentSafetyLabelsResult, type index_ContentSafetyLabelsResultSeverityScoreSummary as ContentSafetyLabelsResultSeverityScoreSummary, type index_ContentSafetyLabelsResultSummary as ContentSafetyLabelsResultSummary, type index_CreateRealtimeTemporaryTokenParams as CreateRealtimeTemporaryTokenParams, type index_Entity as Entity, index_EntityType as EntityType, type Error$1 as Error, type index_GatewayTimeoutResponse as GatewayTimeoutResponse, type index_GetSubtitlesParams as GetSubtitlesParams, type index_InternalServerErrorResponse as InternalServerErrorResponse, type index_LemurActionItemsParams as LemurActionItemsParams, type index_LemurActionItemsParamsAllOf as LemurActionItemsParamsAllOf, type index_LemurActionItemsResponse as LemurActionItemsResponse, type index_LemurBaseParams as LemurBaseParams, type index_LemurBaseParamsContext as LemurBaseParamsContext, type index_LemurBaseParamsContextOneOf as LemurBaseParamsContextOneOf, type index_LemurBaseParamsFinalModel as LemurBaseParamsFinalModel, type index_LemurBaseResponse as LemurBaseResponse, index_LemurModel as LemurModel, type index_LemurQuestion as LemurQuestion, type index_LemurQuestionAnswer as LemurQuestionAnswer, type index_LemurQuestionAnswerParams as LemurQuestionAnswerParams, type index_LemurQuestionAnswerParamsAllOf as LemurQuestionAnswerParamsAllOf, type index_LemurQuestionAnswerResponse as LemurQuestionAnswerResponse, type index_LemurQuestionAnswerResponseAllOf as LemurQuestionAnswerResponseAllOf, type index_LemurQuestionContext as LemurQuestionContext, type index_LemurQuestionContextOneOf as LemurQuestionContextOneOf, type index_LemurResponse as LemurResponse, type index_LemurStringResponse as LemurStringResponse, type index_LemurStringResponseAllOf as LemurStringResponseAllOf, type index_LemurSummaryParams as LemurSummaryParams, type index_LemurSummaryParamsAllOf as LemurSummaryParamsAllOf, type index_LemurSummaryResponse as LemurSummaryResponse, type index_LemurTaskParams as LemurTaskParams, type index_LemurTaskParamsAllOf as LemurTaskParamsAllOf, type index_LemurTaskResponse as LemurTaskResponse, type index_LemurUsage as LemurUsage, type index_ListTranscriptParams as ListTranscriptParams, type index_ListTranscriptsParams as ListTranscriptsParams, type index_NotFoundResponse as NotFoundResponse, type index_PageDetails as PageDetails, type index_PageDetailsNextUrl as PageDetailsNextUrl, type index_PageDetailsPrevUrl as PageDetailsPrevUrl, type index_ParagraphsResponse as ParagraphsResponse, index_PiiPolicy as PiiPolicy, type index_PurgeLemurRequestDataResponse as PurgeLemurRequestDataResponse, type index_RealtimeTemporaryTokenResponse as RealtimeTemporaryTokenResponse, index_RedactPiiAudioQuality as RedactPiiAudioQuality, type index_RedactedAudioNotification as RedactedAudioNotification, type index_RedactedAudioResponse as RedactedAudioResponse, index_RedactedAudioStatus as RedactedAudioStatus, type index_SentencesResponse as SentencesResponse, index_Sentiment as Sentiment, type index_SentimentAnalysisResult as SentimentAnalysisResult, type index_SentimentAnalysisResultChannel as SentimentAnalysisResultChannel, type index_SentimentAnalysisResultSpeaker as SentimentAnalysisResultSpeaker, type index_ServiceUnavailableResponse as ServiceUnavailableResponse, type index_SeverityScoreSummary as SeverityScoreSummary, index_SpeechModel as SpeechModel, index_SubstitutionPolicy as SubstitutionPolicy, index_SubtitleFormat as SubtitleFormat, index_SummaryModel as SummaryModel, index_SummaryType as SummaryType, type index_Timestamp as Timestamp, type index_TooManyRequestsResponse as TooManyRequestsResponse, type index_TopicDetectionModelResult as TopicDetectionModelResult, type index_TopicDetectionModelResultSummary as TopicDetectionModelResultSummary, type index_TopicDetectionResult as TopicDetectionResult, type index_TopicDetectionResultLabelsItem as TopicDetectionResultLabelsItem, type index_Transcript as Transcript, type index_TranscriptAudioDuration as TranscriptAudioDuration, type index_TranscriptAudioEndAt as TranscriptAudioEndAt, type index_TranscriptAudioStartFrom as TranscriptAudioStartFrom, type index_TranscriptAutoChapters as TranscriptAutoChapters, type index_TranscriptAutoHighlightsResult as TranscriptAutoHighlightsResult, index_TranscriptBoostParam as TranscriptBoostParam, type index_TranscriptBoostParamProperty as TranscriptBoostParamProperty, type index_TranscriptChapters as TranscriptChapters, type index_TranscriptConfidence as TranscriptConfidence, type index_TranscriptContentSafety as TranscriptContentSafety, type index_TranscriptContentSafetyLabels as TranscriptContentSafetyLabels, type index_TranscriptCustomSpelling as TranscriptCustomSpelling, type index_TranscriptCustomSpellingProperty as TranscriptCustomSpellingProperty, type index_TranscriptCustomTopics as TranscriptCustomTopics, type index_TranscriptDisfluencies as TranscriptDisfluencies, type index_TranscriptEntities as TranscriptEntities, type index_TranscriptEntityDetection as TranscriptEntityDetection, type index_TranscriptFilterProfanity as TranscriptFilterProfanity, type index_TranscriptFormatText as TranscriptFormatText, type index_TranscriptIabCategories as TranscriptIabCategories, type index_TranscriptIabCategoriesResult as TranscriptIabCategoriesResult, index_TranscriptLanguageCode as TranscriptLanguageCode, type index_TranscriptLanguageCodeProperty as TranscriptLanguageCodeProperty, type index_TranscriptLanguageConfidence as TranscriptLanguageConfidence, type index_TranscriptLanguageConfidenceThreshold as TranscriptLanguageConfidenceThreshold, type index_TranscriptLanguageDetection as TranscriptLanguageDetection, type index_TranscriptList as TranscriptList, type index_TranscriptListItem as TranscriptListItem, type index_TranscriptListItemCompleted as TranscriptListItemCompleted, type index_TranscriptListItemError as TranscriptListItemError, type index_TranscriptMultichannel as TranscriptMultichannel, type index_TranscriptOptionalParams as TranscriptOptionalParams, type index_TranscriptOptionalParamsLanguageCode as TranscriptOptionalParamsLanguageCode, type index_TranscriptOptionalParamsLanguageCodeOneOf as TranscriptOptionalParamsLanguageCodeOneOf, type index_TranscriptOptionalParamsRedactPiiSub as TranscriptOptionalParamsRedactPiiSub, type index_TranscriptOptionalParamsSpeakersExpected as TranscriptOptionalParamsSpeakersExpected, type index_TranscriptOptionalParamsSpeechModel as TranscriptOptionalParamsSpeechModel, type index_TranscriptOptionalParamsSpeechThreshold as TranscriptOptionalParamsSpeechThreshold, type index_TranscriptOptionalParamsWebhookAuthHeaderName as TranscriptOptionalParamsWebhookAuthHeaderName, type index_TranscriptOptionalParamsWebhookAuthHeaderValue as TranscriptOptionalParamsWebhookAuthHeaderValue, type index_TranscriptParagraph as TranscriptParagraph, type index_TranscriptParams as TranscriptParams, type index_TranscriptParamsAllOf as TranscriptParamsAllOf, type index_TranscriptPunctuate as TranscriptPunctuate, type index_TranscriptReadyNotification as TranscriptReadyNotification, index_TranscriptReadyStatus as TranscriptReadyStatus, type index_TranscriptRedactPiiAudio as TranscriptRedactPiiAudio, type index_TranscriptRedactPiiAudioQuality as TranscriptRedactPiiAudioQuality, type index_TranscriptRedactPiiPolicies as TranscriptRedactPiiPolicies, type index_TranscriptSentence as TranscriptSentence, type index_TranscriptSentenceChannel as TranscriptSentenceChannel, type index_TranscriptSentenceSpeaker as TranscriptSentenceSpeaker, type index_TranscriptSentimentAnalysis as TranscriptSentimentAnalysis, type index_TranscriptSentimentAnalysisResults as TranscriptSentimentAnalysisResults, type index_TranscriptSpeakerLabels as TranscriptSpeakerLabels, type index_TranscriptSpeakersExpected as TranscriptSpeakersExpected, type index_TranscriptSpeechModel as TranscriptSpeechModel, type index_TranscriptSpeechThreshold as TranscriptSpeechThreshold, type index_TranscriptSpeedBoost as TranscriptSpeedBoost, index_TranscriptStatus as TranscriptStatus, type index_TranscriptSummary as TranscriptSummary, type index_TranscriptSummaryModel as TranscriptSummaryModel, type index_TranscriptSummaryType as TranscriptSummaryType, type index_TranscriptText as TranscriptText, type index_TranscriptThrottled as TranscriptThrottled, type index_TranscriptUtterance as TranscriptUtterance, type index_TranscriptUtteranceChannel as TranscriptUtteranceChannel, type index_TranscriptUtterances as TranscriptUtterances, type index_TranscriptWebhookAuthHeaderName as TranscriptWebhookAuthHeaderName, type index_TranscriptWebhookNotification as TranscriptWebhookNotification, type index_TranscriptWebhookStatusCode as TranscriptWebhookStatusCode, type index_TranscriptWebhookUrl as TranscriptWebhookUrl, type index_TranscriptWord as TranscriptWord, type index_TranscriptWordChannel as TranscriptWordChannel, type index_TranscriptWordSpeaker as TranscriptWordSpeaker, type index_TranscriptWords as TranscriptWords, type index_UnauthorizedResponse as UnauthorizedResponse, type index_UploadedFile as UploadedFile, type index_WordSearchMatch as WordSearchMatch, type index_WordSearchParams as WordSearchParams, type index_WordSearchResponse as WordSearchResponse, type index_WordSearchTimestamp as WordSearchTimestamp };
 }
 
-export { AssemblyAIAdapter, type AssemblyAIStreamingOptions, index as AssemblyAITypes, AssemblyAIWebhookHandler, type AudioChunk, type AudioInput, AzureSTTAdapter, AzureWebhookHandler, BaseAdapter, BaseWebhookHandler, DeepgramAdapter, type DeepgramStreamingOptions, DeepgramWebhookHandler, GladiaAdapter, type GladiaStreamingOptions, index$1 as GladiaTypes, GladiaWebhookHandler, OpenAIWhisperAdapter, type ProviderCapabilities, type ProviderConfig, type ProviderStreamingOptions, type Speaker, SpeechmaticsAdapter, SpeechmaticsWebhookHandler, type StreamEvent, type StreamEventType, type StreamingCallbacks, type StreamingOptions, type StreamingOptionsForProvider, type StreamingSession, type TranscribeOptions, type TranscribeStreamParams, type TranscriptionAdapter, type TranscriptionProvider, type TranscriptionStatus, type UnifiedTranscriptResponse, type UnifiedWebhookEvent, type Utterance, VoiceRouter, type VoiceRouterConfig, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, type Word, createAssemblyAIAdapter, createAssemblyAIWebhookHandler, createAzureSTTAdapter, createAzureWebhookHandler, createDeepgramAdapter, createDeepgramWebhookHandler, createGladiaAdapter, createGladiaWebhookHandler, createOpenAIWhisperAdapter, createSpeechmaticsAdapter, createVoiceRouter, createWebhookRouter };
+export { AssemblyAIAdapter, type AssemblyAIStreamingOptions, index as AssemblyAITypes, AssemblyAIWebhookHandler, type AudioChunk, type AudioInput, AzureSTTAdapter, AzureWebhookHandler, BaseAdapter, BaseWebhookHandler, type BatchOnlyProvider, DeepgramAdapter, type DeepgramStreamingOptions, DeepgramWebhookHandler, GladiaAdapter, type GladiaStreamingOptions, index$1 as GladiaTypes, GladiaWebhookHandler, OpenAIWhisperAdapter, type ProviderCapabilities, type ProviderConfig, type ProviderStreamingOptions, type SessionStatus, type Speaker, SpeechmaticsAdapter, SpeechmaticsWebhookHandler, type StreamEvent, type StreamEventType, type StreamingCallbacks, type StreamingOptions, type StreamingOptionsForProvider, type StreamingProvider, type StreamingSession, type TranscribeOptions, type TranscribeStreamParams, type TranscriptionAdapter, type TranscriptionProvider, type TranscriptionStatus, type UnifiedTranscriptResponse, type UnifiedWebhookEvent, type Utterance, VoiceRouter, type VoiceRouterConfig, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, type Word, createAssemblyAIAdapter, createAssemblyAIWebhookHandler, createAzureSTTAdapter, createAzureWebhookHandler, createDeepgramAdapter, createDeepgramWebhookHandler, createGladiaAdapter, createGladiaWebhookHandler, createOpenAIWhisperAdapter, createSpeechmaticsAdapter, createVoiceRouter, createWebhookRouter };

package/dist/index.d.ts

@@ -40,6 +40,18 @@ type AudioChannels = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
  * Supported transcription providers
  */
 type TranscriptionProvider = "gladia" | "assemblyai" | "deepgram" | "azure-stt" | "openai-whisper" | "speechmatics";
+/**
+ * Providers that support real-time streaming transcription
+ */
+type StreamingProvider = "gladia" | "deepgram" | "assemblyai";
+/**
+ * Providers that only support batch/async transcription
+ */
+type BatchOnlyProvider = "azure-stt" | "openai-whisper" | "speechmatics";
+/**
+ * WebSocket session status for streaming transcription
+ */
+type SessionStatus = "connecting" | "open" | "closing" | "closed";
 /**
  * Provider capabilities - indicates which features each provider supports
  */
@@ -327,6 +339,39 @@ interface StreamingSession {
     createdAt: Date;
 }
 
+/**
+ * Standardized error handling utilities for Voice Router SDK
+ *
+ * Provides consistent error codes, messages, and formatting across all adapters.
+ */
+/**
+ * Standard error codes used across all providers
+ *
+ * These codes provide a consistent error taxonomy regardless of which
+ * provider is being used.
+ */
+declare const ERROR_CODES: {
+    /** Failed to parse API response or WebSocket message */
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    /** WebSocket connection error */
+    readonly WEBSOCKET_ERROR: "WEBSOCKET_ERROR";
+    /** Async transcription job did not complete within timeout */
+    readonly POLLING_TIMEOUT: "POLLING_TIMEOUT";
+    /** Transcription processing failed on provider side */
+    readonly TRANSCRIPTION_ERROR: "TRANSCRIPTION_ERROR";
+    /** Connection attempt timed out */
+    readonly CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT";
+    /** Invalid input provided to API */
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    /** Requested operation not supported by provider */
+    readonly NOT_SUPPORTED: "NOT_SUPPORTED";
+    /** No transcription results available */
+    readonly NO_RESULTS: "NO_RESULTS";
+    /** Unspecified or unknown error */
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+
 /**
  * Base adapter interface for transcription providers
  * All provider adapters must implement this interface
@@ -444,18 +489,51 @@ interface TranscriptionAdapter {
 declare abstract class BaseAdapter implements TranscriptionAdapter {
     abstract readonly name: TranscriptionProvider;
     abstract readonly capabilities: ProviderCapabilities;
+    /**
+     * Base URL for provider API (must be defined by subclass)
+     */
+    protected abstract baseUrl: string;
     protected config?: ProviderConfig;
     initialize(config: ProviderConfig): void;
     abstract transcribe(audio: AudioInput, options?: TranscribeOptions): Promise<UnifiedTranscriptResponse>;
     abstract getTranscript(transcriptId: string): Promise<UnifiedTranscriptResponse>;
     /**
-     * Helper method to create error responses
+     * Helper method to create error responses with stack traces
+     *
+     * @param error - Error object or unknown error
+     * @param statusCode - Optional HTTP status code
+     * @param code - Optional error code (defaults to extracted or UNKNOWN_ERROR)
      */
-    protected createErrorResponse(error: Error | unknown, statusCode?: number): UnifiedTranscriptResponse;
+    protected createErrorResponse(error: Error | unknown, statusCode?: number, code?: ErrorCode): UnifiedTranscriptResponse;
     /**
      * Helper method to validate configuration
      */
     protected validateConfig(): void;
+    /**
+     * Build axios config for generated API client functions
+     *
+     * @param authHeaderName - Header name for API key (e.g., "Authorization", "x-gladia-key")
+     * @param authHeaderValue - Optional function to format auth header value (defaults to raw API key)
+     * @returns Axios config object
+     */
+    protected getAxiosConfig(authHeaderName?: string, authHeaderValue?: (apiKey: string) => string): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
+    /**
+     * Generic polling helper for async transcription jobs
+     *
+     * Polls getTranscript() until job completes or times out.
+     *
+     * @param transcriptId - Job/transcript ID to poll
+     * @param options - Polling configuration
+     * @returns Final transcription result
+     */
+    protected pollForCompletion(transcriptId: string, options?: {
+        maxAttempts?: number;
+        intervalMs?: number;
+    }): Promise<UnifiedTranscriptResponse>;
 }
 
 /**
@@ -648,13 +726,23 @@ interface LanguageConfig {
 
  * OpenAPI spec version: 1.0.0
  */
-type ListenV1EncodingParameter = (typeof ListenV1EncodingParameter)[keyof typeof ListenV1EncodingParameter];
+/**
+ * ListenV1EncodingParameter type definition
+ */
+/**
+ * ListenV1EncodingParameter type definition
+ */
+/**
+ * ListenV1EncodingParameter type definition
+ */
+/**
+ * ListenV1EncodingParameter type definition
+ */
+type ListenV1EncodingParameter = typeof ListenV1EncodingParameter[keyof typeof ListenV1EncodingParameter];
 declare const ListenV1EncodingParameter: {
     readonly linear16: "linear16";
     readonly flac: "flac";
     readonly mulaw: "mulaw";
-    readonly "amr-nb": "amr-nb";
-    readonly "amr-wb": "amr-wb";
     readonly opus: "opus";
     readonly speex: "speex";
     readonly g729: "g729";
@@ -757,11 +845,11 @@ type ProviderStreamingOptions = ({
 /**
  * Type-safe streaming options for a specific provider
  */
-type StreamingOptionsForProvider<P extends "gladia" | "deepgram" | "assemblyai"> = P extends "gladia" ? GladiaStreamingOptions : P extends "deepgram" ? DeepgramStreamingOptions : P extends "assemblyai" ? AssemblyAIStreamingOptions : never;
+type StreamingOptionsForProvider<P extends StreamingProvider> = P extends "gladia" ? GladiaStreamingOptions : P extends "deepgram" ? DeepgramStreamingOptions : P extends "assemblyai" ? AssemblyAIStreamingOptions : never;
 /**
  * Type-safe transcribeStream parameters for a specific provider
  */
-interface TranscribeStreamParams<P extends "gladia" | "deepgram" | "assemblyai"> {
+interface TranscribeStreamParams<P extends StreamingProvider> {
     /** Streaming options specific to this provider */
     options?: StreamingOptionsForProvider<P> & {
         provider: P;
@@ -1084,12 +1172,16 @@ declare function createVoiceRouter(config: VoiceRouterConfig, adapters?: Transcr
 declare class GladiaAdapter extends BaseAdapter {
     readonly name: "gladia";
     readonly capabilities: ProviderCapabilities;
-    private baseUrl;
+    protected baseUrl: string;
     /**
      * Get axios config for generated API client functions
-     * Configures headers and base URL
+     * Configures headers and base URL using Gladia's x-gladia-key header
      */
-    private getAxiosConfig;
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1181,7 +1273,6 @@ declare class GladiaAdapter extends BaseAdapter {
     /**
      * Poll for transcription completion
      */
-    private pollForCompletion;
     /**
      * Stream audio for real-time transcription
      *
@@ -1287,13 +1378,17 @@ declare function createGladiaAdapter(config: ProviderConfig): GladiaAdapter;
 declare class AssemblyAIAdapter extends BaseAdapter {
     readonly name: "assemblyai";
     readonly capabilities: ProviderCapabilities;
-    private baseUrl;
+    protected baseUrl: string;
     private wsBaseUrl;
     /**
      * Get axios config for generated API client functions
-     * Configures headers and base URL
+     * Configures headers and base URL using authorization header
      */
-    private getAxiosConfig;
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1386,10 +1481,6 @@ declare class AssemblyAIAdapter extends BaseAdapter {
      * Extract utterances from AssemblyAI response
      */
     private extractUtterances;
-    /**
-     * Poll for transcription completion
-     */
-    private pollForCompletion;
     /**
      * Stream audio for real-time transcription
      *
@@ -1496,7 +1587,7 @@ declare class DeepgramAdapter extends BaseAdapter {
     readonly name: "deepgram";
     readonly capabilities: ProviderCapabilities;
     private client?;
-    private baseUrl;
+    protected baseUrl: string;
     private wsBaseUrl;
     initialize(config: ProviderConfig): void;
     /**
@@ -1706,12 +1797,20 @@ declare function createDeepgramAdapter(config: ProviderConfig): DeepgramAdapter;
 declare class AzureSTTAdapter extends BaseAdapter {
     readonly name: "azure-stt";
     readonly capabilities: ProviderCapabilities;
-    private client?;
     private region?;
-    private baseUrl?;
+    protected baseUrl: string;
     initialize(config: ProviderConfig & {
         region?: string;
     }): void;
+    /**
+     * Get axios config for generated API client functions
+     * Configures headers and base URL using Azure subscription key
+     */
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1845,9 +1944,16 @@ declare function createAzureSTTAdapter(config: ProviderConfig & {
 declare class OpenAIWhisperAdapter extends BaseAdapter {
     readonly name: "openai-whisper";
     readonly capabilities: ProviderCapabilities;
-    private client?;
-    private baseUrl;
-    initialize(config: ProviderConfig): void;
+    protected baseUrl: string;
+    /**
+     * Get axios config for generated API client functions
+     * Configures headers and base URL using Bearer token authorization
+     */
+    protected getAxiosConfig(): {
+        baseURL: string;
+        timeout: number;
+        headers: Record<string, string>;
+    };
     /**
      * Submit audio for transcription
      *
@@ -1972,7 +2078,7 @@ declare class SpeechmaticsAdapter extends BaseAdapter {
     readonly name: "speechmatics";
     readonly capabilities: ProviderCapabilities;
     private client?;
-    private baseUrl;
+    protected baseUrl: string;
     initialize(config: ProviderConfig): void;
     /**
      * Submit audio for transcription
@@ -11082,4 +11188,4 @@ declare namespace index {
   export { index_AudioIntelligenceModelStatus as AudioIntelligenceModelStatus, type index_AutoHighlightResult as AutoHighlightResult, type index_AutoHighlightsResult as AutoHighlightsResult, type index_BadRequestResponse as BadRequestResponse, type index_CannotAccessUploadedFileResponse as CannotAccessUploadedFileResponse, type index_Chapter as Chapter, type index_ContentSafetyLabel as ContentSafetyLabel, type index_ContentSafetyLabelResult as ContentSafetyLabelResult, type index_ContentSafetyLabelsResult as ContentSafetyLabelsResult, type index_ContentSafetyLabelsResultSeverityScoreSummary as ContentSafetyLabelsResultSeverityScoreSummary, type index_ContentSafetyLabelsResultSummary as ContentSafetyLabelsResultSummary, type index_CreateRealtimeTemporaryTokenParams as CreateRealtimeTemporaryTokenParams, type index_Entity as Entity, index_EntityType as EntityType, type Error$1 as Error, type index_GatewayTimeoutResponse as GatewayTimeoutResponse, type index_GetSubtitlesParams as GetSubtitlesParams, type index_InternalServerErrorResponse as InternalServerErrorResponse, type index_LemurActionItemsParams as LemurActionItemsParams, type index_LemurActionItemsParamsAllOf as LemurActionItemsParamsAllOf, type index_LemurActionItemsResponse as LemurActionItemsResponse, type index_LemurBaseParams as LemurBaseParams, type index_LemurBaseParamsContext as LemurBaseParamsContext, type index_LemurBaseParamsContextOneOf as LemurBaseParamsContextOneOf, type index_LemurBaseParamsFinalModel as LemurBaseParamsFinalModel, type index_LemurBaseResponse as LemurBaseResponse, index_LemurModel as LemurModel, type index_LemurQuestion as LemurQuestion, type index_LemurQuestionAnswer as LemurQuestionAnswer, type index_LemurQuestionAnswerParams as LemurQuestionAnswerParams, type index_LemurQuestionAnswerParamsAllOf as LemurQuestionAnswerParamsAllOf, type index_LemurQuestionAnswerResponse as LemurQuestionAnswerResponse, type index_LemurQuestionAnswerResponseAllOf as LemurQuestionAnswerResponseAllOf, type index_LemurQuestionContext as LemurQuestionContext, type index_LemurQuestionContextOneOf as LemurQuestionContextOneOf, type index_LemurResponse as LemurResponse, type index_LemurStringResponse as LemurStringResponse, type index_LemurStringResponseAllOf as LemurStringResponseAllOf, type index_LemurSummaryParams as LemurSummaryParams, type index_LemurSummaryParamsAllOf as LemurSummaryParamsAllOf, type index_LemurSummaryResponse as LemurSummaryResponse, type index_LemurTaskParams as LemurTaskParams, type index_LemurTaskParamsAllOf as LemurTaskParamsAllOf, type index_LemurTaskResponse as LemurTaskResponse, type index_LemurUsage as LemurUsage, type index_ListTranscriptParams as ListTranscriptParams, type index_ListTranscriptsParams as ListTranscriptsParams, type index_NotFoundResponse as NotFoundResponse, type index_PageDetails as PageDetails, type index_PageDetailsNextUrl as PageDetailsNextUrl, type index_PageDetailsPrevUrl as PageDetailsPrevUrl, type index_ParagraphsResponse as ParagraphsResponse, index_PiiPolicy as PiiPolicy, type index_PurgeLemurRequestDataResponse as PurgeLemurRequestDataResponse, type index_RealtimeTemporaryTokenResponse as RealtimeTemporaryTokenResponse, index_RedactPiiAudioQuality as RedactPiiAudioQuality, type index_RedactedAudioNotification as RedactedAudioNotification, type index_RedactedAudioResponse as RedactedAudioResponse, index_RedactedAudioStatus as RedactedAudioStatus, type index_SentencesResponse as SentencesResponse, index_Sentiment as Sentiment, type index_SentimentAnalysisResult as SentimentAnalysisResult, type index_SentimentAnalysisResultChannel as SentimentAnalysisResultChannel, type index_SentimentAnalysisResultSpeaker as SentimentAnalysisResultSpeaker, type index_ServiceUnavailableResponse as ServiceUnavailableResponse, type index_SeverityScoreSummary as SeverityScoreSummary, index_SpeechModel as SpeechModel, index_SubstitutionPolicy as SubstitutionPolicy, index_SubtitleFormat as SubtitleFormat, index_SummaryModel as SummaryModel, index_SummaryType as SummaryType, type index_Timestamp as Timestamp, type index_TooManyRequestsResponse as TooManyRequestsResponse, type index_TopicDetectionModelResult as TopicDetectionModelResult, type index_TopicDetectionModelResultSummary as TopicDetectionModelResultSummary, type index_TopicDetectionResult as TopicDetectionResult, type index_TopicDetectionResultLabelsItem as TopicDetectionResultLabelsItem, type index_Transcript as Transcript, type index_TranscriptAudioDuration as TranscriptAudioDuration, type index_TranscriptAudioEndAt as TranscriptAudioEndAt, type index_TranscriptAudioStartFrom as TranscriptAudioStartFrom, type index_TranscriptAutoChapters as TranscriptAutoChapters, type index_TranscriptAutoHighlightsResult as TranscriptAutoHighlightsResult, index_TranscriptBoostParam as TranscriptBoostParam, type index_TranscriptBoostParamProperty as TranscriptBoostParamProperty, type index_TranscriptChapters as TranscriptChapters, type index_TranscriptConfidence as TranscriptConfidence, type index_TranscriptContentSafety as TranscriptContentSafety, type index_TranscriptContentSafetyLabels as TranscriptContentSafetyLabels, type index_TranscriptCustomSpelling as TranscriptCustomSpelling, type index_TranscriptCustomSpellingProperty as TranscriptCustomSpellingProperty, type index_TranscriptCustomTopics as TranscriptCustomTopics, type index_TranscriptDisfluencies as TranscriptDisfluencies, type index_TranscriptEntities as TranscriptEntities, type index_TranscriptEntityDetection as TranscriptEntityDetection, type index_TranscriptFilterProfanity as TranscriptFilterProfanity, type index_TranscriptFormatText as TranscriptFormatText, type index_TranscriptIabCategories as TranscriptIabCategories, type index_TranscriptIabCategoriesResult as TranscriptIabCategoriesResult, index_TranscriptLanguageCode as TranscriptLanguageCode, type index_TranscriptLanguageCodeProperty as TranscriptLanguageCodeProperty, type index_TranscriptLanguageConfidence as TranscriptLanguageConfidence, type index_TranscriptLanguageConfidenceThreshold as TranscriptLanguageConfidenceThreshold, type index_TranscriptLanguageDetection as TranscriptLanguageDetection, type index_TranscriptList as TranscriptList, type index_TranscriptListItem as TranscriptListItem, type index_TranscriptListItemCompleted as TranscriptListItemCompleted, type index_TranscriptListItemError as TranscriptListItemError, type index_TranscriptMultichannel as TranscriptMultichannel, type index_TranscriptOptionalParams as TranscriptOptionalParams, type index_TranscriptOptionalParamsLanguageCode as TranscriptOptionalParamsLanguageCode, type index_TranscriptOptionalParamsLanguageCodeOneOf as TranscriptOptionalParamsLanguageCodeOneOf, type index_TranscriptOptionalParamsRedactPiiSub as TranscriptOptionalParamsRedactPiiSub, type index_TranscriptOptionalParamsSpeakersExpected as TranscriptOptionalParamsSpeakersExpected, type index_TranscriptOptionalParamsSpeechModel as TranscriptOptionalParamsSpeechModel, type index_TranscriptOptionalParamsSpeechThreshold as TranscriptOptionalParamsSpeechThreshold, type index_TranscriptOptionalParamsWebhookAuthHeaderName as TranscriptOptionalParamsWebhookAuthHeaderName, type index_TranscriptOptionalParamsWebhookAuthHeaderValue as TranscriptOptionalParamsWebhookAuthHeaderValue, type index_TranscriptParagraph as TranscriptParagraph, type index_TranscriptParams as TranscriptParams, type index_TranscriptParamsAllOf as TranscriptParamsAllOf, type index_TranscriptPunctuate as TranscriptPunctuate, type index_TranscriptReadyNotification as TranscriptReadyNotification, index_TranscriptReadyStatus as TranscriptReadyStatus, type index_TranscriptRedactPiiAudio as TranscriptRedactPiiAudio, type index_TranscriptRedactPiiAudioQuality as TranscriptRedactPiiAudioQuality, type index_TranscriptRedactPiiPolicies as TranscriptRedactPiiPolicies, type index_TranscriptSentence as TranscriptSentence, type index_TranscriptSentenceChannel as TranscriptSentenceChannel, type index_TranscriptSentenceSpeaker as TranscriptSentenceSpeaker, type index_TranscriptSentimentAnalysis as TranscriptSentimentAnalysis, type index_TranscriptSentimentAnalysisResults as TranscriptSentimentAnalysisResults, type index_TranscriptSpeakerLabels as TranscriptSpeakerLabels, type index_TranscriptSpeakersExpected as TranscriptSpeakersExpected, type index_TranscriptSpeechModel as TranscriptSpeechModel, type index_TranscriptSpeechThreshold as TranscriptSpeechThreshold, type index_TranscriptSpeedBoost as TranscriptSpeedBoost, index_TranscriptStatus as TranscriptStatus, type index_TranscriptSummary as TranscriptSummary, type index_TranscriptSummaryModel as TranscriptSummaryModel, type index_TranscriptSummaryType as TranscriptSummaryType, type index_TranscriptText as TranscriptText, type index_TranscriptThrottled as TranscriptThrottled, type index_TranscriptUtterance as TranscriptUtterance, type index_TranscriptUtteranceChannel as TranscriptUtteranceChannel, type index_TranscriptUtterances as TranscriptUtterances, type index_TranscriptWebhookAuthHeaderName as TranscriptWebhookAuthHeaderName, type index_TranscriptWebhookNotification as TranscriptWebhookNotification, type index_TranscriptWebhookStatusCode as TranscriptWebhookStatusCode, type index_TranscriptWebhookUrl as TranscriptWebhookUrl, type index_TranscriptWord as TranscriptWord, type index_TranscriptWordChannel as TranscriptWordChannel, type index_TranscriptWordSpeaker as TranscriptWordSpeaker, type index_TranscriptWords as TranscriptWords, type index_UnauthorizedResponse as UnauthorizedResponse, type index_UploadedFile as UploadedFile, type index_WordSearchMatch as WordSearchMatch, type index_WordSearchParams as WordSearchParams, type index_WordSearchResponse as WordSearchResponse, type index_WordSearchTimestamp as WordSearchTimestamp };
 }
 
-export { AssemblyAIAdapter, type AssemblyAIStreamingOptions, index as AssemblyAITypes, AssemblyAIWebhookHandler, type AudioChunk, type AudioInput, AzureSTTAdapter, AzureWebhookHandler, BaseAdapter, BaseWebhookHandler, DeepgramAdapter, type DeepgramStreamingOptions, DeepgramWebhookHandler, GladiaAdapter, type GladiaStreamingOptions, index$1 as GladiaTypes, GladiaWebhookHandler, OpenAIWhisperAdapter, type ProviderCapabilities, type ProviderConfig, type ProviderStreamingOptions, type Speaker, SpeechmaticsAdapter, SpeechmaticsWebhookHandler, type StreamEvent, type StreamEventType, type StreamingCallbacks, type StreamingOptions, type StreamingOptionsForProvider, type StreamingSession, type TranscribeOptions, type TranscribeStreamParams, type TranscriptionAdapter, type TranscriptionProvider, type TranscriptionStatus, type UnifiedTranscriptResponse, type UnifiedWebhookEvent, type Utterance, VoiceRouter, type VoiceRouterConfig, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, type Word, createAssemblyAIAdapter, createAssemblyAIWebhookHandler, createAzureSTTAdapter, createAzureWebhookHandler, createDeepgramAdapter, createDeepgramWebhookHandler, createGladiaAdapter, createGladiaWebhookHandler, createOpenAIWhisperAdapter, createSpeechmaticsAdapter, createVoiceRouter, createWebhookRouter };
+export { AssemblyAIAdapter, type AssemblyAIStreamingOptions, index as AssemblyAITypes, AssemblyAIWebhookHandler, type AudioChunk, type AudioInput, AzureSTTAdapter, AzureWebhookHandler, BaseAdapter, BaseWebhookHandler, type BatchOnlyProvider, DeepgramAdapter, type DeepgramStreamingOptions, DeepgramWebhookHandler, GladiaAdapter, type GladiaStreamingOptions, index$1 as GladiaTypes, GladiaWebhookHandler, OpenAIWhisperAdapter, type ProviderCapabilities, type ProviderConfig, type ProviderStreamingOptions, type SessionStatus, type Speaker, SpeechmaticsAdapter, SpeechmaticsWebhookHandler, type StreamEvent, type StreamEventType, type StreamingCallbacks, type StreamingOptions, type StreamingOptionsForProvider, type StreamingProvider, type StreamingSession, type TranscribeOptions, type TranscribeStreamParams, type TranscriptionAdapter, type TranscriptionProvider, type TranscriptionStatus, type UnifiedTranscriptResponse, type UnifiedWebhookEvent, type Utterance, VoiceRouter, type VoiceRouterConfig, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, type Word, createAssemblyAIAdapter, createAssemblyAIWebhookHandler, createAzureSTTAdapter, createAzureWebhookHandler, createDeepgramAdapter, createDeepgramWebhookHandler, createGladiaAdapter, createGladiaWebhookHandler, createOpenAIWhisperAdapter, createSpeechmaticsAdapter, createVoiceRouter, createWebhookRouter };