react-native-sherpa-onnx 0.3.0 → 0.3.2

package/ios/online_stt/sherpa-onnx-online-stt-wrapper.h

@@ -0,0 +1,85 @@
+/**
+ * sherpa-onnx-online-stt-wrapper.h
+ *
+ * Purpose: Wraps sherpa-onnx C++ OnlineRecognizer for iOS streaming STT.
+ * Manages recognizer instances and streams; scans model directory for paths.
+ * Used by SherpaOnnx+OnlineSTT.mm.
+ */
+
+#ifndef SHERPA_ONNX_ONLINE_STT_WRAPPER_H
+#define SHERPA_ONNX_ONLINE_STT_WRAPPER_H
+
+#include <memory>
+#include <string>
+#include <unordered_map>
+#include <vector>
+
+namespace sherpaonnx {
+
+struct OnlineSttInitResult {
+    bool success = false;
+    std::string error;
+};
+
+struct OnlineSttStreamResult {
+    std::string text;
+    std::vector<std::string> tokens;
+    std::vector<float> timestamps;
+    bool isEndpoint = false;
+};
+
+/**
+ * Wrapper for sherpa-onnx OnlineRecognizer (streaming STT).
+ * One wrapper per instanceId; multiple streams per instance.
+ */
+class OnlineSttWrapper {
+public:
+    OnlineSttWrapper();
+    ~OnlineSttWrapper();
+
+    OnlineSttInitResult initialize(
+        const std::string& modelDir,
+        const std::string& modelType,
+        bool enableEndpoint,
+        const std::string& decodingMethod,
+        int32_t maxActivePaths,
+        const std::string& hotwordsFile,
+        float hotwordsScore,
+        int32_t numThreads,
+        const std::string& provider,
+        const std::string& ruleFsts,
+        const std::string& ruleFars,
+        float blankPenalty,
+        bool debug,
+        bool rule1MustContainNonSilence,
+        float rule1MinTrailingSilence,
+        float rule1MinUtteranceLength,
+        bool rule2MustContainNonSilence,
+        float rule2MinTrailingSilence,
+        float rule2MinUtteranceLength,
+        bool rule3MustContainNonSilence,
+        float rule3MinTrailingSilence,
+        float rule3MinUtteranceLength
+    );
+
+    bool createStream(const std::string& streamId, const std::string& hotwords);
+    void acceptWaveform(const std::string& streamId, int32_t sampleRate, const float* samples, size_t n);
+    void inputFinished(const std::string& streamId);
+    void decode(const std::string& streamId);
+    bool isReady(const std::string& streamId);
+    OnlineSttStreamResult getResult(const std::string& streamId);
+    bool isEndpoint(const std::string& streamId);
+    void resetStream(const std::string& streamId);
+    void releaseStream(const std::string& streamId);
+    void unload();
+
+    bool isInitialized() const;
+
+private:
+    struct Impl;
+    std::unique_ptr<Impl> pImpl;
+};
+
+} // namespace sherpaonnx
+
+#endif // SHERPA_ONNX_ONLINE_STT_WRAPPER_H

package/ios/online_stt/sherpa-onnx-online-stt-wrapper.mm

