@gmessier/nitro-speech 0.4.0 → 0.4.1

package/README.md

@@ -13,7 +13,7 @@
 
 #### Key Features:
 
-- ⚡ Built on Nitro Modules for zero-overhead native bridging
+- ⚡ Built with Nitro Modules for low-overhead native binding
 - 🌎 Supports 60+ languages 
 - 🍎 The only library that uses new `SpeechAnalyzer` with `SpeechTranscriber` or `DictationTranscriber` API for iOS 26+ (with fallback to legacy `SFSpeechRecognition` for older versions)
 - ⏱️ Timer for silence
@@ -21,16 +21,16 @@
   - Callback `onAutoFinishProgress` fires periodically with interval
   - Configurable interval `autoFinishProgressIntervalMs` value (default: 1 sec)
   - Method `updateConfig` with `autoFinishRecognitionMs` and `autoFinishProgressIntervalMs`
-  allows to change value on the fly
+  allows changing the value on the fly
   - Method `resetAutoFinishTime` resets the Timer to the threshold
   - Method `addAutoFinishTime` adds ms once without changing threshold
   - Configurable volume-based sensitivity `resetAutoFinishVoiceSensitivity` for the timer from 0 to 1
 - 🎤 Rich user voice input management 
-  - Hook `useVoiceInputVolume()` for `raw` or `smoothed` normalized 
-  volume level from 0 to 1 -> easy to use for UI animations;
+  - Hook `useVoiceInputVolume()` for `raw` or `smoothed` normalized volume level from 0 to 1 -> easy to use for UI animations;
   And `db` as human-friendly value
   - Flexible callback `onVolumeChange` for custom behavior
-- 🧩 Lifecycle methods: `prewarm` | `updateConfig` | `getIsActive` | `getSupportedLocalesIOS`
+  - Static method `getVoiceInputVolume()`
+- 🧩 Lifecycle methods: `prewarm` | `updateConfig` | `getIsActive`
 - 👆 Configurable Haptic Feedback on start and finish
 - 🎚️ Speech-quality configurations:
   - Result is grouped by speech segments into Batches.
