react-native-audio-browser 0.1.1 → 0.2.0-next.10

package/lib/module/features/remoteControls.js

@@ -25,98 +25,15 @@ import { LazyNativeEmitter } from '../utils/LazyNativeEmitter';
  * Remote seek event.
  */
 
-/**
- * Remote set rating event.
- */
-
 /**
  * Remote skip event (Android only).
  */
 
-// MARK: - Default Handlers
-
-// Install remote control handlers with default behavior immediately when module loads
-// Custom handlers can override the defaults using handleRemote* functions
-
-// Basic playback controls
-// AudioBrowser.onRemotePlay(() => {
-//   const customHandler = customHandlers.get('play')
-//   if (customHandler) {
-//     customHandler()
-//   } else {
-//     play()
-//   }
-// })
-
-// AudioBrowser.onRemotePause(() => {
-//   const customHandler = customHandlers.get('pause')
-//   if (customHandler) {
-//     customHandler()
-//   } else {
-//     pause()
-//   }
-// })
-
-// AudioBrowser.onRemoteNext(() => {
-//   const customHandler = customHandlers.get('next')
-//   if (customHandler) {
-//     customHandler()
-//   } else {
-//     skipToNext()
-//   }
-// })
-
-// AudioBrowser.onRemotePrevious(() => {
-//   const customHandler = customHandlers.get('previous')
-//   if (customHandler) {
-//     customHandler()
-//   } else {
-//     skipToPrevious()
-//   }
-// })
-
-// AudioBrowser.onRemoteStop(() => {
-//   const customHandler = customHandlers.get('stop')
-//   if (customHandler) {
-//     customHandler()
-//   } else {
-//     stop()
-//   }
-// })
-
-// // Seek controls
-// AudioBrowser.onRemoteSeek((event: any) => {
-//   const customHandler = customHandlers.get('seek')
-//   if (customHandler) {
-//     customHandler(event)
-//   } else {
-//     seekTo(event.position)
-//   }
-// })
-
-// AudioBrowser.onRemoteJumpForward((event: any) => {
-//   const customHandler = customHandlers.get('jumpForward')
-//   if (customHandler) {
-//     customHandler(event)
-//   } else {
-//     seekBy(event.interval)
-//   }
-// })
-
-// AudioBrowser.onRemoteJumpBackward((event: any) => {
-//   const customHandler = customHandlers.get('jumpBackward')
-//   if (customHandler) {
-//     customHandler(event)
-//   } else {
-//     seekBy(-event.interval)
-//   }
-// })
-
 // MARK: - Handler Override Functions
 //
 // Use these functions when you want to OVERRIDE the default remote control behavior.
 // These will replace the default handlers with your custom logic.
