react-native-sherpa-onnx 0.3.8 → 0.3.9

package/src/extraction/extractTarBz2.ts

@@ -1,5 +1,6 @@
 import { DeviceEventEmitter } from 'react-native';
 import SherpaOnnx from '../NativeSherpaOnnx';
+import type { ExtractNotificationArgs } from './types';
 
 export type ExtractProgressEvent = {
   bytes: number;
@@ -19,7 +20,8 @@ export async function extractTarBz2(
   targetPath: string,
   force = true,
   onProgress?: (event: ExtractProgressEvent) => void,
-  signal?: AbortSignal
+  signal?: AbortSignal,
+  notification?: ExtractNotificationArgs
 ): Promise<ExtractResult> {
   let subscription: { remove: () => void } | null = null;
   let removeAbortListener: (() => void) | null = null;
@@ -62,7 +64,10 @@ export async function extractTarBz2(
     const result = await SherpaOnnx.extractTarBz2(
       sourcePath,
       targetPath,
-      force
+      force,
+      notification?.showNotificationsEnabled,
+      notification?.notificationTitle,
+      notification?.notificationText
     );
     if (!result.success) {
       const message = result.reason || 'Extraction failed';

package/src/extraction/extractTarZst.ts

@@ -1,5 +1,6 @@
 import { DeviceEventEmitter } from 'react-native';
 import SherpaOnnx from '../NativeSherpaOnnx';
+import type { ExtractNotificationArgs } from './types';
 
 export type ExtractProgressEvent = {
   bytes: number;
@@ -19,7 +20,8 @@ export async function extractTarZst(
   targetPath: string,
   force = true,
   onProgress?: (event: ExtractProgressEvent) => void,
-  signal?: AbortSignal
+  signal?: AbortSignal,
+  notification?: ExtractNotificationArgs
 ): Promise<ExtractResult> {
   let subscription: { remove: () => void } | null = null;
   let removeAbortListener: (() => void) | null = null;
@@ -61,7 +63,10 @@ export async function extractTarZst(
     const result = await SherpaOnnx.extractTarZst(
       sourcePath,
       targetPath,
-      force
+      force,
+      notification?.showNotificationsEnabled,
+      notification?.notificationTitle,
+      notification?.notificationText
     );
     if (!result.success) {
       const message = result.reason || 'Extraction failed';

package/src/extraction/index.ts

@@ -17,6 +17,7 @@ import { extractTarBz2 } from './extractTarBz2';
 import type {
   BundledArchive,
   ExtractArchiveOptions,
+  ExtractNotificationArgs,
   ExtractResult,
   ExtractProgressEvent,
 } from './types';
@@ -24,6 +25,7 @@ import type {
 export type {
   BundledArchive,
   ExtractArchiveOptions,
+  ExtractNotificationArgs,
   ExtractResult,
   ExtractProgressEvent,
 } from './types';
@@ -160,6 +162,11 @@ export async function extractArchive(
   const force = options?.force !== false;
   const onProgress = options?.onProgress;
   const signal = options?.signal;
+  const notification = {
+    showNotificationsEnabled: options?.showNotificationsEnabled,
+    notificationTitle: options?.notificationTitle,
+    notificationText: options?.notificationText,
+  };
 
   if (signal?.aborted) {
     const err = new Error('Extraction aborted');
@@ -173,7 +180,14 @@ export async function extractArchive(
       archive.archivePath.startsWith('asset_packs/'));
 
   if (useAssetStream) {
-    return extractFromAsset(archive, targetPath, force, onProgress, signal);
+    return extractFromAsset(
+      archive,
+      targetPath,
+      force,
+      onProgress,
+      signal,
+      notification
+    );
   }
 
   if (archive.format === 'tar.zst') {
@@ -182,7 +196,8 @@ export async function extractArchive(
       targetPath,
       force,
       onProgress,
-      signal
+      signal,
+      notification
     );
   }
   return extractTarBz2(
@@ -190,7 +205,8 @@ export async function extractArchive(
     targetPath,
     force,
     onProgress,
-    signal
+    signal,
+    notification
   );
 }
 
@@ -201,7 +217,8 @@ async function extractFromAsset(
   targetPath: string,
   force: boolean,
   onProgress?: (event: ExtractProgressEvent) => void,
-  signal?: AbortSignal
+  signal?: AbortSignal,
+  notification?: ExtractNotificationArgs
 ): Promise<ExtractResult> {
   const eventName =
     archive.format === 'tar.zst'
@@ -245,12 +262,18 @@ async function extractFromAsset(
         ? await SherpaOnnx.extractTarZstFromAsset(
             archive.archivePath,
             targetPath,
-            force
+            force,
+            notification?.showNotificationsEnabled,
+            notification?.notificationTitle,
+            notification?.notificationText
           )
         : await SherpaOnnx.extractTarBz2FromAsset(
             archive.archivePath,
             targetPath,
-            force
+            force,
+            notification?.showNotificationsEnabled,
+            notification?.notificationTitle,
+            notification?.notificationText
           );
 
     if (!result.success) {

package/src/extraction/types.ts

@@ -60,4 +60,20 @@ export type ExtractArchiveOptions = {
   onProgress?: (event: ExtractProgressEvent) => void;
   /** AbortSignal to cancel the extraction. */
   signal?: AbortSignal;
+  /**
+   * **Android:** When true (default), the native layer posts a system notification with extraction
+   * progress. Set to false to disable (e.g. first-run bundled-model prep with in-app UI only).
+   * **iOS:** Accepted for API parity; no notification is shown.
+   */
+  showNotificationsEnabled?: boolean;
+  /** **Android:** Notification title. Default: generic “unpacking” title. Ignored on iOS. */
+  notificationTitle?: string;
+  /** **Android:** Notification body (progress text is appended). Default: generic. Ignored on iOS. */
+  notificationText?: string;
 };
+
+/** Subset of `ExtractArchiveOptions` passed through to path- and asset-stream extractors. */
+export type ExtractNotificationArgs = Pick<
+  ExtractArchiveOptions,
+  'showNotificationsEnabled' | 'notificationTitle' | 'notificationText'
+>;

package/src/stt/index.ts

@@ -67,10 +67,7 @@ export async function detectSttModel(
     options?.preferInt8,
     options?.modelType
   );
-  const err =
-    typeof (raw as { error?: unknown }).error === 'string'
-      ? String((raw as { error: string }).error).trim()
-      : '';
+  const err = typeof raw.error === 'string' ? raw.error.trim() : '';
   return {
     success: raw.success,
     ...(err.length > 0 ? { error: err } : {}),
@@ -170,10 +167,13 @@ export async function createSTT(
   );
 
   if (!result.success) {
+    const nativeError =
+      typeof result.error === 'string' ? result.error.trim() : '';
+    const detected = JSON.stringify(result.detectedModels ?? []);
     throw new Error(
-      `STT initialization failed: ${JSON.stringify(
-        result.detectedModels ?? []
-      )}`
+      nativeError.length > 0
+        ? `STT initialization failed: ${nativeError}`
+        : `STT initialization failed: ${detected}`
     );
   }
 
@@ -259,6 +259,7 @@ export type {
   STTInitializeOptions,
   STTModelType,
   SttModelOptions,
+  SttQwen3AsrModelOptions,
   SttRecognitionResult,
   SttRuntimeConfig,
   SttEngine,

package/src/stt/streaming.ts

@@ -231,7 +231,13 @@ export async function createStreamingSTT(
   );
 
   if (!result.success) {
-    throw new Error(`Streaming STT initialization failed for ${instanceId}`);
+    const nativeError =
+      typeof result.error === 'string' ? result.error.trim() : '';
+    throw new Error(
+      nativeError.length > 0
+        ? `Streaming STT initialization failed: ${nativeError}`
+        : `Streaming STT initialization failed for ${instanceId}`
+    );
   }
 
   const enableInputNormalization = options.enableInputNormalization !== false;

package/src/stt/types.ts

@@ -15,6 +15,7 @@ export type STTModelType =
   | 'ctc'
   | 'whisper'
   | 'funasr_nano'
+  | 'qwen3_asr'
   | 'fire_red_asr'
   | 'moonshine'
   | 'dolphin'
@@ -50,6 +51,7 @@ export const STT_MODEL_TYPES: readonly STTModelType[] = [
   'ctc',
   'whisper',
   'funasr_nano',
+  'qwen3_asr',
   'fire_red_asr',
   'moonshine',
   'dolphin',
@@ -124,6 +126,20 @@ export interface SttFunAsrNanoModelOptions {
   hotwords?: string;
 }
 
+/** Options for Qwen3 ASR models. Applied only when modelType is 'qwen3_asr'. */
+export interface SttQwen3AsrModelOptions {
+  /** Max total sequence length. Default: 512. */
+  maxTotalLen?: number;
+  /** Max new tokens to generate. Default: 128. */
+  maxNewTokens?: number;
+  /** Sampling temperature. Default: 1e-6. */
+  temperature?: number;
+  /** Top-p sampling. Default: 0.8. */
+  topP?: number;
+  /** Random seed. Default: 42. */
+  seed?: number;
+}
+
 /**
  * Model-specific STT options. Only the block for the actually loaded model type is applied;
  * others are ignored (e.g. whisper options have no effect when a paraformer model is loaded).
@@ -133,6 +149,7 @@ export interface SttModelOptions {
   senseVoice?: SttSenseVoiceModelOptions;
   canary?: SttCanaryModelOptions;
   funasrNano?: SttFunAsrNanoModelOptions;
+  qwen3Asr?: SttQwen3AsrModelOptions;
 }
 
 /**
@@ -162,6 +179,7 @@ export interface STTInitializeOptions {
    * - 'wenet_ctc': Force detection as WeNet CTC model
    * - 'sense_voice': Force detection as SenseVoice model
    * - 'funasr_nano': Force detection as FunASR Nano model
+   * - 'qwen3_asr': Force detection as Qwen3 ASR
    * - 'fire_red_asr': FireRed ASR (encoder/decoder)
    * - 'moonshine': Moonshine (preprocess, encode, uncached_decode, cached_decode)
    * - 'dolphin': Dolphin (single model)

package/src/tts/index.ts

@@ -112,10 +112,7 @@ export async function detectTtsModel(
 }> {
   const resolvedPath = await resolveModelPath(modelPath);
   const raw = await SherpaOnnx.detectTtsModel(resolvedPath, options?.modelType);
-  const err =
-    typeof (raw as { error?: unknown }).error === 'string'
-      ? String((raw as { error: string }).error).trim()
-      : '';
+  const err = typeof raw.error === 'string' ? raw.error.trim() : '';
   return {
     success: raw.success,
     ...(err.length > 0 ? { error: err } : {}),
@@ -243,10 +240,13 @@ export async function createTTS(
   );
 
   if (!result.success) {
+    const nativeError =
+      typeof result.error === 'string' ? result.error.trim() : '';
+    const detected = JSON.stringify(result.detectedModels ?? []);
     throw new Error(
-      `TTS initialization failed: ${JSON.stringify(
-        result.detectedModels ?? []
-      )}`
+      nativeError.length > 0
+        ? `TTS initialization failed: ${nativeError}`
+        : `TTS initialization failed: ${detected}`
     );
   }
 

package/src/tts/streaming.ts

@@ -192,10 +192,13 @@ export async function createStreamingTTS(
   );
 
   if (!result.success) {
+    const nativeError =
+      typeof result.error === 'string' ? result.error.trim() : '';
+    const detected = JSON.stringify(result.detectedModels ?? []);
     throw new Error(
-      `TTS initialization failed: ${JSON.stringify(
-        result.detectedModels ?? []
-      )}`
+      nativeError.length > 0
+        ? `Streaming TTS initialization failed: ${nativeError}`
+        : `Streaming TTS initialization failed: ${detected}`
     );
   }
 

package/third_party/sherpa-onnx-prebuilt/ANDROID_RELEASE_TAG

@@ -1 +1 @@
-sherpa-onnx-android-v1.12.31-1
+sherpa-onnx-android-v1.12.34-1

package/third_party/sherpa-onnx-prebuilt/IOS_RELEASE_TAG

@@ -1 +1 @@
-sherpa-onnx-ios-v1.12.31-1
+sherpa-onnx-ios-v1.12.34-1