@gmessier/nitro-speech 0.3.3 → 0.4.1

package/nitrogen/generated/shared/c++/{SpeechToTextParams.hpp → SpeechRecognitionConfig.hpp}

@@ -1,5 +1,5 @@
 ///
-/// SpeechToTextParams.hpp
+/// SpeechRecognitionConfig.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © Marc Rousavy @ Margelo
@@ -30,75 +30,90 @@
 
 // Forward declaration of `HapticFeedbackStyle` to properly resolve imports.
 namespace margelo::nitro::nitrospeech { enum class HapticFeedbackStyle; }
+// Forward declaration of `IosPreset` to properly resolve imports.
+namespace margelo::nitro::nitrospeech { enum class IosPreset; }
 
 #include <string>
 #include <optional>
 #include <vector>
 #include "HapticFeedbackStyle.hpp"
+#include "IosPreset.hpp"
 
 namespace margelo::nitro::nitrospeech {
 
   /**
-   * A struct which can be represented as a JavaScript object (SpeechToTextParams).
+   * A struct which can be represented as a JavaScript object (SpeechRecognitionConfig).
    */
-  struct SpeechToTextParams final {
+  struct SpeechRecognitionConfig final {
   public:
     std::optional<std::string> locale     SWIFT_PRIVATE;
+    std::optional<std::vector<std::string>> contextualStrings     SWIFT_PRIVATE;
+    std::optional<bool> maskOffensiveWords     SWIFT_PRIVATE;
     std::optional<double> autoFinishRecognitionMs     SWIFT_PRIVATE;
+    std::optional<double> autoFinishProgressIntervalMs     SWIFT_PRIVATE;
+    std::optional<double> resetAutoFinishVoiceSensitivity     SWIFT_PRIVATE;
     std::optional<bool> disableRepeatingFilter     SWIFT_PRIVATE;
-    std::optional<std::vector<std::string>> contextualStrings     SWIFT_PRIVATE;
     std::optional<HapticFeedbackStyle> startHapticFeedbackStyle     SWIFT_PRIVATE;
     std::optional<HapticFeedbackStyle> stopHapticFeedbackStyle     SWIFT_PRIVATE;
-    std::optional<bool> maskOffensiveWords     SWIFT_PRIVATE;
     std::optional<bool> androidFormattingPreferQuality     SWIFT_PRIVATE;
     std::optional<bool> androidUseWebSearchModel     SWIFT_PRIVATE;
     std::optional<bool> androidDisableBatchHandling     SWIFT_PRIVATE;
     std::optional<bool> iosAddPunctuation     SWIFT_PRIVATE;
+    std::optional<IosPreset> iosPreset     SWIFT_PRIVATE;
+    std::optional<bool> iosAtypicalSpeech     SWIFT_PRIVATE;
 
   public:
-    SpeechToTextParams() = default;
-    explicit SpeechToTextParams(std::optional<std::string> locale, std::optional<double> autoFinishRecognitionMs, std::optional<bool> disableRepeatingFilter, std::optional<std::vector<std::string>> contextualStrings, std::optional<HapticFeedbackStyle> startHapticFeedbackStyle, std::optional<HapticFeedbackStyle> stopHapticFeedbackStyle, std::optional<bool> maskOffensiveWords, std::optional<bool> androidFormattingPreferQuality, std::optional<bool> androidUseWebSearchModel, std::optional<bool> androidDisableBatchHandling, std::optional<bool> iosAddPunctuation): locale(locale), autoFinishRecognitionMs(autoFinishRecognitionMs), disableRepeatingFilter(disableRepeatingFilter), contextualStrings(contextualStrings), startHapticFeedbackStyle(startHapticFeedbackStyle), stopHapticFeedbackStyle(stopHapticFeedbackStyle), maskOffensiveWords(maskOffensiveWords), androidFormattingPreferQuality(androidFormattingPreferQuality), androidUseWebSearchModel(androidUseWebSearchModel), androidDisableBatchHandling(androidDisableBatchHandling), iosAddPunctuation(iosAddPunctuation) {}
+    SpeechRecognitionConfig() = default;
+    explicit SpeechRecognitionConfig(std::optional<std::string> locale, std::optional<std::vector<std::string>> contextualStrings, std::optional<bool> maskOffensiveWords, std::optional<double> autoFinishRecognitionMs, std::optional<double> autoFinishProgressIntervalMs, std::optional<double> resetAutoFinishVoiceSensitivity, std::optional<bool> disableRepeatingFilter, std::optional<HapticFeedbackStyle> startHapticFeedbackStyle, std::optional<HapticFeedbackStyle> stopHapticFeedbackStyle, std::optional<bool> androidFormattingPreferQuality, std::optional<bool> androidUseWebSearchModel, std::optional<bool> androidDisableBatchHandling, std::optional<bool> iosAddPunctuation, std::optional<IosPreset> iosPreset, std::optional<bool> iosAtypicalSpeech): locale(locale), contextualStrings(contextualStrings), maskOffensiveWords(maskOffensiveWords), autoFinishRecognitionMs(autoFinishRecognitionMs), autoFinishProgressIntervalMs(autoFinishProgressIntervalMs), resetAutoFinishVoiceSensitivity(resetAutoFinishVoiceSensitivity), disableRepeatingFilter(disableRepeatingFilter), startHapticFeedbackStyle(startHapticFeedbackStyle), stopHapticFeedbackStyle(stopHapticFeedbackStyle), androidFormattingPreferQuality(androidFormattingPreferQuality), androidUseWebSearchModel(androidUseWebSearchModel), androidDisableBatchHandling(androidDisableBatchHandling), iosAddPunctuation(iosAddPunctuation), iosPreset(iosPreset), iosAtypicalSpeech(iosAtypicalSpeech) {}
 
   public:
-    friend bool operator==(const SpeechToTextParams& lhs, const SpeechToTextParams& rhs) = default;
+    friend bool operator==(const SpeechRecognitionConfig& lhs, const SpeechRecognitionConfig& rhs) = default;
   };
 
 } // namespace margelo::nitro::nitrospeech
 
 namespace margelo::nitro {
 
-  // C++ SpeechToTextParams <> JS SpeechToTextParams (object)
+  // C++ SpeechRecognitionConfig <> JS SpeechRecognitionConfig (object)
   template <>
-  struct JSIConverter<margelo::nitro::nitrospeech::SpeechToTextParams> final {
-    static inline margelo::nitro::nitrospeech::SpeechToTextParams fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+  struct JSIConverter<margelo::nitro::nitrospeech::SpeechRecognitionConfig> final {
+    static inline margelo::nitro::nitrospeech::SpeechRecognitionConfig fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
-      return margelo::nitro::nitrospeech::SpeechToTextParams(
+      return margelo::nitro::nitrospeech::SpeechRecognitionConfig(
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "locale"))),
+        JSIConverter<std::optional<std::vector<std::string>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "contextualStrings"))),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "maskOffensiveWords"))),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoFinishRecognitionMs"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoFinishProgressIntervalMs"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "resetAutoFinishVoiceSensitivity"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "disableRepeatingFilter"))),
-        JSIConverter<std::optional<std::vector<std::string>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "contextualStrings"))),
         JSIConverter<std::optional<margelo::nitro::nitrospeech::HapticFeedbackStyle>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "startHapticFeedbackStyle"))),
         JSIConverter<std::optional<margelo::nitro::nitrospeech::HapticFeedbackStyle>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "stopHapticFeedbackStyle"))),