@@ -0,0 +1,270 @@
+/**
+ * sherpa-onnx-online-stt-wrapper.mm
+ *
+ * Purpose: Wraps sherpa-onnx C++ OnlineRecognizer for iOS streaming STT.
+ * Scans model directory, builds config, manages recognizer and streams.
+ */
+
+#include "sherpa-onnx-online-stt-wrapper.h"
+#include "sherpa-onnx-model-detect-helper.h"
+
+#include "sherpa-onnx/c-api/cxx-api.h"
+
+#include <algorithm>
+#include <cstring>
+#include <string>
+#include <utility>
+
+#ifdef __APPLE__
+#import <Foundation/Foundation.h>
+#define LOGO(fmt, ...) NSLog(@"OnlineSttWrapper: " fmt, ##__VA_ARGS__)
+#define LOGE(fmt, ...) NSLog(@"OnlineSttWrapper ERROR: " fmt, ##__VA_ARGS__)
+#else
+#define LOGO(...)
+#define LOGE(...)
+#endif
+
+namespace sherpaonnx {
+
+using namespace model_detect;
+
+namespace {
+
+/** Scan model directory for online model type; returns paths map (encoder, decoder, joiner, tokens or model, tokens). */
+std::unordered_map<std::string, std::string> scanOnlineModelPaths(const std::string& modelDir, const std::string& modelType) {
+    std::unordered_map<std::string, std::string> out;
+    const int kMaxDepth = 4;
+    std::vector<FileEntry> files = ListFilesRecursive(modelDir, kMaxDepth);
+
+    auto firstOnnx = [&files](const std::vector<std::string>& tokens) -> std::string {
+        return FindOnnxByAnyToken(files, tokens, std::nullopt);
+    };
+    std::string tokensPath = FindFileEndingWith(files, "tokens.txt");
+
+    if (modelType == "transducer") {
+        std::string enc = firstOnnx({"encoder"});
+        std::string dec = firstOnnx({"decoder"});
+        std::string join = firstOnnx({"joiner"});
+        if (enc.empty() || dec.empty() || join.empty()) {
+            return {};
+        }
+        out["encoder"] = enc;
+        out["decoder"] = dec;
+        out["joiner"] = join;
+        out["tokens"] = tokensPath;
+        return out;
+    }
+    if (modelType == "paraformer") {
+        std::string enc = firstOnnx({"encoder"});
+        std::string dec = firstOnnx({"decoder"});
+        if (enc.empty() || dec.empty()) return {};
+        out["encoder"] = enc;
+        out["decoder"] = dec;
+        out["tokens"] = tokensPath;
+        return out;
+    }
+    if (modelType == "zipformer2_ctc" || modelType == "nemo_ctc" || modelType == "tone_ctc") {
+        std::string modelPath = firstOnnx({"model"});
+        if (modelPath.empty()) {
+            std::vector<std::string> exclude = {"encoder", "decoder", "joiner", "vocoder", "acoustic", "embedding", "llm"};
+            modelPath = FindLargestOnnxExcludingTokens(files, exclude);
+        }
+        if (modelPath.empty()) return {};
+        out["model"] = modelPath;
+        out["tokens"] = tokensPath;
+        return out;
+    }
+    return {};
+}
+
+} // namespace
+
+struct OnlineSttWrapper::Impl {
+    std::unique_ptr<sherpa_onnx::cxx::OnlineRecognizer> recognizer;
+    std::unordered_map<std::string, sherpa_onnx::cxx::OnlineStream> streams;
+    bool initialized = false;
+};
+
+OnlineSttWrapper::OnlineSttWrapper() : pImpl(std::make_unique<Impl>()) {}
+
+OnlineSttWrapper::~OnlineSttWrapper() {
+    unload();
+}
+
+OnlineSttInitResult OnlineSttWrapper::initialize(
+    const std::string& modelDir,
+    const std::string& modelType,
+    bool enableEndpoint,
+    const std::string& decodingMethod,
+    int32_t maxActivePaths,
+    const std::string& hotwordsFile,
+    float hotwordsScore,
+    int32_t numThreads,
+    const std::string& provider,
+    const std::string& ruleFsts,
+    const std::string& ruleFars,
+    float blankPenalty,
+    bool debug,
+    // NOTE: rule*MustContainNonSilence, rule1/2MinUtteranceLength, and
+    // rule3MinTrailingSilence are not exposed by the sherpa-onnx C++ CXX API
+    // (cxx-api.h). Only rule1_min_trailing_silence, rule2_min_trailing_silence,
+    // and rule3_min_utterance_length are supported on iOS.
+    bool /* rule1MustContainNonSilence */,
+    float rule1MinTrailingSilence,
+    float /* rule1MinUtteranceLength */,
+    bool /* rule2MustContainNonSilence */,
+    float rule2MinTrailingSilence,
+    float /* rule2MinUtteranceLength */,
+    bool /* rule3MustContainNonSilence */,
+    float /* rule3MinTrailingSilence */,
+    float rule3MinUtteranceLength
+) {
+    OnlineSttInitResult result;
+    if (pImpl->initialized) {
+        result.error = "Already initialized";
+        return result;
+    }
+    if (!FileExists(modelDir) || !IsDirectory(modelDir)) {
+        result.error = "Model directory does not exist or is not a directory: " + modelDir;
+        return result;
+    }
+
+    auto paths = scanOnlineModelPaths(modelDir, modelType);
+    if (paths.empty()) {
+        result.error = "Unsupported or invalid online STT model type or missing files: " + modelType;
+        return result;
+    }
+
+    sherpa_onnx::cxx::OnlineRecognizerConfig config;
+    config.feat_config.sample_rate = 16000;
+    config.feat_config.feature_dim = 80;
+    config.decoding_method = decodingMethod.empty() ? "greedy_search" : decodingMethod;
+    config.max_active_paths = maxActivePaths;
+    config.enable_endpoint = enableEndpoint;
+    config.rule1_min_trailing_silence = rule1MinTrailingSilence > 0 ? rule1MinTrailingSilence : 2.4f;
+    config.rule2_min_trailing_silence = rule2MinTrailingSilence > 0 ? rule2MinTrailingSilence : 1.4f;
+    config.rule3_min_utterance_length = rule3MinUtteranceLength > 0 ? rule3MinUtteranceLength : 20.f;
+    config.hotwords_file = hotwordsFile;
+    config.hotwords_score = hotwordsScore;
+    config.rule_fsts = ruleFsts;
+    config.rule_fars = ruleFars;
+    config.blank_penalty = blankPenalty;
+    config.model_config.num_threads = numThreads <= 0 ? 1 : numThreads;
+    config.model_config.provider = provider.empty() ? "cpu" : provider;
+    config.model_config.debug = debug;
+    config.model_config.tokens = paths.count("tokens") ? paths["tokens"] : "";
+
+    if (modelType == "transducer") {
+        config.model_config.transducer.encoder = paths["encoder"];
+        config.model_config.transducer.decoder = paths["decoder"];
+        config.model_config.transducer.joiner = paths["joiner"];
+        config.model_config.model_type = "zipformer";
+    } else if (modelType == "paraformer") {
+        config.model_config.paraformer.encoder = paths["encoder"];
+        config.model_config.paraformer.decoder = paths["decoder"];
+        config.model_config.model_type = "paraformer";
+    } else if (modelType == "zipformer2_ctc") {
+        config.model_config.zipformer2_ctc.model = paths["model"];
+        config.model_config.model_type = "zipformer2";
+    } else if (modelType == "nemo_ctc") {
+        config.model_config.nemo_ctc.model = paths["model"];
+        config.model_config.model_type = "nemo_ctc";
+    } else if (modelType == "tone_ctc") {
+        config.model_config.t_one_ctc.model = paths["model"];
+        config.model_config.model_type = "t_one";
+    } else {
+        result.error = "Unsupported online STT model type: " + modelType;
+        return result;
+    }
+
+    try {
+        sherpa_onnx::cxx::OnlineRecognizer rec = sherpa_onnx::cxx::OnlineRecognizer::Create(config);
+        pImpl->recognizer = std::make_unique<sherpa_onnx::cxx::OnlineRecognizer>(std::move(rec));
+        pImpl->initialized = true;
+        result.success = true;
+    } catch (const std::exception& e) {
+        result.error = std::string("OnlineRecognizer Create failed: ") + e.what();
+        LOGE("%s", result.error.c_str());
+    } catch (...) {
+        result.error = "OnlineRecognizer Create failed: unknown error";
+        LOGE("%s", result.error.c_str());
+    }
+    return result;
+}
+
+bool OnlineSttWrapper::createStream(const std::string& streamId, const std::string& hotwords) {
+    if (!pImpl->initialized || !pImpl->recognizer) return false;
+    if (pImpl->streams.count(streamId)) return false;
+    try {
+        sherpa_onnx::cxx::OnlineStream stream = hotwords.empty()
+            ? pImpl->recognizer->CreateStream()
+            : pImpl->recognizer->CreateStream(hotwords);
+        pImpl->streams.emplace(streamId, std::move(stream));
+        return true;
+    } catch (...) {
+        return false;
+    }
+}
+
+void OnlineSttWrapper::acceptWaveform(const std::string& streamId, int32_t sampleRate, const float* samples, size_t n) {
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end()) return;
+    it->second.AcceptWaveform(sampleRate, samples, static_cast<int32_t>(n));
+}
+
+void OnlineSttWrapper::inputFinished(const std::string& streamId) {
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end()) return;
+    it->second.InputFinished();
+}
+
+void OnlineSttWrapper::decode(const std::string& streamId) {
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end() || !pImpl->recognizer) return;
+    pImpl->recognizer->Decode(&it->second);
+}
+
+bool OnlineSttWrapper::isReady(const std::string& streamId) {
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end() || !pImpl->recognizer) return false;
+    return pImpl->recognizer->IsReady(&it->second);
+}
+
+OnlineSttStreamResult OnlineSttWrapper::getResult(const std::string& streamId) {
+    OnlineSttStreamResult r;
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end() || !pImpl->recognizer) return r;
+    sherpa_onnx::cxx::OnlineRecognizerResult res = pImpl->recognizer->GetResult(&it->second);
+    r.text = res.text;
+    r.tokens = res.tokens;
+    r.timestamps = res.timestamps;
+    return r;
+}
+
+bool OnlineSttWrapper::isEndpoint(const std::string& streamId) {
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end() || !pImpl->recognizer) return false;
+    return pImpl->recognizer->IsEndpoint(&it->second);
+}
+
+void OnlineSttWrapper::resetStream(const std::string& streamId) {
+    auto it = pImpl->streams.find(streamId);
+    if (it == pImpl->streams.end() || !pImpl->recognizer) return;
+    pImpl->recognizer->Reset(&it->second);
+}
+
+void OnlineSttWrapper::releaseStream(const std::string& streamId) {
+    pImpl->streams.erase(streamId);
+}
+
+void OnlineSttWrapper::unload() {
+    pImpl->streams.clear();
+    pImpl->recognizer.reset();
+    pImpl->initialized = false;
+}
+
+bool OnlineSttWrapper::isInitialized() const {
+    return pImpl->initialized && pImpl->recognizer != nullptr;
+}
+
+} // namespace sherpaonnx

