@edkimmel/expo-audio-stream 0.4.1 → 0.5.0

package/NATIVE_EVENTS.md

@@ -200,6 +200,43 @@ The pipeline transitions from `draining` to `idle`.
 
 ---
 
+### `PipelinePlaybackStopped`
+
+Fired approximately `outputLatencyMs` after `PipelineDrained` for the same turn —
+i.e., when the last sample physically leaves the speaker. Pairs symmetrically
+with `PipelinePlaybackStarted` (start-of-emission ↔ end-of-emission).
+
+**Distinct from `state: 'idle'`:** that's the pipeline-state-machine value
+reported via `PipelineStateChanged`. `PipelinePlaybackStopped` is a
+physical-world milestone about audible audio, not a state-machine transition.
+
+| Field | Type | Notes |
+|---|---|---|
+| `turnId` | `string` | The turn whose last sample just stopped emitting |
+
+**Cancellation:** the scheduled dispatch is cancelled if a new turn starts,
+`invalidatePipelineTurn` is called, or the pipeline disconnects before the
+delay elapses. Consumers will not receive a late-arriving event mid-stream.
+
+**Approximation:** the delay uses `outputLatencyMs` captured at drain time.
+On iOS the value reflects `AVAudioSession.outputLatency` (total HW output
+latency). On Android it uses `AudioTrack.getTimestamp()` to compute frames
+in-flight, falling back to a HAL-buffer estimate if the timestamp call fails.
+A route change during the latency window (e.g. switch to Bluetooth mid-tail)
+is *not* re-measured — the captured value is used. The error is typically
+single-digit milliseconds and is acceptable for VAD-gating use cases.
+
+**Platform:** Android, iOS
+
+**JS response:**
+- Use this — not `PipelineDrained` — when you need to know when **mic-side
+  echo from the speaker is over**. Useful for voice-agent pipelines that
+  gate server-side VAD on the agent's own playback ending.
+- If you do not care about the physical-world emission boundary, prefer
+  `PipelineDrained` (cheaper, fires earlier).
+
+---
+
 ### `PipelineFrequencyBands`
 
 Fired at the interval configured by `frequencyBandIntervalMs` during pipeline

package/README.md

@@ -79,6 +79,7 @@ const result = await Pipeline.connect({
   channelCount: 1,
   targetBufferMs: 80,
   frequencyBandIntervalMs: 100, // optional: emit frequency bands every 100ms
+  audioMode: "mixWithOthers",   // coexist with other apps (default)
 });
 
 // Subscribe to events
@@ -226,11 +227,23 @@ interface ConnectPipelineOptions {
   sampleRate?: number;              // default 24000
   channelCount?: number;            // default 1 (mono)
   targetBufferMs?: number;          // ms to buffer before priming gate opens (default 80)
+  playbackMode?: "voiceProcessing" | "conversation";
   frequencyBandIntervalMs?: number; // emit PipelineFrequencyBands every N ms (omit to disable)
   frequencyBandConfig?: FrequencyBandConfig; // crossover frequencies (optional)
+  audioMode?: "mixWithOthers" | "duckOthers" | "doNotMix"; // default "mixWithOthers"
 }
 ```
 
+#### `audioMode`
+
+Controls how pipeline playback coexists with audio from other apps on the device. Default: `"mixWithOthers"` (matches expo-audio).
+
+- **`"mixWithOthers"`** — plays alongside other apps without interrupting them. On Android no audio focus is requested; on iOS the session uses the `.mixWithOthers` category option. Best for sound effects and short clips.
+- **`"duckOthers"`** — requests audio focus with ducking. Other apps lower their volume but keep playing.
+- **`"doNotMix"`** — requests exclusive audio focus. Other apps pause.
+
+> **Breaking change:** The default was effectively `"doNotMix"` in prior versions. If you rely on the previous behavior — where connecting the pipeline pauses other apps' audio — pass `audioMode: "doNotMix"` explicitly when calling `Pipeline.connect`.
+
 ### PushPipelineAudioOptions
 
 ```typescript

package/android/src/main/java/expo/modules/audiostream/ExpoPlayAudioStreamModule.kt

