react-native-sherpa-onnx 0.3.5 → 0.3.7

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

@@ -0,0 +1,20 @@
+import { ModelCategory, type ModelMetaBase, type ChecksumIssue, type DownloadProgress, type DownloadResult, type DownloadState } from './types';
+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>;
+    deleteArchiveAfterExtract?: boolean;
+}): Promise<DownloadResult>;
+export declare function getIncompleteDownloads(category: ModelCategory): Promise<DownloadState[]>;
+export declare function resumeDownload<T extends ModelMetaBase>(category: ModelCategory, id: string, opts?: {
+    onProgress?: (progress: DownloadProgress) => void;
+    signal?: AbortSignal;
+    onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
+    deleteArchiveAfterExtract?: boolean;
+}): Promise<DownloadResult>;
+export declare function deleteIncompleteDownload(category: ModelCategory, id: string): Promise<void>;
+/** Task ids in the form `category:modelId` for downloads currently tracked in JS (before post-processing). */
+export declare function getActiveDownloadTaskKeys(): string[];
+//# sourceMappingURL=downloadTask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloadTask.d.ts","sourceRoot":"","sources":["../../../../src/download/downloadTask.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAsBjB,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,aAAa,EACnE,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACA,OAAO,CAAC,cAAc,CAAC,CAmNzB;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CA4D1B;AAED,wBAAsB,cAAc,CAAC,CAAC,SAAS,aAAa,EAC1D,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACA,OAAO,CAAC,cAAc,CAAC,CAwHzB;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,8GAA8G;AAC9G,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD"}

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

@@ -0,0 +1,26 @@
+import type { ModelCategory, ModelMetaBase, ChecksumIssue, DownloadProgress } from './types';
+import type { DownloadResult } from './types';
+export type EnsureModelOptions = {
+    /** Progress callback (percent, phase, speed, eta). */
+    onProgress?: (progress: DownloadProgress) => void;
+    /** AbortController signal to cancel download or extraction. */
+    signal?: AbortSignal;
+    /** If true, remove existing model and any incomplete state, then download/extract from scratch. */
+    overwrite?: boolean;
+    /** Called on checksum mismatch; return true to keep the file. */
+    onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
+    /** For archive models: if true (default), delete the archive after extraction to save space. */
+    deleteArchiveAfterExtract?: boolean;
+};
+/**
+ * Single entry point to ensure a model is available locally: handles download, extraction,
+ * and all edge cases (already ready, incomplete download, incomplete extraction, archive
+ * already present). Call this with category, id, and optional opts; the function decides
+ * whether to return the existing path, resume an interrupted operation, or start download/extraction.
+ *
+ * Use this as the main API when you only need "make this model ready"; the lower-level
+ * APIs (downloadModelByCategory, resumeDownload, extractModelByCategory, getIncompleteExtractions,
+ * etc.) remain available for advanced flows.
+ */
+export declare function ensureModelByCategory<T extends ModelMetaBase>(category: ModelCategory, id: string, opts?: EnsureModelOptions): Promise<DownloadResult>;
+//# sourceMappingURL=ensureModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensureModel.d.ts","sourceRoot":"","sources":["../../../../src/download/ensureModel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAkB9C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mGAAmG;IACnG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,gGAAgG;IAChG,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,aAAa,EACjE,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,cAAc,CAAC,CAuEzB"}

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

