react-native-sherpa-onnx 0.3.0 → 0.3.2

package/lib/typescript/src/stt/streaming.d.ts

@@ -0,0 +1,42 @@
+import type { OnlineSTTModelType, StreamingSttEngine, StreamingSttInitOptions } from './streamingTypes';
+/**
+ * Map detected STT model type (from detectSttModel) to an online (streaming) model type.
+ * Throws if the detected type has no streaming support.
+ */
+export declare function mapDetectedToOnlineType(detectedType: string | undefined): OnlineSTTModelType;
+/**
+ * Returns the online (streaming) model type for a detected STT model type, or null if streaming is not supported.
+ * Use this to check whether the current model can be used with createStreamingSTT() (e.g. for live transcription).
+ */
+export declare function getOnlineTypeOrNull(detectedType: string | undefined): OnlineSTTModelType | null;
+/**
+ * Create a streaming (online) STT engine. Use this for real-time recognition with
+ * partial results and endpoint detection. Call destroy() when done.
+ *
+ * @param options - Streaming STT init options (modelPath required; modelType optional, use 'auto' to detect from directory)
+ * @returns Promise resolving to a StreamingSttEngine
+ * @example
+ * ```typescript
+ * // With explicit model type
+ * const engine = await createStreamingSTT({
+ *   modelPath: { type: 'asset', path: 'models/streaming-zipformer-en' },
+ *   modelType: 'transducer',
+ * });
+ * // With auto-detection
+ * const engine = await createStreamingSTT({
+ *   modelPath: { type: 'asset', path: 'models/sherpa-onnx-streaming-t-one-russian-2025-09-08' },
+ *   modelType: 'auto',
+ * });
+ * const stream = await engine.createStream();
+ * await stream.acceptWaveform(samples, 16000);
+ * if (await stream.isReady()) {
+ *   await stream.decode();
+ *   const result = await stream.getResult();
+ *   console.log(result.text);
+ * }
+ * await stream.release();
+ * await engine.destroy();
+ * ```
+ */
+export declare function createStreamingSTT(options: StreamingSttInitOptions): Promise<StreamingSttEngine>;
+//# sourceMappingURL=streaming.d.ts.map

package/lib/typescript/src/stt/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../../src/stt/streaming.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EAGxB,MAAM,kBAAkB,CAAC;AAI1B;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,kBAAkB,CAmBpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,kBAAkB,GAAG,IAAI,CAM3B;AAwED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CA8M7B"}

package/lib/typescript/src/stt/streamingTypes.d.ts