-// If you just want to listen to events for debugging/logging, use the onRemote* functions below.
+// If you just want to listen to events for debugging/logging, use the onRemote* emitters below.
 
 /**
  * Sets a custom handler for remote play events, overriding the default behavior.
@@ -184,7 +101,7 @@ export function handleRemoteJumpBackward(callback) {
 
 // MARK: - Event Callbacks (for listening/debugging only)
 //
-// Use these functions when you want to LISTEN to remote control events without overriding
+// Use these emitters when you want to LISTEN to remote control events without overriding
 // the default behavior. These are perfect for logging, analytics, or debugging.
 // Multiple listeners can be registered for the same event.
 // To override the default behavior, use the handleRemote* functions above.
@@ -192,84 +109,77 @@ export function handleRemoteJumpBackward(callback) {
 /**
  * Subscribes to remote jump backward events.
  * @param callback - Called when the user presses the jump backward button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemoteJumpBackward = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteJumpBackward = cb);
 
 /**
  * Subscribes to remote jump forward events.
  * @param callback - Called when the user presses the jump forward button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemoteJumpForward = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteJumpForward = cb);
 
 /**
  * Subscribes to remote next events.
  * @param callback - Called when the user presses the next track button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemoteNext = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteNext = cb);
 
 /**
  * Subscribes to remote pause events.
  * @param callback - Called when the user presses the pause button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemotePause = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePause = cb);
 
 /**
  * Subscribes to remote play events.
  * @param callback - Called when the user presses the play button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemotePlay = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePlay = cb);
 
 /**
  * Subscribes to remote play ID events (Android only).
  * @param callback - Called when the user selects a track from an external device
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemotePlayId = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePlayId = cb);
 
 /**
  * Subscribes to remote play search events (Android only).
  * @param callback - Called when the user searches for a track (usually voice search)
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemotePlaySearch = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePlaySearch = cb);
 
 /**
  * Subscribes to remote previous events.
  * @param callback - Called when the user presses the previous track button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemotePrevious = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePrevious = cb);
 
 /**
  * Subscribes to remote seek events.
  * @param callback - Called when the user changes the position of the timeline
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemoteSeek = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteSeek = cb);
 
-/**
- * Subscribes to remote set rating events.
- * @param callback - Called when the user changes the rating for the track remotely
- * @returns Cleanup function to unsubscribe
- */
-export const onRemoteSetRating = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteSetRating = cb);
-
 /**
  * Subscribes to remote skip events (Android only).
  * @param callback - Called when the user presses the skip button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemoteSkip = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteSkip = cb);
 
 /**
  * Subscribes to remote stop events.
  * @param callback - Called when the user presses the stop button
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onRemoteStop = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteStop = cb);
 //# sourceMappingURL=remoteControls.js.map

package/lib/module/features/remoteControls.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","LazyNativeEmitter","handleRemotePlay","callback","handleRemotePause","handleRemoteNext","handleRemotePrevious","handleRemoteStop","handleRemoteSeek","handleRemoteJumpForward","handleRemoteJumpBackward","onRemoteJumpBackward","emitterize","cb","onRemoteJumpForward","onRemoteNext","onRemotePause","onRemotePlay","onRemotePlayId","onRemotePlaySearch","onRemotePrevious","onRemoteSeek","onRemoteSetRating","onRemoteSkip","onRemoteStop"],"sourceRoot":"../../../src","sources":["features/remoteControls.ts"],"mappings":";;AAMA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,iBAAiB,QAAQ,4BAA4B;;AAE9D;;AAEA;AACA;AACA;;AAMA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AAMA;AACA;AACA;;AAMA;AACA;AACA;;AAKA;AACA;AACA;;AAMA;;AAEA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,QAAkC,EAAE;EACnEH,aAAa,CAACE,gBAAgB,GAAGC,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACD,QAAkC,EAAE;EACpEH,aAAa,CAACI,iBAAiB,GAAGD,QAAQ;AAC5C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,gBAAgBA,CAACF,QAAkC,EAAE;EACnEH,aAAa,CAACK,gBAAgB,GAAGF,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASG,oBAAoBA,CAACH,QAAkC,EAAE;EACvEH,aAAa,CAACM,oBAAoB,GAAGH,QAAQ;AAC/C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,gBAAgBA,CAACJ,QAAkC,EAAE;EACnEH,aAAa,CAACO,gBAAgB,GAAGJ,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,gBAAgBA,CAC9BL,QAAwD,EACxD;EACAH,aAAa,CAACQ,gBAAgB,GAAGL,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASM,uBAAuBA,CACrCN,QAA+D,EAC/D;EACAH,aAAa,CAACS,uBAAuB,GAAGN,QAAQ;AAClD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASO,wBAAwBA,CACtCP,QAAgE,EAChE;EACAH,aAAa,CAACU,wBAAwB,GAAGP,QAAQ;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMQ,oBAAoB,GAC/BV,iBAAiB,CAACW,UAAU,CACzBC,EAAE,IAAMb,aAAa,CAACW,oBAAoB,GAAGE,EAChD,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9Bb,iBAAiB,CAACW,UAAU,CACzBC,EAAE,IAAMb,aAAa,CAACc,mBAAmB,GAAGD,EAC/C,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,YAAY,GAAGd,iBAAiB,CAACW,UAAU,CACrDC,EAAE,IAAMb,aAAa,CAACe,YAAY,GAAGF,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMG,aAAa,GAAGf,iBAAiB,CAACW,UAAU,CACtDC,EAAE,IAAMb,aAAa,CAACgB,aAAa,GAAGH,EACzC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,YAAY,GAAGhB,iBAAiB,CAACW,UAAU,CACrDC,EAAE,IAAMb,aAAa,CAACiB,YAAY,GAAGJ,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,cAAc,GAAGjB,iBAAiB,CAACW,UAAU,CACvDC,EAAE,IAAMb,aAAa,CAACkB,cAAc,GAAGL,EAC1C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMM,kBAAkB,GAC7BlB,iBAAiB,CAACW,UAAU,CACzBC,EAAE,IAAMb,aAAa,CAACmB,kBAAkB,GAAGN,EAC9C,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMO,gBAAgB,GAAGnB,iBAAiB,CAACW,UAAU,CACzDC,EAAE,IAAMb,aAAa,CAACoB,gBAAgB,GAAGP,EAC5C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMQ,YAAY,GAAGpB,iBAAiB,CAACW,UAAU,CACrDC,EAAE,IAAMb,aAAa,CAACqB,YAAY,GAAGR,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMS,iBAAiB,GAC5BrB,iBAAiB,CAACW,UAAU,CACzBC,EAAE,IAAMb,aAAa,CAACsB,iBAAiB,GAAGT,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMU,YAAY,GAAGtB,iBAAiB,CAACW,UAAU,CACrDC,EAAE,IAAMb,aAAa,CAACuB,YAAY,GAAGV,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMW,YAAY,GAAGvB,iBAAiB,CAACW,UAAU,CACrDC,EAAE,IAAMb,aAAa,CAACwB,YAAY,GAAGX,EACxC,CAAC","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","LazyNativeEmitter","handleRemotePlay","callback","handleRemotePause","handleRemoteNext","handleRemotePrevious","handleRemoteStop","handleRemoteSeek","handleRemoteJumpForward","handleRemoteJumpBackward","onRemoteJumpBackward","emitterize","cb","onRemoteJumpForward","onRemoteNext","onRemotePause","onRemotePlay","onRemotePlayId","onRemotePlaySearch","onRemotePrevious","onRemoteSeek","onRemoteSkip","onRemoteStop"],"sourceRoot":"../../../src","sources":["features/remoteControls.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/features/sleepTimer.js

@@ -31,11 +31,16 @@ export function getSleepTimer() {
 }
 
 /**
- * Sets a sleep timer to stop playback after the specified duration.
- * @param seconds - Number of seconds until playback stops
+ * Options for `setSleepTimer`.
  */