@@ -1,7 +1,9 @@
-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 { extractTarBz2 } from '../extraction/extractTarBz2';
+export type { ExtractProgressEvent } from '../extraction/extractTarBz2';
+export { extractTarZst } from '../extraction/extractTarZst';
+export type { ExtractProgressEvent as ExtractZstProgressEvent } from '../extraction/extractTarZst';
+export { listModelsByCategory, refreshModelsByCategory, getModelsCacheStatusByCategory, getModelByIdByCategory, listDownloadedModelsByCategory, isModelDownloadedByCategory, getLocalModelPathByCategory, downloadModelByCategory, deleteModelByCategory, clearModelCacheByCategory, getDownloadStorageBase, subscribeDownloadProgress, subscribeModelsListUpdated, updateModelLastUsed, listDownloadedModelsWithMetadata, cleanupLeastRecentlyUsed, getIncompleteDownloads, resumeDownload, deleteIncompleteDownload, extractModelByCategory, getIncompleteExtractions, resumeExtraction, deleteIncompleteExtraction, ensureModelByCategory, ModelCategory, getProtectedModelKeysForBulkDelete, purgeDownloadedModelArtifacts, } from './ModelDownloadManager';
+export type { ModelMetaBase, TtsModelMeta, TtsModelType, Quantization, SizeTier, DownloadProgress, DownloadProgressListener, ModelsListUpdatedListener, DownloadResult, DownloadState, ExtractionState, ModelWithMetadata, EnsureModelOptions, PurgeDownloadedModelArtifactsResult, } from './ModelDownloadManager';
+export { validateChecksum, validateExtractedFiles, checkDiskSpace, resolveActualModelDir, 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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/download/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACnG,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,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,kCAAkC,EAClC,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mCAAmC,GACpC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ModelCategory, ModelMetaBase, ModelWithMetadata } from './types';
+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 updateModelLastUsed(category: ModelCategory, id: string): Promise<void>;
+export declare function listDownloadedModelsWithMetadata<T extends ModelMetaBase>(category: ModelCategory): Promise<ModelWithMetadata<T>[]>;
+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>;
+//# sourceMappingURL=localModels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localModels.d.ts","sourceRoot":"","sources":["../../../../src/download/localModels.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAejB,wBAAsB,8BAA8B,CAAC,CAAC,SAAS,aAAa,EAC1E,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CAyBd;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,gCAAgC,CAAC,CAAC,SAAS,aAAa,EAC5E,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAqCjC;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,MAAM,EAAE,CAAC,CAkDnB;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAK9D"}

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

@@ -0,0 +1,36 @@
+import type { ModelCategory, ModelMetaBase, ChecksumIssue, DownloadProgress, ExtractionState } from './types';
+import type { DownloadResult } from './types';
+/**
+ * Start extraction for a model: archive must already exist (e.g. after download or from PAD).
+ * Writes extraction state so that if the app crashes, extraction can be resumed via
+ * getIncompleteExtractions + resumeExtraction.
+ * Use signal to abort (pause) extraction.
+ */
+export declare function extractModelByCategory<T extends ModelMetaBase>(category: ModelCategory, id: string, opts?: {
+    onProgress?: (progress: DownloadProgress) => void;
+    signal?: AbortSignal;
+    onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
+    deleteArchiveAfterExtract?: boolean;
+}): Promise<DownloadResult>;
+/**
+ * Returns models in the given category that have incomplete extractions (e.g. after app
+ * crash during extraction). Use with resumeExtraction to continue.
+ */
+export declare function getIncompleteExtractions(category: ModelCategory): Promise<ExtractionState[]>;
+/**
+ * Resume an incomplete extraction (e.g. after app restart). Use getIncompleteExtractions
+ * to discover items to resume. Runs extraction from the start (archive is overwritten into
+ * model dir with force).
+ */
+export declare function resumeExtraction<T extends ModelMetaBase>(category: ModelCategory, id: string, opts?: {
+    onProgress?: (progress: DownloadProgress) => void;
+    signal?: AbortSignal;
+    onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
+    deleteArchiveAfterExtract?: boolean;
+}): Promise<DownloadResult>;
+/**
+ * Cancel/delete an incomplete extraction: removes extraction state and partial model dir.
+ * Does not delete the archive so the user can retry extraction later.
+ */
+export declare function deleteIncompleteExtraction(category: ModelCategory, id: string): Promise<void>;
+//# sourceMappingURL=modelExtraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modelExtraction.d.ts","sourceRoot":"","sources":["../../../../src/download/modelExtraction.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAoB9C;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,aAAa,EAClE,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACA,OAAO,CAAC,cAAc,CAAC,CAkDzB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAoD5B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,aAAa,EAC5D,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACA,OAAO,CAAC,cAAc,CAAC,CA4CzB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAcf"}

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

@@ -0,0 +1,28 @@
+import { ModelCategory } from './types';
+import type { ModelArchiveExt } from './types';
+export declare const CATEGORY_CONFIG: Record<ModelCategory, {
+    tag: string;
+    cacheFile: string;
+    baseDir: string;
+}>;
+export declare function getCacheDir(): string;
+export declare function getCachePath(category: ModelCategory): string;
+export declare function getModelsBaseDir(category: ModelCategory): string;
+export declare function getModelDir(category: ModelCategory, modelId: string): string;
+export declare function getArchiveFilename(modelId: string, archiveExt: ModelArchiveExt): string;
+export declare function getArchivePath(category: ModelCategory, modelId: string, archiveExt: ModelArchiveExt): string;
+export declare function getTarArchivePath(category: ModelCategory, modelId: string): string;
+export declare function getOnnxPath(category: ModelCategory, modelId: string): string;
+export declare function getReadyMarkerPath(category: ModelCategory, modelId: string): string;
+export declare function getManifestPath(category: ModelCategory, modelId: string): string;
+export declare function getDownloadStatePath(category: ModelCategory, modelId: string): string;
+/** Path to extraction state file; used to detect and resume incomplete extractions after app restart. */
+export declare function getExtractionStatePath(category: ModelCategory, modelId: string): string;
+/**
+ * Directory where native `resolveAssetPath` materializes a bundled model folder
+ * (`DocumentDirectoryPath/models/{modelId}` — Android internal `files/models/...`).
+ * Separate from {@link getModelDir}. Remove on delete so empty dirs do not break detection.
+ */
+export declare function getNativeAssetExtractedModelDir(modelId: string): string;
+export declare function getReleaseUrl(category: ModelCategory): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/download/paths.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,aAAa,EACb;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqCpD,CAAC;AAEF,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,GAC1B,MAAM,CAER;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,GAC1B,MAAM,CAMR;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,yGAAyG;AACzG,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAE7D"}

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

@@ -0,0 +1,19 @@
+import type { ModelCategory, ModelMetaBase, ChecksumIssue, DownloadProgress } from './types';
+import type { DownloadResult } from './types';
+export type RunPostDownloadProcessingOptions = {
+    category: ModelCategory;
+    id: string;
+    model: ModelMetaBase;
+    downloadPath: string;
+    modelDir: string;
+    isArchive: boolean;
+    statePath: string;
+    signal?: AbortSignal;
+    onChecksumIssue?: (issue: ChecksumIssue) => Promise<boolean>;
+    deleteArchiveAfterExtract?: boolean;
+    onProgress?: (progress: DownloadProgress) => void;
+    /** Called to get current list of downloaded models for emitModelsListUpdated. */
+    getDownloadedList: () => Promise<ModelMetaBase[]>;
+};
+export declare function runPostDownloadProcessing(options: RunPostDownloadProcessingOptions): Promise<DownloadResult>;
+//# sourceMappingURL=postDownloadProcessing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postDownloadProcessing.d.ts","sourceRoot":"","sources":["../../../../src/download/postDownloadProcessing.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,aAAa,EACb,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAcjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,EAAE,aAAa,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACnD,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,cAAc,CAAC,CAmCzB"}

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

@@ -0,0 +1,6 @@
+/**
+ * Model keys (`category:modelId`) that must not be removed by bulk delete: active JS download tasks,
+ * native background-downloader tasks, and models in post-download processing (extraction / validation).
+ */
+export declare function getProtectedModelKeysForBulkDelete(): Promise<ReadonlySet<string>>;
+//# sourceMappingURL=protectedModelKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protectedModelKeys.d.ts","sourceRoot":"","sources":["../../../../src/download/protectedModelKeys.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,kCAAkC,IAAI,OAAO,CACjE,WAAW,CAAC,MAAM,CAAC,CACpB,CAmBA"}

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

@@ -0,0 +1,14 @@
+import { ModelCategory } from './types';
+import type { ModelMetaBase, CacheStatus } from './types';
+export declare function fetchChecksumsFromRelease(category: ModelCategory): Promise<Map<string, string>>;
+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 clearMemoryCacheForCategory(category: ModelCategory): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/download/registry.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EACV,aAAa,EAGb,WAAW,EAKZ,MAAM,SAAS,CAAC;AAyBjB,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgC9B;AA4ND,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAChE,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd;AAED,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,aAAa,EACnE,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,CAAC,EAAE,CAAC,CAsEd;AAED,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,CAMtB;AAED,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,aAAa,EAClE,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAGnB;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGzE"}

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

