@rntp/player 5.1.0 → 5.1.2

package/android/src/main/java/com/doublesymmetry/trackplayer/TrackPlayerModule.kt

@@ -48,10 +48,6 @@ class TrackPlayerModule internal constructor(private val context: ReactApplicati
   private val controller = MainThreadMediaController()
   private var lastStreamMetadata: MetadataReceivedEvent? = null
   private var lastMediaMetadata: MediaMetadataChangedEvent? = null
-  // Cached PlayerConfig.autoUpdateMetadataFromStream — refreshed in setupPlayer.
-  // When true, ICY/ID3 updates rewrite the queued MediaItem so Now Playing /
-  // getActiveMediaItem follow the live title even without JS. When false, we
-  // only emit MetadataReceived and let the app mutate the queue itself.
   @Volatile private var autoUpdateMetadataFromStream: Boolean = true
 
   // endregion
@@ -671,10 +667,6 @@ class TrackPlayerModule internal constructor(private val context: ReactApplicati
     context.emitEvent(PlaybackStateChangedEvent(state))
   }
 
-  // Effective MediaItem metadata changed (queue transitioned, an
-  // updateMetadata call landed, or the auto-update path rewrote the active
-  // item). This is what backs `getActiveMediaItem()` and the system Now
-  // Playing info, so this is the surface most apps want to observe.
   override fun onMediaMetadataChanged(mediaMetadata: MediaMetadata) {
     val event = MediaMetadataChangedEvent(
       title = mediaMetadata.title?.toString(),
@@ -690,18 +682,6 @@ class TrackPlayerModule internal constructor(private val context: ReactApplicati
     context.emitEvent(event)
   }
 
-  // Raw stream-derived metadata (ICY blocks, ID3 frames, ...). Always emit
-  // the pre-merge view so consumers that need stream-truth (e.g. analytics
-  // or sanitization pipelines) see every frame.
-  //
-  // When `autoUpdateMetadataFromStream` is enabled (default), additionally
-  // rewrite the active MediaItem so the merged effective view picks up the
-  // change. That replaceMediaItem call triggers `onMediaMetadataChanged`,
-  // which then emits `MediaMetadataChanged` with the merged result —
-  // preserving any user-supplied fields (genre, album, etc.) the stream
-  // didn't include. The two events are intentionally separate: one for
-  // "what came in" (synchronous), one for "what the active item is now"
-  // (after the binder roundtrip lands).
   override fun onMetadata(metadata: Metadata) {
     val event = StreamMetadataExtractor.extract(metadata) ?: return
     if (event != lastStreamMetadata) {

package/android/src/main/java/com/doublesymmetry/trackplayer/models/EmitEventType.kt

@@ -85,15 +85,7 @@ data class MetadataReceivedEvent(
   }
 }
 
-/**
- * Carries the *effective* metadata of the currently active MediaItem after
- * any merge between stream-derived metadata and user-supplied fields. Fires
- * on track transitions, explicit updateMetadata calls, and (when
- * autoUpdateMetadataFromStream is enabled) after the native side rewrites
- * the active item in response to stream metadata.
- *
- * Mirrors Media3's Player.Listener.onMediaMetadataChanged callback.
- */
+/** Effective active-item metadata (Media3 [Player.Listener.onMediaMetadataChanged]). */
 data class MediaMetadataChangedEvent(
   val title: String?,
   val artist: String?,

package/android/src/main/java/com/doublesymmetry/trackplayer/models/MetadataApplier.kt

@@ -9,32 +9,9 @@ import android.net.Uri
 import androidx.media3.common.MediaMetadata
 import androidx.media3.common.Player
 
-/**
- * Pure helper that writes a stream-derived [MetadataReceivedEvent] back into
- * the [Player]'s current MediaItem.
- *
- * Used by [com.doublesymmetry.trackplayer.TrackPlayerModule.onMetadata] when
- * `PlayerConfig.autoUpdateMetadataFromStream` is enabled (the default), so
- * that:
- *  - `getActiveMediaItem()` reflects the live ICY title.
- *  - `MPNowPlayingInfoCenter`'s Android analogue (Media3 session → system
- *    notification, Bluetooth, Android Auto) follows along.
- *
- * Lives outside [com.doublesymmetry.trackplayer.TrackPlayerModule] so it can
- * be unit-tested against a real [androidx.media3.exoplayer.ExoPlayer] under
- * Robolectric without spinning up a [androidx.media3.session.MediaController]
- * + service.
- */
+/** Merges stream metadata into the current [Player] media item (see [PlayerConfig.autoUpdateMetadataFromStream]). */
 internal object MetadataApplier {
 
-  /**
-   * Merges [event]'s non-null fields onto the current item's [MediaMetadata]
-   * and dispatches a [Player.replaceMediaItem]. The new MediaItem reuses the
-   * existing URI so Media3 keeps playback uninterrupted.
-   *
-   * @return `true` if the mutation was dispatched, `false` if there is no
-   *         current item to update.
-   */
   fun applyToCurrentMediaItem(player: Player, event: MetadataReceivedEvent): Boolean {
     val idx = player.currentMediaItemIndex
     if (idx < 0 || idx >= player.mediaItemCount) return false

package/android/src/test/java/com/doublesymmetry/trackplayer/models/MetadataApplierTest.kt

@@ -20,13 +20,6 @@ import org.robolectric.RobolectricTestRunner
 import org.robolectric.RuntimeEnvironment
 import org.robolectric.annotation.Config
 
-/**
- * Exercises [MetadataApplier.applyToCurrentMediaItem] against a real
- * [ExoPlayer] under Robolectric. We use [ExoPlayer] directly (rather than the
- * [androidx.media3.session.MediaController] used at runtime) because both
- * implement the [androidx.media3.common.Player] interface that the applier
- * targets — and ExoPlayer is the only one we can stand up without a service.
- */
 @RunWith(RobolectricTestRunner::class)
 @Config(sdk = [33])
 class MetadataApplierTest {
@@ -80,9 +73,6 @@ class MetadataApplierTest {
 
   @Test
   fun `preserves existing user-supplied fields the event does not touch`() {
-    // Mirrors the real-world case: an app queues a radio station with a fixed
-    // `genre` / `albumTitle` and the stream subsequently sends new ICY titles
-    // without artwork/genre. Those originals must survive the rewrite.
     player.setMediaItems(
       listOf(
         buildItem(
@@ -107,8 +97,6 @@ class MetadataApplierTest {
 
   @Test
   fun `overwrites previous stream-supplied title on next update`() {
-    // Two consecutive ICY updates: second one fully replaces the first's
-    // title + artist (same currentIndex, so the rewrite is in place).
     player.setMediaItems(listOf(buildItem("radio")))
 
     MetadataApplier.applyToCurrentMediaItem(
@@ -127,9 +115,6 @@ class MetadataApplierTest {
 
   @Test
   fun `null fields in event do not clobber existing values (sticky semantics)`() {
-    // Match iOS withMetadata behavior: nil from stream means "leave alone",
-    // not "clear". Useful when a station sends artist on one update and only
-    // title on the next.
     player.setMediaItems(listOf(buildItem(id = "radio", artist = "Existing Artist")))
     val event = MetadataReceivedEvent(title = "Just a Title", artist = null)
 
@@ -212,7 +197,6 @@ class MetadataApplierTest {
         buildItem("track-3", title = "Title 3"),
       )
     )
-    // currentIndex defaults to 0 — that's the one we expect to mutate.
     val event = MetadataReceivedEvent(title = "Live Title 1", artist = null)
 
     MetadataApplier.applyToCurrentMediaItem(player, event)
@@ -226,9 +210,6 @@ class MetadataApplierTest {
 
   @Test
   fun `event with all null fields leaves item unchanged but still reports applied`() {
-    // The applier doesn't gate on empty events — that's the caller's job
-    // (StreamMetadataExtractor.extract already returns null for empty
-    // metadata blocks, so this code path is mostly defensive).
     player.setMediaItems(listOf(buildItem(id = "radio", title = "Original Title")))
     val event = MetadataReceivedEvent(
       title = null, artist = null, albumTitle = null, artworkUri = null, genre = null,

package/ios/TrackPlayer.swift

@@ -20,15 +20,7 @@ class TrackPlayer: RCTEventEmitter {
   private var progressSyncTimer: Timer?
   private var progressSyncIntervalSeconds: Double = 0
   private var progressSyncHttpUrl: String?
-  // When true (default), incoming stream metadata (ICY/ID3) is written back
-  // into the queued MediaItem so getActiveTrack() and MPNowPlayingInfoCenter
-  // reflect the live title. When false, only the MetadataReceived event fires
-  // and apps update the queue themselves via TrackPlayer.updateMetadata(…).
   private var autoUpdateMetadataFromStream: Bool = true
-  // Tracks the last-emitted effective metadata so we don't double-emit
-  // MediaMetadataChanged when the same merged view lands twice (e.g. an
-  // ICY frame with no actual changes, or a manual updateMetadata that
-  // re-applies identical fields).
   private var lastEmittedMediaMetadata: MediaMetadataChangedEvent?
   private var progressSyncHttpHeaders: [String: String]?
 
@@ -323,9 +315,6 @@ class TrackPlayer: RCTEventEmitter {
     )
 
     player.updateMetadata(at: idx, with: updated)
-    // Only emit MediaMetadataChanged for the *active* item — updating a
-    // non-current queue entry's metadata changes its stored fields but
-    // doesn't affect what `getActiveMediaItem` returns.
     if idx == player.currentIndex {
       emitMediaMetadataChangedIfNeeded(for: updated)
     }
@@ -557,17 +546,12 @@ class TrackPlayer: RCTEventEmitter {
     let mediaItem = item as? MediaItem
     let dict = mediaItem?.toDictionary()
     BrowseTreeStore.shared.updateNowPlaying(mediaId: mediaItem?.mediaId)
-    // Reset dedup state on transitions so the first emit for the new item
-    // is never suppressed by a coincidental match against the previous one.
     lastEmittedMediaMetadata = nil
     emitEvent(event: MediaItemTransitionEvent(item: dict, index: index))
     emitMediaMetadataChangedIfNeeded(for: mediaItem)
   }
 
   func handleMetadataReceived(_ metadata: StreamMetadata) {
-    // Always emit the raw stream-truth event first (mirrors Android: synchronous,
-    // pre-merge). Consumers that care about the *effective* view get the
-    // separate MediaMetadataChanged event below.
     emitEvent(event: MetadataReceivedEvent(metadata: metadata))
 
     guard autoUpdateMetadataFromStream else { return }
@@ -584,12 +568,7 @@ class TrackPlayer: RCTEventEmitter {
     emitMediaMetadataChangedIfNeeded(for: updated)
   }
 
-  /// Build a MediaMetadataChanged event from a merged MediaItem and emit it,
-  /// skipping duplicate emits when the effective view is unchanged.
-  ///
-  /// Note: iOS's MediaItem schema does not include `genre`, so that field
-  /// is always nil in events from this platform. Android emits it whenever
-  /// present in either the queued item or the stream.
+  /// iOS MediaItem has no `genre`; Android may include it in this event.
   private func emitMediaMetadataChangedIfNeeded(for item: MediaItem?) {
     guard let item else { return }
     let event = MediaMetadataChangedEvent(

package/ios/tests/AVPlayerEngineIntegrationTests.swift

@@ -9,13 +9,7 @@ import XCTest
 @testable import PlayerCore
 
 final class AVPlayerEngineIntegrationTests: XCTestCase {
-  // Generous timeout for tests that play AAC to completion through the cache
-  // proxy. The fast path is sub-second locally, but GitHub-hosted runners
-  // routinely starve the simulator audio pipeline ("HALC IOWorkLoop: skipping
-  // cycle due to overload") and the previous 10s budget was tight enough that
-  // testCachedPlaybackCompletesWithoutContentLength flaked on CI. 30s is well
-  // beyond observed worst-case on macos-26 while staying short enough to fail
-  // fast for genuine regressions.
+  /// Cache-proxy playback tests need a longer wait on slow CI simulators.
   private let playbackTimeout: TimeInterval = 30.0
 
   private var engine: AVPlayerEngine!

package/lib/commonjs/hooks/useActiveMediaItem.js

@@ -14,14 +14,8 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  */
 
 /**
- * Returns the currently active media item, updating on item transitions and
- * whenever the active item's effective metadata changes (e.g. ICY tags from
- * a live radio stream rewriting title/artist).
- *
- * Subscribes to {@link Event.MediaMetadataChanged} rather than
- * {@link Event.MetadataReceived} so the re-read of {@link getActiveMediaItem}
- * happens *after* native has finished merging the new metadata into the
- * queued item — no race against the IPC that lands the auto-update.
+ * Active media item; refreshes on {@link Event.MediaItemTransition} and
+ * {@link Event.MediaMetadataChanged} (after native merges stream metadata).
  */
 function useActiveMediaItem() {
   const [item, setItem] = (0, _react.useState)(() => TrackPlayer.getActiveMediaItem());

package/lib/commonjs/hooks/useActiveMediaItem.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","TrackPlayer","_interopRequireWildcard","_index","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","useActiveMediaItem","item","setItem","useState","getActiveMediaItem","useEffect","transitionSub","addEventListener","Event","MediaItemTransition","event","metadataSub","MediaMetadataChanged","remove"],"sourceRoot":"../../../src","sources":["hooks/useActiveMediaItem.ts"],"mappings":";;;;;;AAKA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,WAAA,GAAAC,uBAAA,CAAAF,OAAA;AACA,IAAAG,MAAA,GAAAH,OAAA;AAAkC,SAAAE,wBAAAE,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAJ,uBAAA,YAAAA,CAAAE,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAPlC;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASkB,kBAAkBA,CAAA,EAAqB;EACrD,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAG,IAAAC,eAAQ,EAAmB,MACjDzB,WAAW,CAAC0B,kBAAkB,CAAC,CACjC,CAAC;EAED,IAAAC,gBAAS,EAAC,MAAM;IACd,MAAMC,aAAa,GAAG5B,WAAW,CAAC6B,gBAAgB,CAChDC,YAAK,CAACC,mBAAmB,EACxBC,KAAK,IAAK;MACTR,OAAO,CAACQ,KAAK,CAACT,IAAI,CAAC;IACrB,CACF,CAAC;IACD,MAAMU,WAAW,GAAGjC,WAAW,CAAC6B,gBAAgB,CAC9CC,YAAK,CAACI,oBAAoB,EAC1B,MAAM;MACJV,OAAO,CAACxB,WAAW,CAAC0B,kBAAkB,CAAC,CAAC,CAAC;IAC3C,CACF,CAAC;IACD,OAAO,MAAM;MACXE,aAAa,CAACO,MAAM,CAAC,CAAC;MACtBF,WAAW,CAACE,MAAM,CAAC,CAAC;IACtB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOZ,IAAI;AACb","ignoreList":[]}
+{"version":3,"names":["_react","require","TrackPlayer","_interopRequireWildcard","_index","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","useActiveMediaItem","item","setItem","useState","getActiveMediaItem","useEffect","transitionSub","addEventListener","Event","MediaItemTransition","event","metadataSub","MediaMetadataChanged","remove"],"sourceRoot":"../../../src","sources":["hooks/useActiveMediaItem.ts"],"mappings":";;;;;;AAKA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,WAAA,GAAAC,uBAAA,CAAAF,OAAA;AACA,IAAAG,MAAA,GAAAH,OAAA;AAAkC,SAAAE,wBAAAE,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAJ,uBAAA,YAAAA,CAAAE,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAPlC;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACO,SAASkB,kBAAkBA,CAAA,EAAqB;EACrD,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAG,IAAAC,eAAQ,EAAmB,MACjDzB,WAAW,CAAC0B,kBAAkB,CAAC,CACjC,CAAC;EAED,IAAAC,gBAAS,EAAC,MAAM;IACd,MAAMC,aAAa,GAAG5B,WAAW,CAAC6B,gBAAgB,CAChDC,YAAK,CAACC,mBAAmB,EACxBC,KAAK,IAAK;MACTR,OAAO,CAACQ,KAAK,CAACT,IAAI,CAAC;IACrB,CACF,CAAC;IACD,MAAMU,WAAW,GAAGjC,WAAW,CAAC6B,gBAAgB,CAC9CC,YAAK,CAACI,oBAAoB,EAC1B,MAAM;MACJV,OAAO,CAACxB,WAAW,CAAC0B,kBAAkB,CAAC,CAAC,CAAC;IAC3C,CACF,CAAC;IACD,OAAO,MAAM;MACXE,aAAa,CAACO,MAAM,CAAC,CAAC;MACtBF,WAAW,CAACE,MAAM,CAAC,CAAC;IACtB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOZ,IAAI;AACb","ignoreList":[]}

package/lib/module/hooks/useActiveMediaItem.js

@@ -9,14 +9,8 @@ import { useEffect, useState } from 'react';
 import * as TrackPlayer from "../audio.js";
 import { Event } from "../events/index.js";
 /**
- * Returns the currently active media item, updating on item transitions and
- * whenever the active item's effective metadata changes (e.g. ICY tags from
- * a live radio stream rewriting title/artist).
- *
- * Subscribes to {@link Event.MediaMetadataChanged} rather than
- * {@link Event.MetadataReceived} so the re-read of {@link getActiveMediaItem}
- * happens *after* native has finished merging the new metadata into the
- * queued item — no race against the IPC that lands the auto-update.
+ * Active media item; refreshes on {@link Event.MediaItemTransition} and
+ * {@link Event.MediaMetadataChanged} (after native merges stream metadata).
  */
 export function useActiveMediaItem() {
   const [item, setItem] = useState(() => TrackPlayer.getActiveMediaItem());

package/lib/module/hooks/useActiveMediaItem.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","TrackPlayer","Event","useActiveMediaItem","item","setItem","getActiveMediaItem","transitionSub","addEventListener","MediaItemTransition","event","metadataSub","MediaMetadataChanged","remove"],"sourceRoot":"../../../src","sources":["hooks/useActiveMediaItem.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,OAAO,KAAKC,WAAW,MAAM,aAAU;AACvC,SAASC,KAAK,QAAQ,oBAAW;AAGjC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAqB;EACrD,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGL,QAAQ,CAAmB,MACjDC,WAAW,CAACK,kBAAkB,CAAC,CACjC,CAAC;EAEDP,SAAS,CAAC,MAAM;IACd,MAAMQ,aAAa,GAAGN,WAAW,CAACO,gBAAgB,CAChDN,KAAK,CAACO,mBAAmB,EACxBC,KAAK,IAAK;MACTL,OAAO,CAACK,KAAK,CAACN,IAAI,CAAC;IACrB,CACF,CAAC;IACD,MAAMO,WAAW,GAAGV,WAAW,CAACO,gBAAgB,CAC9CN,KAAK,CAACU,oBAAoB,EAC1B,MAAM;MACJP,OAAO,CAACJ,WAAW,CAACK,kBAAkB,CAAC,CAAC,CAAC;IAC3C,CACF,CAAC;IACD,OAAO,MAAM;MACXC,aAAa,CAACM,MAAM,CAAC,CAAC;MACtBF,WAAW,CAACE,MAAM,CAAC,CAAC;IACtB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOT,IAAI;AACb","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","TrackPlayer","Event","useActiveMediaItem","item","setItem","getActiveMediaItem","transitionSub","addEventListener","MediaItemTransition","event","metadataSub","MediaMetadataChanged","remove"],"sourceRoot":"../../../src","sources":["hooks/useActiveMediaItem.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,OAAO,KAAKC,WAAW,MAAM,aAAU;AACvC,SAASC,KAAK,QAAQ,oBAAW;AAGjC;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAqB;EACrD,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGL,QAAQ,CAAmB,MACjDC,WAAW,CAACK,kBAAkB,CAAC,CACjC,CAAC;EAEDP,SAAS,CAAC,MAAM;IACd,MAAMQ,aAAa,GAAGN,WAAW,CAACO,gBAAgB,CAChDN,KAAK,CAACO,mBAAmB,EACxBC,KAAK,IAAK;MACTL,OAAO,CAACK,KAAK,CAACN,IAAI,CAAC;IACrB,CACF,CAAC;IACD,MAAMO,WAAW,GAAGV,WAAW,CAACO,gBAAgB,CAC9CN,KAAK,CAACU,oBAAoB,EAC1B,MAAM;MACJP,OAAO,CAACJ,WAAW,CAACK,kBAAkB,CAAC,CAAC,CAAC;IAC3C,CACF,CAAC;IACD,OAAO,MAAM;MACXC,aAAa,CAACM,MAAM,CAAC,CAAC;MACtBF,WAAW,CAACE,MAAM,CAAC,CAAC;IACtB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOT,IAAI;AACb","ignoreList":[]}

package/lib/typescript/src/events/MediaMetadataChanged.d.ts

@@ -3,21 +3,8 @@
  * Commercial use requires a license. See https://rntp.dev/pricing
  */
 /**
- * Fired when the *effective* metadata of the currently active MediaItem
- * changes — i.e. the view that backs {@link getActiveMediaItem} and the system
- * Now Playing info (lock screen, Bluetooth, Android Auto / CarPlay).
- *
- * Sources include:
- * - Track transitions (the new active item's metadata)
- * - Explicit {@link updateMetadata} calls
- * - The native auto-update path that rewrites the active MediaItem when stream
- *   metadata (ICY / ID3) arrives — only fires when
- *   {@link PlayerConfig.autoUpdateMetadataFromStream} is enabled (the default).
- *
- * Contrast with {@link MetadataReceivedEvent}, which fires for every metadata
- * frame the stream pushes (raw, pre-merge) regardless of whether the queue is
- * updated. Many apps only need this event; subscribe to MetadataReceived only
- * when you specifically need stream-truth (e.g. scrobbling).
+ * Effective metadata for the active item ({@link getActiveMediaItem}, Now Playing).
+ * Use {@link MetadataReceivedEvent} for raw per-frame stream metadata instead.
  *
  * @since 5.1.0
  */

package/lib/typescript/src/events/MediaMetadataChanged.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaMetadataChanged.d.ts","sourceRoot":"","sources":["../../../../src/events/MediaMetadataChanged.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"MediaMetadataChanged.d.ts","sourceRoot":"","sources":["../../../../src/events/MediaMetadataChanged.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/lib/typescript/src/hooks/useActiveMediaItem.d.ts

@@ -4,14 +4,8 @@
  */
 import type { MediaItem } from '../interfaces';
 /**
- * Returns the currently active media item, updating on item transitions and
- * whenever the active item's effective metadata changes (e.g. ICY tags from
- * a live radio stream rewriting title/artist).
- *
- * Subscribes to {@link Event.MediaMetadataChanged} rather than
- * {@link Event.MetadataReceived} so the re-read of {@link getActiveMediaItem}
- * happens *after* native has finished merging the new metadata into the
- * queued item — no race against the IPC that lands the auto-update.
+ * Active media item; refreshes on {@link Event.MediaItemTransition} and
+ * {@link Event.MediaMetadataChanged} (after native merges stream metadata).
  */
 export declare function useActiveMediaItem(): MediaItem | null;
 //# sourceMappingURL=useActiveMediaItem.d.ts.map

package/lib/typescript/src/hooks/useActiveMediaItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActiveMediaItem.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActiveMediaItem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,GAAG,IAAI,CAyBrD"}
+{"version":3,"file":"useActiveMediaItem.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActiveMediaItem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,GAAG,IAAI,CAyBrD"}

package/lib/typescript/src/interfaces/PlayerConfig.d.ts

@@ -111,15 +111,8 @@ export interface PlayerConfig {
      */
     handleAudioBecomingNoisy?: boolean;
     /**
-     * When `true`, stream-derived metadata (ICY/ID3) automatically updates the
-     * MediaItem in the queue, keeping `getActiveMediaItem()` and the system Now
-     * Playing info (lock screen, notification, CarPlay/Android Auto) in sync with
-     * the live title — without requiring app code to be running.
-     *
-     * When `false`, only the {@link Event.MetadataReceived} event is emitted; the
-     * queue MediaItem is left untouched. Use this to filter/sanitize stream
-     * metadata yourself and call {@link updateMetadata} from a listener or
-     * background event handler.
+     * When `true` (default), ICY/ID3 metadata updates the queued MediaItem and Now Playing.
+     * When `false`, only {@link Event.MetadataReceived} is emitted; call {@link updateMetadata} yourself.
      *
      * @default true
      * @since 5.1.0

package/lib/typescript/src/interfaces/PlayerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerConfig.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/PlayerConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAE1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,qBAAqB;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC,CACzD,GAAG;IACF,OAAO,EAAE,mBAAmB,CAAC;CAM9B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;;;;;;;;;OAaG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxC"}
+{"version":3,"file":"PlayerConfig.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/PlayerConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAE1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,qBAAqB;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC,CACzD,GAAG;IACF,OAAO,EAAE,mBAAmB,CAAC;CAM9B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;;OAMG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rntp/player",
-  "version": "5.1.0",
+  "version": "5.1.2",
   "description": "The premium audio player for React Native",
   "source": "./src/index.tsx",
   "react-native": "./src/index.tsx",
@@ -14,7 +14,8 @@
       "types": "./lib/typescript/src/index.d.ts",
       "import": "./lib/module/index.js",
       "require": "./lib/commonjs/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "src",

package/src/events/MediaMetadataChanged.ts

@@ -4,21 +4,8 @@
  */
 
 /**
- * Fired when the *effective* metadata of the currently active MediaItem
- * changes — i.e. the view that backs {@link getActiveMediaItem} and the system
- * Now Playing info (lock screen, Bluetooth, Android Auto / CarPlay).
- *
- * Sources include:
- * - Track transitions (the new active item's metadata)
- * - Explicit {@link updateMetadata} calls
- * - The native auto-update path that rewrites the active MediaItem when stream
- *   metadata (ICY / ID3) arrives — only fires when
- *   {@link PlayerConfig.autoUpdateMetadataFromStream} is enabled (the default).
- *
- * Contrast with {@link MetadataReceivedEvent}, which fires for every metadata
- * frame the stream pushes (raw, pre-merge) regardless of whether the queue is
- * updated. Many apps only need this event; subscribe to MetadataReceived only
- * when you specifically need stream-truth (e.g. scrobbling).
+ * Effective metadata for the active item ({@link getActiveMediaItem}, Now Playing).
+ * Use {@link MetadataReceivedEvent} for raw per-frame stream metadata instead.
  *
  * @since 5.1.0
  */

package/src/hooks/useActiveMediaItem.ts

@@ -9,14 +9,8 @@ import { Event } from '../events';
 import type { MediaItem } from '../interfaces';
 
 /**
- * Returns the currently active media item, updating on item transitions and
- * whenever the active item's effective metadata changes (e.g. ICY tags from
- * a live radio stream rewriting title/artist).
- *
- * Subscribes to {@link Event.MediaMetadataChanged} rather than
- * {@link Event.MetadataReceived} so the re-read of {@link getActiveMediaItem}
- * happens *after* native has finished merging the new metadata into the
- * queued item — no race against the IPC that lands the auto-update.
+ * Active media item; refreshes on {@link Event.MediaItemTransition} and
+ * {@link Event.MediaMetadataChanged} (after native merges stream metadata).
  */
 export function useActiveMediaItem(): MediaItem | null {
   const [item, setItem] = useState<MediaItem | null>(() =>

package/src/interfaces/PlayerConfig.ts

@@ -136,15 +136,8 @@ export interface PlayerConfig {
    */
   handleAudioBecomingNoisy?: boolean;
   /**
-   * When `true`, stream-derived metadata (ICY/ID3) automatically updates the
-   * MediaItem in the queue, keeping `getActiveMediaItem()` and the system Now
-   * Playing info (lock screen, notification, CarPlay/Android Auto) in sync with
-   * the live title — without requiring app code to be running.
-   *
-   * When `false`, only the {@link Event.MetadataReceived} event is emitted; the
-   * queue MediaItem is left untouched. Use this to filter/sanitize stream
-   * metadata yourself and call {@link updateMetadata} from a listener or
-   * background event handler.
+   * When `true` (default), ICY/ID3 metadata updates the queued MediaItem and Now Playing.
+   * When `false`, only {@link Event.MetadataReceived} is emitted; call {@link updateMetadata} yourself.
    *
    * @default true
    * @since 5.1.0