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

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
@@ -31,8 +35,8 @@ class PitchAnalyzer {
     // Smaller buffer = better high frequency detection, less latency
     private var bufferSize = 2048
     // Configurable algorithm - can be changed from JS
-    private var algorithm = PitchEstimationAlgorithm.FFT_YIN
-    private var algorithmName = "fft_yin"
+    private var algorithm = PitchEstimationAlgorithm.MPM
+    private var algorithmName = "mpm"
 
     private var dispatcher: AudioDispatcher? = null
     private var processor: AudioProcessor? = null
@@ -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/ReactNativeSimpleNotePitchDetector.types.d.ts

@@ -8,7 +8,4 @@ export type ChangeEventPayload = {
     /** Offset from perfect pitch as percentage (-50 to +50, negative = flat, positive = sharp) */
     offset: number;
 };
-export type ReactNativeSimpleNotePitchDetectorViewProps = {
-    name: string;
-};
 //# sourceMappingURL=ReactNativeSimpleNotePitchDetector.types.d.ts.map

package/build/ReactNativeSimpleNotePitchDetector.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeSimpleNotePitchDetector.types.d.ts","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetector.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}
+{"version":3,"file":"ReactNativeSimpleNotePitchDetector.types.d.ts","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetector.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/build/ReactNativeSimpleNotePitchDetector.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeSimpleNotePitchDetector.types.js","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetector.types.ts"],"names":[],"mappings":"","sourcesContent":["export type ChangeEventPayload = {\n  /** Note name without octave (e.g., \"C#\", \"D\", \"Eb\") */\n  note: string;\n  /** Octave number (e.g., 4 for middle C) */\n  octave: number;\n  /** Raw frequency in Hz */\n  frequency: number;\n  /** Offset from perfect pitch as percentage (-50 to +50, negative = flat, positive = sharp) */\n  offset: number;\n};\n\nexport type ReactNativeSimpleNotePitchDetectorViewProps = {\n  name: string;\n};\n"]}
+{"version":3,"file":"ReactNativeSimpleNotePitchDetector.types.js","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetector.types.ts"],"names":[],"mappings":"","sourcesContent":["export type ChangeEventPayload = {\n  /** Note name without octave (e.g., \"C#\", \"D\", \"Eb\") */\n  note: string;\n  /** Octave number (e.g., 4 for middle C) */\n  octave: number;\n  /** Raw frequency in Hz */\n  frequency: number;\n  /** Offset from perfect pitch as percentage (-50 to +50, negative = flat, positive = sharp) */\n  offset: number;\n};\n"]}

package/build/index.d.ts

@@ -1,5 +1,5 @@
-import { Subscription } from "expo-modules-core";
-import { ChangeEventPayload, ReactNativeSimpleNotePitchDetectorViewProps } from "./ReactNativeSimpleNotePitchDetector.types";
+import { EventSubscription } from "expo-modules-core";
+import { ChangeEventPayload } from "./ReactNativeSimpleNotePitchDetector.types";
 export declare function start(): any;
 export declare function stop(): any;
 export declare function isRecording(): any;
@@ -66,6 +66,16 @@ export declare function setAlgorithm(algorithm: string): any;
  * @returns Current algorithm name
  */
 export declare function getAlgorithm(): string;
