react-native-sherpa-onnx 0.3.2 → 0.3.4

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', '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', '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)
@@ -65,7 +65,7 @@ export interface Spec extends TurboModule {
    * @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)
+   * @returns Object with success, detectedModels (array of { type, modelDir }), modelType (primary detected type), and optionally isHardwareSpecificUnsupported (true when the model is for unsupported hardware e.g. RK35xx, Ascend)
    */
   detectSttModel(
     modelDir: string,
@@ -73,6 +73,8 @@ export interface Spec extends TurboModule {
     modelType?: string
   ): Promise<{
     success: boolean;
+    /** True when detection failed because the model targets unsupported hardware (RK35xx, Ascend, CANN). Use to show a specific message or block init. */
+    isHardwareSpecificUnsupported?: boolean;
     detectedModels: Array<{ type: string; modelDir: string }>;
     modelType?: string;
   }>;
@@ -211,6 +213,20 @@ export interface Spec extends TurboModule {
     isEndpoint: boolean;
   }>;
 
+  /**
+   * Start native PCM live capture. Microphone audio is captured and resampled to the requested
+   * sampleRate; chunks are emitted via the "pcmLiveStreamData" event (base64 Int16 PCM).
+   * App must have RECORD_AUDIO (Android) and NSMicrophoneUsageDescription (iOS) and grant permission before calling.
+   */
+  startPcmLiveStream(options: {
+    sampleRate: number;
+    channelCount?: number;
+    bufferSizeFrames?: number;
+  }): Promise<void>;
+
+  /** Stop native PCM live capture. */
+  stopPcmLiveStream(): Promise<void>;
+
   // ==================== TTS Methods ====================
 
   /**
@@ -254,9 +270,10 @@ export interface Spec extends TurboModule {
   /**
    * Detect TTS model type and structure without initializing the engine.
    * Uses the same native file-based detection as initializeTts.
+   * For Kokoro/Kitten multi-language models, also returns lexiconLanguageCandidates (e.g. ["default"], ["us-en", "gb-en", "zh"]) from detected lexicon.txt / lexicon-*.txt files.
    * @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)
+   * @returns Object with success, detectedModels (array of { type, modelDir }), modelType (primary detected type), and optionally lexiconLanguageCandidates (language ids for multi-lang Kokoro/Kitten)
    */
   detectTtsModel(
     modelDir: string,
@@ -265,6 +282,8 @@ export interface Spec extends TurboModule {
     success: boolean;
     detectedModels: Array<{ type: string; modelDir: string }>;
     modelType?: string;
+    /** Language ids from detected lexicon files (e.g. "default" for lexicon.txt, "us-en", "zh" from lexicon-us-en.txt, lexicon-zh.txt). Present for Kokoro/Kitten when multiple or single lexicon files are found; use for language selection UI. */
+    lexiconLanguageCandidates?: string[];
   }>;
 
   /**
@@ -431,6 +450,19 @@ export interface Spec extends TurboModule {
     mimeType: string
   ): Promise<string>;
 
+  /**
+   * Copy a local file into a document under a SAF directory URI (format-agnostic; Android only).
+   * @param fileUri - Content URI of the saved WAV file
+   * @param filename - Desired cache filename
+   * @returns Absolute file path to the cached copy
+   */
+  copyFileToContentUri(
+    filePath: string,
+    directoryUri: string,
+    filename: string,
+    mimeType: string
+  ): Promise<string>;
+
   /**
    * Copy a SAF content URI to a cache file for local playback.
    * @param fileUri - Content URI of the saved WAV file
@@ -561,6 +593,8 @@ export interface Spec extends TurboModule {
    * All get*Support methods return this shape. Optional modelBase64: if omitted, SDK uses embedded test model for canInit.
    */
   getQnnSupport(modelBase64?: string): Promise<AccelerationSupport>;
+  /** Device SoC model string (e.g. SM8850 on Android 12+). Null if not available. isSupported: true when SoC is SM8xxx (supported for QNN). */
+  getDeviceQnnSoc(): Promise<{ soc: string | null; isSupported: boolean }>;
   getNnapiSupport(modelBase64?: string): Promise<AccelerationSupport>;
   getXnnpackSupport(modelBase64?: string): Promise<AccelerationSupport>;
   getCoreMlSupport(modelBase64?: string): Promise<AccelerationSupport>;

package/src/audio/index.ts

@@ -1,9 +1,92 @@
+import { Buffer } from 'buffer';
+import { DeviceEventEmitter } from 'react-native';
 import SherpaOnnx from '../NativeSherpaOnnx';
 
 /**
- * Convert any supported audio file to a requested format (e.g. "mp3", "flac", "wav").
+ * Decode base64-encoded Int16 PCM to float array in [-1, 1].
+ * Uses a preallocated Float32Array to avoid GC pressure on the live-mic hot path.
+ */
+function base64PcmToFloatArray(base64: string): Float32Array {
+  const bytes = Buffer.from(base64, 'base64');
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const len = bytes.byteLength / 2;
+  const out = new Float32Array(len);
+  for (let i = 0; i < len; i++) {
+    out[i] = view.getInt16(i * 2, true) / 32768;
+  }
+  return out;
+}
+
+export type PcmLiveStreamOptions = {
+  sampleRate?: number;
+  channelCount?: number;
+  bufferSizeFrames?: number;
+};
+
+export type PcmLiveStreamHandle = {
+  start: () => Promise<void>;
+  stop: () => Promise<void>;
+  onData: (
+    callback: (samples: Float32Array, sampleRate: number) => void
+  ) => () => void;
+  onError: (callback: (message: string) => void) => () => void;
+};
+
+/**
+ * Create a PCM live stream from the device microphone. Native capture and resampling ensure
+ * PCM is always delivered at the requested sampleRate (e.g. 16000 for STT). The app must have
+ * RECORD_AUDIO (Android) and NSMicrophoneUsageDescription (iOS) and grant permission before start().
+ */
+export function createPcmLiveStream(
+  options?: PcmLiveStreamOptions
+): PcmLiveStreamHandle {
+  const sampleRate = options?.sampleRate ?? 16000;
+  const channelCount = options?.channelCount ?? 1;
+  const bufferSizeFrames = options?.bufferSizeFrames ?? 0;
+
+  return {
+    start: () =>
+      SherpaOnnx.startPcmLiveStream({
+        sampleRate,
+        channelCount,
+        bufferSizeFrames,
+      }),
+
+    stop: () => SherpaOnnx.stopPcmLiveStream(),
+
+    onData: (callback: (samples: Float32Array, sampleRate: number) => void) => {
+      const sub = DeviceEventEmitter.addListener(
+        'pcmLiveStreamData',
+        (event: { base64Pcm?: string; sampleRate?: number }) => {
+          const base64 = event?.base64Pcm ?? '';
+          const sr = event?.sampleRate ?? sampleRate;
+          if (base64) {
+            const samples = base64PcmToFloatArray(base64);
+            callback(samples, sr);
+          }
+        }
+      );
+      return () => sub.remove();
+    },
+
+    onError: (callback: (message: string) => void) => {
+      const sub = DeviceEventEmitter.addListener(
+        'pcmLiveStreamError',
+        (event: { message?: string }) => {
+          callback(event?.message ?? 'Unknown error');
+        }
+      );
+      return () => sub.remove();
+    },
+  };
+}
+
+/**
+ * Convert any supported audio file to a requested format (e.g. "mp3", "flac", "wav", "m4a", "opus", "webm").
  * 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.
+ * For Opus, optional outputSampleRateHz: 8000, 12000, 16000, 24000, or 48000.
+ * For M4A/AAC, standard bitrates apply.
  * Resolves on success, rejects with an error message on failure.
  */
 export function convertAudioToFormat(

package/src/download/ModelDownloadManager.ts

@@ -33,6 +33,7 @@ export enum ModelCategory {
   Diarization = 'diarization',
   Enhancement = 'enhancement',
   Separation = 'separation',
+  Qnn = 'qnn',
 }
 
 /** TTS model type for meta; 'unknown' when id could not be classified. */
@@ -233,6 +234,11 @@ const CATEGORY_CONFIG: Record<
     cacheFile: 'separation-models.json',
     baseDir: `${DocumentDirectoryPath}/sherpa-onnx/models/separation`,
   },
+  [ModelCategory.Qnn]: {
+    tag: 'asr-models-qnn-binary',
+    cacheFile: 'qnn-models.json',
+    baseDir: `${DocumentDirectoryPath}/sherpa-onnx/models/qnn`,
+  },
 };
 
 function getCacheDir(): string {
@@ -358,6 +364,11 @@ async function retryWithBackoff<T>(
 async function fetchChecksumsFromRelease(
   category: ModelCategory
 ): Promise<Map<string, string>> {
+  // asr-models-qnn-binary has no checksum.txt; use GitHub API digest only (set in toGenericModelMeta).
+  if (category === ModelCategory.Qnn) {
+    return new Map<string, string>();
+  }
+
   // Return cached if available
   if (checksumCacheByCategory[category]) {
     return checksumCacheByCategory[category]!;
@@ -490,6 +501,14 @@ function isAssetSupportedForCategory(
       return ext === 'onnx';
     case ModelCategory.Separation:
       return ext === 'tar.bz2' || ext === 'onnx';
+    case ModelCategory.Qnn:
+      // asr-models-qnn-binary: e.g. sherpa-onnx-qnn-SM8850-binary-5-seconds-zipformer-ctc-zh-*.tar.bz2
+      return (
+        ext === 'tar.bz2' &&
+        lower.includes('sherpa-onnx-qnn') &&
+        lower.includes('binary') &&
+        lower.includes('seconds')
+      );
     default:
       return false;
   }

package/src/index.tsx

@@ -16,6 +16,8 @@ export {
   resolveModelPath,
 } from './utils';
 
+export { copyFileToContentUri } from './tts';
+
 // Note: Feature-specific exports are available via subpath imports:
 // - import { createSTT, createStreamingSTT, ... } from 'react-native-sherpa-onnx/stt'
 // - import { createTTS, ... } from 'react-native-sherpa-onnx/tts'
@@ -41,6 +43,19 @@ export function getQnnSupport(
   return SherpaOnnx.getQnnSupport(modelBase64);
 }
 
+/**
+ * Device SoC result: soc is always the device SoC string when available (Android 12+); on iOS or when unavailable, soc is null.
+ * isSupported is true when the SoC is SM8xxx (supported for QNN models). Use soc for the label; use isSupported to decide whether to auto-select in the download manager.
+ */
+export type DeviceQnnSocResult = {
+  soc: string | null;
+  isSupported: boolean;
+};
+
+export function getDeviceQnnSoc(): Promise<DeviceQnnSocResult> {
+  return SherpaOnnx.getDeviceQnnSoc();
+}
+
 /**
  * Return the list of available ONNX Runtime execution providers
  * (e.g. "CPU", "NNAPI", "QNN", "XNNPACK").

package/src/stt/streaming.ts

@@ -317,11 +317,11 @@ export async function createStreamingSTT(
         },
 
         async processAudioChunk(
-          samples: number[],
+          samples: number[] | Float32Array,
           sampleRate: number
         ): Promise<{ result: StreamingSttResult; isEndpoint: boolean }> {
           streamGuard();
-          let toSend: number[] = samples;
+          let toSend: number[] | Float32Array = samples;
           if (enableInputNormalization && samples.length > 0) {
             let maxAbs = 1e-10;
             for (let i = 0; i < samples.length; i++) {
@@ -329,15 +329,20 @@ export async function createStreamingSTT(
               if (abs > maxAbs) maxAbs = abs;
             }
             const scale = maxAbs < 0.01 ? 80 : Math.min(80, 0.8 / maxAbs);
-            toSend = new Array(samples.length);
+            const normalized = new Float32Array(samples.length);
             for (let i = 0; i < samples.length; i++) {
               const v = samples[i]! * scale;
-              toSend[i] = v < -1 ? -1 : v > 1 ? 1 : v;
+              normalized[i] = v < -1 ? -1 : v > 1 ? 1 : v;
             }
+            toSend = normalized;
           }
+          // Bridge expects a plain array; Float32Array may not serialize as ReadableArray on all platforms.
+          const samplesArray = Array.isArray(toSend)
+            ? toSend
+            : Array.from(toSend);
           const raw = await SherpaOnnx.processSttAudioChunk(
             streamId,
-            toSend,
+            samplesArray,
             sampleRate
           );
           return {

package/src/stt/streamingTypes.ts

@@ -132,7 +132,7 @@ export interface SttStream {
    * Reduces bridge round-trips from 5 to 1 per chunk.
    */
   processAudioChunk(
-    samples: number[],
+    samples: number[] | Float32Array,
     sampleRate: number
   ): Promise<{ result: StreamingSttResult; isEndpoint: boolean }>;
 }

package/src/tts/index.ts

@@ -82,14 +82,18 @@ function flattenTtsModelOptionsForNative(
 /**
  * Detect TTS model type and structure without initializing the engine.
  * Uses the same native file-based detection as createTTS. Stateless; no instance required.
+ * For Kokoro/Kitten multi-language models, the result includes lexiconLanguageCandidates (e.g. ["default"] or ["us-en", "gb-en", "zh"]) derived from lexicon.txt and lexicon-*.txt; use these for a language selection dropdown (language change requires re-initialization).
  *
  * @param modelPath - Model path configuration (asset, file, or auto)
  * @param options - Optional 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), and optionally lexiconLanguageCandidates (language ids for multi-lang Kokoro/Kitten)
  * @example
  * ```typescript
  * const result = await detectTtsModel({ type: 'asset', path: 'models/vits-piper-en' });
  * if (result.success) console.log('Detected type:', result.modelType, result.detectedModels);
+ * if (result.lexiconLanguageCandidates?.length) {
+ *   // Kokoro/Kitten multi-lang: show language dropdown (e.g. "us-en", "zh")
+ * }
  * ```
  */
 export async function detectTtsModel(
@@ -99,6 +103,8 @@ export async function detectTtsModel(
   success: boolean;
   detectedModels: Array<{ type: string; modelDir: string }>;
   modelType?: string;
+  /** Language ids from detected lexicon files ("default" for lexicon.txt, or e.g. "us-en", "zh" from lexicon-us-en.txt, lexicon-zh.txt). Present for Kokoro/Kitten; use for language selection UI. */
+  lexiconLanguageCandidates?: string[];
 }> {
   const resolvedPath = await resolveModelPath(modelPath);
   return SherpaOnnx.detectTtsModel(resolvedPath, options?.modelType);
@@ -360,6 +366,24 @@ export function saveTextToContentUri(
   );
 }
 
+/**
+ * Copy a local file into a document under a SAF directory URI (format-agnostic; Android only).
+ * Use for saving converted audio (e.g. MP3, FLAC) to a content URI.
+ */
+export function copyFileToContentUri(
+  filePath: string,
+  directoryUri: string,
+  filename: string,
+  mimeType: string
+): Promise<string> {
+  return SherpaOnnx.copyFileToContentUri(
+    filePath,
+    directoryUri,
+    filename,
+    mimeType
+  );
+}
+
 /**
  * Copy a SAF content URI to a cache file for local playback (Android only).
  */

package/third_party/ffmpeg_prebuilt/ANDROID_RELEASE_TAG

@@ -1 +1 @@
-ffmpeg-android-v8.0.1
+ffmpeg-android-v8.0.1-1

package/third_party/libarchive_prebuilt/ANDROID_RELEASE_TAG

@@ -1 +1 @@
-libarchive-android-v3.8.5
+libarchive-android-v3.8.5-1

package/third_party/libarchive_prebuilt/IOS_RELEASE_TAG

@@ -1 +1 @@
-libarchive-ios-v3.8.5
+libarchive-ios-v3.8.5-1

package/third_party/sherpa-onnx-prebuilt/ANDROID_RELEASE_TAG

@@ -1 +1 @@
-sherpa-onnx-android-v1.12.24
+sherpa-onnx-android-v1.12.28

package/third_party/sherpa-onnx-prebuilt/IOS_RELEASE_TAG

@@ -1 +1 @@
-framework-v1.12.24
+framework-v1.12.28

package/ios/scripts/patch-libarchive-includes.sh

@@ -1,61 +0,0 @@
-#!/bin/bash
-# Copy libarchive .c files to ios/patched_libarchive and insert <stdio.h> and <unistd.h>
-# after #include "archive_platform.h" so they compile without modifying the submodule.
-# Called from SherpaOnnx.podspec during evaluation.
-# Requires: libarchive source dir (same as used for HEADER_SEARCH_PATHS: third_party or ios/Downloads/libarchive).
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-SDK_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-LIBARCHIVE_SRC="${1:-}"
-PATCHED_DIR="$SDK_ROOT/ios/patched_libarchive"
-
-if [ -z "$LIBARCHIVE_SRC" ]; then
-  echo "Error: libarchive source dir not set. Usage: $0 <libarchive_source_dir>" >&2
-  echo "Use the same path as libarchive_dir in the pod (e.g. third_party/libarchive_prebuilt/libarchive-ios-layout or ios/Downloads/libarchive)." >&2
-  exit 1
-fi
-
-if [ ! -d "$LIBARCHIVE_SRC" ]; then
-  echo "Error: libarchive source dir not found: $LIBARCHIVE_SRC" >&2
-  echo "Run third_party/libarchive_prebuilt/build_libarchive_ios.sh (repo) or ios/scripts/setup-ios-libarchive.sh (npm)." >&2
-  exit 1
-fi
-
-if [ ! -f "$LIBARCHIVE_SRC/archive_platform.h" ]; then
-  echo "Error: $LIBARCHIVE_SRC does not look like libarchive (archive_platform.h missing)." >&2
-  exit 1
-fi
-
-mkdir -p "$PATCHED_DIR"
-count=0
-
-# Same exclude as podspec: no test, windows, linux, sunos, freebsd
-for f in "$LIBARCHIVE_SRC"/*.c; do
-  [ -f "$f" ] || continue
-  base=$(basename "$f" .c)
-  [[ "$(basename "$f")" =~ ^test\. ]] && continue
-  [[ "$base" == *windows* ]] && continue
-  [[ "$base" == *linux* ]] && continue
-  [[ "$base" == *sunos* ]] && continue
-  [[ "$base" == *freebsd* ]] && continue
-
-  dest="$PATCHED_DIR/$(basename "$f")"
-  # Insert #include <stdio.h> and #include <unistd.h> after first #include "archive_platform.h"
-  inserted=0
-  while IFS= read -r line; do
-    echo "$line"
-    if [ "$inserted" -eq 0 ] && echo "$line" | grep -q '^#include "archive_platform.h"'; then
-      echo '#include <stdio.h>'
-      echo '#include <unistd.h>'
-      inserted=1
-    fi
-  done < "$f" > "$dest"
-  count=$((count + 1))
-done
-
-if [ "$count" -eq 0 ]; then
-  echo "Error: No libarchive .c files were copied to $PATCHED_DIR. Check excludes and source dir." >&2
-  exit 1
-fi

package/ios/scripts/setup-ios-libarchive.sh

@@ -1,98 +0,0 @@
-#!/bin/bash
-# Download libarchive iOS sources from GitHub Releases and extract to ios/Downloads/libarchive.
-# Always downloads (no skip when prebuilts exist). Call from Podfile pre_install so that
-# ios/Downloads/libarchive exists before the podspec is evaluated (required when using the SDK from npm).
-#
-# Usage: run from repo root or from Podfile pre_install, e.g.:
-#   system("bash", "#{sdk_path}/ios/scripts/setup-ios-libarchive.sh")
-# Or: ./ios/scripts/setup-ios-libarchive.sh
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# SDK root = parent of ios/
-SDK_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-DOWNLOADS_DIR="$SDK_ROOT/ios/Downloads"
-LIBARCHIVE_DIR="$DOWNLOADS_DIR/libarchive"
-TAG_FILE="$SDK_ROOT/third_party/libarchive_prebuilt/IOS_RELEASE_TAG"
-
-# Resolve release tag: env LIBARCHIVE_IOS_RELEASE_TAG, or IOS_RELEASE_TAG file (single source of truth; committed and included in npm package).
-RELEASE_TAG="${LIBARCHIVE_IOS_RELEASE_TAG:-}"
-if [ -z "$RELEASE_TAG" ] && [ -f "$TAG_FILE" ]; then
-  RELEASE_TAG=$(grep -v '^#' "$TAG_FILE" | grep -v '^[[:space:]]*$' | head -1 | tr -d '\r\n')
-fi
-if [ -z "$RELEASE_TAG" ]; then
-  echo "Error: IOS_RELEASE_TAG not found at $TAG_FILE. Reinstall the package or run from repo." >&2
-  exit 1
-fi
-
-# Skip download if already present (podspec can be evaluated multiple times during pod install).
-if [ -d "$LIBARCHIVE_DIR" ] && [ -f "$LIBARCHIVE_DIR/archive.h" ] && [ -n "$(find "$LIBARCHIVE_DIR" -maxdepth 1 -name '*.c' -print -quit 2>/dev/null)" ]; then
-  exit 0
-fi
-
-AUTH_ARGS=()
-if [ -n "$GITHUB_TOKEN" ]; then
-  AUTH_ARGS+=(-H "Authorization: Bearer $GITHUB_TOKEN")
-fi
-
-echo "Downloading libarchive iOS sources from release $RELEASE_TAG..."
-
-release_json=$(curl -s "${AUTH_ARGS[@]}" -H "Accept: application/vnd.github+json" \
-  "https://api.github.com/repos/XDcobra/react-native-sherpa-onnx/releases/tags/$RELEASE_TAG" 2>/dev/null || true)
-if [ -z "$release_json" ] || ! echo "$release_json" | grep -q '"assets"'; then
-  echo "Error: Could not fetch release $RELEASE_TAG or no assets (rate limit?)." >&2
-  exit 1
-fi
-
-download_url=""
-if command -v jq &>/dev/null; then
-  download_url=$(echo "$release_json" | jq -r '.assets[] | select(.name == "libarchive-ios-sources.zip") | .browser_download_url' | head -1)
-else
-  download_url=$(echo "$release_json" | grep -o '"browser_download_url": "[^"]*libarchive-ios-sources.zip[^"]*"' | head -1 | sed 's/.*: "//;s/"$//')
-fi
-if [ -z "$download_url" ]; then
-  echo "Error: Asset libarchive-ios-sources.zip not found in release $RELEASE_TAG" >&2
-  exit 1
-fi
-
-mkdir -p "$DOWNLOADS_DIR"
-zip_path="$DOWNLOADS_DIR/libarchive-ios-sources.zip"
-if ! curl -L -f "${AUTH_ARGS[@]}" -o "$zip_path" "$download_url"; then
-  rm -f "$zip_path"
-  exit 1
-fi
-if ! file "$zip_path" 2>/dev/null | grep -q "Zip archive"; then
-  echo "Error: Downloaded file is not a valid zip" >&2
-  rm -f "$zip_path"
-  exit 1
-fi
-
-rm -rf "$LIBARCHIVE_DIR"
-mkdir -p "$LIBARCHIVE_DIR"
-unzip -q -o "$zip_path" -d "$LIBARCHIVE_DIR"
-rm -f "$zip_path"
-
-# If the zip had a single top-level dir (e.g. libarchive-ios-sources), flatten so
-# archive.h and archive_xxhash.h are directly in LIBARCHIVE_DIR (podspec HEADER_SEARCH_PATHS expects that).
-subdirs=("$LIBARCHIVE_DIR"/*/)
-if [ -d "${subdirs[0]}" ] && [ "${#subdirs[@]}" -eq 1 ] && [ ! -f "$LIBARCHIVE_DIR/archive.h" ]; then
-  subdir="${subdirs[0]}"
-  echo "Flattening single top-level directory: $(basename "$subdir")"
-  shopt -s dotglob
-  mv "$subdir"* "$LIBARCHIVE_DIR/"
-  shopt -u dotglob
-  rmdir "$subdir" 2>/dev/null || true
-fi
-
-# Ensure required headers exist (e.g. archive_xxhash.h for LZ4 support)
-if [ ! -f "$LIBARCHIVE_DIR/archive.h" ]; then
-  echo "Error: $LIBARCHIVE_DIR/archive.h missing after extract. Zip layout may be unexpected." >&2
-  exit 1
-fi
-if [ ! -f "$LIBARCHIVE_DIR/archive_xxhash.h" ]; then
-  echo "Error: $LIBARCHIVE_DIR/archive_xxhash.h missing. Re-publish libarchive iOS release (build_libarchive_ios.sh copies all *.h)." >&2
-  exit 1
-fi
-
-echo "Libarchive iOS sources extracted to $LIBARCHIVE_DIR"