@@ -101,6 +101,7 @@ class ExpoPlayAudioStreamModule : Module(), EventSender {
             PipelineIntegration.EVENT_ZOMBIE_DETECTED,
             PipelineIntegration.EVENT_UNDERRUN,
             PipelineIntegration.EVENT_DRAINED,
+            PipelineIntegration.EVENT_PLAYBACK_STOPPED,
             PipelineIntegration.EVENT_AUDIO_FOCUS_LOST,
             PipelineIntegration.EVENT_AUDIO_FOCUS_RESUMED,
             PipelineIntegration.EVENT_FREQUENCY_BANDS
@@ -194,6 +195,10 @@ class ExpoPlayAudioStreamModule : Module(), EventSender {
             pipelineIntegration.getState()
         }
 
+        Function("getPipelineOutputLatencyMs") {
+            pipelineIntegration.outputLatencyMs()
+        }
+
     }
     private fun initializeManager() {
         val androidContext =

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)
@@ -58,6 +59,29 @@ interface PipelineListener {
 // AudioPipeline
 // ────────────────────────────────────────────────────────────────────────────
 
+/**
+ * Controls how pipeline playback coexists with audio from other apps.
+ * Mirrors the `PipelineAudioMode` TS type.
+ */
+enum class AudioMode {
+    /** No focus request — playback mixes freely with other audio. */
+    MIX_WITH_OTHERS,
+
+    /** Request transient focus with ducking — others lower volume but keep playing. */
+    DUCK_OTHERS,
+
+    /** Request exclusive focus — others pause. */
+    DO_NOT_MIX;
+
+    companion object {
+        fun fromString(value: String?): AudioMode = when (value) {
+            "duckOthers" -> DUCK_OTHERS
+            "doNotMix"   -> DO_NOT_MIX
+            else         -> MIX_WITH_OTHERS  // default includes null, "mixWithOthers", and unknown
+        }
+    }
+}
+
 /**
  * Core orchestrator for the native audio pipeline.
  *
@@ -90,6 +114,7 @@ class AudioPipeline(
     private val frequencyBandIntervalMs: Int = 100,
     private val lowCrossoverHz: Float = 300f,
     private val highCrossoverHz: Float = 2000f,
+    private val audioMode: AudioMode = AudioMode.MIX_WITH_OTHERS,
     private val listener: PipelineListener
 ) {
     companion object {
@@ -190,6 +215,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
@@ -203,6 +235,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
@@ -285,8 +319,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
         }
     }
 
@@ -297,6 +331,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
@@ -383,6 +420,7 @@ class AudioPipeline(
                 pendingFlush.set(true)
                 setState(PipelineState.STREAMING)
                 frequencyBandAnalyzer?.reset()
+                cancelPendingPlaybackStopped()
             }
 
             // ── Decode base64 → PCM shorts ──────────────────────────────
@@ -427,6 +465,7 @@ class AudioPipeline(
             lastReportedUnderrunCount = 0
             setState(PipelineState.IDLE)
             frequencyBandAnalyzer?.reset()
+            cancelPendingPlaybackStopped()
         }
     }
 
@@ -455,6 +494,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)
     // ════════════════════════════════════════════════════════════════════
@@ -510,6 +580,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()) {
@@ -537,7 +610,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)
             }
         }
@@ -550,18 +626,46 @@ class AudioPipeline(
     // ════════════════════════════════════════════════════════════════════
 
     private fun requestAudioFocus() {
-        val result = audioManager.requestAudioFocus(
-            focusChangeListener,
-            AudioManager.STREAM_MUSIC,
-            AudioManager.AUDIOFOCUS_GAIN
-        )
-        hasAudioFocus.set(result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED)
-        if (!hasAudioFocus.get()) {
-            Log.w(TAG, "Audio focus request denied")
+        when (audioMode) {
+            AudioMode.MIX_WITH_OTHERS -> {
+                // No focus request — we coexist silently with other apps.
+                // Mark as "has focus" so the write loop proceeds unconditionally.
+                hasAudioFocus.set(true)
+                audioFocusLost.set(false)
+                Log.d(TAG, "Audio focus skipped (mixWithOthers)")
+            }
+            AudioMode.DUCK_OTHERS -> {
+                val result = audioManager.requestAudioFocus(
+                    focusChangeListener,
+                    AudioManager.STREAM_MUSIC,
+                    AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
+                )
+                hasAudioFocus.set(result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED)
+                if (!hasAudioFocus.get()) {
+                    Log.w(TAG, "Audio focus request (duckOthers) denied")
+                }
+            }
+            AudioMode.DO_NOT_MIX -> {
+                val result = audioManager.requestAudioFocus(
+                    focusChangeListener,
+                    AudioManager.STREAM_MUSIC,
+                    AudioManager.AUDIOFOCUS_GAIN
+                )
+                hasAudioFocus.set(result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED)
+                if (!hasAudioFocus.get()) {
+                    Log.w(TAG, "Audio focus request (doNotMix) denied")
+                }
+            }
         }
     }
 
     private fun abandonAudioFocus() {
+        if (audioMode == AudioMode.MIX_WITH_OTHERS) {
+            // No focus was ever requested — nothing to abandon.
+            hasAudioFocus.set(false)
+            audioFocusLost.set(false)
+            return
+        }
         audioManager.abandonAudioFocus(focusChangeListener)
         hasAudioFocus.set(false)
         audioFocusLost.set(false)
@@ -720,6 +824,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
@@ -735,6 +876,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"
@@ -121,6 +122,7 @@ class PipelineIntegration(
             val bandConfig = options["frequencyBandConfig"] as? Map<*, *>
             val lowCrossoverHz = (bandConfig?.get("lowCrossoverHz") as? Number)?.toFloat() ?: 300f
             val highCrossoverHz = (bandConfig?.get("highCrossoverHz") as? Number)?.toFloat() ?: 2000f
+            val audioMode = AudioMode.fromString(options["audioMode"] as? String)
 
             pipeline = AudioPipeline(
                 context = context,
@@ -130,6 +132,7 @@ class PipelineIntegration(
                 frequencyBandIntervalMs = frequencyBandIntervalMs,
                 lowCrossoverHz = lowCrossoverHz,
                 highCrossoverHz = highCrossoverHz,
+                audioMode = audioMode,
                 listener = this
             )
             pipeline!!.connect()
@@ -245,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.
@@ -303,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";

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;;;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"}

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,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  /** 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  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"]}

package/build/index.d.ts

@@ -73,5 +73,5 @@ export { AudioDataEvent, DeviceReconnectedReason, DeviceReconnectedEventPayload,
 export type { EventSubscription } from "expo-modules-core";
 export type { Subscription } 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":"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;IAuDF;;;;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,4BAA4B,EAC5B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/build/index.js

@@ -19,10 +19,15 @@ export class ExpoPlayAudioStream {
     static async startMicrophone(recordingConfig) {
         let subscription;
         try {
-            const { onAudioStream, ...options } = recordingConfig;
-            if (onAudioStream && typeof onAudioStream == "function") {
+            const { onAudioStream, onError, ...options } = recordingConfig;
+            if ((onAudioStream && typeof onAudioStream == "function") ||
+                (onError && typeof onError == "function")) {
                 subscription = addAudioEventListener(async (event) => {
-                    const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, } = event;
+                    const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, error, errorMessage, } = event;
+                    if (error) {
+                        onError?.({ code: error, message: errorMessage ?? "" });
+                        return;
+                    }
                     if (!encoded) {
                         console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);
                         throw new Error("Encoded audio data is missing");

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,yBAAyB,MAAM,6BAA6B,CAAC;AAIpE,OAAO,EAOL,aAAa,EAEb,aAAa,GAcd,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,qBAAqB,EAErB,WAAW,EACX,gBAAgB,GAGjB,MAAM,UAAU,CAAC;AAElB,MAAM,OAAO,mBAAmB;IAC9B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO;QAClB,MAAM,yBAAyB,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,eAAgC;QAI3D,IAAI,YAAsC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,GAAG,eAAe,CAAC;YAEtD,IAAI,aAAa,IAAI,OAAO,aAAa,IAAI,UAAU,EAAE,CAAC;gBACxD,YAAY,GAAG,qBAAqB,CAClC,KAAK,EAAE,KAAwB,EAAE,EAAE;oBACjC,MAAM,EACJ,OAAO,EACP,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,UAAU,EACV,cAAc,GACf,GAAG,KAAK,CAAC;oBACV,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,CAAC,KAAK,CACX,qDAAqD,CACtD,CAAC;wBACF,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;oBACnD,CAAC;oBACD,aAAa,EAAE,CAAC;wBACd,IAAI,EAAE,OAAO;wBACb,QAAQ;wBACR,OAAO;wBACP,aAAa,EAAE,SAAS;wBACxB,SAAS;wBACT,UAAU;wBACV,cAAc;qBACf,CAAC,CAAC;gBACL,CAAC,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAExE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,yBAAyB,CAAC,cAAc,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAC3B,kBAA4D;QAE5D,OAAO,qBAAqB,CAAC,KAAK,EAAE,KAAwB,EAAE,EAAE;YAC9D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,GACpF,KAAK,CAAC;YACR,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YACD,kBAAkB,EAAE,CAAC;gBACnB,IAAI,EAAE,OAAO;gBACb,QAAQ;gBACR,OAAO;gBACP,aAAa,EAAE,SAAS;gBACxB,SAAS;gBACT,UAAU;gBACV,cAAc;aACf,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CACd,SAAiB,EACjB,OAAgD;QAEhD,OAAO,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,qBAAqB;QAC1B,yBAAyB,CAAC,qBAAqB,EAAE,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,QAAiB;QACpC,yBAAyB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,uBAAuB;QAKlC,IAAI,CAAC;YACH,OAAO,MAAM,yBAAyB,CAAC,uBAAuB,EAAE,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,mBAAmB;QAK9B,IAAI,CAAC;YACH,OAAO,MAAM,yBAAyB,CAAC,mBAAmB,EAAE,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AAED,OAAO,EAOL,WAAW,EAGX,aAAa,EAEb,aAAa,GAcd,CAAC;AAMF,kCAAkC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC","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  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      if (\n        (onAudioStream && typeof onAudioStream == \"function\") ||\n        (onError && typeof onError == \"function\")\n      ) {\n        subscription = addAudioEventListener(\n          async (event: AudioEventPayload) => {\n            const {\n              fileUri,\n              deltaSize,\n              totalSize,\n              position,\n              encoded,\n              soundLevel,\n              frequencyBands,\n              error,\n              errorMessage,\n            } = event;\n            if (error) {\n              onError?.({ code: error, message: errorMessage ?? \"\" });\n              return;\n            }\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  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
     // ════════════════════════════════════════════════════════════════════════