@soniox/node 1.1.2 → 2.0.1

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 //#region src/constants.d.ts
 declare const SONIOX_API_BASE_URL = "https://api.soniox.com";
 declare const SONIOX_API_WS_URL = "wss://stt-rt.soniox.com/transcribe-websocket";
+declare const SONIOX_TTS_API_BASE_URL = "https://tts-rt.soniox.com";
+declare const SONIOX_TTS_WS_URL = "wss://tts-rt.soniox.com/tts-websocket";
 declare const SONIOX_TMP_API_KEY_USAGE_TYPE = "transcribe_websocket";
 declare const SONIOX_TMP_API_KEY_DURATION_MIN = 1;
 declare const SONIOX_TMP_API_KEY_DURATION_MAX = 3600;
@@ -13,19 +15,40 @@ declare const SONIOX_API_WEBHOOK_SECRET_ENV = "SONIOX_API_WEBHOOK_SECRET";
  */
 type RealtimeErrorCode = 'auth_error' | 'bad_request' | 'quota_exceeded' | 'connection_error' | 'network_error' | 'aborted' | 'state_error' | 'realtime_error';
 /**
- * All possible SDK error codes
+ * Error codes for HTTP client errors
+ */
+type HttpErrorCode = 'network_error' | 'timeout' | 'aborted' | 'http_error' | 'parse_error';
+/**
+ * HTTP methods supported by the client
+ */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
+/**
+ * Error details for SonioxHttpError
+ */
+interface HttpErrorDetails {
+  code: HttpErrorCode;
+  message: string;
+  url: string;
+  method: HttpMethod;
+  statusCode?: number | undefined;
+  headers?: Record<string, string> | undefined;
+  /** Response body text (capped at 4KB) */
+  bodyText?: string | undefined;
+  cause?: unknown;
+}
+/**
+ * All possible SDK error codes (real-time + HTTP-specific codes)
  */
-type SonioxErrorCode$1 = RealtimeErrorCode | 'soniox_error';
+type SonioxErrorCode = RealtimeErrorCode | 'soniox_error' | HttpErrorCode;
 //#endregion
 //#region ../core/src/errors.d.ts
