react-native-sherpa-onnx 0.3.7 → 0.3.9

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

@@ -49,6 +49,8 @@ function flattenTtsModelOptionsForNative(
       ? modelOptions.kitten
       : modelType === 'pocket'
       ? modelOptions.pocket
+      : modelType === 'supertonic'
+      ? modelOptions.supertonic
       : undefined;
   if (!block)
     return {
@@ -110,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 } : {}),
@@ -241,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}`
     );
   }
 
@@ -446,6 +448,7 @@ export type {
   TtsKokoroModelOptions,
   TtsKittenModelOptions,
   TtsPocketModelOptions,
+  TtsSupertonicModelOptions,
   TtsUpdateOptions,
   TtsGenerationOptions,
   GeneratedAudio,

package/src/tts/streaming.ts

@@ -52,6 +52,8 @@ function flattenTtsModelOptionsForNative(
       ? modelOptions.kitten
       : modelType === 'pocket'
       ? modelOptions.pocket
+      : modelType === 'supertonic'
+      ? modelOptions.supertonic
       : undefined;
   if (!block)
     return {
@@ -190,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/src/tts/types.ts

@@ -9,6 +9,7 @@ import type { ModelPathConfig } from '../types';
  * - 'kitten': KittenTTS models (lightweight, multi-speaker)
  * - 'pocket': Pocket TTS models
  * - 'zipvoice': Zipvoice models (voice cloning capable)
+ * - 'supertonic': Supertonic models
  * - 'auto': Auto-detect model type based on files present (default)
  */
 export type TTSModelType =
@@ -18,6 +19,7 @@ export type TTSModelType =
   | 'kitten'
   | 'pocket'
   | 'zipvoice'
+  | 'supertonic'
   | 'auto';
 
 /** Runtime list of supported TTS model types. */
@@ -28,6 +30,7 @@ export const TTS_MODEL_TYPES: readonly TTSModelType[] = [
   'kitten',
   'pocket',
   'zipvoice',
+  'supertonic',
   'auto',
 ] as const;
 
@@ -68,6 +71,11 @@ export interface TtsPocketModelOptions {
   // No init-time options in Kotlin OfflineTtsPocketModelConfig; voice cloning is via GenerationConfig at generate time.
 }
 
+/** Options for Supertonic models. Applied only when modelType is 'supertonic'. */
+export interface TtsSupertonicModelOptions {
+  // No init-time model options exposed by sherpa-onnx currently.
+}
+
 /**
  * Model-specific TTS options. Only the block for the actually loaded model type is applied;
  * others are ignored (e.g. vits options have no effect when a kokoro model is loaded).
@@ -78,6 +86,7 @@ export interface TtsModelOptions {
   kokoro?: TtsKokoroModelOptions;
   kitten?: TtsKittenModelOptions;
   pocket?: TtsPocketModelOptions;
+  supertonic?: TtsSupertonicModelOptions;
 }
 
 /**

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

package/lib/module/download/background-downloader.d.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=background-downloader.d.js.map

package/lib/module/download/background-downloader.d.js.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["download/background-downloader.d.ts"],"mappings":"","ignoreList":[]}

package/src/download/background-downloader.d.ts

@@ -1,43 +0,0 @@
-/**
- * Type declarations for @kesha-antonov/react-native-background-downloader
- * when the package is not installed (e.g. SDK build). The real package provides full types.
- */
-declare module '@kesha-antonov/react-native-background-downloader' {
-  export interface DownloadTask {
-    id: string;
-    start(): void;
-    stop(): void;
-    pause(): Promise<void>;
-    resume(): Promise<void>;
-    begin(
-      cb: (data: {
-        expectedBytes?: number;
-        headers?: Record<string, string>;
-      }) => void
-    ): DownloadTask;
-    progress(
-      cb: (data: { bytesDownloaded: number; bytesTotal: number }) => void
-    ): DownloadTask;
-    done(
-      cb: (data: {
-        location?: string;
-        bytesDownloaded: number;
-        bytesTotal: number;
-      }) => void
-    ): DownloadTask;
-    error(
-      cb: (data: { error?: string; errorCode?: number }) => void
-    ): DownloadTask;
-  }
-
-  export function createDownloadTask(options: {
-    id: string;
-    url: string;
-    destination: string;
-    metadata?: Record<string, unknown>;
-  }): DownloadTask;
-
-  export function completeHandler(taskId: string): void;
-
-  export function getExistingDownloadTasks(): Promise<DownloadTask[]>;
-}