-        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "maskOffensiveWords"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidFormattingPreferQuality"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidUseWebSearchModel"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidDisableBatchHandling"))),
-        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosAddPunctuation")))
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosAddPunctuation"))),
+        JSIConverter<std::optional<margelo::nitro::nitrospeech::IosPreset>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosPreset"))),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosAtypicalSpeech")))
       );
     }
-    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitrospeech::SpeechToTextParams& arg) {
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitrospeech::SpeechRecognitionConfig& arg) {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "locale"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.locale));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "contextualStrings"), JSIConverter<std::optional<std::vector<std::string>>>::toJSI(runtime, arg.contextualStrings));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "maskOffensiveWords"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.maskOffensiveWords));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "autoFinishRecognitionMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.autoFinishRecognitionMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "autoFinishProgressIntervalMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.autoFinishProgressIntervalMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "resetAutoFinishVoiceSensitivity"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.resetAutoFinishVoiceSensitivity));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "disableRepeatingFilter"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.disableRepeatingFilter));
-      obj.setProperty(runtime, PropNameIDCache::get(runtime, "contextualStrings"), JSIConverter<std::optional<std::vector<std::string>>>::toJSI(runtime, arg.contextualStrings));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "startHapticFeedbackStyle"), JSIConverter<std::optional<margelo::nitro::nitrospeech::HapticFeedbackStyle>>::toJSI(runtime, arg.startHapticFeedbackStyle));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "stopHapticFeedbackStyle"), JSIConverter<std::optional<margelo::nitro::nitrospeech::HapticFeedbackStyle>>::toJSI(runtime, arg.stopHapticFeedbackStyle));
-      obj.setProperty(runtime, PropNameIDCache::get(runtime, "maskOffensiveWords"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.maskOffensiveWords));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "androidFormattingPreferQuality"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.androidFormattingPreferQuality));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "androidUseWebSearchModel"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.androidUseWebSearchModel));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "androidDisableBatchHandling"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.androidDisableBatchHandling));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "iosAddPunctuation"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.iosAddPunctuation));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "iosPreset"), JSIConverter<std::optional<margelo::nitro::nitrospeech::IosPreset>>::toJSI(runtime, arg.iosPreset));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "iosAtypicalSpeech"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.iosAtypicalSpeech));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -110,16 +125,20 @@ namespace margelo::nitro {
         return false;
       }
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "locale")))) return false;
+      if (!JSIConverter<std::optional<std::vector<std::string>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "contextualStrings")))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "maskOffensiveWords")))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoFinishRecognitionMs")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoFinishProgressIntervalMs")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "resetAutoFinishVoiceSensitivity")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "disableRepeatingFilter")))) return false;
-      if (!JSIConverter<std::optional<std::vector<std::string>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "contextualStrings")))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::nitrospeech::HapticFeedbackStyle>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "startHapticFeedbackStyle")))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::nitrospeech::HapticFeedbackStyle>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "stopHapticFeedbackStyle")))) return false;
-      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "maskOffensiveWords")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidFormattingPreferQuality")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidUseWebSearchModel")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidDisableBatchHandling")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosAddPunctuation")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::nitrospeech::IosPreset>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosPreset")))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "iosAtypicalSpeech")))) return false;
       return true;
     }
   };

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