-
 declare class SonioxError extends Error {
   /**
    * Error code describing the type of error.
    * Typed as `string` at the base level to allow subclasses (e.g. HTTP errors)
    * to use their own error code unions.
    */
-  readonly code: SonioxErrorCode$1 | (string & {});
+  readonly code: SonioxErrorCode | (string & {});
   /**
    * HTTP status code when applicable (e.g., 401 for auth errors, 500 for server errors).
    */
@@ -34,7 +57,36 @@ declare class SonioxError extends Error {
    * The underlying error that caused this error, if any.
    */
   readonly cause: unknown;
-  constructor(message: string, code?: SonioxErrorCode$1 | (string & {}), statusCode?: number, cause?: unknown);
+  constructor(message: string, code?: SonioxErrorCode | (string & {}), statusCode?: number, cause?: unknown);
+  /**
+   * Creates a human-readable string representation
+   */
+  toString(): string;
+  /**
+   * Converts to a plain object for logging/serialization
+   */
+  toJSON(): Record<string, unknown>;
+}
+//#endregion
+//#region ../core/src/http-errors.d.ts
+/**
+ * HTTP error class for all HTTP-related failures (REST API).
+ *
+ * Thrown when HTTP requests fail due to network issues, timeouts,
+ * server errors, or response parsing failures.
+ */
+declare class SonioxHttpError extends SonioxError {
+  /** Categorized HTTP error code */
+  readonly code: HttpErrorCode;
+  /** Request URL */
+  readonly url: string;
+  /** HTTP method */
+  readonly method: HttpMethod;
+  /** Response headers (only for http_error) */
+  readonly headers: Record<string, string> | undefined;
+  /** Response body text, capped at 4KB (only for http_error/parse_error) */
+  readonly bodyText: string | undefined;
+  constructor(details: HttpErrorDetails);
   /**
    * Creates a human-readable string representation
    */
@@ -44,6 +96,39 @@ declare class SonioxError extends Error {
    */
   toJSON(): Record<string, unknown>;
 }
+/**
+ * Creates a network error
+ */
+declare function createNetworkError(url: string, method: HttpMethod, cause: unknown): SonioxHttpError;
+/**
+ * Creates a timeout error
+ */
+declare function createTimeoutError(url: string, method: HttpMethod, timeoutMs: number): SonioxHttpError;
+/**
+ * Creates an abort error
+ */
+declare function createAbortError(url: string, method: HttpMethod, cause?: unknown): SonioxHttpError;
+/**
+ * Creates an HTTP error (non-2xx status)
+ */
+declare function createHttpError(url: string, method: HttpMethod, statusCode: number, headers: Record<string, string>, bodyText: string): SonioxHttpError;
+/**
+ * Creates a parse error (invalid JSON, etc.)
+ */
+declare function createParseError(url: string, method: HttpMethod, bodyText: string, cause: unknown): SonioxHttpError;
+/**
+ * Type guard to check if an error is an AbortError
+ */
+declare function isAbortError(error: unknown): boolean;
+/**
+ * Type guard to check if an error is any SonioxError (base class).
+ * This catches all SDK errors including HTTP and real-time errors.
+ */
+declare function isSonioxError(error: unknown): error is SonioxError;
+/**
+ * Type guard to check if an error is a SonioxHttpError
+ */
+declare function isSonioxHttpError(error: unknown): error is SonioxHttpError;
 //#endregion
 //#region ../core/src/types/transcriptions.d.ts
 /**
@@ -218,6 +303,13 @@ type SttSessionOptions = {
    * @default 5000
    */
   keepalive_interval_ms?: number | undefined;
+  /**
+   * Maximum time to wait for the WebSocket connection to open (milliseconds).
+   * If the connection is not established within this time, a
+   * {@link ConnectionError} with message "Connection timed out" is thrown.
+   * @default 20000
+   */
+  connect_timeout_ms?: number | undefined;
 };
 /**
  * A single token from the real-time transcription.
@@ -431,6 +523,14 @@ type RealtimeEvent = {
  * Session lifecycle states.
  */
 type SttSessionState = 'idle' | 'connecting' | 'connected' | 'finishing' | 'finished' | 'canceled' | 'closed' | 'error';
+/**
+ * Reason for a state transition.
+ *
+ * Provided as an optional field on `state_change` events so consumers
+ * can distinguish user-initiated actions from automatic reconnections,
+ * connection failures, etc.
+ */
+type StateChangeReason = 'user_action' | 'connected' | 'connection_lost' | 'reconnecting' | 'reconnected' | 'error' | 'finished';
 /**
  * Event handlers for the STT session.
  */
@@ -473,6 +573,7 @@ type SttSessionEvents = {
   state_change: (update: {
     old_state: SttSessionState;
     new_state: SttSessionState;
+    reason?: StateChangeReason;
   }) => void;
 };
 /**
@@ -496,6 +597,368 @@ type SendStreamOptions = {
   finish?: boolean | undefined;
 };
 //#endregion
+//#region ../core/src/realtime/errors.d.ts
+/**
+ * Base error class for all real-time (WebSocket) SDK errors
+ */
+declare class RealtimeError extends SonioxError {
+  /** Real-time error code */
+  readonly code: RealtimeErrorCode;
+  /**
+   * Original response payload for debugging.
+   * Contains the raw WebSocket message that caused the error.
+   */
+  readonly raw: unknown;
+  constructor(message: string, code?: RealtimeErrorCode, statusCode?: number, raw?: unknown);
+  /**
+   * Creates a human-readable string representation
+   */
+  toString(): string;
+  /**
+   * Converts to a plain object for logging/serialization
+   */
+  toJSON(): Record<string, unknown>;
+}
+/**
+ * Authentication error (401).
+ * Thrown when the API key is invalid or expired.
+ */
+declare class AuthError extends RealtimeError {
+  constructor(message: string, statusCode?: number, raw?: unknown);
+}
+/**
+ * Bad request error (400).
+ * Thrown for invalid configuration or parameters.
+ */
+declare class BadRequestError extends RealtimeError {
+  constructor(message: string, statusCode?: number, raw?: unknown);
+}
+/**
+ * Quota error (402, 429).
+ * Thrown when rate limits are exceeded or quota is exhausted.
+ */
+declare class QuotaError extends RealtimeError {
+  constructor(message: string, statusCode?: number, raw?: unknown);
+}
+/**
+ * Connection error.
+ * Thrown for WebSocket connection failures and transport errors.
+ */
+declare class ConnectionError extends RealtimeError {
+  constructor(message: string, raw?: unknown);
+}
+/**
+ * Network error.
+ * Thrown for server-side network issues (408, 500, 503).
+ */
+declare class NetworkError extends RealtimeError {
+  constructor(message: string, statusCode?: number, raw?: unknown);
+}
+/**
+ * Abort error.
+ * Thrown when an operation is cancelled via AbortSignal.
+ */
+declare class AbortError extends RealtimeError {
+  constructor(message?: string);
+}
+/**
+ * State error.
+ * Thrown when an operation is attempted in an invalid state.
+ */
+declare class StateError extends RealtimeError {
+  constructor(message: string);
+}
+//#endregion
+//#region ../core/src/types/tts.d.ts
+/**
+ * Supported audio formats for Text-to-Speech output.
+ */
+type TtsAudioFormat = 'pcm_f32le' | 'pcm_s16le' | 'pcm_mulaw' | 'pcm_alaw' | 'wav' | 'aac' | 'mp3' | 'opus' | 'flac' | (string & {});
+/**
+ * Input for creating a TTS stream. All fields are optional and are merged
+ * with `tts_defaults` from the resolved connection config. After merging,
+ * `model`, `language`, `voice`, and `audio_format` must be present.
+ */
+type TtsStreamInput = {
+  /**
+   * Text-to-Speech model to use.
+   * @example 'tts-rt-v1-preview'
+   */
+  model?: string | undefined;
+  /**
+   * Language code for speech generation.
+   * @example 'en'
+   */
+  language?: string | undefined;
+  /**
+   * Voice identifier.
+   * @example 'Adrian'
+   */
+  voice?: string | undefined;
+  /**
+   * Output audio format
+   * @example 'wav'
+   */
+  audio_format?: TtsAudioFormat | undefined;
+  /**
+   * Output sample rate in Hz. Required for raw PCM formats.
+   */
+  sample_rate?: number | undefined;
+  /**
+   * Codec bitrate in bps (for compressed formats).
+   */
+  bitrate?: number | undefined;
+  /**
+   * Client-generated stream identifier. Must be unique among active streams
+   * on the same connection. Auto-generated if omitted.
+   */
+  stream_id?: string | undefined;
+};
+/**
+ * Fully resolved TTS stream config sent over the WebSocket.
+ * All required fields are present after merging input with defaults.
+ */
+type TtsStreamConfig = {
+  model: string;
+  language: string;
+  voice: string;
+  audio_format: string;
+  sample_rate?: number | undefined;
+  bitrate?: number | undefined;
+  stream_id: string;
+};
+/**
+ * Events emitted by a TTS WebSocket connection.
+ */
+type TtsConnectionEvents = {
+  /**
+   * A connection-level error occurred. Always a {@link RealtimeError}
+   * subclass (e.g. {@link ConnectionError}, {@link NetworkError},
+   * {@link AuthError}).
+   */
+  error: (error: RealtimeError) => void;
+  /** The WebSocket connection was closed. */
+  close: () => void;
+};
+/**
+ * Options for creating a TTS connection.
+ */
+type TtsConnectionOptions = {
+  /**
+   * Interval for sending keepalive messages (milliseconds).
+   * @default 5000
+   * @minimum 1000
+   */
+  keepalive_interval_ms?: number | undefined;
+  /**
+   * Maximum time to wait for the WebSocket connection to open (milliseconds).
+   * @default 20000
+   */
+  connect_timeout_ms?: number | undefined;
+};
+/**
+ * Events emitted by a TTS stream.
+ */
+type TtsStreamEvents = {
+  /** Decoded audio chunk received. */
+  audio: (chunk: Uint8Array) => void;
+  /** Server marked the final audio payload for this stream. */
+  audioEnd: () => void;
+  /** Stream has been fully terminated by the server. */
+  terminated: () => void;
+  /**
+   * A stream-level error occurred. Always a {@link RealtimeError}
+   * subclass mapped from the server `error_code` / `error_message`.
+   */
+  error: (error: RealtimeError) => void;
+};
+/**
+ * Lifecycle states for a TTS stream.
+ */
+type TtsStreamState = 'active' | 'finishing' | 'ended' | 'error';
+/**
+ * Raw JSON event received from the TTS WebSocket server.
+ */
+type TtsEvent = {
+  stream_id?: string | undefined;
+  audio?: string | undefined;
+  audio_end?: boolean | undefined;
+  terminated?: boolean | undefined;
+  error_code?: number | undefined;
+  error_message?: string | undefined;
+};
+/**
+ * Options for REST TTS generation (`generate` / `generateStream`).
+ */
+type GenerateSpeechOptions = {
+  /** Input text to generate as speech. */
+  text: string;
+  /** Text-to-Speech model to use. @default 'tts-rt-v1-preview' */
+  model?: string | undefined;
+  /** Language code. @default 'en' */
+  language?: string | undefined;
+  /** Voice identifier. */
+  voice: string;
+  /**
+   * Output audio format
+   * @default 'wav'
+   */
+  audio_format?: string | undefined;
+  /** Output sample rate in Hz. Required for raw PCM formats. */
+  sample_rate?: number | undefined;
+  /** Codec bitrate in bps (for compressed formats). */
+  bitrate?: number | undefined;
+  /** Optional AbortSignal for cancellation. */
+  signal?: AbortSignal | undefined;
+};
+/**
+ * A Text-to-Speech voice.
+ */
+type TtsVoice = {
+  /** Unique identifier of the voice. */
+  id: string;
+};
+/**
+ * A Text-to-Speech model.
+ */
+type TtsModel = {
+  /** Unique identifier of the model. */
+  id: string;
+  /** If this is an alias, the id of the aliased model. */
+  aliased_model_id?: string | null;
+  /** Name of the model. */
+  name: string;
+  /** Voices supported by this model. */
+  voices: TtsVoice[];
+};
+//#endregion
+//#region ../core/src/connection.d.ts
+/**
+ * Soniox deployment region.
+ *
+ * Defined regions:
+ * - `'eu'` — European Union (`*.eu.soniox.com`)
+ * - `'jp'` — Japan (`*.jp.soniox.com`)
+ * - `undefined` — Default (United States). The US region has no subdomain.
+ *
+ * A region name (other than `'us'`) is shorthand for setting `base_domain`
+ * to `{region}.soniox.com`. The string `'us'` is accepted and normalized to
+ * the default (United States) base domain; there is no `us.soniox.com` host.
+ *
+ * The type stays open (`string & {}`) for forward compatibility with regions
+ * added after this SDK version was published, but passing an unknown region
+ * simply prepends it as a subdomain and may not resolve.
+ *
+ * @see https://soniox.com/docs/stt/data-residency
+ */
+type SonioxRegion = 'eu' | 'jp' | (string & {});
+/**
+ * Connection configuration for Soniox APIs.
+ *
+ * Can be provided as a plain object (sync) or returned from an async function
+ * to support fetching configuration from a server at runtime.
+ */
+type SonioxConnectionConfig = {
+  /** API key for authentication. */
+  api_key: string;
+  /**
+   * Deployment region. Determines which regional endpoints are used.
+   * Leave `undefined` for the default (US) region.
+   *
+   * Shorthand for `base_domain: '{region}.soniox.com'`.
+   * `base_domain` takes precedence when both are provided.
+   *
+   * @see https://soniox.com/docs/stt/data-residency
+   */
+  region?: SonioxRegion | undefined;
+  /**
+   * Base domain for all Soniox service URLs.
+   *
+   * A single override that derives all four service endpoints:
+   * - `api_domain`  → `https://api.{base_domain}`
+   * - `stt_ws_url`  → `wss://stt-rt.{base_domain}/transcribe-websocket`
+   * - `tts_api_url` → `https://tts-rt.{base_domain}`
+   * - `tts_ws_url`  → `wss://tts-rt.{base_domain}/tts-websocket`
+   *
+   * Takes precedence over `region`. Individual URL fields (`api_domain`,
+   * `stt_ws_url`, etc.) still take final precedence over this value.
+   *
+   * @example 'eu.soniox.com'
+   */
+  base_domain?: string | undefined;
+  /**
+   * REST API domain override (e.g. `'https://api.eu.soniox.com'`).
+   * When set, takes precedence over the region-derived domain.
+   */
+  api_domain?: string | undefined;
+  /**
+   * STT WebSocket URL override (e.g. `'wss://stt-rt.eu.soniox.com/transcribe-websocket'`).
+   * When set, takes precedence over the region-derived URL.
+   */
+  stt_ws_url?: string | undefined;
+  /**
+   * TTS REST API URL override (e.g. `'https://tts-rt.eu.soniox.com'`).
+   * When set, takes precedence over the region-derived URL.
+   */
+  tts_api_url?: string | undefined;
+  /**
+   * TTS WebSocket URL override (e.g. `'wss://tts-rt.eu.soniox.com/tts-websocket'`).
+   * When set, takes precedence over the region-derived URL.
+   */
+  tts_ws_url?: string | undefined;
+  /**
+   * Server-provided STT session defaults (model, language hints, context, etc.).
+   *
+   * Available to the `session_config` function passed to `client.realtime.record()`,
+   * allowing server-driven defaults. Not applied automatically — the caller must
+   * explicitly spread them.
+   */
+  stt_defaults?: Partial<SttSessionConfig> | undefined;
+  /**
+   * Server-provided TTS stream defaults (model, voice, language, audio_format, etc.).
+   *
+   * Automatically merged as the base layer when opening TTS streams.
+   * Caller-provided fields override these defaults.
+   */
+  tts_defaults?: Partial<TtsStreamConfig> | undefined;
+  /**
+   * @deprecated Use `stt_defaults` instead. Kept as an alias for backward
+   * compatibility; the resolver treats it as equivalent to `stt_defaults`
+   * when that field is absent. Planned for removal in the next major version.
+   */
+  session_defaults?: Partial<SttSessionConfig> | undefined;
+};
+/**
+ * Fully resolved connection configuration with all URLs determined.
+ */
+type ResolvedConnectionConfig = {
+  api_key: string;
+  api_domain: string;
+  stt_ws_url: string;
+  tts_api_url: string;
+  tts_ws_url: string;
+  /** Server-provided STT session defaults (empty object when not provided). */
+  stt_defaults: Partial<SttSessionConfig>;
+  /** Server-provided TTS stream defaults (empty object when not provided). */
+  tts_defaults: Partial<TtsStreamConfig>;
+  /**
+   * @deprecated Use `stt_defaults` instead. Kept in the resolver output as
+   * an alias for backward compatibility; planned for removal in the next
+   * major version.
+   */
+  session_defaults: Partial<SttSessionConfig>;
+};
+/**
+ * Resolve a {@link SonioxConnectionConfig} into fully qualified URLs.
+ *
+ * Resolution priority (highest → lowest) for each URL:
+ * 1. Explicit field (`api_domain`, `stt_ws_url`, `tts_api_url`, `tts_ws_url`)
+ * 2. Derived from `base_domain`
+ * 3. Derived from `region` → `{region}.soniox.com`
+ * 4. Default US base domain (`soniox.com`)
+ */
+declare function resolveConnectionConfig(config: SonioxConnectionConfig): ResolvedConnectionConfig;
+//#endregion
 //#region ../core/src/realtime/stt.d.ts
 /**
  * Real-time Speech-to-Text session
@@ -521,10 +984,12 @@ type SendStreamOptions = {
 declare class RealtimeSttSession implements AsyncIterable<RealtimeEvent> {
   private readonly emitter;
   private readonly eventQueue;
+  private iteratorAttached;
   private readonly apiKey;
   private readonly wsBaseUrl;
   private readonly config;
   private readonly keepaliveIntervalMs;
+  private readonly connectTimeoutMs;
   private readonly signal;
   private ws;
   private _state;
@@ -608,8 +1073,25 @@ declare class RealtimeSttSession implements AsyncIterable<RealtimeEvent> {
   off<E extends keyof SttSessionEvents>(event: E, handler: SttSessionEvents[E]): this;
   /**
    * Async iterator for consuming events.
+   *
+   * The returned iterator's `return()` resets the internal iterator-attach
+   * flag and drops any buffered events, so consumers that exit `for await`
+   * early (via `break` etc.) stop accruing memory while the session keeps
+   * running.
    */
   [Symbol.asyncIterator](): AsyncIterator<RealtimeEvent>;
+  /**
+   * @internal Debug-only: forcefully close the underlying WebSocket to
+   * simulate an unexpected network disconnection.
+   */
+  __debugForceDisconnect(): void;
+  /**
+   * Push an event to the async iterator queue only when a consumer has
+   * attached via `[Symbol.asyncIterator]()`. Listener-only consumers
+   * (the documented `.on()` pattern) never drain the queue, so pushing
+   * unconditionally would leak buffered events on long-running sessions.
+   */
+  private enqueueIfIterating;
   private createWebSocket;
   private handleMessage;
   private handleClose;
@@ -626,6 +1108,196 @@ declare class RealtimeSttSession implements AsyncIterable<RealtimeEvent> {
   private updateKeepalive;
 }
 //#endregion
+//#region ../core/src/realtime/emitter.d.ts
+/**
+ * A minimal, runtime-agnostic typed event emitter.
+ * Does not depend on Node.js EventEmitter.
+ */
+declare class TypedEmitter<Events extends Record<string, (...args: any[]) => void>> {
+  private listeners;
+  private readonly errorEvent;
+  /**
+   * Register an event handler.
+   */
+  on<E extends keyof Events>(event: E, handler: Events[E]): this;
+  /**
+   * Register a one-time event handler.
+   */
+  once<E extends keyof Events>(event: E, handler: Events[E]): this;
+  /**
+   * Remove an event handler.
+   */
+  off<E extends keyof Events>(event: E, handler: Events[E]): this;
+  /**
+   * Emit an event to all registered handlers.
+   * Handler errors do not prevent other handlers from running.
+   * Errors are reported to an `error` event if present, otherwise rethrown async.
+   */
+  emit<E extends keyof Events>(event: E, ...args: Parameters<Events[E]>): void;
+  /**
+   * Remove all event handlers.
+   */
+  removeAllListeners(event?: keyof Events): void;
+  private reportListenerError;
+  private normalizeError;
+  private scheduleThrow;
+}
+//#endregion
+//#region ../core/src/realtime/tts.d.ts
+/**
+ * Handle for one TTS stream on a WebSocket connection.
+ *
+ * Emits typed events and supports async iteration over decoded audio chunks.
+ *
+ * @example Event-based
+ * ```typescript
+ * stream.on('audio', (chunk) => process(chunk));
+ * stream.on('terminated', () => console.log('done'));
+ * stream.sendText("Hello world");
+ * stream.finish();
+ * ```
+ *
+ * @example Async iteration
+ * ```typescript
+ * stream.sendText("Hello world");
+ * stream.finish();
+ * for await (const chunk of stream) {
+ *   process(chunk);
+ * }
+ * ```
+ */
+declare class RealtimeTtsStream extends TypedEmitter<TtsStreamEvents> implements AsyncIterable<Uint8Array> {
+  readonly streamId: string;
+  private _state;
+  private readonly audioQueue;
+  private iteratorAttached;
+  private readonly connection;
+  private readonly ownsConnection;
+  /** @internal */
+  constructor(streamId: string, connection: RealtimeTtsConnection, ownsConnection: boolean);
+  /** Current stream lifecycle state. */
+  get state(): TtsStreamState;
+  /**
+   * Send one text chunk to the TTS stream.
+   *
+   * @param text - Text to synthesize
+   * @param options.end - If true, signals this is the final text chunk
+   */
+  sendText(text: string, options?: {
+    end?: boolean;
+  }): void;
+  /**
+   * Pipe an async iterable of text chunks into the stream.
+   * Automatically calls {@link finish} when the iterable completes.
+   *
+   * Designed for concurrent use: call `sendStream()` and consume audio
+   * via `for await` or events simultaneously.
+   *
+   * @example LLM token piping
+   * ```typescript
+   * stream.sendStream(llmTokenStream);
+   * for await (const audio of stream) { forward(audio); }
+   * ```
+   */
+  sendStream(source: AsyncIterable<string>): Promise<void>;
+  /**
+   * Signal that no more text will be sent for this stream.
+   * The server will finish generating audio and send `terminated`.
+   */
+  finish(): void;
+  /**
+   * Cancel this stream. The server will stop generating and send `terminated`.
+   */
+  cancel(): void;
+  /**
+   * Close this stream. For single-stream usage (created via `tts(input)`),
+   * also closes the underlying WebSocket connection.
+   */
+  close(): void;
+  /**
+   * Async iterator that yields decoded audio chunks.
+   *
+   * The returned iterator's `return()` resets the internal iterator-attach
+   * flag and drops any buffered audio, so consumers that exit `for await`
+   * early (via `break` etc.) stop accruing memory while the stream keeps
+   * receiving server audio.
+   */
+  [Symbol.asyncIterator](): AsyncIterator<Uint8Array>;
+  /**
+   * Push an audio chunk to the async iterator queue only when a consumer
+   * has attached via `[Symbol.asyncIterator]()`. Listener-only consumers
+   * (the documented `.on('audio', ...)` pattern) never drain the queue,
+   * so pushing unconditionally would leak buffered chunks.
+   */
+  private enqueueIfIterating;
+  /** @internal Dispatch a server event to this stream. */
+  _handleEvent(event: TtsEvent): void;
+  /** @internal Force-end this stream (connection closing). */
+  _forceEnd(): void;
+  private _endStream;
+}
+/**
+ * WebSocket connection for real-time Text-to-Speech.
+ *
+ * Supports up to 5 concurrent streams multiplexed by `stream_id`.
+ * The connection automatically sends keepalive messages while open.
+ *
+ * @example Multi-stream
+ * ```typescript
+ * const conn = new RealtimeTtsConnection(apiKey, wsUrl, ttsDefaults);
+ * await conn.connect();
+ *
+ * const s1 = conn.stream({ model, voice, language, audio_format });
+ * s1.sendText("Hello");
+ * s1.finish();
+ * for await (const chunk of s1) { ... }
+ *
+ * conn.close();
+ * ```
+ */
+declare class RealtimeTtsConnection extends TypedEmitter<TtsConnectionEvents> {
+  private readonly apiKey;
+  private readonly wsUrl;
+  private readonly ttsDefaults;
+  private readonly keepaliveIntervalMs;
+  private readonly connectTimeoutMs;
+  private ws;
+  private connected;
+  private connecting;
+  private keepaliveTimer;
+  private readonly activeStreams;
+  constructor(apiKey: string, wsUrl: string, ttsDefaults?: Partial<TtsStreamConfig>, options?: TtsConnectionOptions);
+  /** Whether the WebSocket is connected. */
+  get isConnected(): boolean;
+  /**
+   * Open the WebSocket connection and start keepalive.
+   * Called automatically by {@link stream} if not yet connected.
+   */
+  connect(): Promise<void>;
+  /**
+   * Open a new TTS stream on this connection.
+   * Auto-connects if the WebSocket is not yet open.
+   *
+   * @param input - Stream configuration (merged with tts_defaults)
+   * @returns A ready-to-use stream handle
+   */
+  stream(input?: TtsStreamInput): Promise<RealtimeTtsStream>;
+  /** @internal Open a stream, optionally marking it as connection-owning. */
+  _openStream(input: TtsStreamInput, ownsConnection: boolean): Promise<RealtimeTtsStream>;
+  /**
+   * Close the WebSocket connection and terminate all active streams.
+   */
+  close(): void;
+  /** @internal Send a JSON payload on the WebSocket. */
+  _sendJson(payload: Record<string, unknown>): void;
+  /** @internal Remove a stream from the active set. */
+  _deactivateStream(streamId: string): void;
+  private createWebSocket;
+  private handleMessage;
+  private startKeepalive;
+  private stopKeepalive;
+}
+//#endregion
 //#region ../core/src/realtime/segments.d.ts
 /**
  * Groups real-time tokens into segments based on specified grouping keys.
@@ -698,104 +1370,52 @@ declare class RealtimeUtteranceBuffer {
   reset(): void;
 }
 //#endregion
-//#region ../core/src/realtime/errors.d.ts
+//#region ../core/src/tts-rest.d.ts
 /**
- * Base error class for all real-time (WebSocket) SDK errors
+ * Browser-safe REST client for TTS generation.
+ *
+ * Provides `generate()` (buffered) and `generateStream()` (streaming)
+ * using only `globalThis.fetch`. HTTP failures are surfaced as
+ * {@link SonioxHttpError}, matching the rest of the Soniox SDK.
+ *
+ * Authentication uses the `Authorization: Bearer <api_key>` header.
+ *
+ * @example
+ * ```typescript
+ * const client = new TtsRestClient(apiKey, 'https://tts-rt.soniox.com');
+ * const audio = await client.generate({ text: 'Hello', voice: 'Adrian' });
+ * ```
  */
-declare class RealtimeError extends SonioxError {
-  /** Real-time error code */
-  readonly code: RealtimeErrorCode;
+declare class TtsRestClient {
+  private readonly apiKey;
+  private readonly ttsApiUrl;
+  constructor(apiKey: string, ttsApiUrl: string);
   /**
-   * Original response payload for debugging.
-   * Contains the raw WebSocket message that caused the error.
+   * Generate speech audio from text. Returns the full audio as a `Uint8Array`.
+   *
+   * @throws {@link SonioxHttpError} on non-2xx responses, network failures,
+   * or aborted requests.
    */
-  readonly raw: unknown;
-  constructor(message: string, code?: RealtimeErrorCode, statusCode?: number, raw?: unknown);
+  generate(options: GenerateSpeechOptions): Promise<Uint8Array>;
   /**
-   * Creates a human-readable string representation
+   * Generate speech audio from text as a streaming async iterable.
+   *
+   * Yields `Uint8Array` chunks as they arrive from the server response body.
+   * Lower time-to-first-audio than {@link generate}.
+   *
+   * **Known limitation:** Mid-stream server errors (reported via HTTP trailers)
+   * cannot be detected through the `fetch` API. The iterator may end early
+   * without an explicit error. Use WebSocket TTS for reliable error detection.
+   *
+   * @throws {@link SonioxHttpError} on non-2xx responses, network failures,
+   * or aborted requests (before the stream starts).
    */
-  toString(): string;
+  generateStream(options: GenerateSpeechOptions): AsyncIterable<Uint8Array>;
   /**
-   * Converts to a plain object for logging/serialization
+   * Internal request helper. Performs the fetch, maps network/abort failures
+   * to {@link SonioxHttpError}, and throws on non-2xx responses.
    */
-  toJSON(): Record<string, unknown>;
-}
-/**
- * Authentication error (401).
- * Thrown when the API key is invalid or expired.
- */
-declare class AuthError extends RealtimeError {
-  constructor(message: string, statusCode?: number, raw?: unknown);
-}
-/**
- * Bad request error (400).
- * Thrown for invalid configuration or parameters.
- */
-declare class BadRequestError extends RealtimeError {
-  constructor(message: string, statusCode?: number, raw?: unknown);
-}
-/**
- * Quota error (402, 429).
- * Thrown when rate limits are exceeded or quota is exhausted.
- */
-declare class QuotaError extends RealtimeError {
-  constructor(message: string, statusCode?: number, raw?: unknown);
-}
-/**
- * Connection error.
- * Thrown for WebSocket connection failures and transport errors.
- */
-declare class ConnectionError extends RealtimeError {
-  constructor(message: string, raw?: unknown);
-}
-/**
- * Network error.
- * Thrown for server-side network issues (408, 500, 503).
- */
-declare class NetworkError extends RealtimeError {
-  constructor(message: string, statusCode?: number, raw?: unknown);
-}
-/**
- * Abort error.
- * Thrown when an operation is cancelled via AbortSignal.
- */
-declare class AbortError extends RealtimeError {
-  constructor(message?: string);
-}
-/**
- * State error.
- * Thrown when an operation is attempted in an invalid state.
- */
-declare class StateError extends RealtimeError {
-  constructor(message: string);
-}
-//#endregion
-//#region src/types/public/errors.d.ts
-/**
- * Error codes for HTTP client errors
- */
-type HttpErrorCode = 'network_error' | 'timeout' | 'aborted' | 'http_error' | 'parse_error';
-/**
- * All possible SDK error codes (core real-time + HTTP-specific codes)
- */
-type SonioxErrorCode = RealtimeErrorCode | 'soniox_error' | HttpErrorCode;
-/**
- * HTTP methods supported by the client
- */
-type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
-/**
- * Error details for SonioxHttpError
- */
-interface HttpErrorDetails {
-  code: HttpErrorCode;
-  message: string;
-  url: string;
-  method: HttpMethod;
-  statusCode?: number | undefined;
-  headers?: Record<string, string> | undefined;
-  /** Response body text (capped at 4KB) */
-  bodyText?: string | undefined;
-  cause?: unknown;
+  private sendRequest;
 }
 //#endregion
 //#region src/types/public/http.d.ts
@@ -947,12 +1567,31 @@ type RealtimeClientOptions = {
    */
   api_key: string;
   /**
-   * WebSocket base URL for real-time connections.
+   * STT WebSocket base URL for real-time connections.
    * @default 'wss://stt-rt.soniox.com/transcribe-websocket'
    */
   ws_base_url: string;
   /**
-   * Default session options applied to all real-time sessions.
+   * TTS WebSocket URL for real-time connections.
+   * @default 'wss://tts-rt.soniox.com/tts-websocket'
+   */
+  tts_ws_url: string;
+  /**
+   * STT session config defaults. Merged as the base layer when opening
+   * STT sessions via `realtime.stt(config)`; caller fields override.
+   */
+  stt_defaults?: Partial<SttSessionConfig> | undefined;
+  /**
+   * TTS stream config defaults. Merged as the base layer when opening
+   * TTS streams via `realtime.tts(...)`; caller fields override.
+   */
+  tts_defaults?: Partial<TtsStreamConfig> | undefined;
+  /**
+   * Default TTS connection options.
+   */
+  tts_connection_options?: TtsConnectionOptions | undefined;
+  /**
+   * Default session options applied to all real-time STT sessions.
    * Can be overridden per-session.
    */
   default_session_options?: SttSessionOptions | undefined;
@@ -1825,7 +2464,7 @@ type HonoLikeContext = {
 };
 //#endregion
 //#region src/types/public/index.d.ts
-type TemporaryApiKeyUsageType = 'transcribe_websocket';
+type TemporaryApiKeyUsageType = 'transcribe_websocket' | 'tts_rt';
 type TemporaryApiKeyRequest = {
   /**
    * Intended usage of the temporary API key.
@@ -1859,16 +2498,44 @@ type TemporaryApiKeyResponse = {
  */
 type RealtimeOptions = {
   /**
-   * WebSocket base URL for real-time connections.
+   * STT WebSocket base URL for real-time connections.
    * Falls back to SONIOX_WS_URL environment variable,
    * then to 'wss://stt-rt.soniox.com/transcribe-websocket'.
    */
   ws_base_url?: string | undefined;
   /**
-   * Default session options applied to all real-time sessions.
+   * TTS WebSocket URL for real-time connections.
+   * Falls back to SONIOX_TTS_WS_URL environment variable,
+   * then to 'wss://tts-rt.soniox.com/tts-websocket'.
+   */
+  tts_ws_url?: string | undefined;
+  /**
+   * Default TTS connection options (keepalive interval, connect timeout).
+   */
+  tts_connection_options?: TtsConnectionOptions | undefined;
+  /**
+   * Default session options applied to all real-time STT sessions.
    * Can be overridden per-session.
    */
   default_session_options?: SttSessionOptions | undefined;
+  /**
+   * Default STT session config fields (model, language hints, context, etc.).
+   *
+   * Merged as the base layer when opening STT sessions via
+   * `client.realtime.stt(config)`. Fields on the caller-provided `config`
+   * override these defaults. Equivalent to
+   * {@link SonioxConnectionConfig.stt_defaults} on the web/react clients.
+   */
+  stt_defaults?: Partial<SttSessionConfig> | undefined;
+  /**
+   * Default TTS stream config fields (model, voice, language, audio_format, etc.).
+   *
+   * Merged as the base layer when opening TTS streams via
+   * `client.realtime.tts(...)`. Fields on the caller-provided
+   * {@link TtsStreamInput} override these defaults. Equivalent to
+   * {@link SonioxConnectionConfig.tts_defaults} on the web/react clients.
+   */
+  tts_defaults?: Partial<TtsStreamConfig> | undefined;
 };
 type SonioxNodeClientOptions = {
   /**
@@ -1876,16 +2543,62 @@ type SonioxNodeClientOptions = {
    * Falls back to SONIOX_API_KEY environment variable if not provided.
    */
   api_key?: string;
+  /**
+   * Deployment region. Determines which regional endpoints are used
+   * for both the REST API and real-time WebSocket connections.
+   *
+   * Leave `undefined` for the default (US) region.
+   * Shorthand for `base_domain: '{region}.soniox.com'`.
+   * `base_domain` takes precedence when both are provided.
+   *
+   * @see https://soniox.com/docs/stt/data-residency
+   */
+  region?: SonioxRegion | undefined;
+  /**
+   * Base domain for all Soniox service URLs.
+   *
+   * A single override that derives all service endpoints from the pattern
+   * `{service}.{base_domain}`. Takes precedence over `region`.
+   * Falls back to SONIOX_BASE_DOMAIN environment variable.
+   * Individual URL fields (`base_url`, `tts_api_url`, `realtime.ws_base_url`,
+   * `realtime.tts_ws_url`) still take final precedence.
+   *
+   * @example 'eu.soniox.com'
+   */
+  base_domain?: string | undefined;
   /**
    * Base URL for the REST API.
    * Falls back to SONIOX_API_BASE_URL environment variable,
-   * then to 'https://api.soniox.com'.
+   * then to the region-derived URL, then to 'https://api.soniox.com'.
    */
   base_url?: string;
+  /**
+   * TTS REST API URL.
+   * Falls back to SONIOX_TTS_API_URL environment variable,
+   * then to the region-derived URL, then to 'https://tts-rt.soniox.com'.
+   */
+  tts_api_url?: string;
   /**
    * Custom HTTP client implementation.
    */
   http_client?: HttpClient;
+  /**
+   * Default STT session config fields applied to every real-time STT session
+   * opened via `client.realtime.stt(config)`. Caller-provided fields override.
+   *
+   * Equivalent to {@link SonioxConnectionConfig.stt_defaults} on the
+   * web/react clients. Prefer this when you want the same defaults
+   * across your whole Node process.
+   */
+  stt_defaults?: Partial<SttSessionConfig> | undefined;
+  /**
+   * Default TTS stream config fields applied to every real-time TTS stream
+   * opened via `client.realtime.tts(...)`. Caller-provided fields override.
+   *
+   * Equivalent to {@link SonioxConnectionConfig.tts_defaults} on the
+   * web/react clients.
+   */
+  tts_defaults?: Partial<TtsStreamConfig> | undefined;
   /**
    * Real-time API configuration options.
    */
@@ -1902,6 +2615,19 @@ declare class SonioxAuthAPI {
    * @param request - Request parameters for the temporary key
    * @param signal - Optional AbortSignal for cancellation
    * @returns The temporary API key response
+   *
+   * @example
+   * ```typescript
+   * const sttKey = await client.auth.createTemporaryKey({
+   *   usage_type: 'transcribe_websocket',
+   *   expires_in_seconds: 300,
+   * });
+   *
+   * const ttsKey = await client.auth.createTemporaryKey({
+   *   usage_type: 'tts_rt',
+   *   expires_in_seconds: 300,
+   * });
+   * ```
    */
   createTemporaryKey(request: TemporaryApiKeyRequest, signal?: AbortSignal): Promise<TemporaryApiKeyResponse>;
 }
@@ -2721,6 +3447,59 @@ declare class SonioxSttApi {
   destroy_all(options?: DeleteAllTranscriptionsOptions): Promise<void>;
 }
 //#endregion
+//#region src/async/tts.d.ts
+/**
+ * REST API for Text-to-Speech generation and TTS model listing.
+ *
+ * Accessed via `client.tts` on {@link SonioxNodeClient}.
+ *
+ * Inherits browser-safe `generate()` and `generateStream()` from
+ * `TtsRestClient` in `@soniox/core`, and adds Node-specific methods
+ * `generateToFile()` and `listModels()`.
+ */
+declare class SonioxTtsApi extends TtsRestClient {
+  private readonly http;
+  constructor(apiKey: string, ttsApiUrl: string, http: HttpClient);
+  /**
+   * Generate speech audio and write to a file or writable stream.
+   *
+   * @param output - File path (string) or a `WritableStream<Uint8Array>`
+   * @param options - Generation options
+   * @returns Number of bytes written
+   *
+   * @example Write to file
+   * ```typescript
+   * const bytes = await client.tts.generateToFile('output.wav', {
+   *   text: 'Hello world',
+   *   voice: 'Adrian',
+   *   language: 'en',
+   * });
+   * ```
+   *
+   * @example Write to a writable stream
+   * ```typescript
+   * const bytes = await client.tts.generateToFile(writableStream, {
+   *   text: 'Hello world',
+   *   voice: 'Adrian',
+   *   language: 'en',
+   * });
+   * ```
+   */
+  generateToFile(output: string | WritableStream<Uint8Array>, options: GenerateSpeechOptions): Promise<number>;
+  /**
+   * List available TTS models and their voices.
+   *
+   * @example
+   * ```typescript
+   * const models = await client.tts.listModels();
+   * for (const model of models) {
+   *   console.log(model.id, model.voices.map(v => v.id));
+   * }
+   * ```
+   */
+  listModels(signal?: AbortSignal): Promise<TtsModel[]>;
+}
+//#endregion
 //#region src/async/webhooks.d.ts
 /**
  * Webhook utilities API accessible via client.webhooks
@@ -2799,48 +3578,134 @@ declare class SonioxWebhooksAPI {
 //#endregion
 //#region src/realtime/index.d.ts
 /**
- * Real-time API factory for creating STT sessions.
+ * Callable TTS factory with `.multiStream()` for multi-stream connections.
+ */
+interface TtsFactory {
+  /**
+   * Create a single-stream TTS connection.
+   * Opens a WebSocket, starts one stream, and returns a ready-to-use stream
+   * that owns its connection (closing the stream closes the connection).
+   *
+   * @example
+   * ```typescript
+   * const stream = await client.realtime.tts({
+   *   model: 'tts-rt-v1-preview',
+   *   voice: 'Adrian',
+   *   language: 'en',
+   *   audio_format: 'wav',
+   * });
+   * stream.sendText("Hello world");
+   * stream.finish();
+   * for await (const chunk of stream) { process(chunk); }
+   * ```
+   */
+  (input?: TtsStreamInput): Promise<RealtimeTtsStream>;
+  /**
+   * Create a multi-stream TTS connection.
+   * Opens a single WebSocket that can host up to 5 concurrent streams.
+   *
+   * @example
+   * ```typescript
+   * const conn = await client.realtime.tts.multiStream();
+   * const s1 = await conn.stream({
+   *   model: 'tts-rt-v1-preview',
+   *   voice: 'Adrian',
+   *   language: 'en',
+   *   audio_format: 'wav',
+   * });
+   * // Use any voice returned by client.tts.listModels()
+   * const s2 = await conn.stream({
+   *   model: 'tts-rt-v1-preview',
+   *   voice: someOtherVoice,
+   *   language: 'en',
+   *   audio_format: 'wav',
+   * });
+   * ```
+   */
+  multiStream(): Promise<RealtimeTtsConnection>;
+}
+/**
+ * Real-time API factory for creating STT sessions and TTS connections.
  *
- * @example
+ * @example STT
+ * ```typescript
+ * const session = client.realtime.stt({ model: 'stt-rt-v4' });
+ * await session.connect();
+ * ```
+ *
+ * @example TTS (single stream)
  * ```typescript
- * const session = client.realtime.stt({
- *   model: 'stt-rt-v4',
- *   enable_endpoint_detection: true,
+ * const stream = await client.realtime.tts({
+ *   model: 'tts-rt-v1-preview',
+ *   voice: 'Adrian',
+ *   language: 'en',
+ *   audio_format: 'wav',
  * });
+ * stream.sendText("Hello");
+ * stream.finish();
+ * for await (const chunk of stream) { ... }
+ * ```
  *
- * await session.connect();
+ * @example TTS (multi-stream)
+ * ```typescript
+ * const conn = await client.realtime.tts.multiStream();
+ * const stream = await conn.stream({
+ *   model: 'tts-rt-v1-preview',
+ *   voice: 'Adrian',
+ *   language: 'en',
+ *   audio_format: 'wav',
+ * });
  * ```
  */
 declare class SonioxRealtimeApi {
   private readonly options;
+  readonly tts: TtsFactory;
   constructor(options: RealtimeClientOptions);
   /**
    * Create a new Speech-to-Text session.
    *
-   * @param config - Session configuration (sent to server)
-   * @param options - Session options (SDK-level settings)
-   * @returns New STT session instance
+   * `config` is shallow-merged on top of `stt_defaults` from the client
+   * options; caller-provided fields override the defaults.
    */
   stt(config: SttSessionConfig, options?: SttSessionOptions): RealtimeSttSession;
+  private createSingleTtsStream;
+  private createTtsConnection;
 }
 //#endregion
 //#region src/client.d.ts
 /**
  * Soniox Node Client
- * @returns {SonioxNodeClient}
  *
  * @example
  * ```typescript
  * import { SonioxNodeClient } from '@soniox/node';
  *
- * const client = new SonioxNodeClient({
- *   api_key: 'your-api-key',
+ * // Default (US) region
+ * const client = new SonioxNodeClient({ api_key: 'your-api-key' });
+ *
+ * // EU region
+ * const client = new SonioxNodeClient({ api_key: 'your-api-key', region: 'eu' });
+ *
+ * // REST TTS
+ * const audio = await client.tts.generate({
+ *   text: 'Hello',
+ *   voice: 'Adrian',
+ *   language: 'en',
+ * });
+ *
+ * // WebSocket TTS
+ * const stream = await client.realtime.tts({
+ *   model: 'tts-rt-v1-preview',
+ *   voice: 'Adrian',
+ *   language: 'en',
+ *   audio_format: 'wav',
  * });
  * ```
  */
 declare class SonioxNodeClient {
   readonly files: SonioxFilesAPI;
   readonly stt: SonioxSttApi;
+  readonly tts: SonioxTtsApi;
   readonly models: SonioxModelsAPI;
   readonly webhooks: SonioxWebhooksAPI;
   readonly auth: SonioxAuthAPI;
@@ -2932,68 +3797,6 @@ declare class FetchHttpClient implements HttpClient {
   private normalizeError;
 }
 //#endregion
-//#region src/http/errors.d.ts
-/**
- * HTTP error class for all HTTP-related failures (REST API).
- *
- * Thrown when HTTP requests fail due to network issues, timeouts,
- * server errors, or response parsing failures.
- */
-declare class SonioxHttpError extends SonioxError {
-  /** Categorized HTTP error code */
-  readonly code: HttpErrorCode;
-  /** Request URL */
-  readonly url: string;
-  /** HTTP method */
-  readonly method: HttpMethod;
-  /** Response headers (only for http_error) */
-  readonly headers: Record<string, string> | undefined;
-  /** Response body text, capped at 4KB (only for http_error/parse_error) */
-  readonly bodyText: string | undefined;
-  constructor(details: HttpErrorDetails);
-  /**
-   * Creates a human-readable string representation
-   */
-  toString(): string;
-  /**
-   * Converts to a plain object for logging/serialization
-   */
-  toJSON(): Record<string, unknown>;
-}
-/**
- * Creates a network error
- */
-declare function createNetworkError(url: string, method: HttpMethod, cause: unknown): SonioxHttpError;
-/**
- * Creates a timeout error
- */
-declare function createTimeoutError(url: string, method: HttpMethod, timeoutMs: number): SonioxHttpError;
-/**
- * Creates an abort error
- */
-declare function createAbortError(url: string, method: HttpMethod, cause?: unknown): SonioxHttpError;
-/**
- * Creates an HTTP error (non-2xx status)
- */
-declare function createHttpError(url: string, method: HttpMethod, statusCode: number, headers: Record<string, string>, bodyText: string): SonioxHttpError;
-/**
- * Creates a parse error (invalid JSON, etc.)
- */
-declare function createParseError(url: string, method: HttpMethod, bodyText: string, cause: unknown): SonioxHttpError;
-/**
- * Type guard to check if an error is an AbortError
- */
-declare function isAbortError(error: unknown): boolean;
-/**
- * Type guard to check if an error is any SonioxError (base class).
- * This catches all SDK errors including HTTP and real-time errors.
- */
-declare function isSonioxError(error: unknown): error is SonioxError;
-/**
- * Type guard to check if an error is a SonioxHttpError
- */
-declare function isSonioxHttpError(error: unknown): error is SonioxHttpError;
-//#endregion
 //#region src/http/url.d.ts
 /**
  * Builds a complete URL from base URL, path, and query parameters
@@ -3008,5 +3811,5 @@ declare function normalizeHeaders(headers: Headers): Record<string, string>;
  */
 declare function mergeHeaders(...headerObjects: (Record<string, string> | undefined)[]): Record<string, string>;
 //#endregion
-export { AbortError, type AudioData, type AudioFormat, AuthError, BadRequestError, type CleanupTarget, ConnectionError, type ContextGeneralEntry, type ContextTranslationTerm, type CreateTranscriptionOptions, type DeleteAllFilesOptions, type DeleteAllTranscriptionsOptions, type ExpressLikeRequest, type FastifyLikeRequest, FetchHttpClient, type FileIdentifier, FileListResult, type HandleWebhookOptions, type HonoLikeContext, type HttpClient, type HttpClientOptions, type HttpErrorCode, type HttpErrorDetails, type HttpMethod, type HttpObservabilityHooks, type HttpRequest, type HttpRequestBody, type HttpRequestMeta, type HttpResponse, type HttpResponseMeta, type HttpResponseType, type ISonioxTranscript, type ISonioxTranscription, type ListFilesOptions, type ListFilesResponse, type ListTranscriptionsOptions, type ListTranscriptionsResponse, type NestJSLikeRequest, NetworkError, type OneWayTranslationConfig, type QueryParams, QuotaError, type RealtimeClientOptions, RealtimeError, type RealtimeErrorCode, type RealtimeEvent, RealtimeOptions, type RealtimeResult, type RealtimeSegment, RealtimeSegmentBuffer, type RealtimeSegmentBufferOptions, type RealtimeSegmentOptions, RealtimeSttSession, type RealtimeToken, type RealtimeUtterance, RealtimeUtteranceBuffer, type RealtimeUtteranceBufferOptions, SONIOX_API_BASE_URL, SONIOX_API_WEBHOOK_HEADER_ENV, SONIOX_API_WEBHOOK_SECRET_ENV, SONIOX_API_WS_URL, SONIOX_TMP_API_KEY_DURATION_MAX, SONIOX_TMP_API_KEY_DURATION_MIN, SONIOX_TMP_API_KEY_USAGE_TYPE, type SegmentGroupKey, type SegmentTranscriptOptions, type SendStreamOptions, SonioxError, type SonioxErrorCode, SonioxFile, type SonioxFileData, SonioxHttpError, type SonioxLanguage, type SonioxModel, SonioxNodeClient, SonioxNodeClientOptions, SonioxRealtimeApi, SonioxTranscript, SonioxTranscription, type SonioxTranscriptionData, type SonioxTranscriptionMode, type SonioxTranslationTarget, StateError, type SttSessionConfig, type SttSessionEvents, type SttSessionOptions, type SttSessionState, TemporaryApiKeyRequest, TemporaryApiKeyResponse, TemporaryApiKeyUsageType, type TranscribeBaseOptions, type TranscribeFromFile, type TranscribeFromFileId, type TranscribeFromFileIdOptions, type TranscribeFromFileOptions, type TranscribeFromUrl, type TranscribeFromUrlOptions, type TranscribeOptions, type TranscriptResponse, type TranscriptSegment, type TranscriptToken, type TranscriptionContext, type TranscriptionIdentifier, TranscriptionListResult, type TranscriptionStatus, type TranslationConfig, type TwoWayTranslationConfig, type UploadFileInput, type UploadFileOptions, type WaitOptions, type WebhookAuthConfig, type WebhookEvent, type WebhookEventStatus, type WebhookHandlerResult, type WebhookHandlerResultWithFetch, type WebhookHeaders, buildUrl, createAbortError, createHttpError, createNetworkError, createParseError, createTimeoutError, isAbortError, isSonioxError, isSonioxHttpError, mergeHeaders, normalizeHeaders, segmentRealtimeTokens, segmentTranscript };
+export { AbortError, type AudioData, type AudioFormat, AuthError, BadRequestError, type CleanupTarget, ConnectionError, type ContextGeneralEntry, type ContextTranslationTerm, type CreateTranscriptionOptions, type DeleteAllFilesOptions, type DeleteAllTranscriptionsOptions, type ExpressLikeRequest, type FastifyLikeRequest, FetchHttpClient, type FileIdentifier, FileListResult, type GenerateSpeechOptions, type HandleWebhookOptions, type HonoLikeContext, type HttpClient, type HttpClientOptions, type HttpErrorCode, type HttpErrorDetails, type HttpMethod, type HttpObservabilityHooks, type HttpRequest, type HttpRequestBody, type HttpRequestMeta, type HttpResponse, type HttpResponseMeta, type HttpResponseType, type ISonioxTranscript, type ISonioxTranscription, type ListFilesOptions, type ListFilesResponse, type ListTranscriptionsOptions, type ListTranscriptionsResponse, type NestJSLikeRequest, NetworkError, type OneWayTranslationConfig, type QueryParams, QuotaError, type RealtimeClientOptions, RealtimeError, type RealtimeErrorCode, type RealtimeEvent, RealtimeOptions, type RealtimeResult, type RealtimeSegment, RealtimeSegmentBuffer, type RealtimeSegmentBufferOptions, type RealtimeSegmentOptions, RealtimeSttSession, type RealtimeToken, RealtimeTtsConnection, RealtimeTtsStream, type RealtimeUtterance, RealtimeUtteranceBuffer, type RealtimeUtteranceBufferOptions, type ResolvedConnectionConfig, SONIOX_API_BASE_URL, SONIOX_API_WEBHOOK_HEADER_ENV, SONIOX_API_WEBHOOK_SECRET_ENV, SONIOX_API_WS_URL, SONIOX_TMP_API_KEY_DURATION_MAX, SONIOX_TMP_API_KEY_DURATION_MIN, SONIOX_TMP_API_KEY_USAGE_TYPE, SONIOX_TTS_API_BASE_URL, SONIOX_TTS_WS_URL, type SegmentGroupKey, type SegmentTranscriptOptions, type SendStreamOptions, type SonioxConnectionConfig, SonioxError, type SonioxErrorCode, SonioxFile, type SonioxFileData, SonioxHttpError, type SonioxLanguage, type SonioxModel, SonioxNodeClient, SonioxNodeClientOptions, SonioxRealtimeApi, type SonioxRegion, SonioxTranscript, SonioxTranscription, type SonioxTranscriptionData, type SonioxTranscriptionMode, type SonioxTranslationTarget, SonioxTtsApi, StateError, type SttSessionConfig, type SttSessionEvents, type SttSessionOptions, type SttSessionState, TemporaryApiKeyRequest, TemporaryApiKeyResponse, TemporaryApiKeyUsageType, type TranscribeBaseOptions, type TranscribeFromFile, type TranscribeFromFileId, type TranscribeFromFileIdOptions, type TranscribeFromFileOptions, type TranscribeFromUrl, type TranscribeFromUrlOptions, type TranscribeOptions, type TranscriptResponse, type TranscriptSegment, type TranscriptToken, type TranscriptionContext, type TranscriptionIdentifier, TranscriptionListResult, type TranscriptionStatus, type TranslationConfig, type TtsAudioFormat, type TtsConnectionEvents, type TtsConnectionOptions, type TtsEvent, type TtsModel, type TtsStreamConfig, type TtsStreamEvents, type TtsStreamInput, type TtsStreamState, type TtsVoice, type TwoWayTranslationConfig, type UploadFileInput, type UploadFileOptions, type WaitOptions, type WebhookAuthConfig, type WebhookEvent, type WebhookEventStatus, type WebhookHandlerResult, type WebhookHandlerResultWithFetch, type WebhookHeaders, buildUrl, createAbortError, createHttpError, createNetworkError, createParseError, createTimeoutError, isAbortError, isSonioxError, isSonioxHttpError, mergeHeaders, normalizeHeaders, resolveConnectionConfig, segmentRealtimeTokens, segmentTranscript };
 //# sourceMappingURL=index.d.mts.map