react-native-sherpa-onnx 0.2.0 → 0.3.0

package/lib/typescript/src/NativeSherpaOnnx.d.ts

@@ -1,91 +1,170 @@
 import { type TurboModule } from 'react-native';
+/** Unified shape for all acceleration backends (QNN, NNAPI, XNNPACK, Core ML). */
+export type AccelerationSupport = {
+    providerCompiled: boolean;
+    hasAccelerator: boolean;
+    canInit: boolean;
+};
 export interface Spec extends TurboModule {
     /**
      * Test method to verify sherpa-onnx native library is loaded.
      */
     testSherpaInit(): Promise<string>;
     /**
-     * Resolve model path based on configuration.
-     * Handles asset paths, file system paths, and auto-detection.
-     * Returns an absolute path that can be used by native code.
-     *
-     * @param config - Object with 'type' ('asset' | 'file' | 'auto') and 'path' (string)
-     */
-    resolveModelPath(config: {
-        type: string;
-        path: string;
-    }): Promise<string>;
-    /**
-     * Initialize sherpa-onnx with model directory.
+     * Initialize Speech-to-Text (STT) with model directory.
      * Expects an absolute path (use resolveModelPath first for asset/file paths).
+     * @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', 'paraformer', 'nemo_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', 'fire_red_asr', 'moonshine', '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)
+     * @param numThreads - Optional: number of threads for inference (default in Kotlin: 1)
+     * @param provider - Optional: provider string e.g. 'cpu' (stored in config only)
+     * @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 (default 0)
+     * @param modelOptions - Optional: model-specific options (whisper, senseVoice, canary, funasrNano). 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)
      */
-    initializeSherpaOnnx(modelDir: string, preferInt8?: boolean, modelType?: string): Promise<{
+    initializeStt(instanceId: string, modelDir: string, preferInt8?: boolean, modelType?: string, debug?: boolean, hotwordsFile?: string, hotwordsScore?: number, numThreads?: number, provider?: string, ruleFsts?: string, ruleFars?: string, dither?: number, modelOptions?: Object, modelingUnit?: string, bpeVocab?: string): Promise<{
         success: boolean;
         detectedModels: Array<{
             type: string;
             modelDir: string;
         }>;
+        modelType?: string;
+        decodingMethod?: string;
     }>;
     /**
-     * Transcribe an audio file.
+     * Detect STT model type and structure without initializing the recognizer.
+     * Uses the same native file-based detection as initializeStt. Useful to show model-specific
+     * options before init or to query the type for a given path.
+     * @param modelDir - Absolute path to model directory (use resolveModelPath first for asset/file paths)
+     * @param preferInt8 - Optional: true = prefer int8, false = prefer regular, undefined = try int8 first
+     * @param modelType - Optional: explicit type or 'auto' (default)
+     * @returns Object with success, detectedModels (array of { type, modelDir }), and modelType (primary detected type)
      */
-    transcribeFile(filePath: string): Promise<string>;
+    detectSttModel(modelDir: string, preferInt8?: boolean, modelType?: string): Promise<{
+        success: boolean;
+        detectedModels: Array<{
+            type: string;
+            modelDir: string;
+        }>;
+        modelType?: string;
+    }>;
     /**
-     * Release sherpa-onnx resources.
+     * Transcribe an audio file. Returns full recognition result (text, tokens, timestamps, lang, emotion, event, durations).
      */
-    unloadSherpaOnnx(): Promise<void>;
+    transcribeFile(instanceId: string, filePath: string): Promise<{
+        text: string;
+        tokens: string[];
+        timestamps: number[];
+        lang: string;
+        emotion: string;
+        event: string;
+        durations: number[];
+    }>;
+    /**
+     * Transcribe from float PCM samples (e.g. from microphone). Same return type as transcribeFile.
+     */
+    transcribeSamples(instanceId: string, samples: number[], sampleRate: number): Promise<{
+        text: string;
+        tokens: string[];
+        timestamps: number[];
+        lang: string;
+        emotion: string;
+        event: string;
+        durations: number[];
+    }>;
+    /**
+     * Update recognizer config at runtime (decodingMethod, maxActivePaths, hotwordsFile, hotwordsScore, blankPenalty, ruleFsts, ruleFars).
+     */
+    setSttConfig(instanceId: string, options: Object): Promise<void>;
+    /**
+     * Release STT resources.
+     */
+    unloadStt(instanceId: string): Promise<void>;
     /**
      * 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', 'zipvoice', 'auto')
+     * @param modelType - Model type ('vits', 'matcha', 'kokoro', 'kitten', 'pocket', 'zipvoice', 'auto')
      * @param numThreads - Number of threads for inference (default: 2)
      * @param debug - Enable debug logging (default: false)
+     * @param noiseScale - Optional noise scale (VITS/Matcha)
+     * @param noiseScaleW - Optional noise scale W (VITS)
+     * @param lengthScale - Optional length scale (VITS/Matcha/Kokoro/Kitten)
+     * @param ruleFsts - Optional path(s) to rule FSTs for TTS (OfflineTtsConfig)
+     * @param ruleFars - Optional path(s) to rule FARs for TTS (OfflineTtsConfig)
+     * @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)
      */
-    initializeTts(modelDir: string, modelType: string, numThreads: number, debug: boolean, noiseScale?: number, noiseScaleW?: number, lengthScale?: number): Promise<{
+    initializeTts(instanceId: string, modelDir: string, modelType: string, numThreads: number, debug: boolean, noiseScale?: number, noiseScaleW?: number, lengthScale?: number, ruleFsts?: string, ruleFars?: string, maxNumSentences?: number, silenceScale?: number, provider?: string): Promise<{
         success: boolean;
         detectedModels: Array<{
             type: string;
             modelDir: string;
         }>;
+        sampleRate: number;
+        numSpeakers: number;
+    }>;
+    /**
+     * Detect TTS model type and structure without initializing the engine.
+     * Uses the same native file-based detection as initializeTts.
+     * @param modelDir - Absolute path to model directory (use resolveModelPath first for asset/file paths)
+     * @param modelType - Optional: explicit type or 'auto' (default)
+     * @returns Object with success, detectedModels (array of { type, modelDir }), and modelType (primary detected type)
+     */
+    detectTtsModel(modelDir: string, modelType?: string): Promise<{
+        success: boolean;
+        detectedModels: Array<{
+            type: string;
+            modelDir: string;
+        }>;
+        modelType?: string;
     }>;
     /**
      * Update TTS model parameters by re-initializing with stored config.
+     * @param instanceId - Unique ID for this engine instance
      * @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
      */
-    updateTtsParams(noiseScale?: number | null, noiseScaleW?: number | null, lengthScale?: number | null): Promise<{
+    updateTtsParams(instanceId: string, noiseScale?: number | null, noiseScaleW?: number | null, lengthScale?: number | null): Promise<{
         success: boolean;
         detectedModels: Array<{
             type: string;
             modelDir: string;
         }>;
+        sampleRate: number;
+        numSpeakers: number;
     }>;
     /**
      * Generate speech from text.
+     * @param instanceId - Unique ID for this engine instance
      * @param text - Text to convert to speech
-     * @param sid - Speaker ID for multi-speaker models (default: 0)
-     * @param speed - Speech speed multiplier (default: 1.0)
+     * @param options - Generation options (sid, speed, referenceAudio, referenceText, numSteps, silenceScale, extra)
      * @returns Object with { samples: number[], sampleRate: number }
      */
-    generateTts(text: string, sid: number, speed: number): Promise<{
+    generateTts(instanceId: string, text: string, options: Object): Promise<{
         samples: number[];
         sampleRate: number;
     }>;
     /**
      * Generate speech with subtitle/timestamp metadata.
+     * @param instanceId - Unique ID for this engine instance
      * @param text - Text to convert to speech
-     * @param sid - Speaker ID for multi-speaker models (default: 0)
-     * @param speed - Speech speed multiplier (default: 1.0)
+     * @param options - Generation options (sid, speed, referenceAudio, referenceText, numSteps, silenceScale, extra)
      * @returns Object with samples, sampleRate, subtitles, and estimated flag
      */
-    generateTtsWithTimestamps(text: string, sid: number, speed: number): Promise<{
+    generateTtsWithTimestamps(instanceId: string, text: string, options: Object): Promise<{
         samples: number[];
         sampleRate: number;
         subtitles: Array<{
@@ -97,44 +176,51 @@ export interface Spec extends TurboModule {
     }>;
     /**
      * Generate speech in streaming mode (emits chunk events).
+     * @param instanceId - Unique ID for this engine instance
      * @param text - Text to convert to speech
-     * @param sid - Speaker ID for multi-speaker models (default: 0)
-     * @param speed - Speech speed multiplier (default: 1.0)
+     * @param options - Generation options (sid, speed, referenceAudio, referenceText, numSteps, silenceScale, extra)
      */
-    generateTtsStream(text: string, sid: number, speed: number): Promise<void>;
+    generateTtsStream(instanceId: string, text: string, options: Object): Promise<void>;
     /**
      * Cancel an ongoing streaming TTS generation.
+     * @param instanceId - Unique ID for this engine instance
      */
-    cancelTtsStream(): Promise<void>;
+    cancelTtsStream(instanceId: string): Promise<void>;
     /**
      * Start PCM playback for streaming TTS.
+     * @param instanceId - Unique ID for this engine instance
      * @param sampleRate - Sample rate in Hz
      * @param channels - Number of channels (1 = mono)
      */
-    startTtsPcmPlayer(sampleRate: number, channels: number): Promise<void>;
+    startTtsPcmPlayer(instanceId: string, sampleRate: number, channels: number): Promise<void>;
     /**
      * Write PCM samples to the streaming TTS player.
+     * @param instanceId - Unique ID for this engine instance
      * @param samples - Float PCM samples in range [-1.0, 1.0]
      */
-    writeTtsPcmChunk(samples: number[]): Promise<void>;
+    writeTtsPcmChunk(instanceId: string, samples: number[]): Promise<void>;
     /**
      * Stop PCM playback for streaming TTS.
+     * @param instanceId - Unique ID for this engine instance
      */
-    stopTtsPcmPlayer(): Promise<void>;
+    stopTtsPcmPlayer(instanceId: string): Promise<void>;
     /**
      * Get the sample rate of the initialized TTS model.
+     * @param instanceId - Unique ID for this engine instance
      * @returns Sample rate in Hz
      */
-    getTtsSampleRate(): Promise<number>;
+    getTtsSampleRate(instanceId: string): Promise<number>;
     /**
      * Get the number of speakers/voices available in the model.
+     * @param instanceId - Unique ID for this engine instance
      * @returns Number of speakers (0 or 1 for single-speaker models)
      */
-    getTtsNumSpeakers(): Promise<number>;
+    getTtsNumSpeakers(instanceId: string): Promise<number>;
     /**
      * Release TTS resources.
+     * @param instanceId - Unique ID for this engine instance
      */
-    unloadTts(): Promise<void>;
+    unloadTts(instanceId: string): Promise<void>;
     /**
      * Save TTS audio samples to a WAV file.
      * @param samples - Audio samples array
@@ -174,6 +260,17 @@ export interface Spec extends TurboModule {
      * @param mimeType - MIME type (e.g., audio/wav)
      */
     shareTtsAudio(fileUri: string, mimeType: string): Promise<void>;
+    /**
+     * Resolve model path based on configuration.
+     * Handles asset paths, file system paths, and auto-detection.
+     * Returns an absolute path that can be used by native code.
+     *
+     * @param config - Object with 'type' ('asset' | 'file' | 'auto') and 'path' (string)
+     */
+    resolveModelPath(config: {
+        type: string;
+        path: string;
+    }): Promise<string>;
     /**
      * List all model folders in the assets/models directory.
      * Scans the platform-specific model directory and returns folder names.
@@ -188,7 +285,7 @@ export interface Spec extends TurboModule {
      * // Then use with resolveModelPath and initialize:
      * for (const model of folders) {
      *   const path = await resolveModelPath({ type: 'asset', path: `models/${model.folder}` });
-     *   const result = await initializeSherpaOnnx(path);
+     *   const result = await initializeStt(path);
      *   if (result.success) {
      *     console.log(`Found models in ${model.folder}:`, result.detectedModels);
      *   }
@@ -199,6 +296,63 @@ export interface Spec extends TurboModule {
         folder: string;
         hint: 'stt' | 'tts' | 'unknown';
     }>>;
+    /**
+     * List model folders under a specific filesystem path.
+     * When recursive is true, returns relative folder paths under the base path.
+     */
+    listModelsAtPath(path: string, recursive: boolean): Promise<Array<{
+        folder: string;
+        hint: 'stt' | 'tts' | 'unknown';
+    }>>;
+    /**
+     * **Play Asset Delivery (PAD):** Returns the filesystem path to the models directory
+     * of an Android asset pack, or null if the pack is not available (e.g. not installed).
+     * Use this to list and load models that are delivered via PAD instead of bundled app assets.
+     */
+    getAssetPackPath(packName: string): Promise<string | null>;
+    /**
+     * Extract a .tar.bz2 archive to a target folder.
+     * Returns { success, path } or { success, reason }.
+     */
+    extractTarBz2(sourcePath: string, targetPath: string, force: boolean): Promise<{
+        success: boolean;
+        path?: string;
+        sha256?: string;
+        reason?: string;
+    }>;
+    /**
+     * Cancel any in-progress tar.bz2 extraction.
+     */
+    cancelExtractTarBz2(): Promise<void>;
+    /**
+     * Compute SHA-256 of a file and return the hex digest.
+     */
+    computeFileSha256(filePath: string): Promise<string>;
+    /**
+     * Convert arbitrary audio file to requested format (e.g. "mp3", "flac", "wav").
+     * Requires FFmpeg prebuilts when called on Android.
+     * For MP3 (libshine), outputSampleRateHz can be 32000, 44100, or 48000; 0 or omitted = 44100.
+     * WAV output is always 16 kHz mono (sherpa-onnx). Resolves when conversion succeeds, rejects with an error message on failure.
+     */
+    convertAudioToFormat(inputPath: string, outputPath: string, format: string, outputSampleRateHz?: number): Promise<void>;
+    /**
+     * Convert any supported audio file to WAV 16 kHz mono 16-bit PCM.
+     * Requires FFmpeg prebuilts when called on Android.
+     */
+    convertAudioToWav16k(inputPath: string, outputPath: string): Promise<void>;
+    /**
+     * Return the list of available ONNX Runtime execution providers (e.g. "CPU", "NNAPI", "QNN", "XNNPACK").
+     * Requires the ORT Java bridge (libonnxruntime4j_jni.so + OrtEnvironment class) from the onnxruntime AAR.
+     */
+    getAvailableProviders(): Promise<string[]>;
+    /**
+     * Unified acceleration support: providerCompiled (ORT EP built in), hasAccelerator (NPU/ANE present), canInit (session with EP works).
+     * All get*Support methods return this shape. Optional modelBase64: if omitted, SDK uses embedded test model for canInit.
+     */
+    getQnnSupport(modelBase64?: string): Promise<AccelerationSupport>;
+    getNnapiSupport(modelBase64?: string): Promise<AccelerationSupport>;
+    getXnnpackSupport(modelBase64?: string): Promise<AccelerationSupport>;
+    getCoreMlSupport(modelBase64?: string): Promise<AccelerationSupport>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativeSherpaOnnx.d.ts.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Convert any supported audio file to a requested format (e.g. "mp3", "flac", "wav").
+ * On Android this requires FFmpeg prebuilts. WAV output is always 16 kHz mono (sherpa-onnx).
+ * For MP3, optional outputSampleRateHz: 32000, 44100, or 48000; 0/undefined = 44100.
+ * Resolves on success, rejects with an error message on failure.
+ */
+export declare function convertAudioToFormat(inputPath: string, outputPath: string, format: string, outputSampleRateHz?: number): Promise<void>;
+/**
+ * Convert any supported audio file to WAV 16 kHz mono 16-bit PCM.
+ * On Android this requires FFmpeg prebuilts. Resolves on success, rejects with an error message on failure.
+ */
+export declare function convertAudioToWav16k(inputPath: string, outputPath: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/audio/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf"}

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

@@ -10,15 +10,16 @@
  * // Future usage:
  * import { initializeDiarization, diarizeAudio } from 'react-native-sherpa-onnx/diarization';
  *
- * await initializeDiarization({ modelPath: 'models/diarization-model' });
+ * await initializeDiarization({ modelPath: { type: 'auto', path: 'models/diarization-model' } });
  * const segments = await diarizeAudio('path/to/audio.wav');
  * ```
  */
+import type { ModelPathConfig } from '../types';
 /**
  * Diarization initialization options (placeholder)
  */
 export interface DiarizationInitializeOptions {
-    modelPath: string;
+    modelPath: ModelPathConfig;
 }
 /**
  * Speaker segment with speaker ID

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/diarization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;CAEnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CAEb;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,4BAA4B,GACrC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/diarization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,eAAe,CAAC;CAE5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CAEb;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,4BAA4B,GACrC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}

package/lib/typescript/src/download/ModelDownloadManager.d.ts

@@ -0,0 +1,108 @@
+import type { TTSModelType } from '../tts/types';
+export declare enum ModelCategory {
+    Tts = "tts",
+    Stt = "stt",
+    Vad = "vad",
+    Diarization = "diarization",
+    Enhancement = "enhancement",
+    Separation = "separation"
+}
+/** TTS model type for meta; 'unknown' when id could not be classified. */
+export type TtsModelType = TTSModelType | 'unknown';
+export type Quantization = 'fp16' | 'int8' | 'int8-quantized' | 'unknown';
+export type SizeTier = 'tiny' | 'small' | 'medium' | 'large' | 'unknown';
+type ModelArchiveExt = 'tar.bz2' | 'onnx';
+export type ModelMetaBase = {
+    id: string;
+    displayName: string;
+    downloadUrl: string;
+    archiveExt: ModelArchiveExt;
+    bytes: number;
+    sha256?: string;
+    category: ModelCategory;
+};
+export type TtsModelMeta = ModelMetaBase & {
+    type: TtsModelType;
+    languages: string[];
+    quantization: Quantization;
+    sizeTier: SizeTier;
+    category: ModelCategory.Tts;
+};
+export type DownloadProgress = {
+    bytesDownloaded: number;
+    totalBytes: number;
+    percent: number;
+    phase?: 'downloading' | 'extracting';
+    speed?: number;
+    eta?: number;
+};
+export type DownloadResult = {
+    modelId: string;
+    localPath: string;
+};
+export type DownloadProgressListener = (category: ModelCategory, modelId: string, progress: DownloadProgress) => void;
+export type ModelsListUpdatedListener = (category: ModelCategory, models: ModelMetaBase[]) => void;
+export type ModelWithMetadata<T extends ModelMetaBase = ModelMetaBase> = {
+    model: T;
+    downloadedAt: string;
+    lastUsed: string | null;
+    sizeOnDisk?: number;
+};
+type ChecksumIssue = {
+    category: ModelCategory;
+    id: string;
+    archivePath: string;
+    expected?: string;
+    message: string;
+    reason: 'CHECKSUM_FAILED' | 'CHECKSUM_MISMATCH';
+};
+type CacheStatus = {
+    lastUpdated: string | null;
+    source: 'cache' | 'remote';
+};
+export declare const subscribeDownloadProgress: (listener: DownloadProgressListener) => (() => void);
+export declare const subscribeModelsListUpdated: (listener: ModelsListUpdatedListener) => (() => void);
+export declare function listModelsByCategory<T extends ModelMetaBase>(category: ModelCategory): Promise<T[]>;
+export declare function refreshModelsByCategory<T extends ModelMetaBase>(category: ModelCategory, options?: {
+    forceRefresh?: boolean;
+    cacheTtlMinutes?: number;
+    maxRetries?: number;
+    signal?: AbortSignal;
+}): Promise<T[]>;
+export declare function getModelsCacheStatusByCategory(category: ModelCategory): Promise<CacheStatus>;
+export declare function getModelByIdByCategory<T extends ModelMetaBase>(category: ModelCategory, id: string): Promise<T | null>;
+export declare function listDownloadedModelsByCategory<T extends ModelMetaBase>(category: ModelCategory): Promise<T[]>;
+export declare function isModelDownloadedByCategory(category: ModelCategory, id: string): Promise<boolean>;
+export declare function getLocalModelPathByCategory(category: ModelCategory, id: string): Promise<string | null>;
+export declare function downloadModelByCategory<T extends ModelMetaBase>(category: ModelCategory, id: string, opts?: {
+    onProgress?: (progress: DownloadProgress) => void;
+    overwrite?: boolean;
+    signal?: AbortSignal;
+    maxRetries?: number;
+    onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
+}): Promise<DownloadResult>;
+/**
+ * Update the lastUsed timestamp for a downloaded model
+ */
+export declare function updateModelLastUsed(category: ModelCategory, id: string): Promise<void>;
+/**
+ * Get all downloaded models with LRU metadata
+ */
+export declare function listDownloadedModelsWithMetadata<T extends ModelMetaBase>(category: ModelCategory): Promise<ModelWithMetadata<T>[]>;
+/**
+ * Remove least recently used models to free up disk space
+ * @param category - Model category
+ * @param targetBytes - Target amount of bytes to free (optional)
+ * @param maxModelsToDelete - Maximum number of models to delete (default: no limit)
+ * @returns Array of deleted model IDs
+ */
+export declare function cleanupLeastRecentlyUsed(category: ModelCategory, options?: {
+    targetBytes?: number;
+    maxModelsToDelete?: number;
+    keepCount?: number;
+}): Promise<string[]>;
+export declare function deleteModelByCategory(category: ModelCategory, id: string): Promise<void>;
+export declare function clearModelCacheByCategory(category: ModelCategory): Promise<void>;
+export declare function getDownloadStorageBase(): Promise<string>;
+export {};
+//# sourceMappingURL=ModelDownloadManager.d.ts.map

package/lib/typescript/src/download/ModelDownloadManager.d.ts.map

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

package/lib/typescript/src/download/extractTarBz2.d.ts

@@ -0,0 +1,14 @@
+export type ExtractProgressEvent = {
+    bytes: number;
+    totalBytes: number;
+    percent: number;
+};
+type ExtractResult = {
+    success: boolean;
+    path?: string;
+    sha256?: string;
+    reason?: string;
+};
+export declare function extractTarBz2(sourcePath: string, targetPath: string, force?: boolean, onProgress?: (event: ExtractProgressEvent) => void, signal?: AbortSignal): Promise<ExtractResult>;
+export {};
+//# sourceMappingURL=extractTarBz2.d.ts.map

package/lib/typescript/src/download/extractTarBz2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTarBz2.d.ts","sourceRoot":"","sources":["../../../../src/download/extractTarBz2.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,UAAO,EACZ,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAClD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAuDxB"}

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

@@ -0,0 +1,7 @@
+export { extractTarBz2 } from './extractTarBz2';
+export type { ExtractProgressEvent } from './extractTarBz2';
+export { listModelsByCategory, refreshModelsByCategory, getModelsCacheStatusByCategory, getModelByIdByCategory, listDownloadedModelsByCategory, isModelDownloadedByCategory, getLocalModelPathByCategory, downloadModelByCategory, deleteModelByCategory, clearModelCacheByCategory, getDownloadStorageBase, subscribeDownloadProgress, subscribeModelsListUpdated, updateModelLastUsed, listDownloadedModelsWithMetadata, cleanupLeastRecentlyUsed, ModelCategory, } from './ModelDownloadManager';
+export type { ModelMetaBase, TtsModelMeta, TtsModelType, Quantization, SizeTier, DownloadProgress, DownloadProgressListener, ModelsListUpdatedListener, DownloadResult, ModelWithMetadata, } from './ModelDownloadManager';
+export { validateChecksum, validateExtractedFiles, checkDiskSpace, setExpectedFilesForCategory, getExpectedFilesForCategory, parseChecksumFile, calculateFileChecksum, } from './validation';
+export type { ValidationError } from './validation';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/download/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,EAC9B,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,gCAAgC,EAChC,wBAAwB,EACxB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/lib/typescript/src/download/validation.d.ts

@@ -0,0 +1,57 @@
+export type ValidationError = 'CHECKSUM_MISMATCH' | 'CHECKSUM_FAILED' | 'MISSING_FILES' | 'INSUFFICIENT_DISK_SPACE';
+export declare class ValidationResult {
+    success: boolean;
+    error?: ValidationError;
+    message?: string;
+    constructor(success: boolean, error?: ValidationError, message?: string);
+}
+/**
+ * Parse checksum.txt format into a Map of filename -> hash
+ * Expected format:
+ * filename\tsha256hash
+ * example:
+ * vits-vctk.tar.bz2	4f0a02db66914b3760b144cebc004e65dd4d1aeef43379f2b058849e74002490
+ */
+export declare function parseChecksumFile(content: string): Map<string, string>;
+/**
+ * Calculate SHA256 hash of a file in chunks to avoid OOM
+ * Reads file in 1MB chunks and processes them efficiently
+ */
+export declare function calculateFileChecksum(filePath: string, onProgress?: (bytesProcessed: number, totalBytes: number, percent: number) => void): Promise<string>;
+/**
+ * Validate checksum of downloaded file
+ */
+export declare function validateChecksum(filePath: string, expectedChecksum: string, onProgress?: (bytesProcessed: number, totalBytes: number, percent: number) => void): Promise<ValidationResult>;
+/**
+ * Validate that extraction was successful by checking:
+ * - Directory exists and is not empty
+ * - Contains at least some files (not just directories)
+ *
+ * The actual model validation (correct files for specific model type)
+ * is delegated to the native DetectSttModel / DetectTtsModel functions,
+ * so we don't need to check for specific filenames here.
+ */
+export declare function validateExtractedFiles(modelDir: string, _category: string): Promise<ValidationResult>;
+/**
+ * Get available disk space (in bytes)
+ * This is a simplified version. For accurate values on Android/iOS, use native modules.
+ */
+export declare function getAvailableDiskSpace(): Promise<number>;
+/**
+ * Check if there's enough disk space for download
+ * Adds 20% buffer to the required size
+ */
+export declare function checkDiskSpace(requiredBytes: number): Promise<ValidationResult>;
+/**
+ * Update expected files configuration for a category
+ * DEPRECATED: The native DetectSttModel/DetectTtsModel functions handle model validation.
+ * This function is kept for backward compatibility but does nothing.
+ */
+export declare function setExpectedFilesForCategory(_category: string, _files: string[]): void;
+/**
+ * Get expected files for a category
+ * DEPRECATED: The native DetectSttModel/DetectTtsModel functions handle model validation.
+ * This function is kept for backward compatibility.
+ */
+export declare function getExpectedFilesForCategory(_category: string): string[];
+//# sourceMappingURL=validation.d.ts.map

package/lib/typescript/src/download/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/download/validation.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,yBAAyB,CAAC;AAE9B,qBAAa,gBAAgB;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEL,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM;CAKxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYtE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CACX,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,KACZ,IAAI,GACR,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,UAAU,CAAC,EAAE,CACX,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,KACZ,IAAI,GACR,OAAO,CAAC,gBAAgB,CAAC,CAmB3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAsF3B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAe7D;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAwB3B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvE"}