-export function setSleepTimer(seconds) {
-  nativeBrowser.setSleepTimer(seconds);
+
+/**
+ * Sets a sleep timer to pause playback after the specified duration.
+ * @param seconds - Number of seconds until playback pauses
+ * @param options - Optional fade-out configuration
+ */
+export function setSleepTimer(seconds, options) {
+  nativeBrowser.setSleepTimer(seconds, options?.fadeDuration);
 }
 
 /**
@@ -58,7 +63,7 @@ export function clearSleepTimer() {
 /**
  * Subscribes to sleep timer changes.
  * @param callback - Called when the sleep timer state changes
- * @returns Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export const onSleepTimerChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onSleepTimerChanged = cb);
 
@@ -73,6 +78,13 @@ export const onSleepTimerChanged = NativeUpdatedValue.emitterize(cb => nativeBro
 export function useSleepTimerActive() {
   const [isActive, setIsActive] = useState(() => getSleepTimer() !== null);
   useEffect(() => {
+    // Re-sync before subscribing: a change between the initial read above and this effect would
+    // otherwise be missed for good. `undefined` means nothing has fired yet, whereas `null` is a
+    // real value — the timer being cleared — so it has to re-sync too.
+    const {
+      lastValue
+    } = onSleepTimerChanged;
+    if (lastValue !== undefined) setIsActive(lastValue !== null);
     return onSleepTimerChanged.addListener(timer => {
       setIsActive(timer !== null);
     });
@@ -99,6 +111,11 @@ export function useSleepTimer(params) {
   });
   const time = state && 'time' in state ? state.time : undefined;
   useEffect(() => {
+    // Re-sync before subscribing — see useSleepTimerActive.
+    const {
+      lastValue
+    } = onSleepTimerChanged;
+    if (lastValue !== undefined) setState(addSecondsLeft(lastValue));
     return onSleepTimerChanged.addListener(event => {
       setState(addSecondsLeft(event));
     });

package/lib/module/features/sleepTimer.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","nativeBrowser","NativeUpdatedValue","getSleepTimer","setSleepTimer","seconds","setSleepTimerToEndOfTrack","clearSleepTimer","onSleepTimerChanged","emitterize","cb","useSleepTimerActive","isActive","setIsActive","addListener","timer","useSleepTimer","params","updateInterval","inactive","state","setState","timerState","addSecondsLeft","time","undefined","event","update","sleepTimer","result","secondsLeft","clear","initialTimeoutId","setTimeout","intervalId","setInterval","clearTimeout","clearInterval","Math","max","round","Date","now"],"sourceRoot":"../../../src","sources":["features/sleepTimer.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","nativeBrowser","NativeUpdatedValue","getSleepTimer","setSleepTimer","seconds","options","fadeDuration","setSleepTimerToEndOfTrack","clearSleepTimer","onSleepTimerChanged","emitterize","cb","useSleepTimerActive","isActive","setIsActive","lastValue","undefined","addListener","timer","useSleepTimer","params","updateInterval","inactive","state","setState","timerState","addSecondsLeft","time","event","update","sleepTimer","result","secondsLeft","clear","initialTimeoutId","setTimeout","intervalId","setInterval","clearTimeout","clearInterval","Math","max","round","Date","now"],"sourceRoot":"../../../src","sources":["features/sleepTimer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/native.js

@@ -1,5 +1,10 @@
 "use strict";
 
 import { NitroModules } from 'react-native-nitro-modules';
+/**
+ * The raw Nitro hybrid object — the bridge itself. Feature modules wrap it;
+ * consumers use those wrappers.
+ * @internal
+ */
 export const nativeBrowser = NitroModules.createHybridObject('AudioBrowser');
 //# sourceMappingURL=native.js.map

package/lib/module/native.js.map

@@ -1 +1 @@
-{"version":3,"names":["NitroModules","nativeBrowser","createHybridObject"],"sourceRoot":"../../src","sources":["native.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAGzD,OAAO,MAAMC,aAAa,GACxBD,YAAY,CAACE,kBAAkB,CAAmB,cAAc,CAAC","ignoreList":[]}
+{"version":3,"names":["NitroModules","nativeBrowser","createHybridObject"],"sourceRoot":"../../src","sources":["native.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAGzD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GACxBD,YAAY,CAACE,kBAAkB,CAAmB,cAAc,CAAC","ignoreList":[]}

package/lib/module/native.web.js

@@ -2,6 +2,9 @@
 
 import { NativeAudioBrowser } from './web/NativeAudioBrowser';
 
-// Web implementation: AudioBrowser is a unified browser + player
+/**
+ * Web implementation: AudioBrowser is a unified browser + player.
+ * @internal
+ */
 export const nativeBrowser = new NativeAudioBrowser();
 //# sourceMappingURL=native.web.js.map

package/lib/module/native.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeAudioBrowser","nativeBrowser"],"sourceRoot":"../../src","sources":["native.web.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,0BAA0B;;AAE7D;AACA,OAAO,MAAMC,aAAa,GAAG,IAAID,kBAAkB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeAudioBrowser","nativeBrowser"],"sourceRoot":"../../src","sources":["native.web.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,0BAA0B;;AAE7D;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GAAG,IAAID,kBAAkB,CAAC,CAAC","ignoreList":[]}

package/lib/module/test-utils/reactNativeStub.js

@@ -0,0 +1,58 @@
+"use strict";
+
+/**
+ * Stands in for `react-native` under vitest, via the alias in `vitest.config.ts`.
+ *
+ * Not a convenience: `react-native/index.js` is Flow-typed (`import typeof ...`)
+ * and Rollup cannot parse it, so any test that reaches a module importing from
+ * `'react-native'` fails to load at all. Jest consumers get this from
+ * `@react-native/jest-preset`; vitest has no equivalent.
+ *
+ * Keep it to the surface the library actually touches. Two symbols so far —
+ * `AppState` (usePolledProgress) and `Image.resolveAssetSource`. Anything a test
+ * needs to drive should get an explicit control here rather than a cast at the
+ * call site.
+ *
+ * @internal — never imported by production code, only aliased in by the runner.
+ */
+
+const changeListeners = new Set();
+export const AppState = {
+  currentState: 'active',
+  // `type` is widened to string so the guard stays live: real AppState also
+  // emits 'memoryWarning' and 'focus', and silently treating one of those as a
+  // 'change' subscription would be a confusing way to find out this stub is thin.
+  addEventListener(type, listener) {
+    if (type !== 'change') throw new Error(`AppState stub: unhandled "${type}"`);
+    changeListeners.add(listener);
+    return {
+      remove: () => changeListeners.delete(listener)
+    };
+  }
+};
+
+/** Move the app to the foreground or background and notify subscribers. */
+export function setAppState(status) {
+  AppState.currentState = status;
+  // Deleting from a Set mid-iteration is safe, so a listener that removes itself
+  // during the callback needs no defensive copy.
+  for (const listener of changeListeners) listener(status);
+}
+
+/**
+ * Drop every subscription and return to the foreground. Call between tests —
+ * the stub is a module singleton, so state outlives an individual test.
+ */
+export function resetAppState() {
+  changeListeners.clear();
+  AppState.currentState = 'active';
+}
+
+/** Number of live `change` subscriptions, for asserting cleanup. */
+export function appStateListenerCount() {
+  return changeListeners.size;
+}
+export const Image = {
+  resolveAssetSource: source => source
+};
+//# sourceMappingURL=reactNativeStub.js.map

package/lib/module/test-utils/reactNativeStub.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["changeListeners","Set","AppState","currentState","addEventListener","type","listener","Error","add","remove","delete","setAppState","status","resetAppState","clear","appStateListenerCount","size","Image","resolveAssetSource","source"],"sourceRoot":"../../../src","sources":["test-utils/reactNativeStub.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,MAAMA,eAAe,GAAG,IAAIC,GAAG,CAAiB,CAAC;AAEjD,OAAO,MAAMC,QAAQ,GAAG;EACtBC,YAAY,EAAE,QAA0B;EAExC;EACA;EACA;EACAC,gBAAgBA,CAACC,IAAY,EAAEC,QAAwB,EAAE;IACvD,IAAID,IAAI,KAAK,QAAQ,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6BF,IAAI,GAAG,CAAC;IAC5EL,eAAe,CAACQ,GAAG,CAACF,QAAQ,CAAC;IAC7B,OAAO;MAAEG,MAAM,EAAEA,CAAA,KAAMT,eAAe,CAACU,MAAM,CAACJ,QAAQ;IAAE,CAAC;EAC3D;AACF,CAAC;;AAED;AACA,OAAO,SAASK,WAAWA,CAACC,MAAsB,EAAQ;EACxDV,QAAQ,CAACC,YAAY,GAAGS,MAAM;EAC9B;EACA;EACA,KAAK,MAAMN,QAAQ,IAAIN,eAAe,EAAEM,QAAQ,CAACM,MAAM,CAAC;AAC1D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAS;EACpCb,eAAe,CAACc,KAAK,CAAC,CAAC;EACvBZ,QAAQ,CAACC,YAAY,GAAG,QAAQ;AAClC;;AAEA;AACA,OAAO,SAASY,qBAAqBA,CAAA,EAAW;EAC9C,OAAOf,eAAe,CAACgB,IAAI;AAC7B;AAEA,OAAO,MAAMC,KAAK,GAAG;EACnBC,kBAAkB,EAAGC,MAAe,IAAKA;AAC3C,CAAC","ignoreList":[]}

package/lib/module/utils/LazyNativeEmitter.js

@@ -1,9 +1,6 @@
 "use strict";
 
-/** @internal */
-
 /**
- * @internal
  * A lightweight event emitter that lazily bridges native callbacks to multiple JavaScript listeners.
  *
  * The native callback is only assigned when the first listener is added, making the emitter
@@ -15,9 +12,11 @@
  *
  * @example
  * ```typescript
- * export const onRemotePlay = LazyEmitter.emitterize<void>(
+ * export const onRemotePlay = LazyNativeEmitter.emitterize<void>(
  *   (cb) => (nativeBrowser.onRemotePlay = cb)
  * )
+ *
+ * const unsubscribe = onRemotePlay.addListener(() => console.log('play'))
  * ```
  */
 export class LazyNativeEmitter {
@@ -41,13 +40,14 @@ export class LazyNativeEmitter {
   }
 
   /**
-   * Creates a lazy emitter subscription function for a native callback.
+   * Creates a lazy emitter for a native callback.
+   *
    * @param setter - Function that sets the native callback property
-   * @returns A subscription function that returns an unsubscribe function
+   * @returns The emitter instance — subscribe with `addListener`, which returns
+   * an unsubscribe function
    */
   static emitterize(setter) {
-    const emitter = new LazyNativeEmitter(setter);
-    return callback => emitter.addListener(callback);
+    return new LazyNativeEmitter(setter);
   }
 }
 //# sourceMappingURL=LazyNativeEmitter.js.map

package/lib/module/utils/LazyNativeEmitter.js.map

@@ -1 +1 @@
-{"version":3,"names":["LazyNativeEmitter","constructor","setter","getListeners","listeners","Set","data","listener","addListener","callback","add","delete","emitterize","emitter"],"sourceRoot":"../../../src","sources":["utils/LazyNativeEmitter.ts"],"mappings":";;AAAA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAI;EAIhCC,WAAWA,CAACC,MAA6C,EAAE;IACzD,IAAI,CAACA,MAAM,GAAGA,MAAM;EACtB;EAEQC,YAAYA,CAAA,EAAqB;IACvC,IAAI,IAAI,CAACC,SAAS,EAAE,OAAO,IAAI,CAACA,SAAS;IACzC,MAAMA,SAAS,GAAI,IAAI,CAACA,SAAS,GAAG,IAAIC,GAAG,CAAC,CAAE;IAC9C,IAAI,CAACH,MAAM,CAAEI,IAAO,IAAK;MACvB,KAAK,MAAMC,QAAQ,IAAIH,SAAS,EAAE;QAChCG,QAAQ,CAACD,IAAI,CAAC;MAChB;IACF,CAAC,CAAC;IACF,OAAOF,SAAS;EAClB;EAEAI,WAAWA,CAACC,QAAqB,EAAc;IAC7C,MAAML,SAAS,GAAG,IAAI,CAACD,YAAY,CAAC,CAAC;IACrCC,SAAS,CAACM,GAAG,CAACD,QAAQ,CAAC;IACvB,OAAO,MAAML,SAAS,CAACO,MAAM,CAACF,QAAQ,CAAC;EACzC;;EAEA;AACF;AACA;AACA;AACA;EACE,OAAOG,UAAUA,CACfV,MAA6C,EACN;IACvC,MAAMW,OAAO,GAAG,IAAIb,iBAAiB,CAACE,MAAM,CAAC;IAC7C,OAAQO,QAAqB,IAAKI,OAAO,CAACL,WAAW,CAACC,QAAQ,CAAC;EACjE;AACF","ignoreList":[]}
+{"version":3,"names":["LazyNativeEmitter","constructor","setter","getListeners","listeners","Set","data","listener","addListener","callback","add","delete","emitterize"],"sourceRoot":"../../../src","sources":["utils/LazyNativeEmitter.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAI;EAIhCC,WAAWA,CAACC,MAA6C,EAAE;IACzD,IAAI,CAACA,MAAM,GAAGA,MAAM;EACtB;EAEQC,YAAYA,CAAA,EAAqB;IACvC,IAAI,IAAI,CAACC,SAAS,EAAE,OAAO,IAAI,CAACA,SAAS;IACzC,MAAMA,SAAS,GAAI,IAAI,CAACA,SAAS,GAAG,IAAIC,GAAG,CAAC,CAAE;IAC9C,IAAI,CAACH,MAAM,CAAEI,IAAO,IAAK;MACvB,KAAK,MAAMC,QAAQ,IAAIH,SAAS,EAAE;QAChCG,QAAQ,CAACD,IAAI,CAAC;MAChB;IACF,CAAC,CAAC;IACF,OAAOF,SAAS;EAClB;EAEAI,WAAWA,CAACC,QAAqB,EAAc;IAC7C,MAAML,SAAS,GAAG,IAAI,CAACD,YAAY,CAAC,CAAC;IACrCC,SAAS,CAACM,GAAG,CAACD,QAAQ,CAAC;IACvB,OAAO,MAAML,SAAS,CAACO,MAAM,CAACF,QAAQ,CAAC;EACzC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACE,OAAOG,UAAUA,CACfV,MAA6C,EACvB;IACtB,OAAO,IAAIF,iBAAiB,CAACE,MAAM,CAAC;EACtC;AACF","ignoreList":[]}

package/lib/module/utils/NativeUpdatedValue.js

@@ -1,9 +1,6 @@
 "use strict";
 
-/** @internal */
-
 /**
- * @internal
  * Bridges native value changes to JavaScript, storing the latest value for immediate access.
  *
  * Subscribes to native changes immediately at module load to ensure no updates are missed.

package/lib/module/utils/NativeUpdatedValue.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeUpdatedValue","listeners","Set","lastValue","undefined","constructor","setter","data","listener","addListener","callback","add","delete","emitterize"],"sourceRoot":"../../../src","sources":["utils/NativeUpdatedValue.ts"],"mappings":";;AAAA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,kBAAkB,CAAI;EACzBC,SAAS,GAAG,IAAIC,GAAG,CAAc,CAAC;EAC1CC,SAAS,GAAkBC,SAAS;EAEpCC,WAAWA,CAACC,MAA6C,EAAE;IACzD;IACAA,MAAM,CAAEC,IAAO,IAAK;MAClB,IAAI,CAACJ,SAAS,GAAGI,IAAI;MACrB,KAAK,MAAMC,QAAQ,IAAI,IAAI,CAACP,SAAS,EAAE;QACrCO,QAAQ,CAACD,IAAI,CAAC;MAChB;IACF,CAAC,CAAC;EACJ;EAEAE,WAAWA,CAACC,QAAqB,EAAc;IAC7C,IAAI,CAACT,SAAS,CAACU,GAAG,CAACD,QAAQ,CAAC;IAC5B,OAAO,MAAM,IAAI,CAACT,SAAS,CAACW,MAAM,CAACF,QAAQ,CAAC;EAC9C;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOG,UAAUA,CACfP,MAA6C,EACtB;IACvB,OAAO,IAAIN,kBAAkB,CAACM,MAAM,CAAC;EACvC;AACF","ignoreList":[]}
+{"version":3,"names":["NativeUpdatedValue","listeners","Set","lastValue","undefined","constructor","setter","data","listener","addListener","callback","add","delete","emitterize"],"sourceRoot":"../../../src","sources":["utils/NativeUpdatedValue.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,kBAAkB,CAAI;EACzBC,SAAS,GAAG,IAAIC,GAAG,CAAc,CAAC;EAC1CC,SAAS,GAAkBC,SAAS;EAEpCC,WAAWA,CAACC,MAA6C,EAAE;IACzD;IACAA,MAAM,CAAEC,IAAO,IAAK;MAClB,IAAI,CAACJ,SAAS,GAAGI,IAAI;MACrB,KAAK,MAAMC,QAAQ,IAAI,IAAI,CAACP,SAAS,EAAE;QACrCO,QAAQ,CAACD,IAAI,CAAC;MAChB;IACF,CAAC,CAAC;EACJ;EAEAE,WAAWA,CAACC,QAAqB,EAAc;IAC7C,IAAI,CAACT,SAAS,CAACU,GAAG,CAACD,QAAQ,CAAC;IAC5B,OAAO,MAAM,IAAI,CAACT,SAAS,CAACW,MAAM,CAACF,QAAQ,CAAC;EAC9C;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOG,UAAUA,CACfP,MAA6C,EACtB;IACvB,OAAO,IAAIN,kBAAkB,CAACM,MAAM,CAAC;EACvC;AACF","ignoreList":[]}

package/lib/module/utils/artwork.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/**
+ * Whether a track's artwork ships one image per appearance.
+ *
+ * Narrows the union in one place, so nothing else has to know how it is
+ * discriminated.
+ */
+export function isArtworkVariants(artwork) {
+  return typeof artwork === 'object' && artwork !== null;
+}
+
+/**
+ * The single artwork URL to use.
+ *
+ * Mirrors the Swift `Variant_String_ArtworkVariants.url` accessor: a pair
+ * resolves to its dark URL unless a scheme is given, because dark is what a
+ * single-URL track would have shipped and is the only appearance Android Auto
+ * has. Callers that can render per appearance (CarPlay, via a `UIImageAsset`)
+ * take the pair itself rather than going through this.
+ */
+export function artworkUrl(artwork, scheme = 'dark') {
+  if (artwork === undefined) return undefined;
+  return isArtworkVariants(artwork) ? artwork[scheme] : artwork;
+}
+//# sourceMappingURL=artwork.js.map

package/lib/module/utils/artwork.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isArtworkVariants","artwork","artworkUrl","scheme","undefined"],"sourceRoot":"../../../src","sources":["utils/artwork.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,iBAAiBA,CAC/BC,OAAiC,EACL;EAC5B,OAAO,OAAOA,OAAO,KAAK,QAAQ,IAAIA,OAAO,KAAK,IAAI;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CACxBD,OAAiC,EACjCE,MAAwB,GAAG,MAAM,EACb;EACpB,IAAIF,OAAO,KAAKG,SAAS,EAAE,OAAOA,SAAS;EAC3C,OAAOJ,iBAAiB,CAACC,OAAO,CAAC,GAAGA,OAAO,CAACE,MAAM,CAAC,GAAGF,OAAO;AAC/D","ignoreList":[]}