@@ -53,6 +53,7 @@
   - [Cross-component control: RecognizerRef](#cross-component-control-recognizerref)
   - [Multithreading (react-native-worklets)](#multithreading-react-native-worklets)
   - [Voice input volume](#voice-input-volume)
+  - [useRecognizerIsActive](#userecognizerisactive)
   - [Unsafe: SpeechRecognizer](#unsafe-speechrecognizer)
 - [Requirements](#requirements)
 - [Compatibility](#compatibility)
@@ -123,11 +124,11 @@ Both permissions are required for speech recognition to work on iOS.
 | **Auto-finish progress** | Callback `onAutoFinishProgress` with countdown until auto-stop | ✅ | ✅ |
 | **Add Auto-finish Time** | Adds time to the auto finish timer once without changing the timer threshold | ✅ | ✅ |
 | **Reset Auto-finish Time** | Resets the Timer to the threshold | ✅ | ✅ |
-| **Voice input volume** | Hook `useVoiceInputVolume` and `onVolumeChange` callback | ✅ | ✅ |
+| **Voice input volume** | `useVoiceInputVolume`, `getVoiceInputVolume()`, `onVolumeChange` | ✅ | ✅ |
 | **Reset Auto-finish Sensitivity** | The voice detector sensitivity to reset the Auto-finish time | ✅ | ✅ |
 | **Prewarm** | Prepares resources, downloads assets, confirms locale availability | ✅ | ✅ |
-| **Update config** | Static method `updateConfig` allows update config on the fly | ✅ | ✅ |
-| **isActive** | Static method `getIsActive()` | ✅ | ✅ |
+| **Update config** | Static method `updateConfig` allows updating the config on the fly | ✅ | ✅ |
+| **Is Active** | Static method `getIsActive()` | ✅ | ✅ |
 | **Haptic feedback** | Haptic feedback on recording start/stop | ✅ | ✅ |
 | **Permission handling** | Dedicated `onPermissionDenied` callback | ✅ | ✅ |
 | **Background handling** | Stop when app loses focus/goes to background | ✅ | ✅ |
@@ -162,6 +163,7 @@ function MyComponent() {
     updateConfig,
     getSupportedLocalesIOS,
     getIsActive,
+    getVoiceInputVolume,
   } = useRecognizer({
     onReadyForSpeech: () => {
       console.log('Listening...');
@@ -271,6 +273,7 @@ RecognizerRef.updateConfig(
   true
 );
 RecognizerRef.getIsActive();
+RecognizerRef.getVoiceInputVolume();
 RecognizerRef.stopListening();
 // iOS only
 RecognizerRef.getSupportedLocalesIOS();
@@ -321,8 +324,6 @@ function VoiceMeter() {
 As a better alternative you can control volume via SharedValue and apply it only on UI thread with Reanimated.
 This way you will avoid re-renders since the volume will be stored on UI thread
 
-Warning: this approach will disable the built-in `useVoiceInputVolume` hook.
-
 ```typescript
 function VoiceMeter() {
   const sharedVolume = useSharedValue(0)
@@ -341,6 +342,16 @@ function VoiceMeter() {
 }
 ```
 
+### useRecognizerIsActive
+
+```typescript
+import { useRecognizerIsActive } from '@gmessier/nitro-speech';
+
+function MyComponent() {
+  const isActive = useRecognizerIsActive();
+  return <Text>{isActive ? 'Listening...' : 'Not listening'}</Text>;
+}
+```
 
 ### Unsafe: SpeechRecognizer
 
@@ -415,7 +426,7 @@ The `SpeechRecognizer.dispose()` method is **NOT SAFE** and should rarely be use
 
 ## Compatibility
 
-Latest versions of `@gmessier/nitro-speech` requires [react-native-nitro-modules 0.35.0 or higher](https://github.com/mrousavy/nitro/releases/tag/v0.35.0).
+Latest versions of `@gmessier/nitro-speech` require [react-native-nitro-modules 0.35.0 or higher](https://github.com/mrousavy/nitro/releases/tag/v0.35.0).
 
 
 | Compatibility                          | Supported versions                |
@@ -427,7 +438,7 @@ Latest versions of `@gmessier/nitro-speech` requires [react-native-nitro-modules
 
 ### Android Gradle sync issues
 
-If you're having issues with Android Gradle sync, try running the prebuild for the library, that causes the issue:
+If you're having issues with Android Gradle sync, try running the prebuild for the library that causes the issue:
 
 e.g. failed in `react-native-nitro-modules`:
 

package/android/src/main/java/com/margelo/nitro/nitrospeech/recognizer/AutoStopper.kt

@@ -2,7 +2,6 @@ package com.margelo.nitro.nitrospeech.recognizer
 
 import android.os.Handler
 import android.os.Looper
-import android.util.Log
 import kotlin.math.max
 
 class AutoStopper(
@@ -12,12 +11,13 @@ class AutoStopper(
     val onTimeout: () -> Unit,
 ) {
     companion object {
-        private const val TAG = "HybridRecognizer"
         private const val DEFAULT_SILENCE_THRESHOLD_MS = 8000.0
         private const val DEFAULT_PROGRESS_INTERVAL_MS = 1000.0
         private const val MIN_PROGRESS_INTERVAL_MS = 50.0
     }
 
+    private val logger = Logger(disable = false)
+
     private var silenceThresholdMs: Double = clampMs(silenceThresholdMs ?: DEFAULT_SILENCE_THRESHOLD_MS)
     private var progressIntervalMs: Double = clampMs(progressIntervalMs ?: DEFAULT_PROGRESS_INTERVAL_MS)
 
@@ -31,7 +31,7 @@ class AutoStopper(
     private val tickRunnable = Runnable { tick() }
 
     fun resetTimer() {
-        Log.d(TAG, "resetTimer | isStopped: $isStopped | ms: ${System.currentTimeMillis()}")
+        logger.log("resetTimer | isStopped: $isStopped | ms: ${System.currentTimeMillis()}")
         handler.removeCallbacks(tickRunnable)
         isTimerScheduled = false
         if (isStopped) return
@@ -55,7 +55,7 @@ class AutoStopper(
 
     fun addMsOnce(extraMs: Double) {
         if (isStopped || !extraMs.isFinite()) return
-        Log.d(TAG, "addMsOnce | extraMs: $extraMs")
+        logger.log("addMsOnce | extraMs: $extraMs")
         timeLeftMs += extraMs
         didTimeout = false
         if (timeLeftMs > 0 && isTimerScheduled) {
@@ -65,7 +65,7 @@ class AutoStopper(
 
     fun updateProgressInterval(newIntervalMs: Double) {
         if (isStopped) return
-        Log.d(TAG, "updateProgressInterval | newIntervalMs: $newIntervalMs")
+        logger.log("updateProgressInterval | newIntervalMs: $newIntervalMs")
         progressIntervalMs = clampMs(newIntervalMs)
         if (isTimerScheduled) {
             scheduleNextTickLocked()
@@ -83,7 +83,7 @@ class AutoStopper(
         if (isStopped || didTimeout) return
         timeLeftMs -= progressIntervalMs
         if (timeLeftMs > 0) {
-            Log.d(TAG, "onProgress | timeLeftMs: $timeLeftMs")
+            logger.log("onProgress | timeLeftMs: $timeLeftMs")
             onProgress(timeLeftMs)
             scheduleNextTickLocked()
             return
@@ -92,7 +92,7 @@ class AutoStopper(
         didTimeout = true
         handler.removeCallbacks(tickRunnable)
         isTimerScheduled = false
-        Log.d(TAG, "onTimeout | ms: ${System.currentTimeMillis()}")
+        logger.log("onTimeout | ms: ${System.currentTimeMillis()}")
         onTimeout()
     }
 

package/android/src/main/java/com/margelo/nitro/nitrospeech/recognizer/HybridRecognizer.kt

@@ -7,7 +7,6 @@ import android.os.Handler
 import android.os.Looper
 import android.speech.RecognizerIntent
 import android.speech.SpeechRecognizer
-import android.util.Log
 import androidx.annotation.Keep
 import com.facebook.proguard.annotations.DoNotStrip
 import com.margelo.nitro.NitroModules
@@ -21,12 +20,14 @@ import com.margelo.nitro.nitrospeech.VolumeChangeEvent
 @Keep
 class HybridRecognizer: HybridRecognizerSpec() {
   companion object {
-    private const val TAG = "HybridRecognizer"
     private const val POST_RECOGNITION_DELAY = 250L
   }
 
+  private val logger = Logger(disable = false)
+
   private var isActive: Boolean = false
   private var config: SpeechRecognitionConfig? = null
+  private var volumeChangeEvent: VolumeChangeEvent = VolumeChangeEvent(0.0,0.0,null)
   private var autoStopper: AutoStopper? = null
   private var speechRecognizer: SpeechRecognizer? = null
   private val mainHandler = Handler(Looper.getMainLooper())
@@ -51,7 +52,7 @@ class HybridRecognizer: HybridRecognizerSpec() {
   @DoNotStrip
   @Keep
   override fun startListening(params: SpeechRecognitionConfig?) {
-    Log.d(TAG, "startListening: $params")
+    logger.log("startListening: $params")
     if (isActive) {
       onFinishRecognition(
         null,
@@ -94,7 +95,7 @@ class HybridRecognizer: HybridRecognizerSpec() {
   @DoNotStrip
   @Keep
   override fun stopListening() {
-    Log.d(TAG, "stopListening called")
+    logger.log("stopListening called")
     if (!isActive) return
     onFinishRecognition(null, null, true)
     mainHandler.postDelayed({
@@ -117,7 +118,7 @@ class HybridRecognizer: HybridRecognizerSpec() {
   @DoNotStrip
   @Keep
   override fun addAutoFinishTime(additionalTimeMs: Double?) {
-    Log.d(TAG, "addAutoFinishTime")
+    logger.log("addAutoFinishTime")
     if (!isActive) return
 
     if (additionalTimeMs != null) {
@@ -134,7 +135,7 @@ class HybridRecognizer: HybridRecognizerSpec() {
     newConfig: MutableSpeechRecognitionConfig?,
     resetAutoFinishTime: Boolean?
   ) {
-    Log.d(TAG, "updateConfig $newConfig",)
+    logger.log("updateConfig $newConfig",)
     if (!isActive) return
 
     val newTimeMs = if (newConfig?.autoFinishRecognitionMs != null) newConfig.autoFinishRecognitionMs else config?.autoFinishRecognitionMs
@@ -177,6 +178,12 @@ class HybridRecognizer: HybridRecognizerSpec() {
     return isActive
   }
 
+  @DoNotStrip
+  @Keep
+  override fun getVoiceInputVolume(): VolumeChangeEvent {
+    return volumeChangeEvent
+  }
+
   @DoNotStrip
   @Keep
   override fun getSupportedLocalesIOS(): Array<String> {
@@ -204,12 +211,14 @@ class HybridRecognizer: HybridRecognizerSpec() {
             }
         )
         val recognitionListenerSession = RecognitionListenerSession(
-          autoStopper,
-          config,
-          onVolumeChange
-        ) { result: ArrayList<String>?, errorMessage: String?, recordingStopped: Boolean ->
-          onFinishRecognition(result, errorMessage, recordingStopped)
-        }
+            autoStopper,
+            config,
+            fireVolumeChangeEvent = { event -> fireVolumeChangeEvent(event) },
+            onFinishRecognition = { result, errorMessage, recordingStopped ->
+              onFinishRecognition(result, errorMessage, recordingStopped)
+            }
+        )
+
         speechRecognizer?.setRecognitionListener(recognitionListenerSession.createRecognitionListener())
 
         val languageModel = if (config?.androidUseWebSearchModel == true) RecognizerIntent.LANGUAGE_MODEL_WEB_SEARCH else RecognizerIntent.LANGUAGE_MODEL_FREE_FORM
@@ -262,7 +271,7 @@ class HybridRecognizer: HybridRecognizerSpec() {
 
   private fun cleanup() {
     try {
-      Log.d(TAG, "cleanup called")
+      logger.log("cleanup called")
       autoStopper?.stop()
       autoStopper = null
       speechRecognizer?.stopListening()
@@ -270,7 +279,7 @@ class HybridRecognizer: HybridRecognizerSpec() {
       speechRecognizer = null
       isActive = false
       // Reset voice meter in JS consumers after stop/error cleanup.
-      onVolumeChange?.invoke(VolumeChangeEvent(0.0,0.0,null))
+      fireVolumeChangeEvent(VolumeChangeEvent(0.0,0.0,null))
     } catch (e: Exception) {
       onFinishRecognition(
         null,
@@ -291,4 +300,10 @@ class HybridRecognizer: HybridRecognizerSpec() {
       onResult?.invoke(result.toTypedArray())
     }
   }
+
+  private fun fireVolumeChangeEvent(event: VolumeChangeEvent) {
+    logger.log("fireVolumeChangeEvent ${event}")
+    volumeChangeEvent = event
+    onVolumeChange?.invoke(event)
+  }
 }

package/android/src/main/java/com/margelo/nitro/nitrospeech/recognizer/Logger.kt

@@ -0,0 +1,16 @@
+package com.margelo.nitro.nitrospeech.recognizer
+
+import android.util.Log
+
+class Logger (
+  private val disable: Boolean
+) {
+  private val isLogging = false
+  companion object {
+    private const val TAG = "HybridRecognizer"
+  }
+  fun log(message: String) {
+    if (disable || !isLogging) return
+    Log.d(TAG, message)
+  }
+}

package/android/src/main/java/com/margelo/nitro/nitrospeech/recognizer/RecognitionListenerSession.kt

@@ -3,7 +3,6 @@ package com.margelo.nitro.nitrospeech.recognizer
 import android.os.Bundle
 import android.speech.RecognitionListener
 import android.speech.SpeechRecognizer
-import android.util.Log
 import com.margelo.nitro.nitrospeech.SpeechRecognitionConfig
 import com.margelo.nitro.nitrospeech.VolumeChangeEvent
 import kotlin.math.max
@@ -12,11 +11,11 @@ import kotlin.math.roundToInt
 class RecognitionListenerSession (
     private val autoStopper: AutoStopper?,
     private val config: SpeechRecognitionConfig?,
-    private val onVolumeChange: ((event: VolumeChangeEvent) -> Unit)?,
+    private val fireVolumeChangeEvent: (event: VolumeChangeEvent) -> Unit,
     private val onFinishRecognition: (result: ArrayList<String>?, errorMessage: String?, recordingStopped: Boolean) -> Unit,
 ) {
+    private val logger = Logger(disable = false)
     companion object {
-        private const val TAG = "HybridRecognizer"
         private const val SPEECH_LEVEL_THRESHOLD = 0.35
         private const val FLOOR_RISE_ALPHA = 0.01f
         private const val FLOOR_FALL_ALPHA = 0.20f
@@ -40,11 +39,11 @@ class RecognitionListenerSession (
             override fun onBeginningOfSpeech() {}
             override fun onRmsChanged(rmsdB: Float) {
                 val volumeEvent = getVolume(rmsdB)
-                onVolumeChange?.invoke(volumeEvent)
+                fireVolumeChangeEvent(volumeEvent)
                 val threshold =
                     config?.resetAutoFinishVoiceSensitivity?.coerceIn(0.0, 1.0)
                         ?: SPEECH_LEVEL_THRESHOLD.toDouble()
-                Log.d(TAG, "onRmsChanged: ${volumeEvent}")
+                // logger.log("onRmsChanged: ${volumeEvent}")
                 if (volumeEvent.rawVolume > threshold) {
                     autoStopper?.resetTimer()
                 }
@@ -75,7 +74,7 @@ class RecognitionListenerSession (
             }
 
             override fun onResults(results: Bundle?) {
-                Log.d(TAG, "onResults: $resultBatches")
+                logger.log("onResults: $resultBatches")
                 onFinishRecognition(resultBatches, null, true)
                 autoStopper?.stop()
                 autoStopper?.onTimeout()
@@ -85,26 +84,26 @@ class RecognitionListenerSession (
                 val matches = partialResults?.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION)
 
                 if (matches.isNullOrEmpty() || matches[0] == "") {
-                    Log.d(TAG, "onPartialResults[0], skip, NO RECOGNIZE")
+                    logger.log("onPartialResults[0], skip, NO RECOGNIZE")
                     return
                 }
 
                 autoStopper?.resetTimer()
-                Log.d(TAG, "onPartialResults[0], add ${matches[0]}")
+                logger.log("onPartialResults[0], add ${matches[0]}")
                 var currentBatches = resultBatches
                 if (currentBatches.isNullOrEmpty()) {
-                    Log.d(TAG, "onPartialResults[1], NO BATCHES YET | add first")
+                    logger.log("onPartialResults[1], NO BATCHES YET | add first")
                     currentBatches = arrayListOf(matches[0])
                 } else {
-                    Log.d(TAG, "onPartialResults[1], current batches $currentBatches")
+                    logger.log("onPartialResults[1], current batches $currentBatches")
                     val prevBatchLength = currentBatches[currentBatches.lastIndex].length
                     val match = if (config?.disableRepeatingFilter == true) matches[0] else repeatingFilter(matches[0])
                     val matchLength = match.length
                     if (config?.androidDisableBatchHandling == true || matchLength + 3 < prevBatchLength) {
-                        Log.d(TAG, "onPartialResults[2], append new batch")
+                        logger.log("onPartialResults[2], append new batch")
                         currentBatches.add(match)
                     } else {
-                        Log.d(TAG, "onPartialResults[2], update batch, replace #${currentBatches.lastIndex}")
+                        logger.log("onPartialResults[2], update batch, replace #${currentBatches.lastIndex}")
                         currentBatches[currentBatches.lastIndex] = match
                     }
                 }

package/ios/Audio/AudioLevelTracker.swift

@@ -16,33 +16,18 @@ final class AudioLevelTracker {
     private static let meterRelease: Float = 0.08
     private static let defaultAutoStopResetThreshold: Double = 0.4
 
-    private var autoStopResetThreshold: Double
     private var smoothedLevel: Float = 0
+
+    var currentSample: AudioLevelSample?
     
-    init(resetAutoFinishVoiceSensitivity: Double?) {
-        if let resetAutoFinishVoiceSensitivity {
-            // Clamp value between 0 and 1
-            self.autoStopResetThreshold = max(0, min(1, resetAutoFinishVoiceSensitivity))
-        } else {
-            self.autoStopResetThreshold = Self.defaultAutoStopResetThreshold
-        }
-    }
-    
-    func updateResetAutoFinishVoiceSensitivity(newValue: Double?) {
-        if let newValue {
-            // Clamp value between 0 and 1
-            self.autoStopResetThreshold = max(0, min(1, newValue))
-        } else {
-            self.autoStopResetThreshold = Self.defaultAutoStopResetThreshold
-        }
-    }
+    private let lg = Lg(prefix: "RecognizerEngine")
 
     func reset() {
         smoothedLevel = 0
-        self.autoStopResetThreshold = Self.defaultAutoStopResetThreshold
+        currentSample = nil
     }
 
-    func process(_ buffer: AVAudioPCMBuffer) -> AudioLevelSample? {
+    func process(_ buffer: AVAudioPCMBuffer,_ autoStopResetThreshold: Double? = nil) -> AudioLevelSample? {
         guard let samples = buffer.floatChannelData?[0] else { return nil }
 
         let frameCount = Int(buffer.frameLength)
@@ -56,11 +41,20 @@ final class AudioLevelTracker {
         let coeff = normalized > smoothedLevel ? Self.meterAttack : Self.meterRelease
         smoothedLevel += coeff * (normalized - smoothedLevel)
         
-        return AudioLevelSample(
+        var threshold = Self.defaultAutoStopResetThreshold
+        if let autoStopResetThreshold {
+            threshold = max(0, min(1, autoStopResetThreshold))
+        }
+
+        currentSample = AudioLevelSample(
             smoothed: Double(smoothedLevel * 1_000_000).rounded() / 1_000_000,
             raw: Double(normalized * 1_000_000).rounded() / 1_000_000,
             db: Double(db * 1_000).rounded() / 1_000,
-            resetTimer: Double(normalized) >= self.autoStopResetThreshold
+            resetTimer: Double(normalized) >= threshold
         )
+        
+        lg.log("[AudioLevelTracker.process] autoStopResetThreshold: \(threshold)")
+        
+        return currentSample
     }
 }

package/ios/Engines/RecognizerEngine.swift

@@ -18,7 +18,7 @@ class RecognizerEngine {
     var hardwareFormat: AVAudioFormat?
     weak var recognizerDelegate: RecognizerDelegate?
     
-    private let audioLevelTracker: AudioLevelTracker
+    private let audioLevelTracker = AudioLevelTracker()
     private var appStateObserver: AppStateObserver?
     private var audioEngine: AVAudioEngine?
     private var autoStopper: AutoStopper?
@@ -29,9 +29,6 @@ class RecognizerEngine {
     init(locale: Locale, delegate: RecognizerDelegate) {
         self.locale = locale
         self.recognizerDelegate = delegate
-        self.audioLevelTracker = AudioLevelTracker(
-            resetAutoFinishVoiceSensitivity: delegate.config?.resetAutoFinishVoiceSensitivity
-        )
     }
     
     // MARK: - Recognizer Methods
@@ -84,7 +81,10 @@ class RecognizerEngine {
             format: hardwareFormat
         ) { [weak self] buffer, _ in
             guard let self, let recognizerDelegate = self.recognizerDelegate else { return }
-            if let sample = self.audioLevelTracker.process(buffer) {
+            if let sample = self.audioLevelTracker.process(
+                buffer,
+                recognizerDelegate.config?.resetAutoFinishVoiceSensitivity
+            ) {
                 // Send buffer volume data
                 recognizerDelegate.volumeChange(
                     event:
@@ -148,13 +148,7 @@ class RecognizerEngine {
                 from: "updateSession"
             )
         }
-        // Update AutoFinish reset voice sensitivity interval
-        if let newSensitivity = newConfig?.resetAutoFinishVoiceSensitivity, 
-            newSensitivity != currentConfig?.resetAutoFinishVoiceSensitivity {
-            audioLevelTracker.updateResetAutoFinishVoiceSensitivity(
-                newValue: newSensitivity
-            )
-        }
+        
         if let addMsToTimer {
             // Add time to the timer once
             autoStopper?.addMsOnce(
@@ -168,7 +162,16 @@ class RecognizerEngine {
         // Only update new non-nil values in the config
         recognizerDelegate.softlyUpdateConfig(newConfig: newConfig)
     }
-    
+
+    func getVoiceInputVolume() -> VolumeChangeEvent? {
+        guard let currentSample = audioLevelTracker.currentSample else { return nil }
+        return VolumeChangeEvent(
+            smoothedVolume: currentSample.smoothed,
+            rawVolume: currentSample.raw,
+            db: currentSample.db
+        )
+    }
+
     func cleanup(from: String) {
         lg.log("[cleanup]: \(from)")
         let wasActive = isActive

package/ios/HybridRecognizer.swift

@@ -68,6 +68,14 @@ class HybridRecognizer: HybridRecognizerSpec  {
     func getIsActive() -> Bool {
         engine?.isActive ?? false
     }
+
+    func getVoiceInputVolume() -> VolumeChangeEvent {
+        return engine?.getVoiceInputVolume() ?? VolumeChangeEvent(
+            smoothedVolume: 0,
+            rawVolume: 0,
+            db: nil
+        )
+    }
     
     func getSupportedLocalesIOS() -> [String] {
         return self.coordinator.getSupportedLocales()

package/ios/Shared/AutoStopper.swift

@@ -5,7 +5,7 @@ final class AutoStopper {
     private static let defaultProgressIntervalMs = 1000.0
     private static let minProgressIntervalMs = 50.0
 
-    private let lg = Lg(prefix: "AutoStopper", disable: true)
+    private let lg = Lg(prefix: "AutoStopper", disable: false)
     
     private let queue = DispatchQueue(label: "com.margelo.nitrospeech.autostopper")
 

package/lib/Recognizer/RecognizerRef.d.ts

@@ -1,5 +1,7 @@
 import type { RecognizerMethods } from './types';
 /**
  * Safe cross-component reference to the Speech Recognizer methods.
+ *
+ * All methods support worklets and UI thread calls
  */
 export declare const RecognizerRef: RecognizerMethods;

package/lib/Recognizer/RecognizerRef.js

@@ -1,6 +1,8 @@
-import { recognizerAddAutoFinishTime, recognizerGetSupportedLocalesIOS, recognizerGetIsActive, recognizerResetAutoFinishTime, recognizerStartListening, recognizerStopListening, recognizerUpdateConfig, } from './methods';
+import { recognizerAddAutoFinishTime, recognizerGetSupportedLocalesIOS, recognizerGetIsActive, recognizerResetAutoFinishTime, recognizerStartListening, recognizerStopListening, recognizerUpdateConfig, recognizerGetVoiceInputVolume, } from './methods';
 /**
  * Safe cross-component reference to the Speech Recognizer methods.
+ *
+ * All methods support worklets and UI thread calls
  */
 export const RecognizerRef = {
     startListening: recognizerStartListening,
@@ -9,5 +11,6 @@ export const RecognizerRef = {
     addAutoFinishTime: recognizerAddAutoFinishTime,
     updateConfig: recognizerUpdateConfig,
     getIsActive: recognizerGetIsActive,
+    getVoiceInputVolume: recognizerGetVoiceInputVolume,
     getSupportedLocalesIOS: recognizerGetSupportedLocalesIOS,
 };

package/lib/Recognizer/methods.d.ts

@@ -5,4 +5,5 @@ export declare const recognizerResetAutoFinishTime: () => void;
 export declare const recognizerAddAutoFinishTime: (additionalTimeMs?: number) => void;
 export declare const recognizerUpdateConfig: (newConfig: SpeechRecognitionConfig, resetAutoFinishTime?: boolean) => void;
 export declare const recognizerGetIsActive: () => boolean;
+export declare const recognizerGetVoiceInputVolume: () => import("./types").VolumeChangeEvent;
 export declare const recognizerGetSupportedLocalesIOS: () => string[];

package/lib/Recognizer/methods.js

@@ -23,6 +23,10 @@ export const recognizerGetIsActive = () => {
     'worklet';
     return SpeechRecognizer.getIsActive();
 };
+export const recognizerGetVoiceInputVolume = () => {
+    'worklet';
+    return SpeechRecognizer.getVoiceInputVolume();
+};
 export const recognizerGetSupportedLocalesIOS = () => {
     'worklet';
     return SpeechRecognizer.getSupportedLocalesIOS().sort();

package/lib/Recognizer/types.d.ts

@@ -2,5 +2,5 @@ import type { Recognizer as RecognizerSpec } from '../specs/Recognizer.nitro';
 import type { SpeechRecognitionConfig } from '../specs/SpeechRecognitionConfig';
 import type { VolumeChangeEvent } from '../specs/VolumeChangeEvent';
 type RecognizerCallbacks = Pick<RecognizerSpec, 'onReadyForSpeech' | 'onRecordingStopped' | 'onResult' | 'onAutoFinishProgress' | 'onError' | 'onPermissionDenied' | 'onVolumeChange'>;
-type RecognizerMethods = Pick<RecognizerSpec, 'startListening' | 'stopListening' | 'resetAutoFinishTime' | 'addAutoFinishTime' | 'updateConfig' | 'getIsActive' | 'getSupportedLocalesIOS'>;
+type RecognizerMethods = Pick<RecognizerSpec, 'startListening' | 'stopListening' | 'resetAutoFinishTime' | 'addAutoFinishTime' | 'updateConfig' | 'getIsActive' | 'getVoiceInputVolume' | 'getSupportedLocalesIOS'>;
 export type { RecognizerSpec, SpeechRecognitionConfig, VolumeChangeEvent, RecognizerCallbacks, RecognizerMethods, };

package/lib/Recognizer/useRecognizer.js

@@ -1,7 +1,8 @@
 import { useEffect } from 'react';
-import { recognizerResetAutoFinishTime, recognizerAddAutoFinishTime, recognizerUpdateConfig, recognizerGetIsActive, recognizerGetSupportedLocalesIOS, recognizerStartListening, recognizerStopListening, } from './methods';
+import { recognizerResetAutoFinishTime, recognizerAddAutoFinishTime, recognizerUpdateConfig, recognizerGetIsActive, recognizerGetSupportedLocalesIOS, recognizerStartListening, recognizerStopListening, recognizerGetVoiceInputVolume, } from './methods';
 import { SpeechRecognizer } from './SpeechRecognizer';
 import { speechRecognizerVolumeChangeHandler } from './useVoiceInputVolume';
+import { speechRecognizerActiveStateHandler } from './useRecognizerIsActive';
 /**
  * Safe, lifecycle-aware hook to use the recognizer.
  *
@@ -17,18 +18,12 @@ import { speechRecognizerVolumeChangeHandler } from './useVoiceInputVolume';
  */
 export const useRecognizer = (callbacks, destroyDeps = []) => {
     useEffect(() => {
-        if (callbacks.onVolumeChange) {
-            SpeechRecognizer.onVolumeChange = (event) => {
-                callbacks.onVolumeChange?.(event);
-            };
-        }
-        else {
-            SpeechRecognizer.onVolumeChange = speechRecognizerVolumeChangeHandler;
-        }
         SpeechRecognizer.onReadyForSpeech = () => {
+            speechRecognizerActiveStateHandler(true);
             callbacks.onReadyForSpeech?.();
         };
         SpeechRecognizer.onRecordingStopped = () => {
+            speechRecognizerActiveStateHandler(false);
             callbacks.onRecordingStopped?.();
         };
         SpeechRecognizer.onResult = (resultBatches) => {
@@ -43,6 +38,10 @@ export const useRecognizer = (callbacks, destroyDeps = []) => {
         SpeechRecognizer.onPermissionDenied = () => {
             callbacks.onPermissionDenied?.();
         };
+        SpeechRecognizer.onVolumeChange = (event) => {
+            speechRecognizerVolumeChangeHandler(event);
+            callbacks.onVolumeChange?.(event);
+        };
         return () => {
             SpeechRecognizer.onReadyForSpeech = undefined;
             SpeechRecognizer.onRecordingStopped = undefined;
@@ -66,6 +65,7 @@ export const useRecognizer = (callbacks, destroyDeps = []) => {
         addAutoFinishTime: recognizerAddAutoFinishTime,
         updateConfig: recognizerUpdateConfig,
         getIsActive: recognizerGetIsActive,
+        getVoiceInputVolume: recognizerGetVoiceInputVolume,
         getSupportedLocalesIOS: recognizerGetSupportedLocalesIOS,
     };
 };

package/lib/Recognizer/useRecognizerIsActive.d.ts

@@ -0,0 +1,25 @@
+type OnActiveStateChange = (isActive: boolean) => void;
+/**
+ * Returns true if the speech recognition session is active.
+ */
+export declare const useRecognizerIsActive: () => boolean;
+/**
+ * Direct access to default Speech Recognizer isActive state change handler.
+ *
+ * In case you use static Speech Recognizer:
+ *
+ * ```typescript
+ * import { speechRecognizerActiveStateHandler } from '@gmessier/nitro-speech'
+ *
+ * SpeechRecognizer.onReadyForSpeech = () => {
+ *   speechRecognizerActiveStateHandler(true)
+ * }
+ * SpeechRecognizer.onRecordingStopped = () => {
+ *   speechRecognizerActiveStateHandler(false)
+ * }
+ * ... // setup everything else
+ * SpeechRecognizer.startListening({ locale: 'en-US' })
+ * ```
+ */
+export declare const speechRecognizerActiveStateHandler: OnActiveStateChange;
+export {};

package/lib/Recognizer/useRecognizerIsActive.js

@@ -0,0 +1,40 @@
+import { useSyncExternalStore } from 'react';
+const subscribers = new Set();
+let recognizerIsActive = false;
+const getSnapshot = () => {
+    return recognizerIsActive;
+};
+/**
+ * Returns true if the speech recognition session is active.
+ */
+export const useRecognizerIsActive = () => {
+    return useSyncExternalStore((subscriber) => {
+        subscribers.add(subscriber);
+        return () => subscribers.delete(subscriber);
+    }, getSnapshot);
+};
+/**
+ * Direct access to default Speech Recognizer isActive state change handler.
+ *
+ * In case you use static Speech Recognizer:
+ *
+ * ```typescript
+ * import { speechRecognizerActiveStateHandler } from '@gmessier/nitro-speech'
+ *
+ * SpeechRecognizer.onReadyForSpeech = () => {
+ *   speechRecognizerActiveStateHandler(true)
+ * }
+ * SpeechRecognizer.onRecordingStopped = () => {
+ *   speechRecognizerActiveStateHandler(false)
+ * }
+ * ... // setup everything else
+ * SpeechRecognizer.startListening({ locale: 'en-US' })
+ * ```
+ */
+export const speechRecognizerActiveStateHandler = (isActive) => {
+    if (isActive === recognizerIsActive) {
+        return;
+    }
+    recognizerIsActive = isActive;
+    subscribers.forEach((subscriber) => subscriber?.(isActive));
+};

package/lib/Recognizer/useVoiceInputVolume.d.ts

@@ -1,5 +1,5 @@
 import type { RecognizerSpec, VolumeChangeEvent } from './types';
-type OnVolumeChange = RecognizerSpec['onVolumeChange'];
+type OnVolumeChange = Exclude<RecognizerSpec['onVolumeChange'], undefined>;
 /**
  * Subscription to the voice input volume changes
  *

package/lib/index.d.ts

@@ -1,6 +1,7 @@
-export * from './Recognizer/useRecognizer';
-export * from './Recognizer/useVoiceInputVolume';
-export * from './Recognizer/SpeechRecognizer';
-export * from './Recognizer/RecognizerRef';
 export * from './Recognizer/types';
-export * from './NitroSpeech';
+export { useRecognizer } from './Recognizer/useRecognizer';
+export { useVoiceInputVolume, speechRecognizerVolumeChangeHandler, } from './Recognizer/useVoiceInputVolume';
+export { useRecognizerIsActive, speechRecognizerActiveStateHandler, } from './Recognizer/useRecognizerIsActive';
+export { SpeechRecognizer } from './Recognizer/SpeechRecognizer';
+export { RecognizerRef } from './Recognizer/RecognizerRef';
+export { NitroSpeech } from './NitroSpeech';

package/lib/index.js

@@ -1,6 +1,7 @@
-export * from './Recognizer/useRecognizer';
-export * from './Recognizer/useVoiceInputVolume';
-export * from './Recognizer/SpeechRecognizer';
-export * from './Recognizer/RecognizerRef';
 export * from './Recognizer/types';
-export * from './NitroSpeech';
+export { useRecognizer } from './Recognizer/useRecognizer';
+export { useVoiceInputVolume, speechRecognizerVolumeChangeHandler, } from './Recognizer/useVoiceInputVolume';
+export { useRecognizerIsActive, speechRecognizerActiveStateHandler, } from './Recognizer/useRecognizerIsActive';
+export { SpeechRecognizer } from './Recognizer/SpeechRecognizer';
+export { RecognizerRef } from './Recognizer/RecognizerRef';
+export { NitroSpeech } from './NitroSpeech';

package/lib/specs/Recognizer.nitro.d.ts

@@ -52,6 +52,10 @@ export interface Recognizer extends HybridObject<{
      * Returns true if the speech recognition is active.
      */
     getIsActive(): boolean;
+    /**
+     * Returns the current voice input volume.
+     */
+    getVoiceInputVolume(): VolumeChangeEvent;
     /**
      * Returns a list of supported locales.
      *
@@ -67,11 +71,11 @@ export interface Recognizer extends HybridObject<{
      */
     onRecordingStopped?: () => void;
     /**
-     * Called each time either a new batch has been added or the last batch has been updated.
+     * Fires each time either a new batch has been added or the last batch has been updated.
      */
     onResult?: (resultBatches: string[]) => void;
     /**
-     * Called every {@linkcode SpeechRecognitionConfig.autoFinishProgressIntervalMs} or 1000ms
+     * Fires every {@linkcode SpeechRecognitionConfig.autoFinishProgressIntervalMs} or 1000ms
      *
      * Time left in milliseconds until the timer stops.
      *
@@ -87,9 +91,7 @@ export interface Recognizer extends HybridObject<{
      */
     onPermissionDenied?: () => void;
     /**
-     * Called with high and arbitrary frequency (many times per second) while audio recording is active.
-     *
-     * @warning overriding it will disable the built-in `useVoiceInputVolume` hook.
+     * Fires with high and arbitrary frequency (many times per second) while audio recording is active.
      */
     onVolumeChange?: (event: VolumeChangeEvent) => void;
 }

package/nitrogen/generated/android/c++/JHybridRecognizerSpec.cpp

@@ -233,6 +233,11 @@ namespace margelo::nitro::nitrospeech {
     auto __result = method(_javaPart);
     return static_cast<bool>(__result);
   }
+  VolumeChangeEvent JHybridRecognizerSpec::getVoiceInputVolume() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<JVolumeChangeEvent>()>("getVoiceInputVolume");
+    auto __result = method(_javaPart);
+    return __result->toCpp();
+  }
   std::vector<std::string> JHybridRecognizerSpec::getSupportedLocalesIOS() {
     static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JArrayClass<jni::JString>>()>("getSupportedLocalesIOS");
     auto __result = method(_javaPart);

package/nitrogen/generated/android/c++/JHybridRecognizerSpec.hpp

@@ -74,6 +74,7 @@ namespace margelo::nitro::nitrospeech {
     void addAutoFinishTime(std::optional<double> additionalTimeMs) override;
     void updateConfig(const std::optional<MutableSpeechRecognitionConfig>& newConfig, std::optional<bool> resetAutoFinishTime) override;
     bool getIsActive() override;
+    VolumeChangeEvent getVoiceInputVolume() override;
     std::vector<std::string> getSupportedLocalesIOS() override;
 
   private:

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitrospeech/HybridRecognizerSpec.kt

@@ -153,6 +153,10 @@ abstract class HybridRecognizerSpec: HybridObject() {
   @Keep
   abstract fun getIsActive(): Boolean
   
+  @DoNotStrip
+  @Keep
+  abstract fun getVoiceInputVolume(): VolumeChangeEvent
+  
   @DoNotStrip
   @Keep
   abstract fun getSupportedLocalesIOS(): Array<String>

package/nitrogen/generated/ios/NitroSpeech-Swift-Cxx-Bridge.hpp

@@ -454,6 +454,15 @@ namespace margelo::nitro::nitrospeech::bridge::swift {
     return Result<bool>::withError(error);
   }
   
+  // pragma MARK: Result<VolumeChangeEvent>
+  using Result_VolumeChangeEvent_ = Result<VolumeChangeEvent>;
+  inline Result_VolumeChangeEvent_ create_Result_VolumeChangeEvent_(const VolumeChangeEvent& value) noexcept {
+    return Result<VolumeChangeEvent>::withValue(value);
+  }
+  inline Result_VolumeChangeEvent_ create_Result_VolumeChangeEvent_(const std::exception_ptr& error) noexcept {
+    return Result<VolumeChangeEvent>::withError(error);
+  }
+  
   // pragma MARK: Result<std::vector<std::string>>
   using Result_std__vector_std__string__ = Result<std::vector<std::string>>;
   inline Result_std__vector_std__string__ create_Result_std__vector_std__string__(const std::vector<std::string>& value) noexcept {

package/nitrogen/generated/ios/c++/HybridRecognizerSpecSwift.hpp

@@ -178,6 +178,14 @@ namespace margelo::nitro::nitrospeech {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline VolumeChangeEvent getVoiceInputVolume() override {
+      auto __result = _swiftPart.getVoiceInputVolume();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline std::vector<std::string> getSupportedLocalesIOS() override {
       auto __result = _swiftPart.getSupportedLocalesIOS();
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/HybridRecognizerSpec.swift

@@ -26,6 +26,7 @@ public protocol HybridRecognizerSpec_protocol: HybridObject {
   func addAutoFinishTime(additionalTimeMs: Double?) throws -> Void
   func updateConfig(newConfig: MutableSpeechRecognitionConfig?, resetAutoFinishTime: Bool?) throws -> Void
   func getIsActive() throws -> Bool
+  func getVoiceInputVolume() throws -> VolumeChangeEvent
   func getSupportedLocalesIOS() throws -> [String]
 }
 

package/nitrogen/generated/ios/swift/HybridRecognizerSpec_cxx.swift

@@ -452,6 +452,18 @@ open class HybridRecognizerSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func getVoiceInputVolume() -> bridge.Result_VolumeChangeEvent_ {
+    do {
+      let __result = try self.__implementation.getVoiceInputVolume()
+      let __resultCpp = __result
+      return bridge.create_Result_VolumeChangeEvent_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_VolumeChangeEvent_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func getSupportedLocalesIOS() -> bridge.Result_std__vector_std__string__ {
     do {

package/nitrogen/generated/shared/c++/HybridRecognizerSpec.cpp

@@ -35,6 +35,7 @@ namespace margelo::nitro::nitrospeech {
       prototype.registerHybridMethod("addAutoFinishTime", &HybridRecognizerSpec::addAutoFinishTime);
       prototype.registerHybridMethod("updateConfig", &HybridRecognizerSpec::updateConfig);
       prototype.registerHybridMethod("getIsActive", &HybridRecognizerSpec::getIsActive);
+      prototype.registerHybridMethod("getVoiceInputVolume", &HybridRecognizerSpec::getVoiceInputVolume);
       prototype.registerHybridMethod("getSupportedLocalesIOS", &HybridRecognizerSpec::getSupportedLocalesIOS);
     });
   }

package/nitrogen/generated/shared/c++/HybridRecognizerSpec.hpp

@@ -80,6 +80,7 @@ namespace margelo::nitro::nitrospeech {
       virtual void addAutoFinishTime(std::optional<double> additionalTimeMs) = 0;
       virtual void updateConfig(const std::optional<MutableSpeechRecognitionConfig>& newConfig, std::optional<bool> resetAutoFinishTime) = 0;
       virtual bool getIsActive() = 0;
+      virtual VolumeChangeEvent getVoiceInputVolume() = 0;
       virtual std::vector<std::string> getSupportedLocalesIOS() = 0;
 
     protected:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmessier/nitro-speech",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "React Native Real-time Speech Recognition Library powered by Nitro Modules",
   "main": "./lib/index.js",
   "module": "./lib/index.js",

package/src/Recognizer/RecognizerRef.ts

@@ -7,10 +7,13 @@ import {
   recognizerStartListening,
   recognizerStopListening,
   recognizerUpdateConfig,
+  recognizerGetVoiceInputVolume,
 } from './methods'
 
 /**
  * Safe cross-component reference to the Speech Recognizer methods.
+ *
+ * All methods support worklets and UI thread calls
  */
 export const RecognizerRef: RecognizerMethods = {
   startListening: recognizerStartListening,
@@ -19,5 +22,6 @@ export const RecognizerRef: RecognizerMethods = {
   addAutoFinishTime: recognizerAddAutoFinishTime,
   updateConfig: recognizerUpdateConfig,
   getIsActive: recognizerGetIsActive,
+  getVoiceInputVolume: recognizerGetVoiceInputVolume,
   getSupportedLocalesIOS: recognizerGetSupportedLocalesIOS,
 }

package/src/Recognizer/methods.ts

@@ -34,6 +34,11 @@ export const recognizerGetIsActive = () => {
   return SpeechRecognizer.getIsActive()
 }
 
+export const recognizerGetVoiceInputVolume = () => {
+  'worklet'
+  return SpeechRecognizer.getVoiceInputVolume()
+}
+
 export const recognizerGetSupportedLocalesIOS = () => {
   'worklet'
   return SpeechRecognizer.getSupportedLocalesIOS().sort()

package/src/Recognizer/types.ts

@@ -21,6 +21,7 @@ type RecognizerMethods = Pick<
   | 'addAutoFinishTime'
   | 'updateConfig'
   | 'getIsActive'
+  | 'getVoiceInputVolume'
   | 'getSupportedLocalesIOS'
 >
 

package/src/Recognizer/useRecognizer.ts

@@ -7,10 +7,12 @@ import {
   recognizerGetSupportedLocalesIOS,
   recognizerStartListening,
   recognizerStopListening,
+  recognizerGetVoiceInputVolume,
 } from './methods'
 import type { RecognizerCallbacks, RecognizerMethods } from './types'
 import { SpeechRecognizer } from './SpeechRecognizer'
 import { speechRecognizerVolumeChangeHandler } from './useVoiceInputVolume'
+import { speechRecognizerActiveStateHandler } from './useRecognizerIsActive'
 
 /**
  * Safe, lifecycle-aware hook to use the recognizer.
@@ -30,17 +32,12 @@ export const useRecognizer = (
   destroyDeps: DependencyList = []
 ): RecognizerMethods => {
   useEffect(() => {
-    if (callbacks.onVolumeChange) {
-      SpeechRecognizer.onVolumeChange = (event) => {
-        callbacks.onVolumeChange?.(event)
-      }
-    } else {
-      SpeechRecognizer.onVolumeChange = speechRecognizerVolumeChangeHandler
-    }
     SpeechRecognizer.onReadyForSpeech = () => {
+      speechRecognizerActiveStateHandler(true)
       callbacks.onReadyForSpeech?.()
     }
     SpeechRecognizer.onRecordingStopped = () => {
+      speechRecognizerActiveStateHandler(false)
       callbacks.onRecordingStopped?.()
     }
     SpeechRecognizer.onResult = (resultBatches: string[]) => {
@@ -55,6 +52,10 @@ export const useRecognizer = (
     SpeechRecognizer.onPermissionDenied = () => {
       callbacks.onPermissionDenied?.()
     }
+    SpeechRecognizer.onVolumeChange = (event) => {
+      speechRecognizerVolumeChangeHandler(event)
+      callbacks.onVolumeChange?.(event)
+    }
     return () => {
       SpeechRecognizer.onReadyForSpeech = undefined
       SpeechRecognizer.onRecordingStopped = undefined
@@ -80,6 +81,7 @@ export const useRecognizer = (
     addAutoFinishTime: recognizerAddAutoFinishTime,
     updateConfig: recognizerUpdateConfig,
     getIsActive: recognizerGetIsActive,
+    getVoiceInputVolume: recognizerGetVoiceInputVolume,
     getSupportedLocalesIOS: recognizerGetSupportedLocalesIOS,
   }
 }

package/src/Recognizer/useRecognizerIsActive.ts

@@ -0,0 +1,49 @@
+import { useSyncExternalStore } from 'react'
+
+type OnActiveStateChange = (isActive: boolean) => void
+
+const subscribers = new Set<OnActiveStateChange>()
+
+let recognizerIsActive = false
+
+const getSnapshot = () => {
+  return recognizerIsActive
+}
+
+/**
+ * Returns true if the speech recognition session is active.
+ */
+export const useRecognizerIsActive = () => {
+  return useSyncExternalStore((subscriber) => {
+    subscribers.add(subscriber)
+    return () => subscribers.delete(subscriber)
+  }, getSnapshot)
+}
+
+/**
+ * Direct access to default Speech Recognizer isActive state change handler.
+ *
+ * In case you use static Speech Recognizer:
+ *
+ * ```typescript
+ * import { speechRecognizerActiveStateHandler } from '@gmessier/nitro-speech'
+ *
+ * SpeechRecognizer.onReadyForSpeech = () => {
+ *   speechRecognizerActiveStateHandler(true)
+ * }
+ * SpeechRecognizer.onRecordingStopped = () => {
+ *   speechRecognizerActiveStateHandler(false)
+ * }
+ * ... // setup everything else
+ * SpeechRecognizer.startListening({ locale: 'en-US' })
+ * ```
+ */
+export const speechRecognizerActiveStateHandler: OnActiveStateChange = (
+  isActive
+) => {
+  if (isActive === recognizerIsActive) {
+    return
+  }
+  recognizerIsActive = isActive
+  subscribers.forEach((subscriber) => subscriber?.(isActive))
+}

package/src/Recognizer/useVoiceInputVolume.ts

@@ -1,7 +1,7 @@
 import { useSyncExternalStore } from 'react'
 import type { RecognizerSpec, VolumeChangeEvent } from './types'
 
-type OnVolumeChange = RecognizerSpec['onVolumeChange']
+type OnVolumeChange = Exclude<RecognizerSpec['onVolumeChange'], undefined>
 
 const subscribers = new Set<OnVolumeChange>()
 

package/src/index.ts

@@ -1,6 +1,13 @@
-export * from './Recognizer/useRecognizer'
-export * from './Recognizer/useVoiceInputVolume'
-export * from './Recognizer/SpeechRecognizer'
-export * from './Recognizer/RecognizerRef'
 export * from './Recognizer/types'
-export * from './NitroSpeech'
+export { useRecognizer } from './Recognizer/useRecognizer'
+export {
+  useVoiceInputVolume,
+  speechRecognizerVolumeChangeHandler,
+} from './Recognizer/useVoiceInputVolume'
+export {
+  useRecognizerIsActive,
+  speechRecognizerActiveStateHandler,
+} from './Recognizer/useRecognizerIsActive'
+export { SpeechRecognizer } from './Recognizer/SpeechRecognizer'
+export { RecognizerRef } from './Recognizer/RecognizerRef'
+export { NitroSpeech } from './NitroSpeech'

package/src/specs/Recognizer.nitro.ts

@@ -66,6 +66,11 @@ export interface Recognizer extends HybridObject<{
    */
   getIsActive(): boolean
 
+  /**
+   * Returns the current voice input volume.
+   */
+  getVoiceInputVolume(): VolumeChangeEvent
+
   /**
    * Returns a list of supported locales.
    *
@@ -82,11 +87,11 @@ export interface Recognizer extends HybridObject<{
    */
   onRecordingStopped?: () => void
   /**
-   * Called each time either a new batch has been added or the last batch has been updated.
+   * Fires each time either a new batch has been added or the last batch has been updated.
    */
   onResult?: (resultBatches: string[]) => void
   /**
-   * Called every {@linkcode SpeechRecognitionConfig.autoFinishProgressIntervalMs} or 1000ms
+   * Fires every {@linkcode SpeechRecognitionConfig.autoFinishProgressIntervalMs} or 1000ms
    *
    * Time left in milliseconds until the timer stops.
    *
@@ -102,9 +107,7 @@ export interface Recognizer extends HybridObject<{
    */
   onPermissionDenied?: () => void
   /**
-   * Called with high and arbitrary frequency (many times per second) while audio recording is active.
-   *
-   * @warning overriding it will disable the built-in `useVoiceInputVolume` hook.
+   * Fires with high and arbitrary frequency (many times per second) while audio recording is active.
    */
   onVolumeChange?: (event: VolumeChangeEvent) => void
 }