@@ -0,0 +1,91 @@
+///
+/// VolumeChangeEvent.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <optional>
+
+namespace margelo::nitro::nitrospeech {
+
+  /**
+   * A struct which can be represented as a JavaScript object (VolumeChangeEvent).
+   */
+  struct VolumeChangeEvent final {
+  public:
+    double smoothedVolume     SWIFT_PRIVATE;
+    double rawVolume     SWIFT_PRIVATE;
+    std::optional<double> db     SWIFT_PRIVATE;
+
+  public:
+    VolumeChangeEvent() = default;
+    explicit VolumeChangeEvent(double smoothedVolume, double rawVolume, std::optional<double> db): smoothedVolume(smoothedVolume), rawVolume(rawVolume), db(db) {}
+
+  public:
+    friend bool operator==(const VolumeChangeEvent& lhs, const VolumeChangeEvent& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitrospeech
+
+namespace margelo::nitro {
+
+  // C++ VolumeChangeEvent <> JS VolumeChangeEvent (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitrospeech::VolumeChangeEvent> final {
+    static inline margelo::nitro::nitrospeech::VolumeChangeEvent fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitrospeech::VolumeChangeEvent(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "smoothedVolume"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "rawVolume"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "db")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitrospeech::VolumeChangeEvent& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "smoothedVolume"), JSIConverter<double>::toJSI(runtime, arg.smoothedVolume));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "rawVolume"), JSIConverter<double>::toJSI(runtime, arg.rawVolume));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "db"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.db));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "smoothedVolume")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "rawVolume")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "db")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@gmessier/nitro-speech",
-  "version": "0.3.3",
-  "description": "React Native Speech Recognition Library powered by Nitro Modules",
-  "main": "./lib/commonjs/index.js",
-  "module": "./lib/module/index.js",
-  "types": "./lib/typescript/index.d.ts",
-  "react-native": "./lib/module/index.js",
-  "source": "src/index.ts",
+  "version": "0.4.1",
+  "description": "React Native Real-time Speech Recognition Library powered by Nitro Modules",
+  "main": "./lib/index.js",
+  "module": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
   "files": [
     "src",
     "react-native.config.js",
@@ -15,7 +15,6 @@
     "android/build.gradle",
     "android/gradle.properties",
     "android/fix-prefab.gradle",
-    "android/proguard-rules.pro",
     "android/CMakeLists.txt",
     "android/src",
     "ios/**/*.h",
@@ -26,16 +25,15 @@
     "app.plugin.js",
     "nitro.json",
     "*.podspec",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf android/build node_modules/**/android/build lib",
+    "build": "rm -rf lib && rm -f tsconfig.tsbuildinfo && bun tsc",
     "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
-    "lint-ci": "eslint \"**/*.{js,ts,tsx}\" -f @jamesacarr/github-actions",
-    "typescript": "tsc",
-    "build": "rm -rf lib && npm run typecheck && bob build",
-    "specs": "tsc --noEmit false && nitrogen --logLevel=\"debug\""
+    "nitro": "rm -rf nitrogen && npx nitrogen@latest",
+    "localnitro": "rm -rf nitrogen && node ../../../nitro/nitro/packages/nitrogen/lib/index.js"
   },
   "keywords": [
     "react-native",
@@ -50,6 +48,7 @@
     "voice",
     "voice-recognition",
     "transcription",
+    "transcriber",
     "audio",
     "microphone",
     "nitro",
@@ -81,8 +80,8 @@
     "prettier": "^3.3.3",
     "react": "19.2.4",
     "react-native": "0.84.1",
-    "react-native-nitro-modules": "0.35.4",
-    "nitrogen": "0.35.4",
+    "react-native-nitro-modules": "0.35.6",
+    "nitrogen": "0.35.6",
     "react-native-builder-bob": "0.37.0",
     "typescript": "^5.8.3"
   },

