@audicle/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,966 @@
+import createClient from 'openapi-fetch';
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+	"/v1/health": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		/**
+		 * Service health check
+		 * @description Returns the health status of the service and its dependencies.
+		 */
+		get: operations["health-check"];
+		put?: never;
+		post?: never;
+		delete?: never;
+		options?: never;
+		head?: never;
+		patch?: never;
+		trace?: never;
+	};
+	"/v1/transcribe": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		/**
+		 * Stream audio for live transcription
+		 * @description Initiates a WebSocket connection for live audio transcription.
+		 *
+		 *     The `model` query parameter determines the transcription backend:
+		 *     - `default`, `turbo` — Whisper-based streaming (TranscriptionSession DO)
+		 *     - `gpt-realtime-mini`, `deepgram-nova-3` — LLM provider relay (RealtimeSession DO)
+		 *
+		 *     **Protocol:** Send binary audio frames (PCM s16le) over the WebSocket. The server responds with JSON messages:
+		 *     - `{"type": "session.begin", "id": "...", "model": "..."}` — connection established
+		 *     - `{"type": "transcript", "is_final": true/false, "transcript": {"text": "...", "start": 0.0, "end": 1.5}}` — transcription results
+		 *     - `{"type": "vad", "event": "speech_start|speech_end", "timestamp_ms": N}` — voice activity detection (realtime models only)
+		 *     - `{"type": "error", "code": "...", "message": "..."}` — error occurred
+		 *     - `{"type": "session.end", "reason": "...", "usage": {...}}` — session ended
+		 *
+		 *     **Client → Server JSON messages:**
+		 *     - `{"type": "finalize"}` — flush current audio buffer and get final transcript
+		 *     - `{"type": "stop"}` — end the session
+		 *     - `{"type": "configure", ...}` — update session config mid-stream
+		 *
+		 *     **WebSocket close codes:** 4400 (bad request), 4401 (unauthorized), 4402 (payment required), 4404 (not found), 4429 (rate limited).
+		 */
+		get: operations["stream-audio"];
+		put?: never;
+		/**
+		 * Transcribe audio
+		 * @description Transcribe audio. Supports two input modes:
+		 *
+		 *     1. **Raw binary** — Send audio bytes directly with `Content-Type: audio/*`. Options via query params.
+		 *     2. **Multipart** — Upload a file via `multipart/form-data` with a `file` field, or provide an `audio_url` to transcribe from a URL. Exactly one of `file` or `audio_url` is required.
+		 *
+		 *     **Sync by default.** Files under 25 MB return the completed transcript in the response (200). Larger files or `Prefer: respond-async` queue for async processing (202 with `Location` header).
+		 *
+		 *     Use `Prefer: wait=N` to set your timeout: "wait up to N seconds, otherwise give me a 202."
+		 *
+		 *     Use `Idempotency-Key` header for safe retries — same key within 24h returns the cached result.
+		 */
+		post: operations["transcribe-file"];
+		delete?: never;
+		options?: never;
+		head?: never;
+		patch?: never;
+		trace?: never;
+	};
+	"/v1/transcribe/{id}/observe": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		/**
+		 * Observe a live transcription session
+		 * @description Opens a read-only WebSocket that receives the same transcript messages as the primary session. Useful for dashboard live views.
+		 */
+		get: operations["observe-session"];
+		put?: never;
+		post?: never;
+		delete?: never;
+		options?: never;
+		head?: never;
+		patch?: never;
+		trace?: never;
+	};
+	"/v1/usage": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		/**
+		 * Get usage summary
+		 * @description Returns usage statistics for the authenticated user within a date range.
+		 */
+		get: operations["get-usage"];
+		put?: never;
+		post?: never;
+		delete?: never;
+		options?: never;
+		head?: never;
+		patch?: never;
+		trace?: never;
+	};
+	"/v1/transcripts": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		/**
+		 * List transcription jobs
+		 * @description Returns a paginated list of transcription jobs with cursor-based pagination.
+		 */
+		get: operations["list-transcripts"];
+		put?: never;
+		post?: never;
+		delete?: never;
+		options?: never;
+		head?: never;
+		patch?: never;
+		trace?: never;
+	};
+	"/v1/transcripts/{id}": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		/**
+		 * Get a transcription job
+		 * @description Returns the transcription job details. Use `?format=` to get alternative output formats: `json` (default), `text` (plain transcript), `srt` (SubRip subtitles), `vtt` (WebVTT subtitles).
+		 */
+		get: operations["get-transcript"];
+		put?: never;
+		post?: never;
+		/**
+		 * Delete a transcription job
+		 * @description Deletes the transcription job and associated result data from storage.
+		 */
+		delete: operations["delete-transcript"];
+		options?: never;
+		head?: never;
+		patch?: never;
+		trace?: never;
+	};
+}
+export interface components {
+	schemas: {
+		HealthResponse: {
+			/** @enum {string} */
+			status: "healthy" | "degraded" | "unhealthy";
+			version: string;
+			checks: {
+				database?: {
+					/** @enum {string} */
+					status: "pass" | "fail";
+					latency_ms: number;
+				};
+				storage?: {
+					/** @enum {string} */
+					status: "pass" | "fail";
+					latency_ms: number;
+				};
+				ai?: {
+					/** @enum {string} */
+					status: "pass" | "fail";
+					latency_ms: number;
+				};
+			};
+		};
+		ErrorResponse: {
+			error: {
+				code: string;
+				message: string;
+				request_id: string;
+				details?: {
+					[key: string]: unknown;
+				};
+			};
+		};
+		Transcription: {
+			id: string;
+			/** @enum {string} */
+			status: "queued" | "processing" | "streaming" | "completed" | "error";
+			language: string | null;
+			detected_language: string | null;
+			model: string;
+			speaker_labels: boolean;
+			word_timestamps: boolean;
+			duration_seconds: number | null;
+			audio_url: string | null;
+			webhook_url: string | null;
+			/** @enum {string|null} */
+			webhook_status: "pending" | "delivered" | "failed" | null;
+			metadata: {
+				[key: string]: string;
+			} | null;
+			error: {
+				code: string;
+				message: string;
+			} | null;
+			result: components["schemas"]["TranscriptionResult"];
+			usage: components["schemas"]["TranscriptionUsage"];
+			created_at: string;
+			updated_at: string;
+		};
+		/** @description Transcription result, populated when status is 'completed' */
+		TranscriptionResult: {
+			/** @description Full transcript text */
+			text: string;
+			/** @description Detected language code */
+			language?: string;
+			/** @description Audio duration in seconds */
+			duration_seconds?: number;
+			/** @description Transcript segments with timestamps */
+			segments: components["schemas"]["TranscriptionSegment"][];
+			/** @description Word-level timestamps */
+			words: components["schemas"]["TranscriptionWord"][];
+		} | null;
+		TranscriptionSegment: {
+			id: number;
+			start: number;
+			end: number;
+			text: string;
+			confidence?: number;
+			words?: components["schemas"]["TranscriptionWord"][];
+		};
+		TranscriptionWord: {
+			text: string;
+			start: number;
+			end: number;
+			confidence?: number;
+		};
+		/** @description Usage and cost info, populated when status is 'completed' */
+		TranscriptionUsage: {
+			duration_seconds: number;
+			cost_cents: number;
+			model: string;
+		} | null;
+		UsageResponse: {
+			total_requests: number;
+			total_duration_seconds: number;
+			total_cost_cents: number;
+			breakdown: {
+				period: string;
+				requests: number;
+				duration_seconds: number;
+				cost_cents: number;
+			}[];
+		};
+		TranscriptionListResponse: {
+			data: components["schemas"]["Transcription"][];
+			has_more: boolean;
+			next_cursor: string | null;
+		};
+	};
+	responses: never;
+	parameters: never;
+	requestBodies: never;
+	headers: never;
+	pathItems: never;
+}
+export interface operations {
+	"health-check": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description Service is healthy */
+			200: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["HealthResponse"];
+				};
+			};
+			/** @description Service is degraded or unhealthy */
+			503: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["HealthResponse"];
+				};
+			};
+		};
+	};
+	"stream-audio": {
+		parameters: {
+			query: {
+				/** @description API key for authentication */
+				token: string;
+				/** @description Transcription model */
+				model?: "default" | "turbo" | "gpt-realtime-mini" | "deepgram-nova-3";
+				/** @description ISO 639-1 language code */
+				language?: "af" | "am" | "ar" | "as" | "az" | "ba" | "be" | "bg" | "bn" | "bo" | "br" | "bs" | "ca" | "cs" | "cy" | "da" | "de" | "el" | "en" | "es" | "et" | "eu" | "fa" | "fi" | "fo" | "fr" | "gl" | "gu" | "ha" | "haw" | "he" | "hi" | "hr" | "ht" | "hu" | "hy" | "id" | "is" | "it" | "ja" | "jw" | "ka" | "kk" | "km" | "kn" | "ko" | "la" | "lb" | "ln" | "lo" | "lt" | "lv" | "mg" | "mi" | "mk" | "ml" | "mn" | "mr" | "ms" | "mt" | "my" | "ne" | "nl" | "nn" | "no" | "oc" | "pa" | "pl" | "ps" | "pt" | "ro" | "ru" | "sa" | "sd" | "si" | "sk" | "sl" | "sn" | "so" | "sq" | "sr" | "su" | "sv" | "sw" | "ta" | "te" | "tg" | "th" | "tk" | "tl" | "tr" | "tt" | "uk" | "ur" | "uz" | "vi" | "yi" | "yo" | "zh" | "yue";
+				/** @description Audio sample rate in Hz (8000-48000) */
+				sample_rate?: number;
+				/** @description Audio encoding */
+				encoding?: "pcm_s16le";
+				/** @description Include interim (partial) transcripts (realtime models only) */
+				interim_results?: boolean | null;
+			};
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description WebSocket connection established */
+			101: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content?: never;
+			};
+			/** @description Invalid request parameters */
+			400: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Invalid or missing API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Payment required */
+			402: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+	"transcribe-file": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		requestBody: {
+			content: {
+				"audio/*": string;
+				"multipart/form-data": {
+					/**
+					 * Format: binary
+					 * @description Audio file to transcribe (mutually exclusive with audio_url)
+					 */
+					file?: string;
+					/**
+					 * Format: uri
+					 * @description URL of audio file to transcribe (must be HTTPS, mutually exclusive with file)
+					 */
+					audio_url?: string;
+					/**
+					 * @default default
+					 * @enum {string}
+					 */
+					model?: "default" | "turbo";
+					language?: string;
+					/**
+					 * @description Enable speaker diarization
+					 * @default true
+					 * @enum {string}
+					 */
+					speaker_labels?: "true" | "false";
+					/**
+					 * @default true
+					 * @enum {string}
+					 */
+					word_timestamps?: "true" | "false";
+					webhook_url?: string;
+					/** @description JSON-encoded key-value pairs */
+					metadata?: string;
+				};
+			};
+		};
+		responses: {
+			/** @description Transcription completed synchronously */
+			200: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["Transcription"];
+				};
+			};
+			/** @description Transcription queued for async processing */
+			202: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["Transcription"];
+				};
+			};
+			/** @description Invalid request */
+			400: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Invalid or missing API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Payment required */
+			402: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description File too large */
+			413: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Rate limit exceeded */
+			429: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+	"observe-session": {
+		parameters: {
+			query: {
+				/** @description API key for authentication */
+				token: string;
+			};
+			header?: never;
+			path: {
+				/** @description Resource ID */
+				id: string;
+			};
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description WebSocket connection established */
+			101: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content?: never;
+			};
+			/** @description Invalid request */
+			400: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Invalid or missing API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Transcription not found */
+			404: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+	"get-usage": {
+		parameters: {
+			query: {
+				/** @description Start date (YYYY-MM-DD) */
+				start_date: string;
+				/** @description End date (YYYY-MM-DD) */
+				end_date: string;
+				/** @description Time granularity for breakdown */
+				granularity?: "hour" | "day";
+			};
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description Usage summary */
+			200: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["UsageResponse"];
+				};
+			};
+			/** @description Invalid request */
+			400: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Missing or invalid API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Rate limit exceeded */
+			429: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+	"list-transcripts": {
+		parameters: {
+			query?: {
+				cursor?: string;
+				/** @description Number of results (1-100, default 20) */
+				limit?: number;
+				status?: "queued" | "processing" | "streaming" | "completed" | "error";
+				/** @description ISO 8601 datetime */
+				created_after?: string;
+				/** @description ISO 8601 datetime */
+				created_before?: string;
+			};
+			header?: never;
+			path?: never;
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description List of transcriptions */
+			200: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["TranscriptionListResponse"];
+				};
+			};
+			/** @description Missing or invalid API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Rate limit exceeded */
+			429: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+	"get-transcript": {
+		parameters: {
+			query?: {
+				/** @description Output format: json (default), text, srt, or vtt */
+				format?: "json" | "text" | "srt" | "vtt";
+			};
+			header?: never;
+			path: {
+				/** @description Resource ID */
+				id: string;
+			};
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description Transcription details (json format). For text/srt/vtt formats, returns text/plain or text/vtt. */
+			200: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["Transcription"];
+				};
+			};
+			/** @description Missing or invalid API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Transcription not found */
+			404: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Rate limit exceeded */
+			429: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+	"delete-transcript": {
+		parameters: {
+			query?: never;
+			header?: never;
+			path: {
+				/** @description Resource ID */
+				id: string;
+			};
+			cookie?: never;
+		};
+		requestBody?: never;
+		responses: {
+			/** @description Transcription deleted */
+			204: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content?: never;
+			};
+			/** @description Missing or invalid API key */
+			401: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Transcription not found */
+			404: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+			/** @description Rate limit exceeded */
+			429: {
+				headers: {
+					[name: string]: unknown;
+				};
+				content: {
+					"application/json": components["schemas"]["ErrorResponse"];
+				};
+			};
+		};
+	};
+}
+/** Opaque type alias for the configured openapi-fetch client */
+export type ApiClient = ReturnType<typeof createClient<paths>>;
+export type Transcription = components["schemas"]["Transcription"];
+export type TranscriptionResult = components["schemas"]["TranscriptionResult"];
+export type TranscriptionSegment = components["schemas"]["TranscriptionSegment"];
+export type TranscriptionWord = components["schemas"]["TranscriptionWord"];
+export type TranscriptionUsage = components["schemas"]["TranscriptionUsage"];
+export type TranscriptionListResponse = components["schemas"]["TranscriptionListResponse"];
+export type UsageResponse = components["schemas"]["UsageResponse"];
+export type HealthResponse = components["schemas"]["HealthResponse"];
+export type ErrorResponse = components["schemas"]["ErrorResponse"];
+export type TranscriptionStatus = Transcription["status"];
+export type TranscriptionModel = "default" | "turbo" | "gpt-realtime-mini" | "deepgram-nova-3";
+export interface ListTranscriptsParams {
+	cursor?: string;
+	limit?: number;
+	status?: "queued" | "processing" | "streaming" | "completed" | "error";
+	createdAfter?: string;
+	createdBefore?: string;
+}
+export interface WaitOptions {
+	/** Polling interval in milliseconds (default: 3000) */
+	interval?: number;
+	/** Maximum time to wait in milliseconds (default: 300000 = 5 minutes) */
+	timeout?: number;
+}
+declare class TranscriptsResource {
+	#private;
+	constructor(api: ApiClient, baseUrl: string, apiKey: string);
+	get(id: string): Promise<Transcription>;
+	getText(id: string): Promise<string>;
+	getSrt(id: string): Promise<string>;
+	getVtt(id: string): Promise<string>;
+	list(params?: ListTranscriptsParams): Promise<TranscriptionListResponse>;
+	listAll(params?: Omit<ListTranscriptsParams, "cursor">): AsyncGenerator<Transcription>;
+	delete(id: string): Promise<void>;
+	wait(id: string, options?: WaitOptions): Promise<Transcription>;
+	private getFormatted;
+}
+export interface GetUsageParams {
+	startDate: string;
+	endDate: string;
+	granularity?: "hour" | "day";
+}
+declare class UsageResource {
+	#private;
+	constructor(api: ApiClient);
+	get(params: GetUsageParams): Promise<UsageResponse>;
+}
+export interface TranscribeFileInput {
+	file?: Blob | File | ArrayBuffer | Uint8Array;
+	audioUrl?: string;
+}
+export interface TranscribeOptions {
+	model?: "default" | "turbo";
+	language?: string;
+	speakerLabels?: boolean;
+	wordTimestamps?: boolean;
+	webhookUrl?: string;
+	metadata?: Record<string, string>;
+	idempotencyKey?: string;
+	/** Force async processing (returns 202 immediately) */
+	async?: boolean;
+	/** Max seconds to wait for sync result before falling back to 202 */
+	wait?: number;
+}
+export type Listener<T> = (data: T) => void;
+export declare class TypedEmitter<Events extends Record<string, unknown> = Record<string, unknown>> {
+	private listeners;
+	on<K extends keyof Events>(event: K, fn: Listener<Events[K]>): this;
+	off<K extends keyof Events>(event: K, fn: Listener<Events[K]>): this;
+	once<K extends keyof Events>(event: K, fn: Listener<Events[K]>): this;
+	protected emit<K extends keyof Events>(event: K, data: Events[K]): void;
+	removeAllListeners(): void;
+}
+export interface StreamWord {
+	text: string;
+	start: number;
+	end: number;
+	confidence?: number;
+	speaker?: string | null;
+	punctuated_word?: string;
+}
+export interface SessionBeginMessage {
+	type: "session.begin";
+	id: string;
+	model: string;
+}
+export interface TranscriptMessage {
+	type: "transcript";
+	is_final: boolean;
+	transcript: {
+		text: string;
+		start: number;
+		end: number;
+		words?: StreamWord[];
+	};
+}
+export interface VadMessage {
+	type: "vad";
+	event: "speech_start" | "speech_end";
+	timestamp_ms: number;
+}
+export interface SessionErrorMessage {
+	type: "error";
+	code: string;
+	message: string;
+}
+export interface SessionEndMessage {
+	type: "session.end";
+	reason: string;
+	usage: {
+		duration_seconds: number;
+		cost_cents: number;
+	};
+}
+export type ServerMessage = SessionBeginMessage | TranscriptMessage | VadMessage | SessionErrorMessage | SessionEndMessage;
+export type StreamEvents = {
+	"session.begin": SessionBeginMessage;
+	transcript: TranscriptMessage;
+	vad: VadMessage;
+	error: SessionErrorMessage;
+	"session.end": SessionEndMessage;
+	open: void;
+	close: {
+		code: number;
+		reason: string;
+	};
+};
+export interface TranscribeStreamOptions {
+	model?: "default" | "turbo" | "gpt-realtime-mini" | "deepgram-nova-3";
+	language?: string;
+	sample_rate?: number;
+	encoding?: "pcm_s16le";
+	interim_results?: boolean;
+}
+export declare class TranscriptionStream extends TypedEmitter<StreamEvents> {
+	#private;
+	constructor(baseUrl: string, apiKey: string, options?: TranscribeStreamOptions);
+	sendAudio(data: ArrayBuffer | ArrayBufferView): void;
+	finalize(): void;
+	stop(): void;
+	configure(config: Record<string, unknown>): void;
+	close(): void;
+	get readyState(): number;
+}
+export declare class ObserverStream extends TypedEmitter<StreamEvents> {
+	#private;
+	constructor(baseUrl: string, apiKey: string, sessionId: string);
+	close(): void;
+	get readyState(): number;
+}
+export interface AudicleOptions {
+	apiKey: string;
+	baseUrl?: string;
+}
+export declare class Audicle {
+	#private;
+	readonly transcripts: TranscriptsResource;
+	readonly usage: UsageResource;
+	readonly streaming: StreamingNamespace;
+	constructor(options: AudicleOptions);
+	health(): Promise<{
+		status: "healthy" | "degraded" | "unhealthy";
+		version: string;
+		checks: {
+			database?: {
+				status: "pass" | "fail";
+				latency_ms: number;
+			};
+			storage?: {
+				status: "pass" | "fail";
+				latency_ms: number;
+			};
+			ai?: {
+				status: "pass" | "fail";
+				latency_ms: number;
+			};
+		};
+	}>;
+	transcribe(input: TranscribeFileInput, options?: TranscribeOptions): Promise<{
+		id: string;
+		status: "queued" | "processing" | "streaming" | "completed" | "error";
+		language: string | null;
+		detected_language: string | null;
+		model: string;
+		speaker_labels: boolean;
+		word_timestamps: boolean;
+		duration_seconds: number | null;
+		audio_url: string | null;
+		webhook_url: string | null;
+		webhook_status: "pending" | "delivered" | "failed" | null;
+		metadata: {
+			[key: string]: string;
+		} | null;
+		error: {
+			code: string;
+			message: string;
+		} | null;
+		result: components["schemas"]["TranscriptionResult"];
+		usage: components["schemas"]["TranscriptionUsage"];
+		created_at: string;
+		updated_at: string;
+	}>;
+}
+declare class StreamingNamespace {
+	#private;
+	constructor(baseUrl: string, apiKey: string);
+	transcribe(options?: TranscribeStreamOptions): TranscriptionStream;
+	observe(sessionId: string): ObserverStream;
+}
+export declare class AudicleError extends Error {
+	constructor(message: string);
+}
+export declare class AudicleApiError extends AudicleError {
+	readonly status: number;
+	readonly code: string;
+	readonly requestId: string;
+	readonly details?: Record<string, unknown>;
+	constructor(status: number, code: string, message: string, requestId: string, details?: Record<string, unknown>);
+}
+export declare class AudicleAuthError extends AudicleApiError {
+	constructor(code: string, message: string, requestId: string, details?: Record<string, unknown>);
+}
+export declare class AudicleNotFoundError extends AudicleApiError {
+	constructor(code: string, message: string, requestId: string, details?: Record<string, unknown>);
+}
+export declare class AudicleRateLimitError extends AudicleApiError {
+	constructor(code: string, message: string, requestId: string, details?: Record<string, unknown>);
+}
+export declare class AudicleTimeoutError extends AudicleError {
+	constructor(message: string);
+}
+
+export {};