@@ -0,0 +1,15 @@
+/**
+ * Retry helper with exponential backoff
+ * @param fn - The async function to retry
+ * @param options - Retry configuration
+ * @returns The result of the function
+ * @throws The last error if all retries fail or AbortError if aborted
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffFactor?: number;
+    signal?: AbortSignal;
+}): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/download/retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACjB,GACL,OAAO,CAAC,CAAC,CAAC,CA2DZ"}

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

@@ -0,0 +1,96 @@
+import type { TTSModelType } from '../tts/types';
+export declare enum ModelCategory {
+    Tts = "tts",
+    Stt = "stt",
+    Vad = "vad",
+    Diarization = "diarization",
+    Enhancement = "enhancement",
+    Separation = "separation",
+    Qnn = "qnn"
+}
+/** 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';
+export 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 DownloadState = {
+    modelId: string;
+    category: ModelCategory;
+    phase: 'downloading' | 'extracting';
+    startedAt: string;
+    archivePath: string;
+    model: ModelMetaBase;
+    bytesDownloaded?: number;
+    totalBytes?: number;
+};
+/** State for an in-progress or interrupted model extraction (archive --> model dir). */
+export type ExtractionState = {
+    modelId: string;
+    category: ModelCategory;
+    phase: 'extracting';
+    startedAt: string;
+    archivePath: string;
+    modelDir: string;
+    model: ModelMetaBase;
+};
+export type DownloadProgressListener = (category: ModelCategory, modelId: string, progress: DownloadProgress) => void;
+export type ModelsListUpdatedListener = (category: ModelCategory, models: ModelMetaBase[]) => void;
+export type ModelManifest<T extends ModelMetaBase = ModelMetaBase> = {
+    downloadedAt: string;
+    lastUsed?: string;
+    model: T;
+    sizeOnDisk?: number;
+};
+export type ModelWithMetadata<T extends ModelMetaBase = ModelMetaBase> = {
+    model: T;
+    downloadedAt: string;
+    lastUsed: string | null;
+    sizeOnDisk?: number;
+    status: 'ready' | 'downloading' | 'extracting' | 'failed';
+    progress?: number;
+};
+export type ChecksumIssue = {
+    category: ModelCategory;
+    id: string;
+    archivePath: string;
+    expected?: string;
+    message: string;
+    reason: 'CHECKSUM_FAILED' | 'CHECKSUM_MISMATCH';
+};
+export type CachePayload<T extends ModelMetaBase> = {
+    lastUpdated: string;
+    models: T[];
+};
+export type CacheStatus = {
+    lastUpdated: string | null;
+    source: 'cache' | 'remote';
+};
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -5,6 +5,11 @@ export declare class ValidationResult {
     message?: string;
     constructor(success: boolean, error?: ValidationError, message?: string);
 }
+/**
+ * Delete a directory and all contents. No-op if the path is missing.
+ * Best-effort: continues on per-entry errors (permissions, race).
+ */
+export declare function removeDirectoryRecursive(dirPath: string): Promise<void>;
 /**
  * Parse checksum.txt format into a Map of filename -> hash
  * Expected format:
@@ -32,6 +37,20 @@ export declare function validateChecksum(filePath: string, expectedChecksum: str
  * so we don't need to check for specific filenames here.
  */
 export declare function validateExtractedFiles(modelDir: string, _category: string): Promise<ValidationResult>;
