react-native-simple-note-pitch-detector 0.6.0 → 0.6.1

package/android/.idea/gradle.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="GradleMigrationSettings" migrationVersion="1" />
   <component name="GradleSettings">
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>

package/android/.idea/misc.xml

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ExternalStorageConfigurationManager" enabled="true" />
   <component name="ProjectRootManager">

package/android/src/main/java/expo/modules/simplenotepitchdetector/PitchAnalyzer.kt

@@ -1,5 +1,6 @@
 package expo.modules.simplepitchdetector
 
+import android.util.Log
 import be.tarsos.dsp.AudioDispatcher
 import be.tarsos.dsp.AudioProcessor
 import be.tarsos.dsp.io.android.AudioDispatcherFactory
@@ -11,6 +12,8 @@ import kotlin.math.round
 import kotlin.math.pow
 import kotlin.math.abs
 
+private const val TAG = "PitchAnalyzer"
+
 data class PitchData(
     val note: String,
     val octave: Int,
@@ -24,6 +27,7 @@ class PitchAnalyzer {
     private val notes = arrayOf("C","C#","D","D#","E","F","F#","G","G#","A","A#","B")
 
     private lateinit var onPitchDetected: (PitchData) -> Unit
+    private var onStatus: ((String, String) -> Unit)? = null
     private var isRecording = false
     private var levelThreshold = -30f
     // Configurable buffer size - can be changed from JS
@@ -43,15 +47,26 @@ class PitchAnalyzer {
         val decibel = e.getdBSPL().toFloat()
         // Only process if above the level threshold
         if (decibel > levelThreshold) {
+            // Note: Not logging every pitch detection to JS to avoid flooding
+            // Use adb logcat for verbose pitch logs
+            Log.v(TAG, "Pitch detected: ${pitchInHz}Hz at ${decibel}dB")
             process(pitchInHz, decibel)
         }
     }
 
     private fun prepare() {
-        processor =
-            PitchProcessor(algorithm, 22050f, bufferSize, handler)
-        dispatcher = AudioDispatcherFactory.fromDefaultMicrophone(22050, bufferSize, 0)
-        dispatcher?.addAudioProcessor(processor)
+        try {
+            logStatus("debug", "prepare() called with bufferSize=$bufferSize, algorithm=$algorithmName")
+            processor = PitchProcessor(algorithm, 22050f, bufferSize, handler)
+            logStatus("debug", "PitchProcessor created successfully")
+            dispatcher = AudioDispatcherFactory.fromDefaultMicrophone(22050, bufferSize, 0)
+            logStatus("debug", "AudioDispatcher created successfully: $dispatcher")
+            dispatcher?.addAudioProcessor(processor)
+            logStatus("debug", "AudioProcessor added to dispatcher")
+        } catch (e: Exception) {
+            logStatus("error", "Error in prepare(): ${e.message}")
+            throw e
+        }
     }
 
     private fun process(pitchInHz: Float, decibel: Float) {
@@ -89,6 +104,20 @@ class PitchAnalyzer {
         this.onPitchDetected = listener
     }
 
+    fun setOnStatusListener(listener: (String, String) -> Unit) {
+        this.onStatus = listener
+    }
+
+    private fun logStatus(level: String, message: String) {
+        when (level) {
+            "debug" -> Log.d(TAG, message)
+            "error" -> Log.e(TAG, message)
+            "verbose" -> Log.v(TAG, message)
+            else -> Log.d(TAG, message)
+        }
+        onStatus?.invoke(level, message)
+    }
+
     fun setLevelThreshold(threshold: Float) {
         this.levelThreshold = threshold
     }
@@ -119,10 +148,18 @@ class PitchAnalyzer {
     }
 
     fun start() {
-        prepare()
-        runner = Thread(dispatcher)
-        runner?.start()
-        isRecording = true
+        try {
+            logStatus("debug", "start() called")
+            prepare()
+            runner = Thread(dispatcher)
+            logStatus("debug", "Thread created, starting...")
+            runner?.start()
+            isRecording = true
+            logStatus("debug", "Recording started successfully")
+        } catch (e: Exception) {
+            logStatus("error", "Error in start(): ${e.message}")
+            isRecording = false
+        }
     }
 
     fun stop() {

package/android/src/main/java/expo/modules/simplenotepitchdetector/ReactNativeSimpleNotePitchDetectorModule.kt

@@ -10,11 +10,21 @@ class ReactNativeSimpleNotePitchDetectorModule : Module() {
 
   private val pitchAnalyzer = PitchAnalyzer()
 
+  private fun sendStatus(level: String, message: String) {
+    this.sendEvent(
+      "onStatus",
+      bundleOf(
+        "level" to level,
+        "message" to message
+      )
+    )
+  }
+
   override fun definition() = ModuleDefinition {
 
     Name("ReactNativeSimpleNotePitchDetector")
 
-    Events("onChangeNote")
+    Events("onChangeNote", "onStatus")
 
     Function("isRecording") {
       pitchAnalyzer.isRecording()
@@ -33,6 +43,10 @@ class ReactNativeSimpleNotePitchDetectorModule : Module() {
         )
       }
 
+      pitchAnalyzer.setOnStatusListener { level: String, message: String ->
+        this@ReactNativeSimpleNotePitchDetectorModule.sendStatus(level, message)
+      }
+
       pitchAnalyzer.start()
     }
 

package/build/index.d.ts

@@ -67,5 +67,15 @@ export declare function setAlgorithm(algorithm: string): any;
  */
 export declare function getAlgorithm(): string;
 export declare function onChangeNote(listener: (event: ChangeEventPayload) => void): Subscription;
+export interface StatusEventPayload {
+    level: "debug" | "error" | "verbose";
+    message: string;
+}
+/**
+ * Listen for status/debug messages from the native module.
+ * Useful for debugging audio initialization issues.
+ * @param listener - Callback that receives status events with level and message
+ */
+export declare function onStatus(listener: (event: StatusEventPayload) => void): Subscription;
 export { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,2CAA2C,EAC5C,MAAM,4CAA4C,CAAC;AAEpD,wBAAgB,KAAK,QAEpB;AAED,wBAAgB,IAAI,QAEnB;AAED,wBAAgB,WAAW,QAE1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,OAElD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAEzC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,OAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAOD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,YAAY,CAEd;AAED,OAAO,EAAE,2CAA2C,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,2CAA2C,EAC5C,MAAM,4CAA4C,CAAC;AAEpD,wBAAgB,KAAK,QAEpB;AAED,wBAAgB,IAAI,QAEnB;AAED,wBAAgB,WAAW,QAE1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,OAElD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAEzC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,OAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAOD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,YAAY,CAEd;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,YAAY,CAEd;AAED,OAAO,EAAE,2CAA2C,EAAE,kBAAkB,EAAE,CAAC"}

package/build/index.js

@@ -87,4 +87,12 @@ const emitter = new EventEmitter(ReactNativeSimpleNotePitchDetectorModule ??
 export function onChangeNote(listener) {
     return emitter.addListener("onChangeNote", listener);
 }
+/**
+ * Listen for status/debug messages from the native module.
+ * Useful for debugging audio initialization issues.
+ * @param listener - Callback that receives status events with level and message
+ */
+export function onStatus(listener) {
+    return emitter.addListener("onStatus", listener);
+}
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,wCAAwC,MAAM,4CAA4C,CAAC;AAMlG,MAAM,UAAU,KAAK;IACnB,OAAO,wCAAwC,CAAC,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,OAAO,wCAAwC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,wCAAwC,CAAC,WAAW,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,wCAAwC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,wCAAwC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,wCAAwC,CAAC,aAAa,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,wCAAwC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,wCAAwC,CAAC,YAAY,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,wCAAwC;IACtC,kBAAkB,CAAC,kCAAkC,CACxD,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,QAA6C;IAE7C,OAAO,OAAO,CAAC,WAAW,CAAqB,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC","sourcesContent":["import {\n  NativeModulesProxy,\n  EventEmitter,\n  Subscription,\n} from \"expo-modules-core\";\n\nimport ReactNativeSimpleNotePitchDetectorModule from \"./ReactNativeSimpleNotePitchDetectorModule\";\nimport {\n  ChangeEventPayload,\n  ReactNativeSimpleNotePitchDetectorViewProps,\n} from \"./ReactNativeSimpleNotePitchDetector.types\";\n\nexport function start() {\n  return ReactNativeSimpleNotePitchDetectorModule.start();\n}\n\nexport function stop() {\n  return ReactNativeSimpleNotePitchDetectorModule.stop();\n}\n\nexport function isRecording() {\n  return ReactNativeSimpleNotePitchDetectorModule.isRecording();\n}\n\n/**\n * Set the minimum audio level threshold for pitch detection.\n * Values are in dB (e.g., -30 means sounds quieter than -30dB are ignored).\n * Lower values = more sensitive (picks up quieter sounds).\n * Default is -30.\n * @param threshold - Level threshold in dB (e.g., -30, -35, -40)\n */\nexport function setLevelThreshold(threshold: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setLevelThreshold(threshold);\n}\n\n/**\n * Set the buffer size for pitch detection.\n * Must be called before start() or will restart the engine if already running.\n *\n * Buffer size affects the trade-off between frequency range and responsiveness:\n * - Smaller buffer (2048-4096): Better for high frequencies, faster response, but less accurate for low notes\n * - Larger buffer (8192-16384): Better for low frequencies, more accurate, but slightly more latency\n *\n * iOS defaults to 8192, Android defaults to 2048.\n *\n * Recommended values:\n * - 4096: Good balance for most use cases\n * - 8192: Better for bass instruments or full piano range (iOS default)\n * - 2048: Better for high-pitched instruments, faster response (Android default)\n *\n * @param size - Buffer size (must be power of 2: 1024, 2048, 4096, 8192, 16384)\n */\nexport function setBufferSize(size: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setBufferSize(size);\n}\n\n/**\n * Get the current buffer size.\n * @returns Current buffer size\n */\nexport function getBufferSize(): number {\n  return ReactNativeSimpleNotePitchDetectorModule.getBufferSize();\n}\n\n/**\n * Set the pitch estimation algorithm.\n * Must be called before start() or will restart the engine if already running.\n *\n * Available algorithms differ by platform:\n *\n * **iOS (Beethoven library):**\n * - \"yin\" (default) - YIN algorithm, good for monophonic instruments\n * - \"hps\" - Harmonic Product Spectrum\n * - \"barycentric\" - Barycentric interpolation\n * - \"quadradic\" - Quadratic interpolation\n * - \"jains\" - Jain's method\n * - \"quinnsFirst\" - Quinn's first estimator\n * - \"quinnsSecond\" - Quinn's second estimator\n * - \"maxValue\" - Maximum value method\n *\n * **Android (TarsosDSP library):**\n * - \"fft_yin\" (default) - FFT-based YIN, faster than pure YIN\n * - \"yin\" - Pure YIN algorithm\n * - \"mpm\" - McLeod Pitch Method, good for speech and music\n * - \"fft_pitch\" - FFT bin with most energy\n * - \"dynamic_wavelet\" - Dynamic wavelet algorithm\n * - \"amdf\" - Average Magnitude Difference Function\n *\n * @param algorithm - Algorithm name (case-insensitive)\n */\nexport function setAlgorithm(algorithm: string) {\n  return ReactNativeSimpleNotePitchDetectorModule.setAlgorithm(algorithm);\n}\n\n/**\n * Get the current algorithm name.\n * @returns Current algorithm name\n */\nexport function getAlgorithm(): string {\n  return ReactNativeSimpleNotePitchDetectorModule.getAlgorithm();\n}\n\nconst emitter = new EventEmitter(\n  ReactNativeSimpleNotePitchDetectorModule ??\n    NativeModulesProxy.ReactNativeSimpleNotePitchDetector\n);\n\nexport function onChangeNote(\n  listener: (event: ChangeEventPayload) => void\n): Subscription {\n  return emitter.addListener<ChangeEventPayload>(\"onChangeNote\", listener);\n}\n\nexport { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,wCAAwC,MAAM,4CAA4C,CAAC;AAMlG,MAAM,UAAU,KAAK;IACnB,OAAO,wCAAwC,CAAC,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,OAAO,wCAAwC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,wCAAwC,CAAC,WAAW,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,wCAAwC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,wCAAwC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,wCAAwC,CAAC,aAAa,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,wCAAwC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,wCAAwC,CAAC,YAAY,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,wCAAwC;IACtC,kBAAkB,CAAC,kCAAkC,CACxD,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,QAA6C;IAE7C,OAAO,OAAO,CAAC,WAAW,CAAqB,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA6C;IAE7C,OAAO,OAAO,CAAC,WAAW,CAAqB,UAAU,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import {\n  NativeModulesProxy,\n  EventEmitter,\n  Subscription,\n} from \"expo-modules-core\";\n\nimport ReactNativeSimpleNotePitchDetectorModule from \"./ReactNativeSimpleNotePitchDetectorModule\";\nimport {\n  ChangeEventPayload,\n  ReactNativeSimpleNotePitchDetectorViewProps,\n} from \"./ReactNativeSimpleNotePitchDetector.types\";\n\nexport function start() {\n  return ReactNativeSimpleNotePitchDetectorModule.start();\n}\n\nexport function stop() {\n  return ReactNativeSimpleNotePitchDetectorModule.stop();\n}\n\nexport function isRecording() {\n  return ReactNativeSimpleNotePitchDetectorModule.isRecording();\n}\n\n/**\n * Set the minimum audio level threshold for pitch detection.\n * Values are in dB (e.g., -30 means sounds quieter than -30dB are ignored).\n * Lower values = more sensitive (picks up quieter sounds).\n * Default is -30.\n * @param threshold - Level threshold in dB (e.g., -30, -35, -40)\n */\nexport function setLevelThreshold(threshold: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setLevelThreshold(threshold);\n}\n\n/**\n * Set the buffer size for pitch detection.\n * Must be called before start() or will restart the engine if already running.\n *\n * Buffer size affects the trade-off between frequency range and responsiveness:\n * - Smaller buffer (2048-4096): Better for high frequencies, faster response, but less accurate for low notes\n * - Larger buffer (8192-16384): Better for low frequencies, more accurate, but slightly more latency\n *\n * iOS defaults to 8192, Android defaults to 2048.\n *\n * Recommended values:\n * - 4096: Good balance for most use cases\n * - 8192: Better for bass instruments or full piano range (iOS default)\n * - 2048: Better for high-pitched instruments, faster response (Android default)\n *\n * @param size - Buffer size (must be power of 2: 1024, 2048, 4096, 8192, 16384)\n */\nexport function setBufferSize(size: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setBufferSize(size);\n}\n\n/**\n * Get the current buffer size.\n * @returns Current buffer size\n */\nexport function getBufferSize(): number {\n  return ReactNativeSimpleNotePitchDetectorModule.getBufferSize();\n}\n\n/**\n * Set the pitch estimation algorithm.\n * Must be called before start() or will restart the engine if already running.\n *\n * Available algorithms differ by platform:\n *\n * **iOS (Beethoven library):**\n * - \"yin\" (default) - YIN algorithm, good for monophonic instruments\n * - \"hps\" - Harmonic Product Spectrum\n * - \"barycentric\" - Barycentric interpolation\n * - \"quadradic\" - Quadratic interpolation\n * - \"jains\" - Jain's method\n * - \"quinnsFirst\" - Quinn's first estimator\n * - \"quinnsSecond\" - Quinn's second estimator\n * - \"maxValue\" - Maximum value method\n *\n * **Android (TarsosDSP library):**\n * - \"fft_yin\" (default) - FFT-based YIN, faster than pure YIN\n * - \"yin\" - Pure YIN algorithm\n * - \"mpm\" - McLeod Pitch Method, good for speech and music\n * - \"fft_pitch\" - FFT bin with most energy\n * - \"dynamic_wavelet\" - Dynamic wavelet algorithm\n * - \"amdf\" - Average Magnitude Difference Function\n *\n * @param algorithm - Algorithm name (case-insensitive)\n */\nexport function setAlgorithm(algorithm: string) {\n  return ReactNativeSimpleNotePitchDetectorModule.setAlgorithm(algorithm);\n}\n\n/**\n * Get the current algorithm name.\n * @returns Current algorithm name\n */\nexport function getAlgorithm(): string {\n  return ReactNativeSimpleNotePitchDetectorModule.getAlgorithm();\n}\n\nconst emitter = new EventEmitter(\n  ReactNativeSimpleNotePitchDetectorModule ??\n    NativeModulesProxy.ReactNativeSimpleNotePitchDetector\n);\n\nexport function onChangeNote(\n  listener: (event: ChangeEventPayload) => void\n): Subscription {\n  return emitter.addListener<ChangeEventPayload>(\"onChangeNote\", listener);\n}\n\nexport interface StatusEventPayload {\n  level: \"debug\" | \"error\" | \"verbose\";\n  message: string;\n}\n\n/**\n * Listen for status/debug messages from the native module.\n * Useful for debugging audio initialization issues.\n * @param listener - Callback that receives status events with level and message\n */\nexport function onStatus(\n  listener: (event: StatusEventPayload) => void\n): Subscription {\n  return emitter.addListener<StatusEventPayload>(\"onStatus\", listener);\n}\n\nexport { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };\n"]}

package/ios/ReactNativeSimpleNotePitchDetectorModule.swift

@@ -12,14 +12,23 @@ public class ReactNativeSimpleNotePitchDetectorModule: Module {
     private var estimationStrategy: EstimationStrategy = .yin
     private var _pitchEngine: PitchEngine?
 
+    private func sendStatus(_ level: String, _ message: String) {
+        self.sendEvent("onStatus", [
+            "level": level,
+            "message": message
+        ])
+    }
+
     public func definition() -> ModuleDefinition {
 
         Name("ReactNativeSimpleNotePitchDetector")
 
-        Events("onChangeNote")
+        Events("onChangeNote", "onStatus")
 
         Function("start") {
+            self.sendStatus("debug", "start() called with bufferSize=\(self.bufferSize), algorithm=\(self.estimationStrategy)")
             self.pitchEngine.start()
+            self.sendStatus("debug", "Recording started successfully")
         }
 
         Function("stop") {
@@ -150,7 +159,7 @@ extension ReactNativeSimpleNotePitchDetectorModule: PitchEngineDelegate {
     }
 
     public func pitchEngine(_ pitchEngine: PitchEngine, didReceiveError error: Error) {
-        // Optionally send error events to JS
+        self.sendStatus("error", "PitchEngine error: \(error.localizedDescription)")
     }
 
     public func pitchEngineWentBelowLevelThreshold(_ pitchEngine: PitchEngine) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-simple-note-pitch-detector",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "a simple react native library to detect the pitch of the input recording",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -39,4 +39,4 @@
     "react": "*",
     "react-native": "*"
   }
-}
+}

package/src/index.ts

@@ -111,4 +111,20 @@ export function onChangeNote(
   return emitter.addListener<ChangeEventPayload>("onChangeNote", listener);
 }
 
+export interface StatusEventPayload {
+  level: "debug" | "error" | "verbose";
+  message: string;
+}
+
+/**
+ * Listen for status/debug messages from the native module.
+ * Useful for debugging audio initialization issues.
+ * @param listener - Callback that receives status events with level and message
+ */
+export function onStatus(
+  listener: (event: StatusEventPayload) => void
+): Subscription {
+  return emitter.addListener<StatusEventPayload>("onStatus", listener);
+}
+
 export { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };