@edkimmel/expo-audio-stream 0.4.2 → 0.6.0

package/android/src/main/java/expo/modules/audiostream/pipeline/AudioPipeline.kt

@@ -49,6 +49,7 @@ interface PipelineListener {
     fun onZombieDetected(playbackHead: Long, stalledMs: Long)
     fun onUnderrun(count: Int)
     fun onDrained(turnId: String)
+    fun onPlaybackStopped(turnId: String)
     fun onAudioFocusLost()
     fun onAudioFocusResumed()
     fun onFrequencyBands(low: Float, mid: Float, high: Float)
@@ -89,8 +90,9 @@ enum class AudioMode {
  * **MAX_PRIORITY write thread** that loops `buffer.read() → track.write(BLOCKING)`.
  *
  * Key design points:
- *   - AudioTrack uses **USAGE_MEDIA + CONTENT_TYPE_SPEECH** (not
- *     VOICE_COMMUNICATION — avoids earpiece routing).
+ *   - AudioTrack uses **USAGE_VOICE_COMMUNICATION + CONTENT_TYPE_SPEECH** so its
+ *     output feeds the hardware AEC echo reference path. Earpiece routing is
+ *     prevented by CommunicationAudioManager (setCommunicationDevice/isSpeakerphoneOn).
  *   - AudioTrack stays alive for the entire session, writing silence when idle.
  *     This avoids 50–100 ms restart latency.
  *   - Config is **immutable per session** — tear down and rebuild to change
@@ -128,7 +130,9 @@ class AudioPipeline(
         /** If playback head hasn't moved for this long, declare zombie. */
         private const val ZOMBIE_STALL_THRESHOLD_MS = 5000L
 
-        /** Minimum volume level (0–15) enforced by VolumeGuard on STREAM_MUSIC. */
+        /** Minimum volume level (0–15) enforced by VolumeGuard on STREAM_VOICE_CALL.
+         *  USAGE_VOICE_COMMUNICATION is required so the output feeds the hardware AEC
+         *  echo reference path — USAGE_MEDIA does not. */
         private const val MIN_VOLUME_LEVEL = 1
     }
 
@@ -214,6 +218,13 @@ class AudioPipeline(
     // ── Underrun debounce ───────────────────────────────────────────────
     private var lastReportedUnderrunCount = 0
 
+    /**
+     * Pending PlaybackStopped runnable scheduled on [mainHandler] — cancelled
+     * on new turn / invalidateTurn / disconnect. All mutations of this field
+     * MUST happen on the main thread to avoid races with the timer firing.
+     */
+    private var pendingPlaybackStoppedRunnable: Runnable? = null
+
     // ── Frequency band analysis ──────────────────────────────────────
     private var frequencyBandAnalyzer: FrequencyBandAnalyzer? = null
     private var frequencyBandExecutor: java.util.concurrent.ScheduledExecutorService? = null
@@ -227,6 +238,8 @@ class AudioPipeline(
     val totalPushCalls = AtomicLong(0)
     val totalPushBytes = AtomicLong(0)
     val totalWriteLoops = AtomicLong(0)
+    /** Frames successfully written to AudioTrack (one frame per sample-time across all channels). */
+    private val framesWritten = AtomicLong(0)
 
     // ════════════════════════════════════════════════════════════════════
     // Connect / Disconnect
@@ -253,7 +266,7 @@ class AudioPipeline(
 
             // ── 2. AudioTrack ───────────────────────────────────────────
             val audioAttributes = AudioAttributes.Builder()
-                .setUsage(AudioAttributes.USAGE_MEDIA)
+                .setUsage(AudioAttributes.USAGE_VOICE_COMMUNICATION)
                 .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
                 .build()
 
@@ -309,8 +322,8 @@ class AudioPipeline(
         } catch (e: Exception) {
             Log.e(TAG, "connect() failed", e)
             setState(PipelineState.ERROR)
-            listener.onError("CONNECT_FAILED", e.message ?: "Unknown error")
             disconnect()
+            throw e
         }
     }
 
@@ -321,6 +334,9 @@ class AudioPipeline(
      * `WRITE_BLOCKING` call, then joins the thread.
      */
     fun disconnect() {
+        // Cancel any pending PlaybackStopped dispatch before tearing down.
+        cancelPendingPlaybackStopped()
+
         running.set(false)
 
         // Stop zombie detection
@@ -407,6 +423,7 @@ class AudioPipeline(
                 pendingFlush.set(true)
                 setState(PipelineState.STREAMING)
                 frequencyBandAnalyzer?.reset()
+                cancelPendingPlaybackStopped()
             }
 
             // ── Decode base64 → PCM shorts ──────────────────────────────
@@ -451,6 +468,7 @@ class AudioPipeline(
             lastReportedUnderrunCount = 0
             setState(PipelineState.IDLE)
             frequencyBandAnalyzer?.reset()
+            cancelPendingPlaybackStopped()
         }
     }
 
@@ -479,6 +497,37 @@ class AudioPipeline(
         return bundle
     }
 
+    /**
+     * Current platform output latency in milliseconds — i.e., how long after
+     * a sample is written before it physically leaves the speaker.
+     *
+     * Uses [AudioTrack.getTimestamp] to compute frames still in flight, then
+     * converts to ms. Falls back to a conservative HAL-buffer estimate when
+     * the timestamp call returns false (notably during initial buffering or
+     * on bad audio routes).
+     *
+     * Returns 0 if the pipeline is not connected.
+     */
+    fun outputLatencyMs(): Double {
+        val track = audioTrack ?: return 0.0
+        val ts = android.media.AudioTimestamp()
+        val ok = try {
+            track.getTimestamp(ts)
+        } catch (e: IllegalStateException) {
+            false
+        }
+        if (ok) {
+            val inFlight = framesWritten.get() - ts.framePosition
+            if (inFlight > 0) {
+                return (inFlight.toDouble() / sampleRate.toDouble()) * 1000.0
+            }
+            return 0.0
+        }
+        // Fallback: assume the HAL holds ~2× minBuffer worth of frames.
+        val fallbackFrames = (minBufferBytes / 2 / channelCount) * 2
+        return (fallbackFrames.toDouble() / sampleRate.toDouble()) * 1000.0
+    }
+
     // ════════════════════════════════════════════════════════════════════
     // Write loop (runs on MAX_PRIORITY thread)
     // ════════════════════════════════════════════════════════════════════
@@ -534,6 +583,9 @@ class AudioPipeline(
                     listener.onError("WRITE_ERROR", "AudioTrack.write returned $errorName ($written)")
                     break
                 }
+                // Track frames written for output-latency computation.
+                // `written` is Int16-sample count; divide by channelCount for frames.
+                framesWritten.addAndGet((written / channelCount).toLong())
             } catch (e: IllegalStateException) {
                 // Track was stopped/released — expected during disconnect
                 if (running.get()) {
@@ -561,7 +613,10 @@ class AudioPipeline(
 
             // ── Drain detection ─────────────────────────────────────────
             if (buf.isDrained() && state == PipelineState.DRAINING) {
-                currentTurnId?.let { listener.onDrained(it) }
+                currentTurnId?.let { tid ->
+                    listener.onDrained(tid)
+                    schedulePlaybackStopped(tid)
+                }
                 setState(PipelineState.IDLE)
             }
         }
@@ -585,7 +640,7 @@ class AudioPipeline(
             AudioMode.DUCK_OTHERS -> {
                 val result = audioManager.requestAudioFocus(
                     focusChangeListener,
-                    AudioManager.STREAM_MUSIC,
+                    AudioManager.STREAM_VOICE_CALL,
                     AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
                 )
                 hasAudioFocus.set(result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED)
@@ -596,7 +651,7 @@ class AudioPipeline(
             AudioMode.DO_NOT_MIX -> {
                 val result = audioManager.requestAudioFocus(
                     focusChangeListener,
-                    AudioManager.STREAM_MUSIC,
+                    AudioManager.STREAM_VOICE_CALL,
                     AudioManager.AUDIOFOCUS_GAIN
                 )
                 hasAudioFocus.set(result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED)
@@ -691,12 +746,12 @@ class AudioPipeline(
     private fun installVolumeGuard() {
         volumeObserver = object : ContentObserver(mainHandler) {
             override fun onChange(selfChange: Boolean) {
-                val current = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
+                val current = audioManager.getStreamVolume(AudioManager.STREAM_VOICE_CALL)
                 if (current < MIN_VOLUME_LEVEL) {
-                    Log.d(TAG, "VolumeGuard: raising STREAM_MUSIC from $current to $MIN_VOLUME_LEVEL")
+                    Log.d(TAG, "VolumeGuard: raising STREAM_VOICE_CALL from $current to $MIN_VOLUME_LEVEL")
                     try {
                         audioManager.setStreamVolume(
-                            AudioManager.STREAM_MUSIC,
+                            AudioManager.STREAM_VOICE_CALL,
                             MIN_VOLUME_LEVEL,
                             0 // no flags — silent raise
                         )
@@ -772,6 +827,43 @@ class AudioPipeline(
     // Internal helpers
     // ════════════════════════════════════════════════════════════════════
 
+    /**
+     * Schedule a `PlaybackStopped` callback approximately [outputLatencyMs]
+     * milliseconds after `Drained`. Cancels any previously pending dispatch.
+     *
+     * Called from the write thread; the actual cancellation/scheduling and
+     * invocation happen on the main thread so we never race ourselves.
+     */
+    private fun schedulePlaybackStopped(turnId: String) {
+        val latencyMs = outputLatencyMs().toLong()
+        mainHandler.post {
+            pendingPlaybackStoppedRunnable?.let { mainHandler.removeCallbacks(it) }
+
+            val runnable = Runnable {
+                pendingPlaybackStoppedRunnable = null
+                listener.onPlaybackStopped(turnId)
+            }
+            pendingPlaybackStoppedRunnable = runnable
+
+            if (latencyMs > 0) {
+                mainHandler.postDelayed(runnable, latencyMs)
+            } else {
+                mainHandler.post(runnable)
+            }
+        }
+    }
+
+    /**
+     * Cancel any pending PlaybackStopped dispatch. Posts to [mainHandler] so
+     * all mutations of [pendingPlaybackStoppedRunnable] are on one thread.
+     */
+    private fun cancelPendingPlaybackStopped() {
+        mainHandler.post {
+            pendingPlaybackStoppedRunnable?.let { mainHandler.removeCallbacks(it) }
+            pendingPlaybackStoppedRunnable = null
+        }
+    }
+
     private fun setState(newState: PipelineState) {
         if (state == newState) return
         state = newState
@@ -787,6 +879,7 @@ class AudioPipeline(
         totalPushCalls.set(0)
         totalPushBytes.set(0)
         totalWriteLoops.set(0)
+        framesWritten.set(0)
         jitterBuffer?.resetTelemetry()
     }
 }

package/android/src/main/java/expo/modules/audiostream/pipeline/PipelineIntegration.kt

@@ -90,6 +90,7 @@ class PipelineIntegration(
         const val EVENT_ZOMBIE_DETECTED    = "PipelineZombieDetected"
         const val EVENT_UNDERRUN           = "PipelineUnderrun"
         const val EVENT_DRAINED            = "PipelineDrained"
+        const val EVENT_PLAYBACK_STOPPED   = "PipelinePlaybackStopped"
         const val EVENT_AUDIO_FOCUS_LOST   = "PipelineAudioFocusLost"
         const val EVENT_AUDIO_FOCUS_RESUMED = "PipelineAudioFocusResumed"
         const val EVENT_FREQUENCY_BANDS = "PipelineFrequencyBands"
@@ -247,6 +248,13 @@ class PipelineIntegration(
         return pipeline?.getState()?.value ?: PipelineState.IDLE.value
     }
 
+    /**
+     * Current platform output latency in milliseconds. Returns 0 if not connected.
+     */
+    fun outputLatencyMs(): Double {
+        return pipeline?.outputLatencyMs() ?: 0.0
+    }
+
     /**
      * Log AudioTrack health — called from the device callback to capture
      * track state at the moment of a route change.
@@ -305,6 +313,12 @@ class PipelineIntegration(
         })
     }
 
+    override fun onPlaybackStopped(turnId: String) {
+        sendEvent(EVENT_PLAYBACK_STOPPED, Bundle().apply {
+            putString("turnId", turnId)
+        })
+    }
+
     override fun onAudioFocusLost() {
         sendEvent(EVENT_AUDIO_FOCUS_LOST, Bundle())
     }

package/build/events.d.ts

@@ -16,6 +16,10 @@ export interface AudioEventPayload {
         mid: number;
         high: number;
     };
+    /** Set by native when a mid-recording error occurs (interruption, read failure).
+     * When present, `encoded` is absent and the recording is no longer active. */
+    error?: string;
+    errorMessage?: string;
 }
 export declare const DeviceReconnectedReasons: {
     readonly newDeviceAvailable: "newDeviceAvailable";
@@ -28,8 +32,30 @@ export type DeviceReconnectedEventPayload = {
 };
 export declare const AudioEvents: {
     AudioData: string;
+    MicrophoneError: string;
     DeviceReconnected: string;
 };
 export declare function addAudioEventListener(listener: (event: AudioEventPayload) => Promise<void>): EventSubscription;
+export interface MicrophoneErrorEventPayload {
+    code: string;
+    message: string;
+    isFatal: boolean;
+    autoResuming: boolean;
+}
+/**
+ * Subscribe to the dedicated MicrophoneError native event.
+ *
+ * OTA safe: if the running native binary predates this feature, the event is
+ * never emitted and this listener is never called. Apps that also subscribe to
+ * AudioData errors via addAudioEventListener continue to work unchanged.
+ *
+ * @example
+ * const sub = addMicrophoneErrorListener((e) => {
+ *   if (e.isFatal) { stopMicrophone(); reconnect(); }
+ *   else if (e.autoResuming) { showPausedUI(); }
+ * })
+ * // cleanup: sub.remove()
+ */
+export declare function addMicrophoneErrorListener(listener: (event: MicrophoneErrorEventPayload) => void): EventSubscription;
 export declare function subscribeToEvent<T extends unknown>(eventName: string, listener: (event: T | undefined) => Promise<void>): EventSubscription;
 //# sourceMappingURL=events.d.ts.map

package/build/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAM7C,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACpD,iBAAiB,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAChD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAChD,iBAAiB,CAEnB"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAM7C,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D;kFAC8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACpD,iBAAiB,CAEnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,GACrD,iBAAiB,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAChD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAChD,iBAAiB,CAEnB"}

package/build/events.js

@@ -9,11 +9,29 @@ export const DeviceReconnectedReasons = {
 };
 export const AudioEvents = {
     AudioData: "AudioData",
+    MicrophoneError: "MicrophoneError",
     DeviceReconnected: "DeviceReconnected",
 };
 export function addAudioEventListener(listener) {
     return emitter.addListener("AudioData", listener);
 }
+/**
+ * Subscribe to the dedicated MicrophoneError native event.
+ *
+ * OTA safe: if the running native binary predates this feature, the event is
+ * never emitted and this listener is never called. Apps that also subscribe to
+ * AudioData errors via addAudioEventListener continue to work unchanged.
+ *
+ * @example
+ * const sub = addMicrophoneErrorListener((e) => {
+ *   if (e.isFatal) { stopMicrophone(); reconnect(); }
+ *   else if (e.autoResuming) { showPausedUI(); }
+ * })
+ * // cleanup: sub.remove()
+ */
+export function addMicrophoneErrorListener(listener) {
+    return emitter.addListener("MicrophoneError", listener);
+}
 export function subscribeToEvent(eventName, listener) {
     return emitter.addListener(eventName, listener);
 }

package/build/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAKzE,OAAO,yBAAyB,MAAM,6BAA6B,CAAC;AAEpE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAC;AAgB5D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,OAAO,EAAE,SAAS;CACV,CAAC;AASX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;CACvC,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,QAAqD;IAErD,OAAQ,OAAe,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,QAAiD;IAEjD,OAAQ,OAAe,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["// packages/expo-audio-stream/src/events.ts\n\nimport { EventEmitter, type EventSubscription } from \"expo-modules-core\";\n\n// Type alias for backwards compatibility\nexport type Subscription = EventSubscription;\n\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\nconst emitter = new EventEmitter(ExpoPlayAudioStreamModule);\n\nexport interface AudioEventPayload {\n  encoded?: string;\n  buffer?: Float32Array;\n  fileUri: string;\n  lastEmittedSize: number;\n  position: number;\n  deltaSize: number;\n  totalSize: number;\n  mimeType: string;\n  streamUuid: string;\n  soundLevel?: number;\n  frequencyBands?: { low: number; mid: number; high: number };\n}\n\nexport const DeviceReconnectedReasons = {\n  newDeviceAvailable: \"newDeviceAvailable\",\n  oldDeviceUnavailable: \"oldDeviceUnavailable\",\n  unknown: \"unknown\",\n} as const;\n\nexport type DeviceReconnectedReason =\n  (typeof DeviceReconnectedReasons)[keyof typeof DeviceReconnectedReasons];\n\nexport type DeviceReconnectedEventPayload = {\n  reason: DeviceReconnectedReason;\n};\n\nexport const AudioEvents = {\n  AudioData: \"AudioData\",\n  DeviceReconnected: \"DeviceReconnected\",\n};\n\nexport function addAudioEventListener(\n  listener: (event: AudioEventPayload) => Promise<void>\n): EventSubscription {\n  return (emitter as any).addListener(\"AudioData\", listener);\n}\n\nexport function subscribeToEvent<T extends unknown>(\n  eventName: string,\n  listener: (event: T | undefined) => Promise<void>\n): EventSubscription {\n  return (emitter as any).addListener(eventName, listener);\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAKzE,OAAO,yBAAyB,MAAM,6BAA6B,CAAC;AAEpE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAC;AAoB5D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,OAAO,EAAE,SAAS;CACV,CAAC;AASX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;CACvC,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,QAAqD;IAErD,OAAQ,OAAe,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AASD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAsD;IAEtD,OAAQ,OAAe,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,QAAiD;IAEjD,OAAQ,OAAe,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["// packages/expo-audio-stream/src/events.ts\n\nimport { EventEmitter, type EventSubscription } from \"expo-modules-core\";\n\n// Type alias for backwards compatibility\nexport type Subscription = EventSubscription;\n\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\nconst emitter = new EventEmitter(ExpoPlayAudioStreamModule);\n\nexport interface AudioEventPayload {\n  encoded?: string;\n  buffer?: Float32Array;\n  fileUri: string;\n  lastEmittedSize: number;\n  position: number;\n  deltaSize: number;\n  totalSize: number;\n  mimeType: string;\n  streamUuid: string;\n  soundLevel?: number;\n  frequencyBands?: { low: number; mid: number; high: number };\n  /** Set by native when a mid-recording error occurs (interruption, read failure).\n   * When present, `encoded` is absent and the recording is no longer active. */\n  error?: string;\n  errorMessage?: string;\n}\n\nexport const DeviceReconnectedReasons = {\n  newDeviceAvailable: \"newDeviceAvailable\",\n  oldDeviceUnavailable: \"oldDeviceUnavailable\",\n  unknown: \"unknown\",\n} as const;\n\nexport type DeviceReconnectedReason =\n  (typeof DeviceReconnectedReasons)[keyof typeof DeviceReconnectedReasons];\n\nexport type DeviceReconnectedEventPayload = {\n  reason: DeviceReconnectedReason;\n};\n\nexport const AudioEvents = {\n  AudioData: \"AudioData\",\n  MicrophoneError: \"MicrophoneError\",\n  DeviceReconnected: \"DeviceReconnected\",\n};\n\nexport function addAudioEventListener(\n  listener: (event: AudioEventPayload) => Promise<void>\n): EventSubscription {\n  return (emitter as any).addListener(\"AudioData\", listener);\n}\n\nexport interface MicrophoneErrorEventPayload {\n  code: string;\n  message: string;\n  isFatal: boolean;\n  autoResuming: boolean;\n}\n\n/**\n * Subscribe to the dedicated MicrophoneError native event.\n *\n * OTA safe: if the running native binary predates this feature, the event is\n * never emitted and this listener is never called. Apps that also subscribe to\n * AudioData errors via addAudioEventListener continue to work unchanged.\n *\n * @example\n * const sub = addMicrophoneErrorListener((e) => {\n *   if (e.isFatal) { stopMicrophone(); reconnect(); }\n *   else if (e.autoResuming) { showPausedUI(); }\n * })\n * // cleanup: sub.remove()\n */\nexport function addMicrophoneErrorListener(\n  listener: (event: MicrophoneErrorEventPayload) => void\n): EventSubscription {\n  return (emitter as any).addListener(\"MicrophoneError\", listener);\n}\n\nexport function subscribeToEvent<T extends unknown>(\n  eventName: string,\n  listener: (event: T | undefined) => Promise<void>\n): EventSubscription {\n  return (emitter as any).addListener(eventName, listener);\n}\n"]}

package/build/index.d.ts

@@ -72,6 +72,8 @@ export declare class ExpoPlayAudioStream {
 export { AudioDataEvent, DeviceReconnectedReason, DeviceReconnectedEventPayload, AudioRecording, RecordingConfig, StartRecordingResult, AudioEvents, PlaybackMode, Encoding, EncodingTypes, FrequencyBands, PlaybackModes, IAudioBufferConfig, IAudioPlayPayload, IAudioFrame, BufferHealthState, IBufferHealthMetrics, IAudioBufferManager, IFrameProcessor, IQualityMonitor, BufferedStreamConfig, SmartBufferConfig, SmartBufferMode, NetworkConditions, };
 export type { EventSubscription } from "expo-modules-core";
 export type { Subscription } from "./events";
+export { addMicrophoneErrorListener } from "./events";
+export type { MicrophoneErrorEventPayload } from "./events";
 export { Pipeline } from "./pipeline";
-export type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineBufferTelemetry, PipelineTelemetry, PipelineStateChangedEvent, PipelinePlaybackStartedEvent, PipelineErrorEvent, PipelineZombieDetectedEvent, PipelineUnderrunEvent, PipelineDrainedEvent, PipelineAudioFocusLostEvent, PipelineAudioFocusResumedEvent, } from "./pipeline";
+export type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineBufferTelemetry, PipelineTelemetry, PipelineStateChangedEvent, PipelinePlaybackStartedEvent, PipelineErrorEvent, PipelineZombieDetectedEvent, PipelineUnderrunEvent, PipelineDrainedEvent, PipelinePlaybackStoppedEvent, PipelineAudioFocusLostEvent, PipelineAudioFocusResumedEvent, } from "./pipeline";
 //# 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,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,KAAK,YAAY,GAAG,iBAAiB,CAAC;AACtC,OAAO,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EAEb,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAGL,WAAW,EAEX,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,UAAU,CAAC;AAElB,qBAAa,mBAAmB;IAC9B;;;;OAIG;WACU,OAAO;IAIpB;;;;;OAKG;WACU,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC;QACtE,eAAe,EAAE,oBAAoB,CAAC;QACtC,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B,CAAC;IA8CF;;;;OAIG;WACU,cAAc,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAS7D;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAC3B,kBAAkB,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAC3D,YAAY;IAoBf;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,OAAO,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,YAAY;IAIf;;;;OAIG;IACH,MAAM,CAAC,qBAAqB;IAI5B;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO;IAItC;;;OAGG;WACU,uBAAuB,IAAI,OAAO,CAAC;QAC9C,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IASF;;;OAGG;WACU,mBAAmB,IAAI,OAAO,CAAC;QAC1C,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CAQH;AAED,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,6BAA6B,EAC7B,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EAEb,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,CAAC;AAGF,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -1,6 +1,6 @@
 import ExpoPlayAudioStreamModule from "./ExpoPlayAudioStreamModule";
 import { EncodingTypes, PlaybackModes, } from "./types";
-import { addAudioEventListener, AudioEvents, subscribeToEvent, } from "./events";
+import { addAudioEventListener, addMicrophoneErrorListener, AudioEvents, subscribeToEvent, } from "./events";
 export class ExpoPlayAudioStream {
     /**
      * Destroys the audio stream module, cleaning up all resources.
@@ -19,15 +19,18 @@ export class ExpoPlayAudioStream {
     static async startMicrophone(recordingConfig) {
         let subscription;
         try {
-            const { onAudioStream, ...options } = recordingConfig;
-            if (onAudioStream && typeof onAudioStream == "function") {
-                subscription = addAudioEventListener(async (event) => {
-                    const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, } = event;
+            const { onAudioStream, onError, ...options } = recordingConfig;
+            const subscriptions = [];
+            if (onAudioStream && typeof onAudioStream === "function") {
+                subscriptions.push(addAudioEventListener(async (event) => {
+                    const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, error } = event;
+                    if (error)
+                        return; // handled by MicrophoneError subscription; ignore here
                     if (!encoded) {
                         console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);
                         throw new Error("Encoded audio data is missing");
                     }
-                    onAudioStream?.({
+                    onAudioStream({
                         data: encoded,
                         position,
                         fileUri,
@@ -36,7 +39,15 @@ export class ExpoPlayAudioStream {
                         soundLevel,
                         frequencyBands,
                     });
-                });
+                }));
+            }
+            if (onError && typeof onError === "function") {
+                subscriptions.push(addMicrophoneErrorListener((event) => {
+                    onError(event);
+                }));
+            }
+            if (subscriptions.length > 0) {
+                subscription = { remove: () => subscriptions.forEach((s) => s.remove()) };
             }
             const result = await ExpoPlayAudioStreamModule.startMicrophone(options);
             return { recordingResult: result, subscription };
@@ -137,6 +148,7 @@ export class ExpoPlayAudioStream {
     }
 }
 export { AudioEvents, EncodingTypes, PlaybackModes, };
+export { addMicrophoneErrorListener } from "./events";
 // Export native audio pipeline V3
 export { Pipeline } from "./pipeline";
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\n// Type alias for backwards compatibility\ntype Subscription = EventSubscription;\nimport {\n  AudioDataEvent,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n} from \"./types\";\n\nimport {\n  addAudioEventListener,\n  AudioEventPayload,\n  AudioEvents,\n  subscribeToEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n} from \"./events\";\n\nexport class ExpoPlayAudioStream {\n  /**\n   * Destroys the audio stream module, cleaning up all resources.\n   * This should be called when the module is no longer needed.\n   * It will reset all internal state and release audio resources.\n   */\n  static async destroy() {\n    await ExpoPlayAudioStreamModule.destroy();\n  }\n\n  /**\n   * Starts microphone streaming.\n   * @param {RecordingConfig} recordingConfig - The recording configuration.\n   * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.\n   * @throws {Error} If the recording fails to start.\n   */\n  static async startMicrophone(recordingConfig: RecordingConfig): Promise<{\n    recordingResult: StartRecordingResult;\n    subscription?: Subscription;\n  }> {\n    let subscription: Subscription | undefined;\n    try {\n      const { onAudioStream, ...options } = recordingConfig;\n\n      if (onAudioStream && typeof onAudioStream == \"function\") {\n        subscription = addAudioEventListener(\n          async (event: AudioEventPayload) => {\n            const {\n              fileUri,\n              deltaSize,\n              totalSize,\n              position,\n              encoded,\n              soundLevel,\n              frequencyBands,\n            } = event;\n            if (!encoded) {\n              console.error(\n                `[ExpoPlayAudioStream] Encoded audio data is missing`\n              );\n              throw new Error(\"Encoded audio data is missing\");\n            }\n            onAudioStream?.({\n              data: encoded,\n              position,\n              fileUri,\n              eventDataSize: deltaSize,\n              totalSize,\n              soundLevel,\n              frequencyBands,\n            });\n          }\n        );\n      }\n\n      const result = await ExpoPlayAudioStreamModule.startMicrophone(options);\n\n      return { recordingResult: result, subscription };\n    } catch (error) {\n      console.error(error);\n      subscription?.remove();\n      throw new Error(`Failed to start recording: ${error}`);\n    }\n  }\n\n  /**\n   * Stops the current microphone streaming.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone streaming fails to stop.\n   */\n  static async stopMicrophone(): Promise<AudioRecording | null> {\n    try {\n      return await ExpoPlayAudioStreamModule.stopMicrophone();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to stop mic stream: ${error}`);\n    }\n  }\n\n  /**\n   * Subscribes to audio events emitted during recording/streaming.\n   * @param onMicrophoneStream - Callback function that will be called when audio data is received.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events\n   */\n  static subscribeToAudioEvents(\n    onMicrophoneStream: (event: AudioDataEvent) => Promise<void>\n  ): Subscription {\n    return addAudioEventListener(async (event: AudioEventPayload) => {\n      const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands } =\n        event;\n      if (!encoded) {\n        console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n        throw new Error(\"Encoded audio data is missing\");\n      }\n      onMicrophoneStream?.({\n        data: encoded,\n        position,\n        fileUri,\n        eventDataSize: deltaSize,\n        totalSize,\n        soundLevel,\n        frequencyBands,\n      });\n    });\n  }\n\n  /**\n   * Subscribes to events emitted by the audio stream module, for advanced use cases.\n   * @param eventName - The name of the event to subscribe to.\n   * @param onEvent - Callback function that will be called when the event is emitted.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.\n   */\n  static subscribe<T extends unknown>(\n    eventName: string,\n    onEvent: (event: T | undefined) => Promise<void>\n  ): Subscription {\n    return subscribeToEvent(eventName, onEvent);\n  }\n\n  /**\n   * Prompts the user to select the microphone mode.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone mode fails to prompt.\n   */\n  static promptMicrophoneModes() {\n    ExpoPlayAudioStreamModule.promptMicrophoneModes();\n  }\n\n  /**\n   * Toggles the silence state of the microphone.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone fails to toggle silence.\n   */\n  static toggleSilence(isSilent: boolean) {\n    ExpoPlayAudioStreamModule.toggleSilence(isSilent);\n  }\n\n  /**\n   * Requests microphone permission from the user.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.\n   */\n  static async requestPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.requestPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to request permissions: ${error}`);\n    }\n  }\n\n  /**\n   * Gets the current microphone permission status.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.\n   */\n  static async getPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.getPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to get permissions: ${error}`);\n    }\n  }\n}\n\nexport {\n  AudioDataEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  AudioEvents,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n};\n\n// Re-export Subscription type for backwards compatibility\nexport type { EventSubscription } from \"expo-modules-core\";\nexport type { Subscription } from \"./events\";\n\n// Export native audio pipeline V3\nexport { Pipeline } from \"./pipeline\";\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from \"./pipeline\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\n// Type alias for backwards compatibility\ntype Subscription = EventSubscription;\nimport {\n  AudioDataEvent,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n} from \"./types\";\n\nimport {\n  addAudioEventListener,\n  addMicrophoneErrorListener,\n  AudioEventPayload,\n  AudioEvents,\n  subscribeToEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n} from \"./events\";\n\nexport class ExpoPlayAudioStream {\n  /**\n   * Destroys the audio stream module, cleaning up all resources.\n   * This should be called when the module is no longer needed.\n   * It will reset all internal state and release audio resources.\n   */\n  static async destroy() {\n    await ExpoPlayAudioStreamModule.destroy();\n  }\n\n  /**\n   * Starts microphone streaming.\n   * @param {RecordingConfig} recordingConfig - The recording configuration.\n   * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.\n   * @throws {Error} If the recording fails to start.\n   */\n  static async startMicrophone(recordingConfig: RecordingConfig): Promise<{\n    recordingResult: StartRecordingResult;\n    subscription?: Subscription;\n  }> {\n    let subscription: Subscription | undefined;\n    try {\n      const { onAudioStream, onError, ...options } = recordingConfig;\n\n      const subscriptions: EventSubscription[] = [];\n\n      if (onAudioStream && typeof onAudioStream === \"function\") {\n        subscriptions.push(\n          addAudioEventListener(async (event: AudioEventPayload) => {\n            const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, error } = event;\n            if (error) return; // handled by MicrophoneError subscription; ignore here\n            if (!encoded) {\n              console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n              throw new Error(\"Encoded audio data is missing\");\n            }\n            onAudioStream({\n              data: encoded,\n              position,\n              fileUri,\n              eventDataSize: deltaSize,\n              totalSize,\n              soundLevel,\n              frequencyBands,\n            });\n          })\n        );\n      }\n\n      if (onError && typeof onError === \"function\") {\n        subscriptions.push(\n          addMicrophoneErrorListener((event) => {\n            onError(event);\n          })\n        );\n      }\n\n      if (subscriptions.length > 0) {\n        subscription = { remove: () => subscriptions.forEach((s) => s.remove()) };\n      }\n\n      const result = await ExpoPlayAudioStreamModule.startMicrophone(options);\n\n      return { recordingResult: result, subscription };\n    } catch (error) {\n      console.error(error);\n      subscription?.remove();\n      throw new Error(`Failed to start recording: ${error}`);\n    }\n  }\n\n  /**\n   * Stops the current microphone streaming.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone streaming fails to stop.\n   */\n  static async stopMicrophone(): Promise<AudioRecording | null> {\n    try {\n      return await ExpoPlayAudioStreamModule.stopMicrophone();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to stop mic stream: ${error}`);\n    }\n  }\n\n  /**\n   * Subscribes to audio events emitted during recording/streaming.\n   * @param onMicrophoneStream - Callback function that will be called when audio data is received.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events\n   */\n  static subscribeToAudioEvents(\n    onMicrophoneStream: (event: AudioDataEvent) => Promise<void>\n  ): Subscription {\n    return addAudioEventListener(async (event: AudioEventPayload) => {\n      const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands } =\n        event;\n      if (!encoded) {\n        console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n        throw new Error(\"Encoded audio data is missing\");\n      }\n      onMicrophoneStream?.({\n        data: encoded,\n        position,\n        fileUri,\n        eventDataSize: deltaSize,\n        totalSize,\n        soundLevel,\n        frequencyBands,\n      });\n    });\n  }\n\n  /**\n   * Subscribes to events emitted by the audio stream module, for advanced use cases.\n   * @param eventName - The name of the event to subscribe to.\n   * @param onEvent - Callback function that will be called when the event is emitted.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.\n   */\n  static subscribe<T extends unknown>(\n    eventName: string,\n    onEvent: (event: T | undefined) => Promise<void>\n  ): Subscription {\n    return subscribeToEvent(eventName, onEvent);\n  }\n\n  /**\n   * Prompts the user to select the microphone mode.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone mode fails to prompt.\n   */\n  static promptMicrophoneModes() {\n    ExpoPlayAudioStreamModule.promptMicrophoneModes();\n  }\n\n  /**\n   * Toggles the silence state of the microphone.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone fails to toggle silence.\n   */\n  static toggleSilence(isSilent: boolean) {\n    ExpoPlayAudioStreamModule.toggleSilence(isSilent);\n  }\n\n  /**\n   * Requests microphone permission from the user.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.\n   */\n  static async requestPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.requestPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to request permissions: ${error}`);\n    }\n  }\n\n  /**\n   * Gets the current microphone permission status.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.\n   */\n  static async getPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.getPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to get permissions: ${error}`);\n    }\n  }\n}\n\nexport {\n  AudioDataEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  AudioEvents,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n};\n\n// Re-export Subscription type for backwards compatibility\nexport type { EventSubscription } from \"expo-modules-core\";\nexport type { Subscription } from \"./events\";\nexport { addMicrophoneErrorListener } from \"./events\";\nexport type { MicrophoneErrorEventPayload } from \"./events\";\n\n// Export native audio pipeline V3\nexport { Pipeline } from \"./pipeline\";\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelinePlaybackStoppedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from \"./pipeline\";\n"]}

package/build/pipeline/index.d.ts

@@ -39,6 +39,19 @@ export declare class Pipeline {
     static getState(): PipelineState;
     /** Get a telemetry snapshot (buffer levels, counters, etc.). */
     static getTelemetry(): PipelineTelemetry;
+    /**
+     * Query the platform's current output latency — i.e., how long after a
+     * sample is written to the native buffer before it actually leaves the
+     * speaker.
+     *
+     * Value can change mid-session, notably on audio route changes such as
+     * switching from built-in speaker to Bluetooth (Bluetooth typically adds
+     * 100+ ms). **Always query at the moment you care; do not cache.**
+     *
+     * Returns 0 if the pipeline is not connected or the platform cannot
+     * report a value.
+     */
+    static getOutputLatencyMs(): number;
     /**
      * Subscribe to a specific pipeline event with full type safety.
      *
@@ -77,5 +90,5 @@ export declare class Pipeline {
         remove: () => void;
     };
 }
-export type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineBufferTelemetry, PipelineTelemetry, PipelineStateChangedEvent, PipelinePlaybackStartedEvent, PipelineErrorEvent, PipelineZombieDetectedEvent, PipelineUnderrunEvent, PipelineDrainedEvent, PipelineAudioFocusLostEvent, PipelineAudioFocusResumedEvent, } from './types';
+export type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineBufferTelemetry, PipelineTelemetry, PipelineStateChangedEvent, PipelinePlaybackStartedEvent, PipelineErrorEvent, PipelineZombieDetectedEvent, PipelineUnderrunEvent, PipelineDrainedEvent, PipelinePlaybackStoppedEvent, PipelineAudioFocusLostEvent, PipelineAudioFocusResumedEvent, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/build/pipeline/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ;IAKnB;;;;;;OAMG;WACU,OAAO,CAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;OAGG;WACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;;;OAMG;WACU,SAAS,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO;IAQhE;;;OAGG;WACU,cAAc,CACzB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC;IAQhB,oDAAoD;IACpD,MAAM,CAAC,QAAQ,IAAI,aAAa;IAIhC,gEAAgE;IAChE,MAAM,CAAC,YAAY,IAAI,iBAAiB;IAQxC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAC1C,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC7D,iBAAiB;IAWpB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAC3D;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IAuBzB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC9C;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;CAmB1B;AAGD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ;IAKnB;;;;;;OAMG;WACU,OAAO,CAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;OAGG;WACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;;;OAMG;WACU,SAAS,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO;IAQhE;;;OAGG;WACU,cAAc,CACzB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC;IAQhB,oDAAoD;IACpD,MAAM,CAAC,QAAQ,IAAI,aAAa;IAIhC,gEAAgE;IAChE,MAAM,CAAC,YAAY,IAAI,iBAAiB;IAIxC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM;IAQnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAC1C,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC7D,iBAAiB;IAWpB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAC3D;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IAuBzB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC9C;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;CAmB1B;AAGD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,SAAS,CAAC"}

package/build/pipeline/index.js

@@ -74,6 +74,21 @@ export class Pipeline {
     static getTelemetry() {
         return ExpoPlayAudioStreamModule.getPipelineTelemetry();
     }
+    /**
+     * Query the platform's current output latency — i.e., how long after a
+     * sample is written to the native buffer before it actually leaves the
+     * speaker.
+     *
+     * Value can change mid-session, notably on audio route changes such as
+     * switching from built-in speaker to Bluetooth (Bluetooth typically adds
+     * 100+ ms). **Always query at the moment you care; do not cache.**
+     *
+     * Returns 0 if the pipeline is not connected or the platform cannot
+     * report a value.
+     */
+    static getOutputLatencyMs() {
+        return ExpoPlayAudioStreamModule.getPipelineOutputLatencyMs();
+    }
     // ════════════════════════════════════════════════════════════════════════
     // Event subscriptions
     // ════════════════════════════════════════════════════════════════════════

package/build/pipeline/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"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","sourcesContent":["// ────────────────────────────────────────────────────────────────────────────\n// Native Audio Pipeline — V3 TypeScript Wrapper\n// ────────────────────────────────────────────────────────────────────────────\n//\n// Thin wrapper over the existing ExpoPlayAudioStreamModule (not a new native\n// module). Uses static methods matching the existing codebase pattern.\n//\n// Hot path:  pushAudioSync() — synchronous Function call, no Promise overhead.\n// Cold path: pushAudio()     — async with error propagation via Promise.\n\nimport type { EventSubscription } from 'expo-modules-core';\nimport ExpoPlayAudioStreamModule from '../ExpoPlayAudioStreamModule';\nimport { subscribeToEvent } from '../events';\n\nimport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineTelemetry,\n} from './types';\n\nexport class Pipeline {\n  // ════════════════════════════════════════════════════════════════════════\n  // Lifecycle\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Connect the native audio pipeline.\n   *\n   * Creates an AudioTrack (buffer size from device HAL), jitter buffer, and\n   * MAX_PRIORITY write thread. Config is immutable per session — disconnect\n   * and reconnect to change sample rate.\n   */\n  static async connect(\n    options: ConnectPipelineOptions = {}\n  ): Promise<ConnectPipelineResult> {\n    return await ExpoPlayAudioStreamModule.connectPipeline(options);\n  }\n\n  /**\n   * Disconnect the pipeline. Tears down AudioTrack, write thread, audio\n   * focus, volume guard, and zombie detection.\n   */\n  static async disconnect(): Promise<void> {\n    return await ExpoPlayAudioStreamModule.disconnectPipeline();\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Push audio\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Push base64-encoded PCM16 audio into the jitter buffer (async).\n   *\n   * Use this when you need error propagation via Promise rejection.\n   * For the hot path (e.g., inside a WebSocket message handler), prefer\n   * [pushAudioSync] which avoids Promise overhead.\n   */\n  static async pushAudio(options: PushPipelineAudioOptions): Promise<void> {\n    return await ExpoPlayAudioStreamModule.pushPipelineAudio(options);\n  }\n\n  /**\n   * Push base64-encoded PCM16 audio synchronously (no Promise overhead).\n   *\n   * Designed for the hot path — call this from your WebSocket onmessage\n   * handler for minimum latency. Returns `true` on success, `false` on\n   * failure (errors are also reported via PipelineError events).\n   */\n  static pushAudioSync(options: PushPipelineAudioOptions): boolean {\n    return ExpoPlayAudioStreamModule.pushPipelineAudioSync(options);\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Turn management\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Invalidate the current turn. Resets the jitter buffer so stale audio\n   * from the old turn is discarded immediately.\n   */\n  static async invalidateTurn(\n    options: InvalidatePipelineTurnOptions\n  ): Promise<void> {\n    return await ExpoPlayAudioStreamModule.invalidatePipelineTurn(options);\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // State & Telemetry\n  // ════════════════════════════════════════════════════════════════════════\n\n  /** Get the current pipeline state synchronously. */\n  static getState(): PipelineState {\n    return ExpoPlayAudioStreamModule.getPipelineState() as PipelineState;\n  }\n\n  /** Get a telemetry snapshot (buffer levels, counters, etc.). */\n  static getTelemetry(): PipelineTelemetry {\n    return ExpoPlayAudioStreamModule.getPipelineTelemetry() as PipelineTelemetry;\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Event subscriptions\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Subscribe to a specific pipeline event with full type safety.\n   *\n   * @example\n   * ```ts\n   * const sub = Pipeline.subscribe('PipelineStateChanged', async (e) => {\n   *   console.log('State:', e.state);\n   * });\n   * // Later:\n   * sub.remove();\n   * ```\n   */\n  static subscribe<K extends PipelineEventName>(\n    eventName: K,\n    listener: (event: PipelineEventMap[K]) => Promise<void> | void\n  ): EventSubscription {\n    return subscribeToEvent<PipelineEventMap[K]>(\n      eventName,\n      async (event) => {\n        if (event !== undefined) {\n          await listener(event);\n        }\n      }\n    );\n  }\n\n  /**\n   * Convenience: subscribe to both PipelineError and PipelineZombieDetected.\n   *\n   * Useful for a single error handler that covers fatal and near-fatal\n   * conditions. The callback receives a normalized `{ code, message }`.\n   */\n  static onError(\n    listener: (error: { code: string; message: string }) => void\n  ): { remove: () => void } {\n    const subs: EventSubscription[] = [];\n\n    subs.push(\n      Pipeline.subscribe('PipelineError', async (e) => {\n        listener({ code: e.code, message: e.message });\n      })\n    );\n\n    subs.push(\n      Pipeline.subscribe('PipelineZombieDetected', async (e) => {\n        listener({\n          code: 'ZOMBIE_DETECTED',\n          message: `AudioTrack stalled for ${e.stalledMs}ms at head=${e.playbackHead}`,\n        });\n      })\n    );\n\n    return {\n      remove: () => subs.forEach((s) => s.remove()),\n    };\n  }\n\n  /**\n   * Convenience: subscribe to audio focus loss and resumption events.\n   *\n   * During focus loss the pipeline writes silence instead of real audio.\n   * The caller should typically invalidateTurn + re-request audio from the\n   * AI backend on focus regain.\n   */\n  static onAudioFocus(\n    listener: (event: { focused: boolean }) => void\n  ): { remove: () => void } {\n    const subs: EventSubscription[] = [];\n\n    subs.push(\n      Pipeline.subscribe('PipelineAudioFocusLost', async () => {\n        listener({ focused: false });\n      })\n    );\n\n    subs.push(\n      Pipeline.subscribe('PipelineAudioFocusResumed', async () => {\n        listener({ focused: true });\n      })\n    );\n\n    return {\n      remove: () => subs.forEach((s) => s.remove()),\n    };\n  }\n}\n\n// Re-export all types for consumer convenience\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"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","sourcesContent":["// ────────────────────────────────────────────────────────────────────────────\n// Native Audio Pipeline — V3 TypeScript Wrapper\n// ────────────────────────────────────────────────────────────────────────────\n//\n// Thin wrapper over the existing ExpoPlayAudioStreamModule (not a new native\n// module). Uses static methods matching the existing codebase pattern.\n//\n// Hot path:  pushAudioSync() — synchronous Function call, no Promise overhead.\n// Cold path: pushAudio()     — async with error propagation via Promise.\n\nimport type { EventSubscription } from 'expo-modules-core';\nimport ExpoPlayAudioStreamModule from '../ExpoPlayAudioStreamModule';\nimport { subscribeToEvent } from '../events';\n\nimport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineTelemetry,\n} from './types';\n\nexport class Pipeline {\n  // ════════════════════════════════════════════════════════════════════════\n  // Lifecycle\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Connect the native audio pipeline.\n   *\n   * Creates an AudioTrack (buffer size from device HAL), jitter buffer, and\n   * MAX_PRIORITY write thread. Config is immutable per session — disconnect\n   * and reconnect to change sample rate.\n   */\n  static async connect(\n    options: ConnectPipelineOptions = {}\n  ): Promise<ConnectPipelineResult> {\n    return await ExpoPlayAudioStreamModule.connectPipeline(options);\n  }\n\n  /**\n   * Disconnect the pipeline. Tears down AudioTrack, write thread, audio\n   * focus, volume guard, and zombie detection.\n   */\n  static async disconnect(): Promise<void> {\n    return await ExpoPlayAudioStreamModule.disconnectPipeline();\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Push audio\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Push base64-encoded PCM16 audio into the jitter buffer (async).\n   *\n   * Use this when you need error propagation via Promise rejection.\n   * For the hot path (e.g., inside a WebSocket message handler), prefer\n   * [pushAudioSync] which avoids Promise overhead.\n   */\n  static async pushAudio(options: PushPipelineAudioOptions): Promise<void> {\n    return await ExpoPlayAudioStreamModule.pushPipelineAudio(options);\n  }\n\n  /**\n   * Push base64-encoded PCM16 audio synchronously (no Promise overhead).\n   *\n   * Designed for the hot path — call this from your WebSocket onmessage\n   * handler for minimum latency. Returns `true` on success, `false` on\n   * failure (errors are also reported via PipelineError events).\n   */\n  static pushAudioSync(options: PushPipelineAudioOptions): boolean {\n    return ExpoPlayAudioStreamModule.pushPipelineAudioSync(options);\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Turn management\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Invalidate the current turn. Resets the jitter buffer so stale audio\n   * from the old turn is discarded immediately.\n   */\n  static async invalidateTurn(\n    options: InvalidatePipelineTurnOptions\n  ): Promise<void> {\n    return await ExpoPlayAudioStreamModule.invalidatePipelineTurn(options);\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // State & Telemetry\n  // ════════════════════════════════════════════════════════════════════════\n\n  /** Get the current pipeline state synchronously. */\n  static getState(): PipelineState {\n    return ExpoPlayAudioStreamModule.getPipelineState() as PipelineState;\n  }\n\n  /** Get a telemetry snapshot (buffer levels, counters, etc.). */\n  static getTelemetry(): PipelineTelemetry {\n    return ExpoPlayAudioStreamModule.getPipelineTelemetry() as PipelineTelemetry;\n  }\n\n  /**\n   * Query the platform's current output latency — i.e., how long after a\n   * sample is written to the native buffer before it actually leaves the\n   * speaker.\n   *\n   * Value can change mid-session, notably on audio route changes such as\n   * switching from built-in speaker to Bluetooth (Bluetooth typically adds\n   * 100+ ms). **Always query at the moment you care; do not cache.**\n   *\n   * Returns 0 if the pipeline is not connected or the platform cannot\n   * report a value.\n   */\n  static getOutputLatencyMs(): number {\n    return ExpoPlayAudioStreamModule.getPipelineOutputLatencyMs() as number;\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Event subscriptions\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Subscribe to a specific pipeline event with full type safety.\n   *\n   * @example\n   * ```ts\n   * const sub = Pipeline.subscribe('PipelineStateChanged', async (e) => {\n   *   console.log('State:', e.state);\n   * });\n   * // Later:\n   * sub.remove();\n   * ```\n   */\n  static subscribe<K extends PipelineEventName>(\n    eventName: K,\n    listener: (event: PipelineEventMap[K]) => Promise<void> | void\n  ): EventSubscription {\n    return subscribeToEvent<PipelineEventMap[K]>(\n      eventName,\n      async (event) => {\n        if (event !== undefined) {\n          await listener(event);\n        }\n      }\n    );\n  }\n\n  /**\n   * Convenience: subscribe to both PipelineError and PipelineZombieDetected.\n   *\n   * Useful for a single error handler that covers fatal and near-fatal\n   * conditions. The callback receives a normalized `{ code, message }`.\n   */\n  static onError(\n    listener: (error: { code: string; message: string }) => void\n  ): { remove: () => void } {\n    const subs: EventSubscription[] = [];\n\n    subs.push(\n      Pipeline.subscribe('PipelineError', async (e) => {\n        listener({ code: e.code, message: e.message });\n      })\n    );\n\n    subs.push(\n      Pipeline.subscribe('PipelineZombieDetected', async (e) => {\n        listener({\n          code: 'ZOMBIE_DETECTED',\n          message: `AudioTrack stalled for ${e.stalledMs}ms at head=${e.playbackHead}`,\n        });\n      })\n    );\n\n    return {\n      remove: () => subs.forEach((s) => s.remove()),\n    };\n  }\n\n  /**\n   * Convenience: subscribe to audio focus loss and resumption events.\n   *\n   * During focus loss the pipeline writes silence instead of real audio.\n   * The caller should typically invalidateTurn + re-request audio from the\n   * AI backend on focus regain.\n   */\n  static onAudioFocus(\n    listener: (event: { focused: boolean }) => void\n  ): { remove: () => void } {\n    const subs: EventSubscription[] = [];\n\n    subs.push(\n      Pipeline.subscribe('PipelineAudioFocusLost', async () => {\n        listener({ focused: false });\n      })\n    );\n\n    subs.push(\n      Pipeline.subscribe('PipelineAudioFocusResumed', async () => {\n        listener({ focused: true });\n      })\n    );\n\n    return {\n      remove: () => subs.forEach((s) => s.remove()),\n    };\n  }\n}\n\n// Re-export all types for consumer convenience\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelinePlaybackStoppedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from './types';\n"]}