+/**
+ * Resolve the directory that actually contains model files.
+ * After extracting a tarball, model files often end up in a single top-level subdirectory
+ * (e.g. installDir/modelId/encoder.onnx). Native APIs expect the path to the folder
+ * that directly contains encoder.onnx, decoder.onnx, etc.
+ *
+ * - If installDir itself contains native model files (.onnx/.bin), returns installDir.
+ * - If installDir has exactly one subdirectory that contains native model files, returns that subdirectory path.
+ *   (Ignores our metadata: .ready, manifest.json.) This can produce paths like
+ *   .../tts/vits-piper-de_DE-thorsten-medium-int8/vits-piper-de_DE-thorsten-medium-int8 when the
+ *   archive extracts a top-level folder with the same name as the model id; that is intentional.
+ * - Otherwise returns installDir unchanged.
+ */
+export declare function resolveActualModelDir(installDir: string): Promise<string>;
 /**
  * Get available disk space (in bytes)
  * This is a simplified version. For accurate values on Android/iOS, use native modules.

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

@@ -1 +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"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/download/validation.ts"],"names":[],"mappings":"AAUA,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;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB7E;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,CAyF3B;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA6BjB;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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractTarBz2.d.ts","sourceRoot":"","sources":["../../../../src/extraction/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,CAyDxB"}

package/lib/typescript/src/extraction/extractTarZst.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 extractTarZst(sourcePath: string, targetPath: string, force?: boolean, onProgress?: (event: ExtractProgressEvent) => void, signal?: AbortSignal): Promise<ExtractResult>;
+export {};
+//# sourceMappingURL=extractTarZst.d.ts.map

package/lib/typescript/src/extraction/extractTarZst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTarZst.d.ts","sourceRoot":"","sources":["../../../../src/extraction/extractTarZst.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,CAwDxB"}

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

@@ -0,0 +1,50 @@
+/**
+ * Extraction subpath: list and extract compressed model archives (.tar.zst / .tar.bz2).
+ *
+ * Three entry points:
+ *  - getBundledArchives(packName)    – Android PAD packs (STORAGE_FILES or APK_ASSETS)
+ *  - listBundledArchives(dirPath)    – any filesystem directory (cross-platform)
+ *  - extractArchive(archive, target) – unified extraction (auto-selects path or asset-stream)
+ *
+ * After extraction, use listModelsAtPath / autoModelPath from the main package.
+ */
+import type { BundledArchive, ExtractArchiveOptions, ExtractResult } from './types';
+export type { BundledArchive, ExtractArchiveOptions, ExtractResult, ExtractProgressEvent, } from './types';
+/**
+ * List compressed archives delivered via a **Play Asset Delivery** pack.
+ *
+ * - **STORAGE_FILES** packs: scans the pack directory on the filesystem.
+ * - **APK_ASSETS** packs: queries the Android AssetManager for embedded archive paths.
+ *   Archives returned with `fromAsset: true` are extracted by streaming from the APK
+ *   (no temp copy needed).
+ * - **iOS / unavailable pack**: returns `null`.
+ *
+ * @param packName  Name of the PAD asset pack (e.g. `"sherpa_models"`)
+ */
+export declare function getBundledArchives(packName: string): Promise<BundledArchive[] | null>;
+/**
+ * List `.tar.zst` and `.tar.bz2` archives in a filesystem directory.
+ *
+ * Works on **all platforms** — use for:
+ * - iOS main-bundle archives (`MainBundlePath + '/models'`)
+ * - Archives downloaded to the documents directory
+ * - Any other folder containing compressed model archives
+ *
+ * @param directoryPath  Absolute path to the directory to scan
+ */
+export declare function listBundledArchives(directoryPath: string): Promise<BundledArchive[]>;
+/**
+ * Extract a single archive to the target directory.
+ *
+ * Handles both source types transparently:
+ * - **Filesystem archives** (from `listBundledArchives` or PAD STORAGE_FILES) —
+ *   uses the regular path-based extraction.
+ * - **APK asset archives** (`fromAsset: true`, from PAD APK_ASSETS) —
+ *   streams directly from the APK without copying the archive to disk first.
+ *
+ * @param archive    Descriptor returned by `getBundledArchives` or `listBundledArchives`
+ * @param targetPath Directory to extract into (e.g. `DocumentDirectoryPath + '/models'`)
+ * @param options    `force` (default `true`), `onProgress`, `signal` (AbortSignal)
+ */
+export declare function extractArchive(archive: BundledArchive, targetPath: string, options?: ExtractArchiveOptions): Promise<ExtractResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extraction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,aAAa,EAEd,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAyDjB;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAyBlC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAE3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAoCxB"}

