react-native-sherpa-onnx 0.3.7 → 0.3.9

package/scripts/ci/update_model_license_csv.sh

@@ -14,7 +14,7 @@
 # - Uses tree-cache (from asr/tts-models-structure.txt + new downloads) to see if a LICENSE-like
 #   path exists — no full extract unless we need file contents for detection.
 # - Downloads the .tar.bz2 only when a license-like path was found and license_type is still empty.
-# - Pipeline: try archive (if applicable) → HF/ModelScope fallbacks for eligible assets. If no license
+# - Pipeline: try archive (if applicable) --> HF/ModelScope fallbacks for eligible assets. If no license
 #   is found after all attempts, license_type is set to exhausted (default keyword; override with
 #   LICENSE_EXHAUSTED env). You can set exhausted manually after review.
 # - .onnx-only: exhausted (no archive to scan).
@@ -30,7 +30,7 @@
 #   asr-models-license-status.csv (default: same directory as --csv). Strip prefix
 #   sherpa-onnx-qnn-<soc>-binary-<n>-seconds- from the QNN asset name, then try a few derived filenames
 #   (exact, sherpa-onnx-…, and sherpa-onnx-<stem>.tar.bz2 when …-int8.tar.bz2). On match, copy the ASR row’s
-#   license fields (not asset_name) onto the QNN asset; on no match → exhausted like other dead ends.
+#   license fields (not asset_name) onto the QNN asset; on no match --> exhausted like other dead ends.
 # - Hugging Face: set HF_TOKEN or HUGGINGFACE_HUB_TOKEN (read token is enough for public repos). Anonymous
 #   requests from CI often get HTTP 401; without a token README/MODEL_CARD cannot be fetched.
 #
@@ -566,7 +566,7 @@ for asset_name in "${release_assets[@]}"; do
 
   if [[ "$asset_name" == *.onnx ]]; then
     set_exhausted "$asset_name"
-    echo "  $asset_name — .onnx bundle → license_type=$LICENSE_EXHAUSTED (no archive; skipped next run)"
+    echo "  $asset_name — .onnx bundle --> license_type=$LICENSE_EXHAUSTED (no archive; skipped next run)"
     continue
   fi
 