package/lib/module/NativeSherpaOnnx.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeSherpaOnnx.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;;AAEpE;;AAudA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,YAAY,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeSherpaOnnx.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;;AAEpE;;AAsjBA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,YAAY,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -7,8 +7,8 @@ import SherpaOnnx from "./NativeSherpaOnnx.js";
 export { assetModelPath, autoModelPath, fileModelPath, getAssetPackPath, getDefaultModelPath, getPlayAssetDeliveryModelsPath, listAssetModels, listModelsAtPath, resolveModelPath } from "./utils.js";
 
 // 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/lib/module/stt/index.js

@@ -142,6 +142,10 @@ export async function createSTT(options) {
   return engine;
 }
 
+// Streaming (online) STT
+export { createStreamingSTT, mapDetectedToOnlineType, getOnlineTypeOrNull } from "./streaming.js";
+export { ONLINE_STT_MODEL_TYPES } from "./streamingTypes.js";
+
 // Export types and runtime type list
 
 export { STT_MODEL_TYPES, STT_HOTWORDS_MODEL_TYPES, sttSupportsHotwords } from "./types.js";

package/lib/module/stt/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["SherpaOnnx","resolveModelPath","sttInstanceCounter","normalizeSttResult","raw","text","tokens","Array","isArray","timestamps","lang","emotion","event","durations","detectSttModel","modelPath","options","resolvedPath","preferInt8","modelType","createSTT","instanceId","hotwordsFile","hotwordsScore","numThreads","provider","ruleFsts","ruleFars","dither","modelOptions","modelingUnit","bpeVocab","undefined","debug","result","initializeStt","success","Error","JSON","stringify","detectedModels","destroyed","guard","engine","transcribeFile","filePath","transcribeSamples","samples","sampleRate","setConfig","config","map","decodingMethod","maxActivePaths","blankPenalty","setSttConfig","destroy","unloadStt","STT_MODEL_TYPES","STT_HOTWORDS_MODEL_TYPES","sttSupportsHotwords","getWhisperLanguages","WHISPER_LANGUAGES","getSenseVoiceLanguages","SENSEVOICE_LANGUAGES","getCanaryLanguages","CANARY_LANGUAGES","getFunasrNanoLanguages","FUNASR_NANO_LANGUAGES","getFunasrMltNanoLanguages","FUNASR_MLT_NANO_LANGUAGES"],"sourceRoot":"../../../src","sources":["stt/index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["SherpaOnnx","resolveModelPath","sttInstanceCounter","normalizeSttResult","raw","text","tokens","Array","isArray","timestamps","lang","emotion","event","durations","detectSttModel","modelPath","options","resolvedPath","preferInt8","modelType","createSTT","instanceId","hotwordsFile","hotwordsScore","numThreads","provider","ruleFsts","ruleFars","dither","modelOptions","modelingUnit","bpeVocab","undefined","debug","result","initializeStt","success","Error","JSON","stringify","detectedModels","destroyed","guard","engine","transcribeFile","filePath","transcribeSamples","samples","sampleRate","setConfig","config","map","decodingMethod","maxActivePaths","blankPenalty","setSttConfig","destroy","unloadStt","createStreamingSTT","mapDetectedToOnlineType","getOnlineTypeOrNull","ONLINE_STT_MODEL_TYPES","STT_MODEL_TYPES","STT_HOTWORDS_MODEL_TYPES","sttSupportsHotwords","getWhisperLanguages","WHISPER_LANGUAGES","getSenseVoiceLanguages","SENSEVOICE_LANGUAGES","getCanaryLanguages","CANARY_LANGUAGES","getFunasrNanoLanguages","FUNASR_NANO_LANGUAGES","getFunasrMltNanoLanguages","FUNASR_MLT_NANO_LANGUAGES"],"sourceRoot":"../../../src","sources":["stt/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/stt/streaming.js

@@ -0,0 +1,257 @@
+"use strict";
+
+import SherpaOnnx from "../NativeSherpaOnnx.js";
+import { resolveModelPath } from "../utils.js";
+let streamingSttInstanceCounter = 0;
+
+/**
+ * Map detected STT model type (from detectSttModel) to an online (streaming) model type.
+ * Throws if the detected type has no streaming support.
+ */
+export function mapDetectedToOnlineType(detectedType) {
+  const t = detectedType ?? '';
+  switch (t) {
+    case 'transducer':
+      return 'transducer';
+    case 'paraformer':
+      return 'paraformer';
+    case 'nemo_ctc':
+      return 'nemo_ctc';
+    case 'zipformer_ctc':
+    case 'ctc':
+      return 'zipformer2_ctc';
+    case 'tone_ctc':
+      return 'tone_ctc';
+    default:
+      throw new Error(`Model type "${t}" is not supported for streaming STT. Use createSTT() for offline recognition, or pass a supported modelType: transducer, paraformer, zipformer2_ctc, nemo_ctc, tone_ctc.`);
+  }
+}
+
+/**
+ * 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 function getOnlineTypeOrNull(detectedType) {
+  try {
+    return mapDetectedToOnlineType(detectedType);
+  } catch {
+    return null;
+  }
+}
+let sttStreamCounter = 0;
+function normalizeStreamingResult(raw) {
+  return {
+    text: typeof raw.text === 'string' ? raw.text : '',
+    tokens: Array.isArray(raw.tokens) ? raw.tokens : [],
+    timestamps: Array.isArray(raw.timestamps) ? raw.timestamps : []
+  };
+}
+
+/**
+ * Flatten StreamingSttInitOptions to native initializeOnlineStt parameters.
+ * EndpointConfig (rule1, rule2, rule3) is expanded to 9 flat params.
+ */
+function flattenInitOptionsForNative(options) {
+  const ep = options.endpointConfig;
+  return {
+    modelDir: '',
+    // filled by caller after resolveModelPath
+    modelType: options.modelType,
+    enableEndpoint: options.enableEndpoint ?? true,
+    decodingMethod: options.decodingMethod ?? 'greedy_search',
+    maxActivePaths: options.maxActivePaths ?? 4,
+    hotwordsFile: options.hotwordsFile,
+    hotwordsScore: options.hotwordsScore,
+    numThreads: options.numThreads,
+    provider: options.provider,
+    ruleFsts: options.ruleFsts,
+    ruleFars: options.ruleFars,
+    blankPenalty: options.blankPenalty,
+    debug: options.debug,
+    rule1MustContainNonSilence: ep?.rule1?.mustContainNonSilence,
+    rule1MinTrailingSilence: ep?.rule1?.minTrailingSilence,
+    rule1MinUtteranceLength: ep?.rule1?.minUtteranceLength,
+    rule2MustContainNonSilence: ep?.rule2?.mustContainNonSilence,
+    rule2MinTrailingSilence: ep?.rule2?.minTrailingSilence,
+    rule2MinUtteranceLength: ep?.rule2?.minUtteranceLength,
+    rule3MustContainNonSilence: ep?.rule3?.mustContainNonSilence,
+    rule3MinTrailingSilence: ep?.rule3?.minTrailingSilence,
+    rule3MinUtteranceLength: ep?.rule3?.minUtteranceLength
+  };
+}
+
+/**
+ * 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 async function createStreamingSTT(options) {
+  const instanceId = `streaming_stt_${++streamingSttInstanceCounter}`;
+  const resolvedPath = await resolveModelPath(options.modelPath);
+  let effectiveModelType;
+  if (options.modelType === 'auto' || options.modelType === undefined) {
+    const detectResult = await SherpaOnnx.detectSttModel(resolvedPath, undefined, undefined);
+    if (!detectResult.success) {
+      const errMsg = 'error' in detectResult && typeof detectResult.error === 'string' ? detectResult.error : 'Unknown error';
+      throw new Error(`Streaming STT auto-detection failed for ${resolvedPath}. ${errMsg}`);
+    }
+    effectiveModelType = mapDetectedToOnlineType(detectResult.modelType);
+  } else {
+    effectiveModelType = options.modelType;
+  }
+  const optionsWithResolvedType = {
+    ...options,
+    modelType: effectiveModelType
+  };
+  const flat = flattenInitOptionsForNative(optionsWithResolvedType);
+  flat.modelDir = resolvedPath;
+
+  // Build options with only defined values (no undefined) to avoid iOS TurboModule marshalling crash when options contain undefined.
+  const nativeOptions = {
+    modelDir: flat.modelDir,
+    modelType: flat.modelType,
+    enableEndpoint: flat.enableEndpoint,
+    decodingMethod: flat.decodingMethod,
+    maxActivePaths: flat.maxActivePaths
+  };
+  if (flat.hotwordsFile !== undefined) nativeOptions.hotwordsFile = flat.hotwordsFile;
+  if (flat.hotwordsScore !== undefined) nativeOptions.hotwordsScore = flat.hotwordsScore;
+  if (flat.numThreads !== undefined) nativeOptions.numThreads = flat.numThreads;
+  if (flat.provider !== undefined) nativeOptions.provider = flat.provider;
+  if (flat.ruleFsts !== undefined) nativeOptions.ruleFsts = flat.ruleFsts;
+  if (flat.ruleFars !== undefined) nativeOptions.ruleFars = flat.ruleFars;
+  if (flat.blankPenalty !== undefined) nativeOptions.blankPenalty = flat.blankPenalty;
+  if (flat.debug !== undefined) nativeOptions.debug = flat.debug;
+  if (flat.rule1MustContainNonSilence !== undefined) nativeOptions.rule1MustContainNonSilence = flat.rule1MustContainNonSilence;
+  if (flat.rule1MinTrailingSilence !== undefined) nativeOptions.rule1MinTrailingSilence = flat.rule1MinTrailingSilence;
+  if (flat.rule1MinUtteranceLength !== undefined) nativeOptions.rule1MinUtteranceLength = flat.rule1MinUtteranceLength;
+  if (flat.rule2MustContainNonSilence !== undefined) nativeOptions.rule2MustContainNonSilence = flat.rule2MustContainNonSilence;
+  if (flat.rule2MinTrailingSilence !== undefined) nativeOptions.rule2MinTrailingSilence = flat.rule2MinTrailingSilence;
+  if (flat.rule2MinUtteranceLength !== undefined) nativeOptions.rule2MinUtteranceLength = flat.rule2MinUtteranceLength;
+  if (flat.rule3MustContainNonSilence !== undefined) nativeOptions.rule3MustContainNonSilence = flat.rule3MustContainNonSilence;
+  if (flat.rule3MinTrailingSilence !== undefined) nativeOptions.rule3MinTrailingSilence = flat.rule3MinTrailingSilence;
+  if (flat.rule3MinUtteranceLength !== undefined) nativeOptions.rule3MinUtteranceLength = flat.rule3MinUtteranceLength;
+  const result = await SherpaOnnx.initializeOnlineSttWithOptions(instanceId, nativeOptions);
+  if (!result.success) {
+    throw new Error(`Streaming STT initialization failed for ${instanceId}`);
+  }
+  const enableInputNormalization = options.enableInputNormalization !== false;
+  let destroyed = false;
+  const guard = () => {
+    if (destroyed) {
+      throw new Error(`Streaming STT engine ${instanceId} has been destroyed; cannot call methods on it.`);
+    }
+  };
+  const engine = {
+    get instanceId() {
+      return instanceId;
+    },
+    async createStream(hotwords) {
+      guard();
+      const streamId = `stt_stream_${++sttStreamCounter}`;
+      await SherpaOnnx.createSttStream(instanceId, streamId, hotwords);
+      let released = false;
+      const streamGuard = () => {
+        if (destroyed) {
+          throw new Error(`Streaming STT engine ${instanceId} has been destroyed.`);
+        }
+        if (released) {
+          throw new Error(`Stream ${streamId} has been released; cannot call methods on it.`);
+        }
+      };
+      const stream = {
+        get streamId() {
+          return streamId;
+        },
+        async acceptWaveform(samples, sampleRate) {
+          streamGuard();
+          await SherpaOnnx.acceptSttWaveform(streamId, samples, sampleRate);
+        },
+        async inputFinished() {
+          streamGuard();
+          await SherpaOnnx.sttStreamInputFinished(streamId);
+        },
+        async decode() {
+          streamGuard();
+          await SherpaOnnx.decodeSttStream(streamId);
+        },
+        async isReady() {
+          streamGuard();
+          return SherpaOnnx.isSttStreamReady(streamId);
+        },
+        async getResult() {
+          streamGuard();
+          const raw = await SherpaOnnx.getSttStreamResult(streamId);
+          return normalizeStreamingResult(raw);
+        },
+        async isEndpoint() {
+          streamGuard();
+          return SherpaOnnx.isSttStreamEndpoint(streamId);
+        },
+        async reset() {
+          streamGuard();
+          await SherpaOnnx.resetSttStream(streamId);
+        },
+        async release() {
+          if (released) return;
+          released = true;
+          await SherpaOnnx.releaseSttStream(streamId);
+        },
+        async processAudioChunk(samples, sampleRate) {
+          streamGuard();
+          let toSend = samples;
+          if (enableInputNormalization && samples.length > 0) {
+            let maxAbs = 1e-10;
+            for (let i = 0; i < samples.length; i++) {
+              const abs = Math.abs(samples[i]);
+              if (abs > maxAbs) maxAbs = abs;
+            }
+            const scale = maxAbs < 0.01 ? 80 : Math.min(80, 0.8 / maxAbs);
+            toSend = new Array(samples.length);
+            for (let i = 0; i < samples.length; i++) {
+              const v = samples[i] * scale;
+              toSend[i] = v < -1 ? -1 : v > 1 ? 1 : v;
+            }
+          }
+          const raw = await SherpaOnnx.processSttAudioChunk(streamId, toSend, sampleRate);
+          return {
+            result: normalizeStreamingResult(raw),
+            isEndpoint: Boolean(raw.isEndpoint)
+          };
+        }
+      };
+      return stream;
+    },
+    async destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      await SherpaOnnx.unloadOnlineStt(instanceId);
+    }
+  };
+  return engine;
+}
+//# sourceMappingURL=streaming.js.map