package/lib/typescript/src/extraction/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Types for the extraction subpath.
+ *
+ * A BundledArchive describes a compressed model archive (.tar.zst or .tar.bz2)
+ * that can come from two distinct sources:
+ *
+ *  1. **Filesystem** — a regular file on disk (PAD STORAGE_FILES, iOS bundle,
+ *     downloaded archive, etc.). `fromAsset` is absent or `false`.
+ *  2. **Android APK asset** — embedded in the APK via PAD APK_ASSETS.
+ *     `fromAsset` is `true`; extraction streams directly from the APK.
+ *
+ * The consumer does not need to distinguish between the two:
+ * `extractArchive()` handles both transparently.
+ */
+/** Describes one compressed model archive. */
+export type BundledArchive = {
+    /** Identifier derived from the archive filename (filename minus the extension). */
+    modelId: string;
+    /**
+     * Path to the archive.
+     * - Filesystem archives: absolute path (e.g. `/data/.../models/whisper-tiny.tar.zst`).
+     * - APK assets: asset path (e.g. `asset_packs/sherpa_models/assets/whisper-tiny.tar.zst`).
+     */
+    archivePath: string;
+    /** Compression format. */
+    format: 'tar.zst' | 'tar.bz2';
+    /** File size in bytes (available for filesystem archives; 0 or absent for APK assets). */
+    fileSize?: number;
+    /** `true` when the archive lives inside the APK (APK_ASSETS). Absent for filesystem archives. */
+    fromAsset?: boolean;
+};
+/** Progress event emitted during extraction. */
+export type ExtractProgressEvent = {
+    /** Bytes extracted so far. */
+    bytes: number;
+    /** Total bytes of the archive (may be 0 when unknown). */
+    totalBytes: number;
+    /** Progress percentage 0–100. */
+    percent: number;
+};
+/** Result returned by `extractArchive`. */
+export type ExtractResult = {
+    success: boolean;
+    /** Absolute path to the extracted directory (on success). */
+    path?: string;
+    /** SHA-256 hex digest of the source archive (when available). */
+    sha256?: string;
+    /** Error description (on failure). */
+    reason?: string;
+};
+/** Options for `extractArchive`. */
+export type ExtractArchiveOptions = {
+    /** Overwrite existing files. Defaults to `true`. */
+    force?: boolean;
+    /** Callback for extraction progress. */
+    onProgress?: (event: ExtractProgressEvent) => void;
+    /** AbortSignal to cancel the extraction. */
+    signal?: AbortSignal;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/extraction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/extraction/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG;IAC3B,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,oBAAoB,GAAG;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,qBAAqB,GAAG;IAClC,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACnD,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC"}

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

@@ -3,6 +3,7 @@ export type { AccelerationSupport } from './NativeSherpaOnnx';
 export type { ModelPathConfig } from './types';
 export { assetModelPath, autoModelPath, fileModelPath, getAssetPackPath, getDefaultModelPath, getPlayAssetDeliveryModelsPath, listAssetModels, listModelsAtPath, resolveModelPath, } from './utils';
 export { copyFileToContentUri } from './tts';
+export { getModelLicenses, type ModelLicense } from './licenses';
 /**
  * Test method to verify sherpa-onnx native library is loaded.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAW7C;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAWjE;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

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

@@ -0,0 +1,10 @@
+export interface ModelLicense {
+    asset_name: string;
+    license_type: string;
+    commercial_use: 'yes' | 'no' | 'conditional' | 'restricted' | 'unknown';
+    confidence: string;
+    detection_source: string;
+    license_file: string;
+}
+export declare function getModelLicenses(): Promise<ModelLicense[]>;
+//# sourceMappingURL=licenses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"licenses.d.ts","sourceRoot":"","sources":["../../../src/licenses.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,KAAK,GAAG,IAAI,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAwChE"}

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

@@ -6,7 +6,7 @@ import type { ModelPathConfig } from '../types';
  *
  * @param modelPath - Model path configuration (asset, file, or auto)
  * @param options - Optional preferInt8 and modelType (default: auto)
- * @returns Object with success, detectedModels (array of { type, modelDir }), and modelType (primary detected type)
+ * @returns Object with success, detectedModels (array of { type, modelDir }), modelType (primary detected type), optional error when success is false, and optionally isHardwareSpecificUnsupported
  * @example
  * ```typescript
  * const path = { type: 'asset' as const, path: 'models/sherpa-onnx-whisper-tiny-en' };
@@ -21,11 +21,14 @@ export declare function detectSttModel(modelPath: ModelPathConfig, options?: {
     modelType?: STTModelType;
 }): Promise<{
     success: boolean;
+    /** Native validation/detect failure. */
+    error?: string;
     detectedModels: Array<{
         type: string;
         modelDir: string;
     }>;
     modelType?: string;
+    isHardwareSpecificUnsupported?: boolean;
 }>;
 /**
  * Create an STT engine instance. Call destroy() on the returned engine when done to free native resources.