package/src/NitroSpeech.ts

@@ -0,0 +1,5 @@
+import { NitroModules } from 'react-native-nitro-modules'
+import type { NitroSpeech as NitroSpeechSpec } from './specs/NitroSpeech.nitro'
+
+export const NitroSpeech =
+  NitroModules.createHybridObject<NitroSpeechSpec>('NitroSpeech')

package/src/Recognizer/RecognizerRef.ts

@@ -0,0 +1,27 @@
+import type { RecognizerMethods } from './types'
+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: RecognizerMethods = {
+  startListening: recognizerStartListening,
+  stopListening: recognizerStopListening,
+  resetAutoFinishTime: recognizerResetAutoFinishTime,
+  addAutoFinishTime: recognizerAddAutoFinishTime,
+  updateConfig: recognizerUpdateConfig,
+  getIsActive: recognizerGetIsActive,
+  getVoiceInputVolume: recognizerGetVoiceInputVolume,
+  getSupportedLocalesIOS: recognizerGetSupportedLocalesIOS,
+}

package/src/Recognizer/SpeechRecognizer.ts

@@ -0,0 +1,10 @@
+import { NitroSpeech } from '../NitroSpeech'
+
+/**
+ * Static Speech Recognizer instance.
+ *
+ * Direct access to the all Speech Recognizer methods and callbacks.
+ *
+ * @note unsafe, might lead to race conditions
+ */
+export const SpeechRecognizer = NitroSpeech.recognizer

package/src/Recognizer/methods.ts

@@ -0,0 +1,45 @@
+import { SpeechRecognizer } from './SpeechRecognizer'
+import type { SpeechRecognitionConfig } from './types'
+
+export const recognizerStartListening = (params: SpeechRecognitionConfig) => {
+  'worklet'
+  SpeechRecognizer.startListening(params)
+}
+
+export const recognizerStopListening = () => {
+  'worklet'
+  SpeechRecognizer.stopListening()
+}
+
+export const recognizerResetAutoFinishTime = () => {
+  'worklet'
+  SpeechRecognizer.resetAutoFinishTime()
+}
+
+export const recognizerAddAutoFinishTime = (additionalTimeMs?: number) => {
+  'worklet'
+  SpeechRecognizer.addAutoFinishTime(additionalTimeMs)
+}
+
+export const recognizerUpdateConfig = (
+  newConfig: SpeechRecognitionConfig,
+  resetAutoFinishTime?: boolean
+) => {
+  'worklet'
+  SpeechRecognizer.updateConfig(newConfig, resetAutoFinishTime)
+}
+
+export const recognizerGetIsActive = () => {
+  'worklet'
+  return SpeechRecognizer.getIsActive()
+}
+
+export const recognizerGetVoiceInputVolume = () => {
+  'worklet'
+  return SpeechRecognizer.getVoiceInputVolume()
+}
+
+export const recognizerGetSupportedLocalesIOS = () => {
+  'worklet'
+  return SpeechRecognizer.getSupportedLocalesIOS().sort()
+}

package/src/Recognizer/types.ts

@@ -0,0 +1,34 @@
+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'
+  | 'getVoiceInputVolume'
+  | 'getSupportedLocalesIOS'
+>
+
+export type {
+  RecognizerSpec,
+  SpeechRecognitionConfig,
+  VolumeChangeEvent,
+  RecognizerCallbacks,
+  RecognizerMethods,
+}

package/src/Recognizer/useRecognizer.ts