-export declare function onChangeNote(listener: (event: ChangeEventPayload) => void): Subscription;
-export { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };
+export declare function onChangeNote(listener: (event: ChangeEventPayload) => void): EventSubscription;
+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): EventSubscription;
+export { 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,EACL,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAEhF,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;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,iBAAiB,CAEnB;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,iBAAiB,CAEnB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/build/index.js

@@ -1,4 +1,3 @@
-import { NativeModulesProxy, EventEmitter, } from "expo-modules-core";
 import ReactNativeSimpleNotePitchDetectorModule from "./ReactNativeSimpleNotePitchDetectorModule";
 export function start() {
     return ReactNativeSimpleNotePitchDetectorModule.start();
@@ -82,9 +81,15 @@ export function setAlgorithm(algorithm) {
 export function getAlgorithm() {
     return ReactNativeSimpleNotePitchDetectorModule.getAlgorithm();
 }
-const emitter = new EventEmitter(ReactNativeSimpleNotePitchDetectorModule ??
-    NativeModulesProxy.ReactNativeSimpleNotePitchDetector);
 export function onChangeNote(listener) {
-    return emitter.addListener("onChangeNote", listener);
+    return ReactNativeSimpleNotePitchDetectorModule.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 ReactNativeSimpleNotePitchDetectorModule.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":"AAIA,OAAO,wCAAwC,MAAM,4CAA4C,CAAC;AAGlG,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,UAAU,YAAY,CAC1B,QAA6C;IAE7C,OAAO,wCAAwC,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AACxF,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA6C;IAE7C,OAAO,wCAAwC,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC","sourcesContent":["import {\n  EventSubscription,\n} from \"expo-modules-core\";\n\nimport ReactNativeSimpleNotePitchDetectorModule from \"./ReactNativeSimpleNotePitchDetectorModule\";\nimport { ChangeEventPayload } 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\nexport function onChangeNote(\n  listener: (event: ChangeEventPayload) => void\n): EventSubscription {\n  return ReactNativeSimpleNotePitchDetectorModule.addListener(\"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): EventSubscription {\n  return ReactNativeSimpleNotePitchDetectorModule.addListener(\"onStatus\", listener);\n}\n\nexport { 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.7.0",
   "description": "a simple react native library to detect the pitch of the input recording",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -13,7 +13,9 @@
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module",
     "open:ios": "open -a \"Xcode\" example/ios",
-    "open:android": "open -a \"Android Studio\" example/android"
+    "open:android": "open -a \"Android Studio\" example/android",
+    "android": "expo run:android",
+    "ios": "expo run:ios"
   },
   "keywords": [
     "react-native",
@@ -30,13 +32,13 @@
   "homepage": "https://github.com/derekhdawson/react-native-simple-note-pitch-detector#readme",
   "dependencies": {},
   "devDependencies": {
-    "@types/react": "^18.0.25",
+    "@types/react": "~19.1.10",
     "expo-module-scripts": "^3.0.11",
-    "expo-modules-core": "^1.5.7"
+    "expo-modules-core": "~3.0.29"
   },
   "peerDependencies": {
     "expo": "*",
     "react": "*",
     "react-native": "*"
   }
-}
+}

package/src/ReactNativeSimpleNotePitchDetector.types.ts

@@ -8,7 +8,3 @@ export type ChangeEventPayload = {
   /** Offset from perfect pitch as percentage (-50 to +50, negative = flat, positive = sharp) */
   offset: number;
 };
-
-export type ReactNativeSimpleNotePitchDetectorViewProps = {
-  name: string;
-};

package/src/index.ts

@@ -1,14 +1,9 @@
 import {
-  NativeModulesProxy,
-  EventEmitter,
-  Subscription,
+  EventSubscription,
 } from "expo-modules-core";
 
 import ReactNativeSimpleNotePitchDetectorModule from "./ReactNativeSimpleNotePitchDetectorModule";
-import {
-  ChangeEventPayload,
-  ReactNativeSimpleNotePitchDetectorViewProps,
-} from "./ReactNativeSimpleNotePitchDetector.types";
+import { ChangeEventPayload } from "./ReactNativeSimpleNotePitchDetector.types";
 
 export function start() {
   return ReactNativeSimpleNotePitchDetectorModule.start();
@@ -100,15 +95,26 @@ export function getAlgorithm(): string {
   return ReactNativeSimpleNotePitchDetectorModule.getAlgorithm();
 }
 
-const emitter = new EventEmitter(
-  ReactNativeSimpleNotePitchDetectorModule ??
-    NativeModulesProxy.ReactNativeSimpleNotePitchDetector
-);
-
 export function onChangeNote(
   listener: (event: ChangeEventPayload) => void
-): Subscription {
-  return emitter.addListener<ChangeEventPayload>("onChangeNote", listener);
+): EventSubscription {
+  return ReactNativeSimpleNotePitchDetectorModule.addListener("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
+): EventSubscription {
+  return ReactNativeSimpleNotePitchDetectorModule.addListener("onStatus", listener);
 }
 
-export { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };
+export { ChangeEventPayload };

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +0,0 @@
-#Mon Feb 02 16:29:03 PST 2026
-gradle.version=9.0-milestone-1

package/android/.gradle/config.properties

@@ -1,2 +0,0 @@
-#Mon Feb 02 16:28:55 PST 2026
-java.home=/Applications/Android Studio.app/Contents/jbr/Contents/Home

package/android/.idea/AndroidProjectSystem.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AndroidProjectSystem">
-    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
-  </component>
-</project>