@volley/recognition-client-sdk 0.1.255 → 0.1.287

package/dist/index.d.ts

@@ -1,1079 +1,15 @@
-import { R as RecognitionProvider, E as ErrorTypeV1, S as Stage, A as ASRRequestConfig, G as GameContextV1, a as RecognitionCallbackUrl, T as TranscriptionResultV1, M as MetadataResultV1, b as ErrorResultV1, c as RealTimeTwoWayWebSocketRecognitionClientConfig, I as IRecognitionClient, C as ClientState, d as IRecognitionClientConfig } from './browser-BZs4BL_w.js';
-export { m as ASRRequestV1, h as AudioEncoding, k as ControlSignal, k as ControlSignalTypeV1, D as DeepgramModel, F as FunctionCallResultV1, n as GoogleModel, g as IRecognitionClientStats, L as Language, e as RealTimeTwoWayWebSocketRecognitionClient, j as RecognitionContextTypeV1, l as RecognitionResultTypeV1, p as STAGES, o as SampleRate, f as TranscriptionResult, i as isNormalDisconnection } from './browser-BZs4BL_w.js';
-import { z } from 'zod';
-
-/**
- * Error Exception Types
- *
- * Defines structured exception types for each ErrorTypeV1 category.
- * Each exception type has metadata about whether it's immediately available
- * (can be shown to user right away vs needs investigation/retry).
- */
-
-/**
- * Authentication/Authorization Error
- * isImmediatelyAvailable: false
- * These are system configuration issues, not user-facing
- */
-declare const AuthenticationExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.AUTHENTICATION_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<false>;
-    service: z.ZodOptional<z.ZodString>;
-    authMethod: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    service?: string | undefined;
-    authMethod?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    service?: string | undefined;
-    authMethod?: string | undefined;
-}>;
-type AuthenticationException = z.infer<typeof AuthenticationExceptionSchema>;
-/**
- * Validation Error
- * isImmediatelyAvailable: true
- * User provided invalid input - can show them what's wrong
- */
-declare const ValidationExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.VALIDATION_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    field: z.ZodOptional<z.ZodString>;
-    expected: z.ZodOptional<z.ZodString>;
-    received: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.VALIDATION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    expected?: string | undefined;
-    received?: string | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    field?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.VALIDATION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    expected?: string | undefined;
-    received?: string | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    field?: string | undefined;
-}>;
-type ValidationException = z.infer<typeof ValidationExceptionSchema>;
-/**
- * Provider Error
- * isImmediatelyAvailable: false
- * Error from ASR provider - usually transient or needs investigation
- */
-declare const ProviderExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.PROVIDER_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<false>;
-    provider: z.ZodOptional<z.ZodString>;
-    providerErrorCode: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    isTransient: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.PROVIDER_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: string | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    providerErrorCode?: string | number | undefined;
-    isTransient?: boolean | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.PROVIDER_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: string | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    providerErrorCode?: string | number | undefined;
-    isTransient?: boolean | undefined;
-}>;
-type ProviderException = z.infer<typeof ProviderExceptionSchema>;
-/**
- * Timeout Error
- * isImmediatelyAvailable: true
- * Request took too long - user should try again
- */
-declare const TimeoutExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.TIMEOUT_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    operation: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.TIMEOUT_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    timeoutMs?: number | undefined;
-    operation?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.TIMEOUT_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    timeoutMs?: number | undefined;
-    operation?: string | undefined;
-}>;
-type TimeoutException = z.infer<typeof TimeoutExceptionSchema>;
-/**
- * Quota Exceeded Error
- * isImmediatelyAvailable: true
- * Rate limit or quota exceeded - user should wait
- */
-declare const QuotaExceededExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.QUOTA_EXCEEDED>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    quotaType: z.ZodOptional<z.ZodString>;
-    resetAt: z.ZodOptional<z.ZodNumber>;
-    retryAfterSeconds: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.QUOTA_EXCEEDED;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    quotaType?: string | undefined;
-    resetAt?: number | undefined;
-    retryAfterSeconds?: number | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.QUOTA_EXCEEDED;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    quotaType?: string | undefined;
-    resetAt?: number | undefined;
-    retryAfterSeconds?: number | undefined;
-}>;
-type QuotaExceededException = z.infer<typeof QuotaExceededExceptionSchema>;
-/**
- * Connection Error
- * isImmediatelyAvailable: true
- * Connection establishment or network failure - user should check network or retry
- */
-declare const ConnectionExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.CONNECTION_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    attempts: z.ZodOptional<z.ZodNumber>;
-    url: z.ZodOptional<z.ZodString>;
-    underlyingError: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.CONNECTION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    attempts?: number | undefined;
-    url?: string | undefined;
-    underlyingError?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.CONNECTION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    attempts?: number | undefined;
-    url?: string | undefined;
-    underlyingError?: string | undefined;
-}>;
-type ConnectionException = z.infer<typeof ConnectionExceptionSchema>;
-/**
- * Unknown Error
- * isImmediatelyAvailable: false
- * Unexpected error - needs investigation
- */
-declare const UnknownExceptionSchema: z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.UNKNOWN_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<false>;
-    stack: z.ZodOptional<z.ZodString>;
-    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.UNKNOWN_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    stack?: string | undefined;
-    context?: Record<string, unknown> | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.UNKNOWN_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    stack?: string | undefined;
-    context?: Record<string, unknown> | undefined;
-}>;
-type UnknownException = z.infer<typeof UnknownExceptionSchema>;
-/**
- * Discriminated union of all exception types
- * Use this for type-safe error handling
- */
-declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.AUTHENTICATION_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<false>;
-    service: z.ZodOptional<z.ZodString>;
-    authMethod: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    service?: string | undefined;
-    authMethod?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    service?: string | undefined;
-    authMethod?: string | undefined;
-}>, z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.VALIDATION_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    field: z.ZodOptional<z.ZodString>;
-    expected: z.ZodOptional<z.ZodString>;
-    received: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.VALIDATION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    expected?: string | undefined;
-    received?: string | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    field?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.VALIDATION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    expected?: string | undefined;
-    received?: string | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    field?: string | undefined;
-}>, z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.PROVIDER_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<false>;
-    provider: z.ZodOptional<z.ZodString>;
-    providerErrorCode: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    isTransient: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.PROVIDER_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: string | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    providerErrorCode?: string | number | undefined;
-    isTransient?: boolean | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.PROVIDER_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: string | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    providerErrorCode?: string | number | undefined;
-    isTransient?: boolean | undefined;
-}>, z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.TIMEOUT_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    operation: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.TIMEOUT_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    timeoutMs?: number | undefined;
-    operation?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.TIMEOUT_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    timeoutMs?: number | undefined;
-    operation?: string | undefined;
-}>, z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.QUOTA_EXCEEDED>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    quotaType: z.ZodOptional<z.ZodString>;
-    resetAt: z.ZodOptional<z.ZodNumber>;
-    retryAfterSeconds: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.QUOTA_EXCEEDED;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    quotaType?: string | undefined;
-    resetAt?: number | undefined;
-    retryAfterSeconds?: number | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.QUOTA_EXCEEDED;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    quotaType?: string | undefined;
-    resetAt?: number | undefined;
-    retryAfterSeconds?: number | undefined;
-}>, z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.CONNECTION_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<true>;
-    attempts: z.ZodOptional<z.ZodNumber>;
-    url: z.ZodOptional<z.ZodString>;
-    underlyingError: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.CONNECTION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    attempts?: number | undefined;
-    url?: string | undefined;
-    underlyingError?: string | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.CONNECTION_ERROR;
-    isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    attempts?: number | undefined;
-    url?: string | undefined;
-    underlyingError?: string | undefined;
-}>, z.ZodObject<{
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    description: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-} & {
-    errorType: z.ZodLiteral<ErrorTypeV1.UNKNOWN_ERROR>;
-    isImmediatelyAvailable: z.ZodLiteral<false>;
-    stack: z.ZodOptional<z.ZodString>;
-    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    errorType: ErrorTypeV1.UNKNOWN_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    stack?: string | undefined;
-    context?: Record<string, unknown> | undefined;
-}, {
-    message: string;
-    errorType: ErrorTypeV1.UNKNOWN_ERROR;
-    isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
-    code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
-    description?: string | undefined;
-    timestamp?: number | undefined;
-    stack?: string | undefined;
-    context?: Record<string, unknown> | undefined;
-}>]>;
-type RecognitionException = z.infer<typeof RecognitionExceptionSchema>;
-/**
- * Check if an exception should be shown to the user immediately
- */
-declare function isExceptionImmediatelyAvailable(exception: RecognitionException): boolean;
-/**
- * Get user-friendly error message for exceptions
- */
-declare function getUserFriendlyMessage(exception: RecognitionException): string;
-
-/**
- * Gemini Model Types
- * Based on available models as of January 2025
- *
- * API Version Notes:
- * - Gemini 2.5+ models: Use v1beta API (early access features)
- * - Gemini 2.0 models: Use v1beta API (early access features)
- * - Gemini 1.5 models: Use v1 API (stable, production-ready)
- *
- * @see https://ai.google.dev/gemini-api/docs/models
- * @see https://ai.google.dev/gemini-api/docs/api-versions
- */
-declare enum GeminiModel {
-    GEMINI_2_5_PRO = "gemini-2.5-pro",// State-of-the-art thinking model
-    GEMINI_2_5_FLASH = "gemini-2.5-flash",// Best price-performance balance
-    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",// Fastest, most cost-efficient
-    GEMINI_2_0_FLASH_LATEST = "gemini-2.0-flash-latest",// Auto-updated to latest 2.0 flash
-    GEMINI_2_0_FLASH = "gemini-2.0-flash-002",// Specific stable version
-    GEMINI_2_0_FLASH_EXP = "gemini-2.0-flash-exp",// Experimental version
-    GEMINI_1_5_FLASH = "gemini-1.5-flash",
-    GEMINI_1_5_PRO = "gemini-1.5-pro"
-}
-
-/**
- * OpenAI Model Types
- */
-declare enum OpenAIModel {
-    WHISPER_1 = "whisper-1"
-}
-
-/**
- * Configuration Builder for Recognition Client
- *
- * Simple builder pattern for RealTimeTwoWayWebSocketRecognitionClientConfig
- */
-
-/**
- * Builder for RealTimeTwoWayWebSocketRecognitionClientConfig
- *
- * Provides a fluent API for building client configurations.
- *
- * Example:
- * ```typescript
- * import { STAGES } from '@recog/shared-types';
- *
- * const config = new ConfigBuilder()
- *   .stage(STAGES.STAGING)  // Recommended: automatic environment selection
- *   .asrRequestConfig({
- *     provider: RecognitionProvider.DEEPGRAM,
- *     model: 'nova-2-general'
- *   })
- *   .onTranscript((result) => console.log(result))
- *   .build();
- * ```
- */
-declare class ConfigBuilder {
-    private config;
-    /**
-     * Set the WebSocket URL (advanced usage)
-     * For standard environments, use stage() instead
-     */
-    url(url: string): this;
-    /**
-     * Set the stage for automatic environment selection (recommended)
-     * @param stage - STAGES.LOCAL | STAGES.DEV | STAGES.STAGING | STAGES.PRODUCTION
-     * @example
-     * ```typescript
-     * import { STAGES } from '@recog/shared-types';
-     * builder.stage(STAGES.STAGING)
-     * ```
-     */
-    stage(stage: Stage | string): this;
-    /**
-     * Set ASR request configuration
-     */
-    asrRequestConfig(config: ASRRequestConfig): this;
-    /**
-     * Set game context
-     */
-    gameContext(context: GameContextV1): this;
-    /**
-     * Set audio utterance ID
-     */
-    audioUtteranceId(id: string): this;
-    /**
-     * Set callback URLs
-     */
-    callbackUrls(urls: RecognitionCallbackUrl[]): this;
-    /**
-     * Set user ID
-     */
-    userId(id: string): this;
-    /**
-     * Set game session ID
-     */
-    gameSessionId(id: string): this;
-    /**
-     * Set device ID
-     */
-    deviceId(id: string): this;
-    /**
-     * Set account ID
-     */
-    accountId(id: string): this;
-    /**
-     * Set question answer ID
-     */
-    questionAnswerId(id: string): this;
-    /**
-     * Set platform
-     */
-    platform(platform: string): this;
-    /**
-     * Set transcript callback
-     */
-    onTranscript(callback: (result: TranscriptionResultV1) => void): this;
-    /**
-     * Set metadata callback
-     */
-    onMetadata(callback: (metadata: MetadataResultV1) => void): this;
-    /**
-     * Set error callback
-     */
-    onError(callback: (error: ErrorResultV1) => void): this;
-    /**
-     * Set connected callback
-     */
-    onConnected(callback: () => void): this;
-    /**
-     * Set disconnected callback
-     */
-    onDisconnected(callback: (code: number, reason: string) => void): this;
-    /**
-     * Set high water mark
-     */
-    highWaterMark(bytes: number): this;
-    /**
-     * Set low water mark
-     */
-    lowWaterMark(bytes: number): this;
-    /**
-     * Set max buffer duration in seconds
-     */
-    maxBufferDurationSec(seconds: number): this;
-    /**
-     * Set chunks per second
-     */
-    chunksPerSecond(chunks: number): this;
-    /**
-     * Set logger function
-     */
-    logger(logger: (level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: any) => void): this;
-    /**
-     * Build the configuration
-     */
-    build(): RealTimeTwoWayWebSocketRecognitionClientConfig;
-}
-
-/**
- * Factory function for creating Recognition Client instances
- */
-
-/**
- * Create a recognition client from a configuration object
- *
- * Example:
- * ```typescript
- * const client = createClient({
- *   url: 'ws://localhost:3101/ws/v1/recognize',
- *   audioUtteranceId: 'unique-id',
- *   onTranscript: (result) => console.log(result)
- * });
- * ```
- *
- * @param config - Client configuration
- * @returns Configured recognition client instance
- */
-declare function createClient(config: RealTimeTwoWayWebSocketRecognitionClientConfig): IRecognitionClient;
-/**
- * Create a recognition client using the builder pattern
- *
- * Example:
- * ```typescript
- * const client = createClientWithBuilder((builder) =>
- *   builder
- *     .url('ws://localhost:3101/ws/v1/recognize')
- *     .onTranscript((result) => console.log(result))
- *     .onError((error) => console.error(error))
- * );
- * ```
- */
-declare function createClientWithBuilder(configure: (builder: ConfigBuilder) => ConfigBuilder): IRecognitionClient;
-
-/**
- * SDK Error Classes
- *
- * Typed error classes that extend native Error with recognition-specific metadata
- */
-
-/**
- * Base class for all recognition SDK errors
- */
-declare class RecognitionError extends Error {
-    readonly errorType: ErrorTypeV1;
-    readonly timestamp: number;
-    constructor(errorType: ErrorTypeV1, message: string);
-}
-/**
- * Connection error - thrown when WebSocket connection fails after all retry attempts
- */
-declare class ConnectionError extends RecognitionError {
-    readonly attempts: number;
-    readonly url: string;
-    readonly underlyingError?: Error;
-    constructor(message: string, attempts: number, url: string, underlyingError?: Error);
-}
-/**
- * Timeout error - thrown when operations exceed timeout limits
- */
-declare class TimeoutError extends RecognitionError {
-    readonly timeoutMs: number;
-    readonly operation: string;
-    constructor(message: string, timeoutMs: number, operation: string);
-}
-/**
- * Validation error - thrown when invalid configuration or input is provided
- */
-declare class ValidationError extends RecognitionError {
-    readonly field?: string;
-    readonly expected?: string;
-    readonly received?: string;
-    constructor(message: string, field?: string, expected?: string, received?: string);
-}
-
-/**
- * VGF-style state schema for game-side recognition state/results management.
- *
- * This schema provides a standardized way for game developers to manage
- * voice recognition state and results in their applications. It supports:
- *
- * STEP 1: Basic transcription flow
- * STEP 2: Mic auto-stop upon correct answer (using partial transcripts)
- * STEP 3: Semantic/function-call outcomes for game actions
- *
- * Ideally this should be part of a more centralized shared type library to free
- * game developers and provide helper functions (VGF? Platform SDK?).
- */
-declare const RecognitionVGFStateSchema: z.ZodObject<{
-    audioUtteranceId: z.ZodString;
-    startRecordingStatus: z.ZodOptional<z.ZodString>;
-    transcriptionStatus: z.ZodOptional<z.ZodString>;
-    finalTranscript: z.ZodOptional<z.ZodString>;
-    finalConfidence: z.ZodOptional<z.ZodNumber>;
-    asrConfig: z.ZodOptional<z.ZodString>;
-    startRecordingTimestamp: z.ZodOptional<z.ZodString>;
-    finalRecordingTimestamp: z.ZodOptional<z.ZodString>;
-    finalTranscriptionTimestamp: z.ZodOptional<z.ZodString>;
-    pendingTranscript: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pendingConfidence: z.ZodOptional<z.ZodNumber>;
-    functionCallMetadata: z.ZodOptional<z.ZodString>;
-    functionCallConfidence: z.ZodOptional<z.ZodNumber>;
-    finalFunctionCallTimestamp: z.ZodOptional<z.ZodString>;
-    promptSlotMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-}, "strip", z.ZodTypeAny, {
-    audioUtteranceId: string;
-    pendingTranscript: string;
-    startRecordingStatus?: string | undefined;
-    transcriptionStatus?: string | undefined;
-    finalTranscript?: string | undefined;
-    finalConfidence?: number | undefined;
-    asrConfig?: string | undefined;
-    startRecordingTimestamp?: string | undefined;
-    finalRecordingTimestamp?: string | undefined;
-    finalTranscriptionTimestamp?: string | undefined;
-    pendingConfidence?: number | undefined;
-    functionCallMetadata?: string | undefined;
-    functionCallConfidence?: number | undefined;
-    finalFunctionCallTimestamp?: string | undefined;
-    promptSlotMap?: Record<string, string[]> | undefined;
-}, {
-    audioUtteranceId: string;
-    startRecordingStatus?: string | undefined;
-    transcriptionStatus?: string | undefined;
-    finalTranscript?: string | undefined;
-    finalConfidence?: number | undefined;
-    asrConfig?: string | undefined;
-    startRecordingTimestamp?: string | undefined;
-    finalRecordingTimestamp?: string | undefined;
-    finalTranscriptionTimestamp?: string | undefined;
-    pendingTranscript?: string | undefined;
-    pendingConfidence?: number | undefined;
-    functionCallMetadata?: string | undefined;
-    functionCallConfidence?: number | undefined;
-    finalFunctionCallTimestamp?: string | undefined;
-    promptSlotMap?: Record<string, string[]> | undefined;
-}>;
-type RecognitionState = z.infer<typeof RecognitionVGFStateSchema>;
-declare const RecordingStatus: {
-    readonly NOT_READY: "NOT_READY";
-    readonly READY: "READY";
-    readonly RECORDING: "RECORDING";
-    readonly FINISHED: "FINISHED";
-};
-type RecordingStatusType = typeof RecordingStatus[keyof typeof RecordingStatus];
-declare const TranscriptionStatus: {
-    readonly NOT_STARTED: "NOT_STARTED";
-    readonly IN_PROGRESS: "IN_PROGRESS";
-    readonly FINALIZED: "FINALIZED";
-    readonly ERROR: "ERROR";
-};
-type TranscriptionStatusType = typeof TranscriptionStatus[keyof typeof TranscriptionStatus];
-declare function createInitialRecognitionState(audioUtteranceId: string): RecognitionState;
-declare function isValidRecordingStatusTransition(from: string | undefined, to: string): boolean;
-
-/**
- * Simplified VGF Recognition Client
- *
- * A thin wrapper around RealTimeTwoWayWebSocketRecognitionClient that maintains
- * a VGF RecognitionState as a pure sink/output of recognition events.
- *
- * The VGF state is updated based on events but never influences client behavior.
- * All functionality is delegated to the underlying client.
- */
-
-/**
- * Configuration for SimplifiedVGFRecognitionClient
- */
-interface SimplifiedVGFClientConfig extends IRecognitionClientConfig {
-    /**
-     * Callback invoked whenever the VGF state changes
-     * Use this to update your UI or React state
-     */
-    onStateChange?: (state: RecognitionState) => void;
-    /**
-     * Optional initial state to restore from a previous session
-     * If provided, audioUtteranceId will be extracted and used
-     */
-    initialState?: RecognitionState;
-}
-/**
- * Interface for SimplifiedVGFRecognitionClient
- *
- * A simplified client that maintains VGF state for game developers.
- * All methods from the underlying client are available, plus VGF state management.
- */
-interface ISimplifiedVGFRecognitionClient {
-    /**
-     * Connect to the recognition service WebSocket
-     * @returns Promise that resolves when connected and ready
-     */
-    connect(): Promise<void>;
-    /**
-     * Send audio data for transcription
-     * @param audioData - PCM audio data as ArrayBuffer, typed array, or Blob
-     */
-    sendAudio(audioData: ArrayBuffer | ArrayBufferView | Blob): void;
-    /**
-     * Stop recording and wait for final transcription
-     * @returns Promise that resolves when transcription is complete
-     */
-    stopRecording(): Promise<void>;
-    /**
-     * Get the current VGF recognition state
-     * @returns Current RecognitionState with all transcription data
-     */
-    getVGFState(): RecognitionState;
-    /**
-     * Check if connected to the WebSocket
-     */
-    isConnected(): boolean;
-    /**
-     * Check if currently connecting
-     */
-    isConnecting(): boolean;
-    /**
-     * Check if currently stopping
-     */
-    isStopping(): boolean;
-    /**
-     * Check if transcription has finished
-     */
-    isTranscriptionFinished(): boolean;
-    /**
-     * Check if the audio buffer has overflowed
-     */
-    isBufferOverflowing(): boolean;
-    /**
-     * Get the audio utterance ID for this session
-     */
-    getAudioUtteranceId(): string;
-    /**
-     * Get the WebSocket URL being used
-     */
-    getUrl(): string;
-    /**
-     * Get the underlying client state (for advanced usage)
-     */
-    getState(): ClientState;
-}
-/**
- * This wrapper ONLY maintains VGF state as a sink.
- * All actual functionality is delegated to the underlying client.
- */
-declare class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognitionClient {
-    private client;
-    private state;
-    private isRecordingAudio;
-    private stateChangeCallback;
-    constructor(config: SimplifiedVGFClientConfig);
-    connect(): Promise<void>;
-    sendAudio(audioData: ArrayBuffer | ArrayBufferView | Blob): void;
-    stopRecording(): Promise<void>;
-    getAudioUtteranceId(): string;
-    getUrl(): string;
-    getState(): ClientState;
-    isConnected(): boolean;
-    isConnecting(): boolean;
-    isStopping(): boolean;
-    isTranscriptionFinished(): boolean;
-    isBufferOverflowing(): boolean;
-    getVGFState(): RecognitionState;
-    private notifyStateChange;
-}
-/**
- * Factory function for creating simplified client
- * Usage examples:
- *
- * // Basic usage
- * const client = createSimplifiedVGFClient({
- *   asrRequestConfig: { provider: 'deepgram', language: 'en' },
- *   onStateChange: (state) => {
- *     console.log('VGF State updated:', state);
- *     // Update React state, game UI, etc.
- *   }
- * });
- *
- * // With initial state (e.g., restoring from previous session)
- * const client = createSimplifiedVGFClient({
- *   asrRequestConfig: { provider: 'deepgram', language: 'en' },
- *   initialState: previousState, // Will use audioUtteranceId from state
- *   onStateChange: (state) => setVGFState(state)
- * });
- *
- * // With initial state containing promptSlotMap for enhanced recognition
- * const stateWithSlots: RecognitionState = {
- *   audioUtteranceId: 'session-123',
- *   promptSlotMap: {
- *     'song_title': ['one time', 'baby'],
- *     'artists': ['justin bieber']
- *   }
- * };
- * const client = createSimplifiedVGFClient({
- *   asrRequestConfig: { provider: 'deepgram', language: 'en' },
- *   gameContext: {
- *     type: RecognitionContextTypeV1.GAME_CONTEXT,
- *     gameId: 'music-quiz',  // Your game's ID
- *     gamePhase: 'song-guessing'  // Current game phase
- *   },
- *   initialState: stateWithSlots, // promptSlotMap will be added to gameContext
- *   onStateChange: (state) => setVGFState(state)
- * });
- *
- * await client.connect();
- * client.sendAudio(audioData);
- * // VGF state automatically updates based on transcription results
- */
-declare function createSimplifiedVGFClient(config: SimplifiedVGFClientConfig): ISimplifiedVGFRecognitionClient;
-
-/**
- * Base URL schema shared across service endpoint helpers.
- */
-type ServiceBaseUrls = {
-    httpBase: string;
-    wsBase: string;
-};
-/**
- * Base URL mappings keyed by stage.
- */
-declare const RECOGNITION_SERVICE_BASES: Record<Stage, ServiceBaseUrls>;
-declare const RECOGNITION_CONDUCTOR_BASES: Record<Stage, ServiceBaseUrls>;
-/**
- * Normalize arbitrary stage input into a known `Stage`, defaulting to `local`.
- */
-declare function normalizeStage(input?: Stage | string | null | undefined): Stage;
-/**
- * Resolve the recognition-service base URLs for a given stage.
- */
-declare function getRecognitionServiceBase(stage?: Stage | string | null | undefined): ServiceBaseUrls;
-/**
- * Convenience helper for retrieving the HTTP base URL.
- */
-declare function getRecognitionServiceHttpBase(stage?: Stage | string | null | undefined): string;
-/**
- * Convenience helper for retrieving the WebSocket base URL.
- */
-declare function getRecognitionServiceWsBase(stage?: Stage | string | null | undefined): string;
-/**
- * Expose hostname lookup separately for callers that need raw host strings.
- */
-declare function getRecognitionServiceHost(stage?: Stage | string | null | undefined): string;
-/**
- * Resolve the recognition-conductor base URLs for a given stage.
- */
-declare function getRecognitionConductorBase(stage?: Stage | string | null | undefined): ServiceBaseUrls;
-declare function getRecognitionConductorHttpBase(stage?: Stage | string | null | undefined): string;
-declare function getRecognitionConductorWsBase(stage?: Stage | string | null | undefined): string;
-declare function getRecognitionConductorHost(stage?: Stage | string | null | undefined): string;
-
-export { ASRRequestConfig, type AuthenticationException, ClientState, ConfigBuilder, ConnectionError, type ConnectionException, ErrorResultV1, ErrorTypeV1, GameContextV1, GeminiModel, IRecognitionClient, IRecognitionClientConfig, type ISimplifiedVGFRecognitionClient, MetadataResultV1, OpenAIModel, type ProviderException, type QuotaExceededException, RECOGNITION_CONDUCTOR_BASES, RECOGNITION_SERVICE_BASES, RealTimeTwoWayWebSocketRecognitionClientConfig, RecognitionCallbackUrl, RecognitionError, type RecognitionException, RecognitionProvider, type RecognitionState, RecognitionVGFStateSchema, RecordingStatus, type RecordingStatusType, type SimplifiedVGFClientConfig, SimplifiedVGFRecognitionClient, Stage, TimeoutError, type TimeoutException, TranscriptionResultV1, TranscriptionStatus, type TranscriptionStatusType, type UnknownException, ValidationError, type ValidationException, createClient, createClientWithBuilder, createInitialRecognitionState, createSimplifiedVGFClient, getRecognitionConductorBase, getRecognitionConductorHost, getRecognitionConductorHttpBase, getRecognitionConductorWsBase, getRecognitionServiceBase, getRecognitionServiceHost, getRecognitionServiceHttpBase, getRecognitionServiceWsBase, getUserFriendlyMessage, isExceptionImmediatelyAvailable, isValidRecordingStatusTransition, normalizeStage };
+export { RealTimeTwoWayWebSocketRecognitionClient, type RealTimeTwoWayWebSocketRecognitionClientConfig, type TranscriptionResult, isNormalDisconnection } from './recognition-client.js';
+export { type IRecognitionClient, type IRecognitionClientConfig, type IRecognitionClientStats, type RecognitionCallbackUrl, ClientState } from './recognition-client.types.js';
+export { ConfigBuilder } from './config-builder.js';
+export { createClient, createClientWithBuilder } from './factory.js';
+export { RecognitionError, ConnectionError, TimeoutError, ValidationError } from './errors.js';
+export { ErrorTypeV1 } from '@recog/shared-types';
+export type { RecognitionException, ConnectionException, TimeoutException, ValidationException, AuthenticationException, ProviderException, QuotaExceededException, UnknownException } from '@recog/shared-types';
+export { isExceptionImmediatelyAvailable, getUserFriendlyMessage } from '@recog/shared-types';
+export { SimplifiedVGFRecognitionClient, createSimplifiedVGFClient, type ISimplifiedVGFRecognitionClient, type SimplifiedVGFClientConfig } from './simplified-vgf-recognition-client.js';
+export { type RecognitionState, RecognitionVGFStateSchema, RecordingStatus, TranscriptionStatus, type RecordingStatusType, type TranscriptionStatusType, createInitialRecognitionState, isValidRecordingStatusTransition } from './vgf-recognition-state.js';
+export { AudioEncoding } from '@recog/websocket';
+export { type GameContextV1, type SlotMap, RecognitionContextTypeV1, ControlSignalTypeV1, ControlSignalTypeV1 as ControlSignal, // Alias for backward compatibility
+type TranscriptionResultV1, type FunctionCallResultV1, type MetadataResultV1, type ErrorResultV1, RecognitionResultTypeV1, ClientControlActionV1, type ASRRequestConfig, type ASRRequestV1, FinalTranscriptStability, createDefaultASRConfig, RecognitionProvider, DeepgramModel, GoogleModel, GeminiModel, OpenAIModel, Language, SampleRate, STAGES, type Stage } from '@recog/shared-types';
+export { getRecognitionServiceBase, getRecognitionServiceHttpBase, getRecognitionServiceWsBase, getRecognitionServiceHost, getRecognitionConductorBase, getRecognitionConductorHttpBase, getRecognitionConductorWsBase, getRecognitionConductorHost, normalizeStage, RECOGNITION_SERVICE_BASES, RECOGNITION_CONDUCTOR_BASES } from '@recog/shared-config';
+//# sourceMappingURL=index.d.ts.map