@@ -0,0 +1,87 @@
+import { useEffect, type DependencyList } from 'react'
+import {
+  recognizerResetAutoFinishTime,
+  recognizerAddAutoFinishTime,
+  recognizerUpdateConfig,
+  recognizerGetIsActive,
+  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.
+ *
+ * @param callbacks - The callbacks to use for the recognizer.
+ * @param destroyDeps - The additional dependencies to use for the cleanup effect.
+ *
+ * Example: To cleanup when the screen is unfocused.
+ *
+ * ```typescript
+ * const isFocused = useIsFocused()
+ * useRecognizer({ ... }, [isFocused])
+ * ```
+ */
+export const useRecognizer = (
+  callbacks: RecognizerCallbacks,
+  destroyDeps: DependencyList = []
+): RecognizerMethods => {
+  useEffect(() => {
+    SpeechRecognizer.onReadyForSpeech = () => {
+      speechRecognizerActiveStateHandler(true)
+      callbacks.onReadyForSpeech?.()
+    }
+    SpeechRecognizer.onRecordingStopped = () => {
+      speechRecognizerActiveStateHandler(false)
+      callbacks.onRecordingStopped?.()
+    }
+    SpeechRecognizer.onResult = (resultBatches: string[]) => {
+      callbacks.onResult?.(resultBatches)
+    }
+    SpeechRecognizer.onAutoFinishProgress = (timeLeftMs: number) => {
+      callbacks.onAutoFinishProgress?.(timeLeftMs)
+    }
+    SpeechRecognizer.onError = (message: string) => {
+      callbacks.onError?.(message)
+    }
+    SpeechRecognizer.onPermissionDenied = () => {
+      callbacks.onPermissionDenied?.()
+    }
+    SpeechRecognizer.onVolumeChange = (event) => {
+      speechRecognizerVolumeChangeHandler(event)
+      callbacks.onVolumeChange?.(event)
+    }
+    return () => {
+      SpeechRecognizer.onReadyForSpeech = undefined
+      SpeechRecognizer.onRecordingStopped = undefined
+      SpeechRecognizer.onResult = undefined
+      SpeechRecognizer.onAutoFinishProgress = undefined
+      SpeechRecognizer.onError = undefined
+      SpeechRecognizer.onPermissionDenied = undefined
+      SpeechRecognizer.onVolumeChange = undefined
+    }
+  }, [callbacks])
+
+  useEffect(() => {
+    return () => {
+      SpeechRecognizer.stopListening()
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [...destroyDeps])
+
+  return {
+    startListening: recognizerStartListening,
+    stopListening: recognizerStopListening,
+    resetAutoFinishTime: recognizerResetAutoFinishTime,
+    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

@@ -0,0 +1,65 @@
+import { useSyncExternalStore } from 'react'
+import type { RecognizerSpec, VolumeChangeEvent } from './types'
+
+type OnVolumeChange = Exclude<RecognizerSpec['onVolumeChange'], undefined>
+
+const subscribers = new Set<OnVolumeChange>()
+
+let current: VolumeChangeEvent = {
+  smoothedVolume: 0,
+  rawVolume: 0,
+  db: undefined,
+}
+
+let snapshot: VolumeChangeEvent = { ...current }
+
+const getSnapshot = () => {
+  if (
+    snapshot.smoothedVolume === current.smoothedVolume &&
+    snapshot.rawVolume === current.rawVolume &&
+    snapshot.db === current.db
+  ) {
+    return snapshot
+  }
+  snapshot = { ...current }
+  return snapshot
+}
+
+/**
+ * Subscription to the voice input volume changes
+ *
+ * Updates with arbitrary frequency (many times per second) while audio recording is active.
+ *
+ * @returns The current voice input volume normalized to a range of 0 to 1.
+ */
+export const useVoiceInputVolume = () => {
+  return useSyncExternalStore((subscriber) => {
+    subscribers.add(subscriber)
+    return () => subscribers.delete(subscriber)
+  }, getSnapshot)
+}
+
+/**
+ * Direct access to default Speech Recognizer volume change handler.
+ *
+ * In case you use static Speech Recognizer:
+ *
+ * ```typescript
+ * import { speechRecognizerVolumeChangeHandler } from '@gmessier/nitro-speech'
+ *
+ * SpeechRecognizer.onVolumeChange = speechRecognizerVolumeChangeHandler
+ * ... // setup everything else
+ * SpeechRecognizer.startListening({ locale: 'en-US' })
+ * ```
+ */
+export const speechRecognizerVolumeChangeHandler: OnVolumeChange = (event) => {
+  if (
+    event.smoothedVolume === current.smoothedVolume &&
+    event.rawVolume === current.rawVolume &&
+    event.db === current.db
+  ) {
+    return
+  }
+  current = event
+  subscribers.forEach((subscriber) => subscriber?.(event))
+}