@@ -0,0 +1,122 @@
+import type { ModelPathConfig } from '../types';
+/**
+ * Online (streaming) STT model types.
+ * These models use OnlineRecognizer + OnlineStream in sherpa-onnx.
+ * Must match the native OnlineRecognizer model config (transducer, paraformer, zipformer2_ctc, nemo_ctc, tone_ctc).
+ */
+export type OnlineSTTModelType = 'transducer' | 'paraformer' | 'zipformer2_ctc' | 'nemo_ctc' | 'tone_ctc';
+/** Runtime list of supported online STT model types. */
+export declare const ONLINE_STT_MODEL_TYPES: readonly OnlineSTTModelType[];
+/**
+ * Single endpoint rule (Kotlin EndpointRule).
+ * Used to detect end of utterance in streaming recognition.
+ */
+export interface EndpointRule {
+    /** If true, rule only matches when the segment contains non-silence. */
+    mustContainNonSilence: boolean;
+    /** Minimum trailing silence in seconds. */
+    minTrailingSilence: number;
+    /** Minimum utterance length in seconds (e.g. max length cap). */
+    minUtteranceLength: number;
+}
+/**
+ * Endpoint detection config (Kotlin EndpointConfig).
+ * Three rules; first match determines end of utterance.
+ */
+export interface EndpointConfig {
+    /** Rule 1: e.g. 2.4s trailing silence, no speech required. */
+    rule1?: EndpointRule;
+    /** Rule 2: e.g. 1.4s trailing silence, speech required. */
+    rule2?: EndpointRule;
+    /** Rule 3: e.g. max utterance length 20s. */
+    rule3?: EndpointRule;
+}
+/**
+ * Options for initializing the streaming (online) STT engine.
+ */
+export interface StreamingSttInitOptions {
+    /** Model path configuration (asset, file, or auto). */
+    modelPath: ModelPathConfig;
+    /** Online model type. Use 'auto' to detect from model directory (calls detectSttModel and maps to an online type). */
+    modelType: OnlineSTTModelType | 'auto';
+    /** Enable endpoint detection. Default: true. */
+    enableEndpoint?: boolean;
+    /** Endpoint rules. Defaults match Kotlin (rule1: 2.4s silence, rule2: 1.4s + speech, rule3: 20s max). */
+    endpointConfig?: EndpointConfig;
+    /** Decoding method. Default: "greedy_search". */
+    decodingMethod?: 'greedy_search' | 'modified_beam_search';
+    /** Max active paths for beam search. Default: 4. */
+    maxActivePaths?: number;
+    /** Path to hotwords file (transducer/nemo_transducer). */
+    hotwordsFile?: string;
+    /** Hotwords score. Default: 1.5. */
+    hotwordsScore?: number;
+    /** Number of threads for inference. Default: 1. */
+    numThreads?: number;
+    /** Execution provider (e.g. "cpu"). */
+    provider?: string;
+    /** Path(s) to rule FSTs for ITN. */
+    ruleFsts?: string;
+    /** Path(s) to rule FARs for ITN. */
+    ruleFars?: string;
+    /** Blank penalty. */
+    blankPenalty?: number;
+    /** Enable debug logging. Default: false. */
+    debug?: boolean;
+    /**
+     * Enable adaptive input normalization for audio chunks in processAudioChunk().
+     * When true (default), input is scaled so the peak is ~0.8 to handle varying device levels (e.g. quiet mics on iOS).
+     * Set to false if your audio is already in the expected range [-1, 1] and you want to pass it through unchanged.
+     */
+    enableInputNormalization?: boolean;
+}
+/**
+ * Partial or final recognition result from streaming STT (maps to Kotlin OnlineRecognizerResult).
+ */
+export interface StreamingSttResult {
+    text: string;
+    tokens: string[];
+    timestamps: number[];
+}
+/**
+ * Streaming STT stream. Created by StreamingSttEngine.createStream().
+ * Feeds audio via acceptWaveform, then decode / getResult / isEndpoint.
+ */
+export interface SttStream {
+    readonly streamId: string;
+    /** Feed PCM samples (float in [-1, 1]) to the stream. */
+    acceptWaveform(samples: number[], sampleRate: number): Promise<void>;
+    /** Signal that no more audio will be fed. */
+    inputFinished(): Promise<void>;
+    /** Run decoding on accumulated audio (call when isReady() is true). */
+    decode(): Promise<void>;
+    /** True if there is enough audio to decode. */
+    isReady(): Promise<boolean>;
+    /** Get current partial or final result. Call after decode(). */
+    getResult(): Promise<StreamingSttResult>;
+    /** True if endpoint (end of utterance) was detected. */
+    isEndpoint(): Promise<boolean>;
+    /** Reset stream state for reuse. */
+    reset(): Promise<void>;
+    /** Release native stream; do not use after this. */
+    release(): Promise<void>;
+    /**
+     * Convenience: feed audio, auto-decode while ready, return result and endpoint status.
+     * Reduces bridge round-trips from 5 to 1 per chunk.
+     */
+    processAudioChunk(samples: number[], sampleRate: number): Promise<{
+        result: StreamingSttResult;
+        isEndpoint: boolean;
+    }>;
+}
+/**
+ * Streaming STT engine (OnlineRecognizer). Create via createStreamingSTT().
+ */
+export interface StreamingSttEngine {
+    readonly instanceId: string;
+    /** Create a new stream for this recognizer. Optional hotwords string. */
+    createStream(hotwords?: string): Promise<SttStream>;
+    /** Release native recognizer and all streams. */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=streamingTypes.d.ts.map

package/lib/typescript/src/stt/streamingTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingTypes.d.ts","sourceRoot":"","sources":["../../../../src/stt/streamingTypes.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/tts/index.d.ts

@@ -60,6 +60,8 @@ export declare function copyContentUriToCache(fileUri: string, filename: string)
  * Share a TTS audio file (file path or content URI).
  */
 export declare function shareAudioFile(fileUri: string, mimeType?: string): Promise<void>;
-export type { TTSInitializeOptions, TTSModelType, TtsModelOptions, TtsVitsModelOptions, TtsMatchaModelOptions, TtsKokoroModelOptions, TtsKittenModelOptions, TtsPocketModelOptions, TtsUpdateOptions, TtsGenerationOptions, GeneratedAudio, GeneratedAudioWithTimestamps, TtsSubtitleItem, TTSModelInfo, TtsEngine, TtsStreamHandlers, TtsStreamChunk, TtsStreamEnd, TtsStreamError, } from './types';
+export { createStreamingTTS } from './streaming';
+export type { StreamingTtsEngine } from './streamingTypes';
+export type { TTSInitializeOptions, TTSModelType, TtsModelOptions, TtsVitsModelOptions, TtsMatchaModelOptions, TtsKokoroModelOptions, TtsKittenModelOptions, TtsPocketModelOptions, TtsUpdateOptions, TtsGenerationOptions, GeneratedAudio, GeneratedAudioWithTimestamps, TtsSubtitleItem, TTSModelInfo, TtsEngine, TtsStreamController, TtsStreamHandlers, TtsStreamChunk, TtsStreamEnd, TtsStreamError, } from './types';
 export { TTS_MODEL_TYPES } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/tts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tts/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAIZ,cAAc,EAGd,SAAS,EAKV,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAqEhD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GACrC,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAGD;AA6BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,oBAAoB,GAAG,eAAe,GAC9C,OAAO,CAAC,SAAS,CAAC,CA4NpB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,SAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAEf;AAGD,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,4BAA4B,EAC5B,eAAe,EACf,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tts/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAIZ,cAAc,EAGd,SAAS,EACV,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAqEhD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GACrC,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAGD;AA6BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,oBAAoB,GAAG,eAAe,GAC9C,OAAO,CAAC,SAAS,CAAC,CAgKpB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,SAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAEf;AAGD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,4BAA4B,EAC5B,eAAe,EACf,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/src/tts/streaming.d.ts

@@ -0,0 +1,24 @@
+import type { TTSInitializeOptions } from './types';
+import type { StreamingTtsEngine } from './streamingTypes';
+import type { ModelPathConfig } from '../types';
+/**
+ * Create a streaming TTS engine instance. Use for incremental generation with
+ * chunk callbacks and PCM playback. Call destroy() when done.
+ *
+ * @param options - TTS initialization options or model path configuration
+ * @returns Promise resolving to a StreamingTtsEngine instance
+ * @example
+ * ```typescript
+ * const tts = await createStreamingTTS({
+ *   modelPath: { type: 'asset', path: 'models/vits-piper-en' },
+ *   modelType: 'vits',
+ * });
+ * const controller = await tts.generateSpeechStream('Hello', undefined, {
+ *   onChunk: (chunk) => playPcm(chunk.samples, chunk.sampleRate),
+ *   onEnd: () => {},
+ * });
+ * await tts.destroy();
+ * ```
+ */
+export declare function createStreamingTTS(options: TTSInitializeOptions | ModelPathConfig): Promise<StreamingTtsEngine>;
+//# sourceMappingURL=streaming.d.ts.map

package/lib/typescript/src/tts/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../../src/tts/streaming.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAUrB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAwFhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,GAAG,eAAe,GAC9C,OAAO,CAAC,kBAAkB,CAAC,CAmN7B"}

package/lib/typescript/src/tts/streamingTypes.d.ts

@@ -0,0 +1,27 @@
+import type { TtsStreamHandlers, TtsStreamController, TtsGenerationOptions, TTSModelInfo } from './types';
+export type { TtsStreamChunk, TtsStreamEnd, TtsStreamError, TtsStreamHandlers, TtsStreamController, TtsGenerationOptions, TTSModelInfo, } from './types';
+/**
+ * Streaming-only TTS engine returned by createStreamingTTS().
+ * Use for incremental generation with chunk callbacks and PCM playback.
+ * Call destroy() when done to free native resources.
+ */
+export interface StreamingTtsEngine {
+    readonly instanceId: string;
+    /** Generate speech in streaming mode; audio delivered via handlers. */
+    generateSpeechStream(text: string, options: TtsGenerationOptions | undefined, handlers: TtsStreamHandlers): Promise<TtsStreamController>;
+    /** Cancel the current streaming generation. */
+    cancelSpeechStream(): Promise<void>;
+    /** Start built-in PCM playback (e.g. for play-while-generating). */
+    startPcmPlayer(sampleRate: number, channels: number): Promise<void>;
+    /** Write float PCM samples to the player. Use from onChunk. */
+    writePcmChunk(samples: number[]): Promise<void>;
+    /** Stop and release the PCM player. */
+    stopPcmPlayer(): Promise<void>;
+    /** Model sample rate and number of speakers. */
+    getModelInfo(): Promise<TTSModelInfo>;
+    getSampleRate(): Promise<number>;
+    getNumSpeakers(): Promise<number>;
+    /** Release native TTS resources. Do not use the engine after this. */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=streamingTypes.d.ts.map

package/lib/typescript/src/tts/streamingTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingTypes.d.ts","sourceRoot":"","sources":["../../../../src/tts/streamingTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,uEAAuE;IACvE,oBAAoB,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,+CAA+C;IAC/C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,oEAAoE;IACpE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,+DAA+D;IAC/D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,uCAAuC;IACvC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,gDAAgD;IAChD,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC,sEAAsE;IACtE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/lib/typescript/src/tts/types.d.ts

@@ -239,6 +239,8 @@ export interface GeneratedAudioWithTimestamps extends GeneratedAudio {
 export interface TtsStreamChunk {
     /** Instance ID (set by native for multi-instance routing). */
     instanceId?: string;
+    /** Request ID for this generation (distinguishes concurrent streams on same instance). */
+    requestId?: string;
     samples: number[];
     sampleRate: number;
     progress: number;
@@ -250,6 +252,8 @@ export interface TtsStreamChunk {
 export interface TtsStreamEnd {
     /** Instance ID (set by native for multi-instance routing). */
     instanceId?: string;
+    /** Request ID for this generation. */
+    requestId?: string;
     cancelled: boolean;
 }
 /**
@@ -258,8 +262,20 @@ export interface TtsStreamEnd {
 export interface TtsStreamError {
     /** Instance ID (set by native for multi-instance routing). */
     instanceId?: string;
+    /** Request ID for this generation. */
+    requestId?: string;
     message: string;
 }
+/**
+ * Controller returned by generateSpeechStream().
+ * Use cancel() to stop generation, unsubscribe() to remove event listeners.
+ */
+export interface TtsStreamController {
+    /** Cancel the ongoing TTS generation. */
+    cancel(): Promise<void>;
+    /** Remove event listeners (called automatically on end/error, or manually). */
+    unsubscribe(): void;
+}
 /**
  * Handlers for TTS streaming generation (chunk, end, error).
  */
@@ -269,18 +285,15 @@ export interface TtsStreamHandlers {
     onError?: (event: TtsStreamError) => void;
 }
 /**
- * Instance-based TTS engine returned by createTTS().
+ * Instance-based batch TTS engine returned by createTTS().
+ * Use for one-shot synthesis (generateSpeech, generateSpeechWithTimestamps).
+ * For streaming, use createStreamingTTS() and StreamingTtsEngine instead.
  * Call destroy() when done to free native resources.
  */
 export interface TtsEngine {
     readonly instanceId: string;
     generateSpeech(text: string, options?: TtsGenerationOptions): Promise<GeneratedAudio>;
     generateSpeechWithTimestamps(text: string, options?: TtsGenerationOptions): Promise<GeneratedAudioWithTimestamps>;
-    generateSpeechStream(text: string, options: TtsGenerationOptions | undefined, handlers: TtsStreamHandlers): Promise<() => void>;
-    cancelSpeechStream(): Promise<void>;
-    startPcmPlayer(sampleRate: number, channels: number): Promise<void>;
-    writePcmChunk(samples: number[]): Promise<void>;
-    stopPcmPlayer(): Promise<void>;
     updateParams(options: TtsUpdateOptions): Promise<{
         success: boolean;
         detectedModels: Array<{

package/lib/typescript/src/tts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tts/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,MAAM,CAAC;AAEX,iDAAiD;AACjD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAQzC,CAAC;AAIX,wGAAwG;AACxG,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8GAA8G;AAC9G,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8GAA8G;AAC9G,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iHAAiH;AACjH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wJAAwJ;AACxJ,MAAM,WAAW,qBAAqB;CAErC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,cAAc,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAE3D;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc;IAClE;;OAEG;IACH,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,4BAA4B,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,oBAAoB,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACvB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAC/C,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3D,CAAC,CAAC;IACH,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tts/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-sherpa-onnx",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Offline Speech-to-text, text-to-speech, speaker diarization, speech enhancement, source separation, and VAD with sherpa-onnx for React NativeSpeech-to-Text with sherpa-onnx for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -185,7 +185,6 @@
     "name": "SherpaOnnxSpec",
     "type": "modules",
     "jsSrcsDir": "src",
-    "includesGeneratedCode": false,
     "android": {
       "javaPackageName": "com.sherpaonnx"
     }

package/src/NativeSherpaOnnx.ts

@@ -120,6 +120,97 @@ export interface Spec extends TurboModule {
    */
   unloadStt(instanceId: string): Promise<void>;
 
+  // ==================== Online (streaming) STT Methods ====================
+
+  /**
+   * Initialize OnlineRecognizer for streaming STT (single options object to avoid iOS TurboModule marshalling crash with many args).
+   * @param instanceId - Unique ID for this engine instance (from createStreamingSTT)
+   * @param options - All init options (modelDir, modelType, enableEndpoint, decodingMethod, maxActivePaths, and optional endpoint/rule params)
+   */
+  initializeOnlineSttWithOptions(
+    instanceId: string,
+    options: {
+      modelDir: string;
+      modelType: string;
+      enableEndpoint?: boolean;
+      decodingMethod?: string;
+      maxActivePaths?: number;
+      hotwordsFile?: string;
+      hotwordsScore?: number;
+      numThreads?: number;
+      provider?: string;
+      ruleFsts?: string;
+      ruleFars?: string;
+      blankPenalty?: number;
+      debug?: boolean;
+      rule1MustContainNonSilence?: boolean;
+      rule1MinTrailingSilence?: number;
+      rule1MinUtteranceLength?: number;
+      rule2MustContainNonSilence?: boolean;
+      rule2MinTrailingSilence?: number;
+      rule2MinUtteranceLength?: number;
+      rule3MustContainNonSilence?: boolean;
+      rule3MinTrailingSilence?: number;
+      rule3MinUtteranceLength?: number;
+    }
+  ): Promise<{ success: boolean }>;
+
+  /** Create a new stream for the given OnlineRecognizer instance. */
+  createSttStream(
+    instanceId: string,
+    streamId: string,
+    hotwords?: string
+  ): Promise<void>;
+
+  /** Feed PCM samples to a streaming STT stream. */
+  acceptSttWaveform(
+    streamId: string,
+    samples: number[],
+    sampleRate: number
+  ): Promise<void>;
+
+  /** Signal end of input for a streaming STT stream. */
+  sttStreamInputFinished(streamId: string): Promise<void>;
+
+  /** Run decoding on the stream (call when isSttStreamReady is true). */
+  decodeSttStream(streamId: string): Promise<void>;
+
+  /** True if the stream has enough audio to decode. */
+  isSttStreamReady(streamId: string): Promise<boolean>;
+
+  /** Get current partial or final result (call after decodeSttStream). */
+  getSttStreamResult(streamId: string): Promise<{
+    text: string;
+    tokens: string[];
+    timestamps: number[];
+  }>;
+
+  /** True if endpoint (end of utterance) was detected. */
+  isSttStreamEndpoint(streamId: string): Promise<boolean>;
+
+  /** Reset stream state for reuse. */
+  resetSttStream(streamId: string): Promise<void>;
+
+  /** Release stream and remove from native state. */
+  releaseSttStream(streamId: string): Promise<void>;
+
+  /** Release OnlineRecognizer and all its streams. */
+  unloadOnlineStt(instanceId: string): Promise<void>;
+
+  /**
+   * Convenience: feed audio, decode while ready, return result and endpoint status in one call.
+   */
+  processSttAudioChunk(
+    streamId: string,
+    samples: number[],
+    sampleRate: number
+  ): Promise<{
+    text: string;
+    tokens: string[];
+    timestamps: number[];
+    isEndpoint: boolean;
+  }>;
+
   // ==================== TTS Methods ====================
 
   /**
@@ -230,14 +321,18 @@ export interface Spec extends TurboModule {
     estimated: boolean;
   }>;
 
+  // ==================== Online (streaming) TTS Methods ====================
+
   /**
    * Generate speech in streaming mode (emits chunk events).
    * @param instanceId - Unique ID for this engine instance
+   * @param requestId - Unique ID for this generation (included in chunk/end/error events for routing)
    * @param text - Text to convert to speech
    * @param options - Generation options (sid, speed, referenceAudio, referenceText, numSteps, silenceScale, extra)
    */
   generateTtsStream(
     instanceId: string,
+    requestId: string,
     text: string,
     options: Object
   ): Promise<void>;

package/src/index.tsx

@@ -17,8 +17,8 @@ export {
 } from './utils';
 
 // Note: Feature-specific exports are available via subpath imports:
-// - import { ... } from 'react-native-sherpa-onnx/stt'
-// - import { ... } from 'react-native-sherpa-onnx/tts'
+// - import { createSTT, createStreamingSTT, ... } from 'react-native-sherpa-onnx/stt'
+// - import { createTTS, ... } from 'react-native-sherpa-onnx/tts'
 // - import { ... } from 'react-native-sherpa-onnx/download'
 // - import { ... } from 'react-native-sherpa-onnx/vad' (planned)
 // - import { ... } from 'react-native-sherpa-onnx/diarization' (planned)

package/src/stt/index.ts

@@ -219,6 +219,23 @@ export async function createSTT(
   return engine;
 }
 
+// Streaming (online) STT
+export {
+  createStreamingSTT,
+  mapDetectedToOnlineType,
+  getOnlineTypeOrNull,
+} from './streaming';
+export type {
+  OnlineSTTModelType,
+  StreamingSttEngine,
+  StreamingSttInitOptions,
+  StreamingSttResult,
+  SttStream,
+  EndpointConfig,
+  EndpointRule,
+} from './streamingTypes';
+export { ONLINE_STT_MODEL_TYPES } from './streamingTypes';
+
 // Export types and runtime type list
 export type {
   STTInitializeOptions,