@@ -601,15 +601,15 @@ for asset_name in "${release_assets[@]}"; do
 
   if [[ ${#license_paths[@]} -eq 0 ]]; then
     if try_hf_model_card_fallback "$asset_name"; then
-      echo "  $asset_name — no license in tree → filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — no license in tree --> filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     if try_qnn_asr_license_fallback "$asset_name"; then
-      echo "  $asset_name — no license in tree + HF exhausted → QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — no license in tree + HF exhausted --> QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     set_exhausted "$asset_name"
-    echo "  $asset_name — no license in tree + fallbacks exhausted → license_type=$LICENSE_EXHAUSTED"
+    echo "  $asset_name — no license in tree + fallbacks exhausted --> license_type=$LICENSE_EXHAUSTED"
     continue
   fi
 
@@ -624,15 +624,15 @@ for asset_name in "${release_assets[@]}"; do
   if ! curl "${_curl_dl[@]}" -o "$archive_path" "$url"; then
     rm -rf "$td"
     if try_hf_model_card_fallback "$asset_name"; then
-      echo "  $asset_name — download failed → filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — download failed --> filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     if try_qnn_asr_license_fallback "$asset_name"; then
-      echo "  $asset_name — download failed + HF exhausted → QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — download failed + HF exhausted --> QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     set_exhausted "$asset_name"
-    echo "  $asset_name — download failed + fallbacks exhausted → license_type=$LICENSE_EXHAUSTED"
+    echo "  $asset_name — download failed + fallbacks exhausted --> license_type=$LICENSE_EXHAUSTED"
     continue
   fi
 
@@ -665,15 +665,15 @@ for asset_name in "${release_assets[@]}"; do
   if [[ -z "$extracted_text" ]]; then
     rm -rf "$td"
     if try_hf_model_card_fallback "$asset_name"; then
-      echo "  $asset_name — could not extract license file → filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — could not extract license file --> filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     if try_qnn_asr_license_fallback "$asset_name"; then
-      echo "  $asset_name — could not extract license + HF exhausted → QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — could not extract license + HF exhausted --> QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     set_exhausted "$asset_name"
-    echo "  $asset_name — could not extract license file + fallbacks exhausted → license_type=$LICENSE_EXHAUSTED"
+    echo "  $asset_name — could not extract license file + fallbacks exhausted --> license_type=$LICENSE_EXHAUSTED"
     continue
   fi
 
@@ -686,15 +686,15 @@ for asset_name in "${release_assets[@]}"; do
 
   if [[ "$l_res" == "unknown" ]]; then
     if try_hf_model_card_fallback "$asset_name"; then
-      echo "  $asset_name — archive license text unknown → filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — archive license text unknown --> filled from $(log_license_fallback_source "$asset_name") (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     if try_qnn_asr_license_fallback "$asset_name"; then
-      echo "  $asset_name — archive text unknown + HF exhausted → QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
+      echo "  $asset_name — archive text unknown + HF exhausted --> QNN mirror from asr row (${_QNN_ASR_MIRROR_MATCHED}) (license_type=${existing_license_type["$asset_name"]})"
       continue
     fi
     set_exhausted "$asset_name"
-    echo "  $asset_name — archive text unclassified + fallbacks exhausted → license_type=$LICENSE_EXHAUSTED"
+    echo "  $asset_name — archive text unclassified + fallbacks exhausted --> license_type=$LICENSE_EXHAUSTED"
     continue
   fi
 
@@ -761,5 +761,5 @@ if [[ -d "$REPO_ROOT/android" && -d "$REPO_ROOT/ios" && -f "$CSV_FILE" ]]; then
   if ! same_canonical_path "$CSV_FILE" "$_ios_target"; then
     cp "$CSV_FILE" "$_ios_target"
   fi
-  echo "Synced $_bn → android/src/main/assets/model_licenses/ and ios/Resources/model_licenses/"
+  echo "Synced $_bn --> android/src/main/assets/model_licenses/ and ios/Resources/model_licenses/"
 fi

package/src/NativeSherpaOnnx.ts

@@ -21,7 +21,7 @@ export interface Spec extends TurboModule {
    * @param instanceId - Unique ID for this engine instance (from createSTT)
    * @param modelDir - Absolute path to model directory
    * @param preferInt8 - Optional: true = prefer int8 models, false = prefer regular models, undefined = try int8 first (default)
-   * @param modelType - Optional: explicit model type ('transducer', 'nemo_transducer', 'paraformer', 'nemo_ctc', 'wenet_ctc', 'sense_voice', 'zipformer_ctc', 'whisper', 'funasr_nano', 'fire_red_asr', 'moonshine', 'moonshine_v2', 'dolphin', 'canary', 'omnilingual', 'medasr', 'telespeech_ctc', 'auto'), undefined = auto (default)
+   * @param modelType - Optional: explicit model type ('transducer', 'nemo_transducer', 'paraformer', 'nemo_ctc', 'wenet_ctc', 'sense_voice', 'zipformer_ctc', 'whisper', 'funasr_nano', 'qwen3_asr', 'fire_red_asr', 'moonshine', 'moonshine_v2', 'dolphin', 'canary', 'omnilingual', 'medasr', 'telespeech_ctc', 'auto'), undefined = auto (default)
    * @param debug - Optional: enable debug logging in native layer and sherpa-onnx (default: false)
    * @param hotwordsFile - Optional: path to hotwords file (OfflineRecognizerConfig)
    * @param hotwordsScore - Optional: hotwords score (default in Kotlin 1.5)
@@ -30,10 +30,10 @@ export interface Spec extends TurboModule {
    * @param ruleFsts - Optional: path(s) to rule FSTs for ITN (comma-separated)
    * @param ruleFars - Optional: path(s) to rule FARs for ITN (comma-separated)
    * @param dither - Optional: dither for feature extraction. **Android:** applied. **iOS:** ignored (native API does not expose it)
-   * @param modelOptions - Optional: model-specific options (whisper, senseVoice, canary, funasrNano). Only the block for the loaded model type is applied.
+   * @param modelOptions - Optional: model-specific options (whisper, senseVoice, canary, funasrNano, qwen3Asr). Only the block for the loaded model type is applied.
    * @param modelingUnit - Optional: 'cjkchar' | 'bpe' | 'cjkchar+bpe' for hotwords tokenization (OfflineModelConfig.modelingUnit)
    * @param bpeVocab - Optional: path to BPE vocab file (OfflineModelConfig.bpeVocab), used when modelingUnit is bpe or cjkchar+bpe
-   * @returns Object with success boolean and array of detected models (each with type and modelDir)
+   * @returns Object with success boolean, array of detected models (each with type and modelDir), and optional error when success is false.
    */
   initializeStt(
     instanceId: string,
@@ -53,6 +53,8 @@ export interface Spec extends TurboModule {
     bpeVocab?: string
   ): Promise<{
     success: boolean;
+    /** Present when success is false (native structured failure). */
+    error?: string;
     detectedModels: Array<{ type: string; modelDir: string }>;
     modelType?: string;
     decodingMethod?: string;
@@ -131,6 +133,7 @@ export interface Spec extends TurboModule {
    * @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).
    *   `options.dither`: **Android** only; **iOS** ignores it (native `FeatureConfig` has no dither field).
+   * @returns `{ success: true }` on success, or `{ success: false, error?: string }` on structured native failure.
    */
   initializeOnlineSttWithOptions(
     instanceId: string,
@@ -160,7 +163,7 @@ export interface Spec extends TurboModule {
       rule3MinTrailingSilence?: number;
       rule3MinUtteranceLength?: number;
     }
-  ): Promise<{ success: boolean }>;
+  ): Promise<{ success: boolean; error?: string }>;
 
   /** Create a new stream for the given OnlineRecognizer instance. */
   createSttStream(
@@ -238,7 +241,7 @@ export interface Spec extends TurboModule {
    * Initialize Text-to-Speech (TTS) with model directory.
    * @param instanceId - Unique ID for this engine instance (from createTTS)
    * @param modelDir - Absolute path to model directory
-   * @param modelType - Model type ('vits', 'matcha', 'kokoro', 'kitten', 'pocket', 'zipvoice', 'auto')
+   * @param modelType - Model type ('vits', 'matcha', 'kokoro', 'kitten', 'pocket', 'zipvoice', 'supertonic', 'auto')
    * @param numThreads - Number of threads for inference (default: 2)
    * @param debug - Enable debug logging (default: false)
    * @param noiseScale - Optional noise scale (VITS/Matcha)
@@ -249,7 +252,7 @@ export interface Spec extends TurboModule {
    * @param maxNumSentences - Optional max sentences per callback (default: 1)
    * @param silenceScale - Optional silence scale on config (default: 0.2)
    * @param provider - Optional execution provider (e.g. 'cpu', 'coreml', 'xnnpack'; default: 'cpu')
-   * @returns Object with success boolean and array of detected models (each with type and modelDir)
+   * @returns Object with success boolean, array of detected models (each with type and modelDir), sampleRate/numSpeakers on success, and optional error when success is false.
    */
   initializeTts(
     instanceId: string,
@@ -267,6 +270,8 @@ export interface Spec extends TurboModule {
     provider?: string
   ): Promise<{
     success: boolean;
+    /** Present when success is false (native structured failure). */
+    error?: string;
     detectedModels: Array<{ type: string; modelDir: string }>;
     sampleRate: number;
     numSpeakers: number;
@@ -299,7 +304,7 @@ export interface Spec extends TurboModule {
    * @param noiseScale - Optional noise scale override
    * @param noiseScaleW - Optional noise scale W override
    * @param lengthScale - Optional length scale override
-   * @returns Object with success boolean and array of detected models
+   * @returns Object with success, detectedModels, sampleRate, numSpeakers on success, and optional error when success is false.
    */
   updateTtsParams(
     instanceId: string,
@@ -308,6 +313,8 @@ export interface Spec extends TurboModule {
     lengthScale?: number | null
   ): Promise<{
     success: boolean;
+    /** Present when success is false (native structured failure). */
+    error?: string;
     detectedModels: Array<{ type: string; modelDir: string }>;
     sampleRate: number;
     numSpeakers: number;
@@ -550,11 +557,18 @@ export interface Spec extends TurboModule {
   /**
    * Extract a .tar.bz2 archive to a target folder.
    * Returns { success, path } or { success, reason }.
+   *
+   * **Android:** When `showNotificationsEnabled` is true (default), a system notification shows
+   * extraction progress. Optional `notificationTitle` / `notificationText` customize the copy.
+   * **iOS:** Notification parameters are accepted but have no effect (no extraction progress notification).
    */
   extractTarBz2(
     sourcePath: string,
     targetPath: string,
-    force: boolean
+    force: boolean,
+    showNotificationsEnabled?: boolean,
+    notificationTitle?: string,
+    notificationText?: string
   ): Promise<{
     success: boolean;
     path?: string;
@@ -570,11 +584,16 @@ export interface Spec extends TurboModule {
   /**
    * Extract a .tar.zst (or .zst) archive to a target folder.
    * Returns { success, path } or { success, reason }.
+   *
+   * **Android:** Same notification behavior as `extractTarBz2`. **iOS:** No effect.
    */
   extractTarZst(
     sourcePath: string,
     targetPath: string,
-    force: boolean
+    force: boolean,
+    showNotificationsEnabled?: boolean,
+    notificationTitle?: string,
+    notificationText?: string
   ): Promise<{
     success: boolean;
     path?: string;
@@ -601,11 +620,15 @@ export interface Spec extends TurboModule {
   /**
    * Extract a .tar.zst archive from Android assets (AssetManager) to a target folder. Android only.
    * Streams from asset; no copy of the archive to disk. Used when PAD pack is APK_ASSETS.
+   * Notification options match `extractTarZst` (Android only).
    */
   extractTarZstFromAsset(
     assetPath: string,
     targetPath: string,
-    force: boolean
+    force: boolean,
+    showNotificationsEnabled?: boolean,
+    notificationTitle?: string,
+    notificationText?: string
   ): Promise<{
     success: boolean;
     path?: string;
@@ -616,11 +639,15 @@ export interface Spec extends TurboModule {
   /**
    * Extract a .tar.bz2 archive from Android assets (AssetManager) to a target folder. Android only.
    * Streams from asset; no copy of the archive to disk. Used when PAD pack is APK_ASSETS.
+   * Notification options match `extractTarBz2` (Android only).
    */
   extractTarBz2FromAsset(
     assetPath: string,
     targetPath: string,
-    force: boolean
+    force: boolean,
+    showNotificationsEnabled?: boolean,
+    notificationTitle?: string,
+    notificationText?: string
   ): Promise<{
     success: boolean;
     path?: string;

package/src/download/ModelDownloadManager.ts

@@ -36,11 +36,13 @@ export {
   getDownloadStorageBase,
 } from './localModels';
 export {
+  configureModelDownloadBackgroundDownloader,
   downloadModelByCategory,
   getIncompleteDownloads,
   resumeDownload,
   deleteIncompleteDownload,
 } from './downloadTask';
+export type { BackgroundDownloaderSetConfigOptions } from './downloadTask';
 export {
   extractModelByCategory,
   getIncompleteExtractions,

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

@@ -0,0 +1,73 @@
+/**
+ * Compile-time shim for @kesha-antonov/react-native-background-downloader.
+ *
+ * The package currently ships TS sources without distributable .d.ts files.
+ * We route TS path resolution to this shim so the SDK can typecheck strictly
+ * without checking third-party TS internals.
+ */
+
+export interface BackgroundDownloaderNotificationTexts {
+  downloadTitle?: string;
+  downloadStarting?: string;
+  downloadProgress?: string;
+  downloadPaused?: string;
+  downloadFinished?: string;
+  groupTitle?: string;
+  groupText?: string | ((count: number) => string);
+}
+
+export type BackgroundDownloaderSetConfigOptions = {
+  showNotificationsEnabled?: boolean;
+  notificationsGrouping?: {
+    enabled?: boolean;
+    mode?: 'individual' | 'summaryOnly';
+    texts?: BackgroundDownloaderNotificationTexts;
+  };
+  headers?: Record<string, string>;
+  progressInterval?: number;
+  progressMinBytes?: number;
+  isLogsEnabled?: boolean;
+  maxParallelDownloads?: number;
+  allowsCellularAccess?: boolean;
+};
+
+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 declare function setConfig(
+  options: BackgroundDownloaderSetConfigOptions
+): void;
+
+export declare function createDownloadTask(options: {
+  id: string;
+  url: string;
+  destination: string;
+  metadata?: Record<string, unknown>;
+}): DownloadTask;
+
+export declare function completeHandler(taskId: string): void;
+export declare function getExistingDownloadTasks(): Promise<DownloadTask[]>;

package/src/download/downloadTask.ts

@@ -1,7 +1,10 @@
+import { Platform } from 'react-native';
+import type { BackgroundDownloaderSetConfigOptions } from './background-downloader-types';
 import {
   createDownloadTask,
   completeHandler,
   getExistingDownloadTasks,
+  setConfig,
 } from '@kesha-antonov/react-native-background-downloader';
 import {
   exists,
@@ -41,6 +44,68 @@ function makeDownloadTaskId(category: ModelCategory, id: string): string {
 
 const activeDownloadTasks = new Map<string, { stop: () => void }>();
 
+let androidDownloaderNotificationConfigApplied = false;
+let didWarnConfigFailure = false;
+
+function warnBackgroundDownloaderConfigFailure(
+  context: string,
+  error: unknown
+) {
+  if (didWarnConfigFailure) return;
+  didWarnConfigFailure = true;
+  const reason = error instanceof Error ? error.message : String(error);
+  console.warn(
+    `[Download] Background downloader config failed (${context}): ${reason}`
+  );
+}
+
+export type { BackgroundDownloaderSetConfigOptions };
+
+/**
+ * Apply your own `@kesha-antonov/react-native-background-downloader` `setConfig` **before** the first
+ * model download. When called, the SDK will **not** overwrite it with built-in defaults on first download.
+ *
+ * Safe to call at app startup (e.g. `App.tsx`). Other `setConfig` options (e.g. headers) are forwarded
+ * where the native module supports them on each platform.
+ */
+export function configureModelDownloadBackgroundDownloader(
+  options: BackgroundDownloaderSetConfigOptions
+): void {
+  try {
+    setConfig(options);
+    androidDownloaderNotificationConfigApplied = true;
+  } catch (error) {
+    // Keep fallback default config enabled if custom config fails.
+    warnBackgroundDownloaderConfigFailure('custom', error);
+  }
+}
+
+/**
+ * Library default is showNotificationsEnabled: false (silent empty FGS notification).
+ * Enable visible notifications unless the host app already called `configureModelDownloadBackgroundDownloader`.
+ */
+function ensureAndroidBackgroundDownloaderNotifications() {
+  if (androidDownloaderNotificationConfigApplied) return;
+  if (Platform.OS !== 'android') return;
+  try {
+    setConfig({
+      showNotificationsEnabled: true,
+      notificationsGrouping: {
+        enabled: false,
+        mode: 'individual',
+        texts: {
+          downloadTitle: 'Model download',
+          downloadStarting: 'Starting download…',
+          downloadProgress: 'Downloading… {progress}%',
+        },
+      },
+    });
+    androidDownloaderNotificationConfigApplied = true;
+  } catch (error) {
+    warnBackgroundDownloaderConfigFailure('default', error);
+  }
+}
+
 export async function downloadModelByCategory<T extends ModelMetaBase>(
   category: ModelCategory,
   id: string,
@@ -103,6 +168,8 @@ export async function downloadModelByCategory<T extends ModelMetaBase>(
     throw new Error(`Insufficient disk space: ${diskSpaceCheck.message}`);
   }
 
+  ensureAndroidBackgroundDownloaderNotifications();
+
   const statePath = getDownloadStatePath(category, id);
 
   if (opts?.overwrite) {
@@ -339,6 +406,7 @@ export async function resumeDownload<T extends ModelMetaBase>(
     deleteArchiveAfterExtract?: boolean;
   }
 ): Promise<DownloadResult> {
+  ensureAndroidBackgroundDownloaderNotifications();
   const taskId = makeDownloadTaskId(category, id);
   const existingTasks = await getExistingDownloadTasks();
   const existing = existingTasks.find((t) => t.id === taskId);

package/src/download/index.ts

@@ -30,8 +30,10 @@ export {
   ModelCategory,
   getProtectedModelKeysForBulkDelete,
   purgeDownloadedModelArtifacts,
+  configureModelDownloadBackgroundDownloader,
 } from './ModelDownloadManager';
 export type {
+  BackgroundDownloaderSetConfigOptions,
   ModelMetaBase,
   TtsModelMeta,
   TtsModelType,

package/src/download/postDownloadProcessing.ts

@@ -43,6 +43,15 @@ export type RunPostDownloadProcessingOptions = {
   onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
   deleteArchiveAfterExtract?: boolean;
   onProgress?: (progress: DownloadProgress) => void;
+  /**
+   * **Android:** Native extraction progress notification (default true), aligned with the download-manager flow.
+   * **iOS:** No effect.
+   */
+  showExtractionNotifications?: boolean;
+  /** **Android:** Optional notification title (default: SDK/native default title). */
+  extractionNotificationTitle?: string;
+  /** **Android:** Optional notification body prefix (progress percent is appended natively). */
+  extractionNotificationText?: string;
   /** Called to get current list of downloaded models for emitModelsListUpdated. */
   getDownloadedList: () => Promise<ModelMetaBase[]>;
 };
@@ -63,6 +72,9 @@ export async function runPostDownloadProcessing(
     deleteArchiveAfterExtract,
     onProgress,
     getDownloadedList,
+    showExtractionNotifications,
+    extractionNotificationTitle,
+    extractionNotificationText,
   } = options;
 
   registerActivePostProcess(category, id);
@@ -80,6 +92,9 @@ export async function runPostDownloadProcessing(
       deleteArchiveAfterExtract,
       onProgress,
       getDownloadedList,
+      showExtractionNotifications,
+      extractionNotificationTitle,
+      extractionNotificationText,
     });
   } finally {
     unregisterActivePostProcess(category, id);
@@ -102,6 +117,9 @@ async function runPostDownloadProcessingBody(
     deleteArchiveAfterExtract,
     onProgress,
     getDownloadedList,
+    showExtractionNotifications,
+    extractionNotificationTitle,
+    extractionNotificationText,
   } = options;
 
   const isAborted = () => Boolean(signal?.aborted);
@@ -164,7 +182,12 @@ async function runPostDownloadProcessingBody(
         onProgress?.(progress);
         emitDownloadProgress(category, id, progress);
       },
-      signal
+      signal,
+      {
+        showNotificationsEnabled: showExtractionNotifications !== false,
+        notificationTitle: extractionNotificationTitle,
+        notificationText: extractionNotificationText,
+      }
     );
   }
 

package/src/download/registry.ts

@@ -96,6 +96,7 @@ function deriveType(id: string): TtsModelType {
   if (lower.includes('kitten')) return 'kitten';
   if (lower.includes('pocket')) return 'pocket';
   if (lower.includes('zipvoice')) return 'zipvoice';
+  if (lower.includes('supertonic')) return 'supertonic';
   return 'unknown';
 }
 

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';