react-native-audio-browser 0.2.0-next.9 → 0.2.0

package/lib/module/features/playback/playWhenReady.js

@@ -33,7 +33,7 @@ export function setPlayWhenReady(playWhenReady) {
 /**
  * Subscribes to play when ready changes.
  * @param callback - Called when playWhenReady changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onPlayWhenReadyChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackPlayWhenReadyChanged = cb);
 

package/lib/module/features/playback/playing.js

@@ -20,7 +20,7 @@ export function getPlayingState() {
 /**
  * Subscribes to playing state changes.
  * @param callback - Called when playing or buffering state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onPlayingState = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackPlayingState = cb);
 

package/lib/module/features/playback/progress.js

@@ -1,7 +1,6 @@
 "use strict";
 
 import { useEffect, useState } from 'react';
-import { AppState } from 'react-native';
 import { nativeBrowser } from '../../native';
 import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
 import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
@@ -29,7 +28,7 @@ export function getProgress() {
 /**
  * Subscribes to playback progress updates.
  * @param callback - Called periodically with playback progress updates
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onProgressUpdated = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackProgressUpdated = cb);
 
@@ -50,9 +49,6 @@ export function useProgress() {
  *
  * Use this when you need custom polling behavior instead of event-based updates.
  *
- * Skips updates while the app is backgrounded and refreshes once it becomes
- * active again.
- *
  * @param updateInterval - Update interval in milliseconds (default: 1000)
  * @returns The current playback progress
  */
@@ -63,8 +59,7 @@ export function usePolledProgress(updateInterval = 1000) {
     buffered: 0
   });
   useEffect(() => {
-    let timer;
-    let unsubscribeState;
+    let mounted = true;
     const update = () => {
       try {
         const {
@@ -72,6 +67,7 @@ export function usePolledProgress(updateInterval = 1000) {
           duration,
           buffered
         } = getProgress();
+        if (!mounted) return;
         setState(currentState => position === currentState.position && duration === currentState.duration && buffered === currentState.buffered ? currentState : {
           position,
           duration,
@@ -81,32 +77,20 @@ export function usePolledProgress(updateInterval = 1000) {
         // Ignore failures (e.g., before setup)
       }
     };
+
+    // Update immediately on playback state changes
+    const unsubscribeState = onPlaybackChanged.addListener(update);
     const poll = () => {
       update();
-      timer = setTimeout(poll, updateInterval);
-    };
-
-    // We only poll and listen for playback changes while the app is active. On
-    // return to the foreground we update once and restart the loop so the
-    // interval timing stays correct.
-    const start = () => {
-      if (timer !== undefined) return;
-      unsubscribeState = onPlaybackChanged.addListener(update);
-      poll();
-    };
-    const stop = () => {
-      clearTimeout(timer);
-      timer = undefined;
-      unsubscribeState?.();
-      unsubscribeState = undefined;
+      if (!mounted) return;
+      setTimeout(() => {
+        if (mounted) poll();
+      }, updateInterval);
     };
-    const appStateSub = AppState.addEventListener('change', next => {
-      if (next === 'active') start();else stop();
-    });
-    if (AppState.currentState === 'active') start();
+    poll();
     return () => {
-      stop();
-      appStateSub.remove();
+      mounted = false;
+      unsubscribeState();
     };
   }, [updateInterval]);
   return state;

package/lib/module/features/playback/progress.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","AppState","nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","onPlaybackChanged","getProgress","onProgressUpdated","emitterize","cb","onPlaybackProgressUpdated","useProgress","usePolledProgress","updateInterval","state","setState","position","duration","buffered","timer","unsubscribeState","update","currentState","poll","setTimeout","start","undefined","addListener","stop","clearTimeout","appStateSub","addEventListener","next","remove"],"sourceRoot":"../../../../src","sources":["features/playback/progress.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,QAAQ,QAAQ,cAAc;AACvC,SAASC,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;AACzE,SAASC,iBAAiB,QAAQ,SAAS;;AAE3C;;AAiBA;AACA;AACA;;AAMA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAOJ,aAAa,CAACI,WAAW,CAAC,CAAC;AACpC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BJ,kBAAkB,CAACK,UAAU,CAC1BC,EAAE,IAAMP,aAAa,CAACQ,yBAAyB,GAAGD,EACrD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,WAAWA,CAAA,EAAa;EACtC,OAAOP,qBAAqB,CAACE,WAAW,EAAEC,iBAAiB,CAAC;AAC9D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,iBAAiBA,CAACC,cAAc,GAAG,IAAI,EAAY;EACjE,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGf,QAAQ,CAAW;IAC3CgB,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE;EACZ,CAAC,CAAC;EAEFnB,SAAS,CAAC,MAAM;IACd,IAAIoB,KAAgD;IACpD,IAAIC,gBAA0C;IAE9C,MAAMC,MAAM,GAAGA,CAAA,KAAM;MACnB,IAAI;QACF,MAAM;UAAEL,QAAQ;UAAEC,QAAQ;UAAEC;QAAS,CAAC,GAAGZ,WAAW,CAAC,CAAC;QAEtDS,QAAQ,CAAEO,YAAY,IACpBN,QAAQ,KAAKM,YAAY,CAACN,QAAQ,IAClCC,QAAQ,KAAKK,YAAY,CAACL,QAAQ,IAClCC,QAAQ,KAAKI,YAAY,CAACJ,QAAQ,GAC9BI,YAAY,GACZ;UAAEN,QAAQ;UAAEC,QAAQ;UAAEC;QAAS,CACrC,CAAC;MACH,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC;IAED,MAAMK,IAAI,GAAGA,CAAA,KAAM;MACjBF,MAAM,CAAC,CAAC;MACRF,KAAK,GAAGK,UAAU,CAACD,IAAI,EAAEV,cAAc,CAAC;IAC1C,CAAC;;IAED;IACA;IACA;IACA,MAAMY,KAAK,GAAGA,CAAA,KAAM;MAClB,IAAIN,KAAK,KAAKO,SAAS,EAAE;MACzBN,gBAAgB,GAAGf,iBAAiB,CAACsB,WAAW,CAACN,MAAM,CAAC;MACxDE,IAAI,CAAC,CAAC;IACR,CAAC;IAED,MAAMK,IAAI,GAAGA,CAAA,KAAM;MACjBC,YAAY,CAACV,KAAK,CAAC;MACnBA,KAAK,GAAGO,SAAS;MACjBN,gBAAgB,GAAG,CAAC;MACpBA,gBAAgB,GAAGM,SAAS;IAC9B,CAAC;IAED,MAAMI,WAAW,GAAG7B,QAAQ,CAAC8B,gBAAgB,CAAC,QAAQ,EAAGC,IAAI,IAAK;MAChE,IAAIA,IAAI,KAAK,QAAQ,EAAEP,KAAK,CAAC,CAAC,MACzBG,IAAI,CAAC,CAAC;IACb,CAAC,CAAC;IAEF,IAAI3B,QAAQ,CAACqB,YAAY,KAAK,QAAQ,EAAEG,KAAK,CAAC,CAAC;IAE/C,OAAO,MAAM;MACXG,IAAI,CAAC,CAAC;MACNE,WAAW,CAACG,MAAM,CAAC,CAAC;IACtB,CAAC;EACH,CAAC,EAAE,CAACpB,cAAc,CAAC,CAAC;EAEpB,OAAOC,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","onPlaybackChanged","getProgress","onProgressUpdated","emitterize","cb","onPlaybackProgressUpdated","useProgress","usePolledProgress","updateInterval","state","setState","position","duration","buffered","mounted","update","currentState","unsubscribeState","addListener","poll","setTimeout"],"sourceRoot":"../../../../src","sources":["features/playback/progress.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;AACzE,SAASC,iBAAiB,QAAQ,SAAS;;AAE3C;;AAiBA;AACA;AACA;;AAMA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAOJ,aAAa,CAACI,WAAW,CAAC,CAAC;AACpC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BJ,kBAAkB,CAACK,UAAU,CAC1BC,EAAE,IAAMP,aAAa,CAACQ,yBAAyB,GAAGD,EACrD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,WAAWA,CAAA,EAAa;EACtC,OAAOP,qBAAqB,CAACE,WAAW,EAAEC,iBAAiB,CAAC;AAC9D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,iBAAiBA,CAACC,cAAc,GAAG,IAAI,EAAY;EACjE,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGd,QAAQ,CAAW;IAC3Ce,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE;EACZ,CAAC,CAAC;EAEFlB,SAAS,CAAC,MAAM;IACd,IAAImB,OAAO,GAAG,IAAI;IAElB,MAAMC,MAAM,GAAGA,CAAA,KAAM;MACnB,IAAI;QACF,MAAM;UAAEJ,QAAQ;UAAEC,QAAQ;UAAEC;QAAS,CAAC,GAAGZ,WAAW,CAAC,CAAC;QACtD,IAAI,CAACa,OAAO,EAAE;QAEdJ,QAAQ,CAAEM,YAAY,IACpBL,QAAQ,KAAKK,YAAY,CAACL,QAAQ,IAClCC,QAAQ,KAAKI,YAAY,CAACJ,QAAQ,IAClCC,QAAQ,KAAKG,YAAY,CAACH,QAAQ,GAC9BG,YAAY,GACZ;UAAEL,QAAQ;UAAEC,QAAQ;UAAEC;QAAS,CACrC,CAAC;MACH,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC;;IAED;IACA,MAAMI,gBAAgB,GAAGjB,iBAAiB,CAACkB,WAAW,CAACH,MAAM,CAAC;IAE9D,MAAMI,IAAI,GAAGA,CAAA,KAAM;MACjBJ,MAAM,CAAC,CAAC;MACR,IAAI,CAACD,OAAO,EAAE;MACdM,UAAU,CAAC,MAAM;QACf,IAAIN,OAAO,EAAEK,IAAI,CAAC,CAAC;MACrB,CAAC,EAAEX,cAAc,CAAC;IACpB,CAAC;IAEDW,IAAI,CAAC,CAAC;IAEN,OAAO,MAAM;MACXL,OAAO,GAAG,KAAK;MACfG,gBAAgB,CAAC,CAAC;IACpB,CAAC;EACH,CAAC,EAAE,CAACT,cAAc,CAAC,CAAC;EAEpB,OAAOC,KAAK;AACd","ignoreList":[]}

package/lib/module/features/playback/state.js

@@ -41,7 +41,7 @@ export function getPlayback() {
 /**
  * Subscribes to playback state changes.
  * @param callback - Called when the playback state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onPlaybackChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackChanged = cb);
 

package/lib/module/features/playback/volume.js

@@ -33,7 +33,7 @@ export function setVolume(level) {
 /**
  * Sets the system volume.
  * @param level - The volume as a number between 0 and 1.
- * @remarks On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
+ * @note On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
  */
 export function setSystemVolume(level) {
   nativeBrowser.setSystemVolume(level);
@@ -44,7 +44,7 @@ export function setSystemVolume(level) {
 /**
  * Subscribes to system volume changes.
  * @param callback - Called when the system volume changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onSystemVolumeChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onSystemVolumeChanged = cb);
 

package/lib/module/features/player/options.js

@@ -3,14 +3,12 @@
 import { nativeBrowser } from '../../native';
 import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
 import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
-import { validateIOSUpdateOptions } from './validateOptions';
 
 // MARK: - Types
 
 /**
  * Player capabilities control which media controls are available to the user.
- * Most capabilities are enabled by default - only specify the ones you want to change.
- * Exceptions that default to off: `jumpForward`, `jumpBackward`, and `favorite`.
+ * All capabilities are enabled by default - only specify ones you want to disable.
  *
  * @example
  * ```typescript
@@ -25,64 +23,34 @@ import { validateIOSUpdateOptions } from './validateOptions';
  */
 
 /**
- * Buttons that can be placed in the Android button layout — the interactive
- * controls a listener taps in the notification, on the Android Auto Now Playing
- * screen, and in the Android 13+ system media controls.
+ * Buttons that can be assigned to Android notification button slots.
+ * These represent the interactive buttons users can tap in the notification.
  */
 
 /**
- * Where each button sits on Android.
+ * Configuration for notification button layout on Android.
+ * Allows explicit control over which buttons appear in which slots.
  *
- * Android offers exactly three positions, and play/pause always occupies the
- * centre — you cannot move it, and you cannot put two buttons on the same side
- * of it:
- *
- * ```
- *   back  │  ▶ play/pause  │  forward        overflow ⋯
- * ```
- *
- * - **`back`** — the single position left of play/pause
- * - **`forward`** — the single position right of play/pause
- * - **`overflow`** — everything else, in priority order
- *
- * **A layout describes the whole arrangement.** All three fields are required —
- * there is no per-field merge with the capability defaults, so what you write is
- * exactly what renders. Use `undefined` for an empty position and `[]` for no
- * overflow. To go back to the derived defaults, omit `remoteButtonLayout`
- * entirely (or set it to `null`); that is the only switch.
- *
- * **Overflow order is priority, not coordinates.** Each surface renders as many
- * buttons as it has room for, taking them from the front — a phone
- * notification, the Android 13+ system media controls, and a car head unit all
- * have different budgets. A head unit with a spare slot may promote the first
- * overflow entry onto the main row, and a long list gets truncated by whichever
- * surface is showing it. Put what matters most first.
- *
- * Placement never changes what a control *can* do: a button left out entirely
- * still responds to a Bluetooth remote or headset, as long as its
- * {@link PlayerCapabilities} entry is enabled.
+ * Slot behavior:
+ * - **Omit a slot**: Derive from capabilities (smart default)
+ * - **Set to null**: Explicitly empty slot
+ * - **Set to button**: Show that button in that slot
  *
  * @example
  * ```typescript
- * // Podcast-style: jump either side of play/pause
- * remoteButtonLayout: {
+ * // Podcast-style: jump buttons as primary
+ * notificationButtons: {
  *   back: 'jump-backward',
  *   forward: 'jump-forward',
- *   overflow: ['skip-to-previous', 'skip-to-next', 'favorite']
- * }
- *
- * // Music-style: skip either side of play/pause
- * remoteButtonLayout: {
- *   back: 'skip-to-previous',
- *   forward: 'skip-to-next',
  *   overflow: ['favorite']
  * }
  *
- * // Live radio: forward only, nothing to the left
- * remoteButtonLayout: {
- *   back: undefined,
+ * // Music-style: skip as primary, jump as secondary
+ * notificationButtons: {
+ *   back: 'skip-to-previous',
  *   forward: 'skip-to-next',
- *   overflow: []
+ *   backSecondary: 'jump-backward',
+ *   forwardSecondary: 'jump-forward'
  * }
  * ```
  */
@@ -109,32 +77,13 @@ import { validateIOSUpdateOptions } from './validateOptions';
  * @example
  * ```typescript
  * const options = getOptions();
- * console.log(options.forwardJumpInterval); // 15
+ * console.log(options.repeatMode); // 'off'
  * console.log(options.capabilities); // { shuffleMode: false } - only disabled caps shown
  * console.log(options.android?.skipSilence); // true (Android only)
+ * console.log(options.ios?.likeOptions); // { isActive: false, title: 'Like' } (iOS only)
  * ```
  */
 
-/**
- * iOS-specific player options with resolved defaults (from {@link getOptions}).
- * Only present on iOS.
- */
-
-/**
- * Wire shape of {@link AndroidUpdateOptions} — what crosses the Nitro bridge.
- * @internal
- */
-
-/**
- * iOS-specific player options that can be changed at runtime via {@link updateOptions}.
- * @platform ios
- */
-
-/**
- * Wire shape of {@link IOSUpdateOptions} — what crosses the Nitro bridge.
- * @internal
- */
-
 /**
  * Partial options for updating player configuration.
  * Only specify the properties you want to change - all properties are optional.
@@ -142,6 +91,9 @@ import { validateIOSUpdateOptions } from './validateOptions';
  *
  * @example
  * ```typescript
+ * // Update only repeat mode
+ * updateOptions({ repeatMode: 'track' });
+ *
  * // Disable specific capabilities
  * updateOptions({
  *   capabilities: { shuffleMode: false, repeatMode: false }
@@ -154,16 +106,12 @@ import { validateIOSUpdateOptions } from './validateOptions';
  *
  * // Platform-specific options
  * updateOptions({
- *   android: { skipSilence: true }
+ *   android: { skipSilence: true },
+ *   ios: { likeOptions: { isActive: true, title: 'Love' } }
  * });
  * ```
  */
 
-/**
- * Wire shape of {@link UpdateOptions} — what crosses the Nitro bridge.
- * @internal
- */
-
 // MARK: - Functions
 
 /**
@@ -174,6 +122,9 @@ import { validateIOSUpdateOptions } from './validateOptions';
  * @see {@link getOptions} to get current options
  * @example
  * ```typescript
+ * // Update single property
+ * updateOptions({ repeatMode: 'track' });
+ *
  * // Disable specific capabilities
  * updateOptions({
  *   capabilities: { shuffleMode: false },
@@ -182,7 +133,6 @@ import { validateIOSUpdateOptions } from './validateOptions';
  * ```
  */
 export function updateOptions(options) {
-  validateIOSUpdateOptions(options.ios);
   nativeBrowser.updateOptions(options);
 }
 
@@ -196,8 +146,8 @@ export function updateOptions(options) {
  * @example
  * ```typescript
  * const options = getOptions();
- * if (options.capabilities.shuffleMode === false) {
- *   // Shuffle is disabled
+ * if (options.repeatMode === 'track') {
+ *   // Handle track repeat mode
  * }
  * ```
  */
@@ -210,7 +160,7 @@ export function getOptions() {
 /**
  * Subscribes to player options changes.
  * @param callback - Called when the player options change
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onOptionsChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOptionsChanged = cb);
 

package/lib/module/features/player/options.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","validateIOSUpdateOptions","updateOptions","options","ios","getOptions","onOptionsChanged","emitterize","cb","useOptions"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;AAEA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;AACzE,SAASC,wBAAwB,QAAQ,mBAAmB;;AAE5D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgGA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA4CA;AACA;AACA;AACA;;AA4EA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AA6BA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuDA;AACA;AACA;AACA;;AAwCA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAsB,EAAQ;EAC1DF,wBAAwB,CAACE,OAAO,CAACC,GAAG,CAAC;EACrCN,aAAa,CAACI,aAAa,CAACC,OAAO,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOP,aAAa,CAACO,UAAU,CAAC,CAAC;AACnC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,GAAGP,kBAAkB,CAACQ,UAAU,CAC1DC,EAAE,IAAMV,aAAa,CAACQ,gBAAgB,GAAGE,EAC5C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOT,qBAAqB,CAACK,UAAU,EAAEC,gBAAgB,CAAC;AAC5D","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","updateOptions","options","getOptions","onOptionsChanged","emitterize","cb","useOptions"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;AAEA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqEA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkFA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAsB,EAAQ;EAC1DJ,aAAa,CAACG,aAAa,CAACC,OAAO,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOL,aAAa,CAACK,UAAU,CAAC,CAAC;AACnC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,GAAGL,kBAAkB,CAACM,UAAU,CAC1DC,EAAE,IAAMR,aAAa,CAACM,gBAAgB,GAAGE,EAC5C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOP,qBAAqB,CAACG,UAAU,EAAEC,gBAAgB,CAAC;AAC5D","ignoreList":[]}

package/lib/module/features/player/setup.js

@@ -3,80 +3,6 @@
 // MARK: - Types
 
 import { nativeBrowser } from '../../native';
-import { validateIOSUpdateOptions } from './validateOptions';
-
-/**
- * Parameters passed to the {@link FormatNowPlayingCallback}.
- *
- * The formatter owns every line shown on the now-playing surface — the track text, the live song,
- * *and* any transient status (reconnecting / error). The library no longer renders status copy
- * itself, so these fields give you what you need to render (and localize) it yourself. The formatter
- * is re-invoked on track change, each timed-metadata update, play/pause + error/rebuffer
- * transitions, and device connectivity changes.
- */
-
-/**
- * Why ongoing playback has stalled, surfaced via {@link FormatNowPlayingParams.stalled}:
- * - `'buffering'` — rebuffering while online (the live stream is rejoining the live edge);
- * - `'offline'` — the device has no network connectivity.
- */
-
-/**
- * Customizes what's rendered on the now-playing surface — lock screen, notification, Control Center,
- * CarPlay, and Android Auto — for the currently playing track.
- *
- * Configure it via {@link SetupPlayerOptions.nowPlaying}. Where the default behavior
- * simply publishes the track's own `title` / `artist`, the formatter hands you the two now-playing
- * text lines outright: render the live timed metadata (the ICY / ID3 "now playing song"), surface a
- * transient status line ("Reconnecting…", an error message), drop the song while paused — anything
- * you can derive from the {@link FormatNowPlayingParams} for that moment.
- *
- * The callback is **synchronous** and should stay cheap: it's a pure formatting function, run on the
- * JS thread and awaited natively. Don't do I/O in it. If you need asynchronously-fetched data (e.g.
- * album art), resolve it out-of-band and stamp it imperatively rather than awaiting inside here.
- *
- * ### When it's invoked
- * The player re-invokes the formatter whenever the now-playing could change:
- * - on track change (a new item becomes current);
- * - on each timed-metadata update ({@link FormatNowPlayingParams.timedMetadata} arrives or changes);
- * - on every playback transition — play / pause, a stall starting or recovering, an error.
- *
- * Identical results are de-duplicated natively before they reach the media session, so returning the
- * same fields across a rapid burst of transitions is cheap and won't flicker the surface.
- *
- * ### What to return
- * Return a {@link NowPlayingUpdate} with the fields to display. Each field falls back **independently**
- * to the track's own value when omitted — so `{ artist: 'Some Song' }` replaces only the secondary
- * line and leaves the title as the track's title. Return `undefined` (or `{}`) to use the library
- * default entirely (the track's own `title` / `artist`).
- *
- * @param params - The current track, latest timed metadata, and playback signals for this moment
- *   ({@link FormatNowPlayingParams}), including a {@link StallReason} that already classifies an
- *   offline stall — no separate connectivity read needed for the now-playing line.
- * @returns The now-playing fields to display, or `undefined` to fall back to the track's own
- *   `title` / `artist`.
- *
- * @example
- * ```ts
- * setupPlayer({
- *   nowPlaying: ({ timedMetadata, playWhenReady, stalled, error }) => {
- *     if (error)   return { artist: error.message ?? 'Playback error' }
- *     if (stalled) return { artist: stalled === 'offline' ? 'No internet connection' : 'Reconnecting…' }
- *     // Show the live song only while actually playing; otherwise fall back to the track default.
- *     if (!playWhenReady || !timedMetadata?.title) return
- *     return {
- *       artist: timedMetadata.artist
- *         ? `${timedMetadata.artist} — ${timedMetadata.title}`
- *         : timedMetadata.title
- *     }
- *   }
- * })
- * ```
- *
- * @see {@link FormatNowPlayingParams} - the per-invocation signals passed in
- * @see {@link NowPlayingUpdate} - the shape returned
- * @see {@link SetupPlayerOptions.nowPlaying} - where the callback is configured
- */
 
 /**
  * AndroidAudioContentType options:
@@ -187,26 +113,6 @@ import { validateIOSUpdateOptions } from './validateOptions';
 
 /**
  * Configuration for retry behavior.
- *
- * Two budgets apply, chosen by whether the current load has ever produced
- * audio:
- *
- * - **First connect** (the load has never played): retries are bounded by
- *   `firstConnectMaxRetryDurationMs`. A stream that fails before ever playing
- *   is usually dead, and the listener is actively waiting for a verdict —
- *   seconds, not minutes.
- * - **Recovery** (the load played, then failed): retries are bounded by
- *   `maxRetryDurationMs`. Playback proved the stream works; drops are usually
- *   transient (tunnels, network handovers, a station's encoder restarting)
- *   and patience is what recovers them unattended.
- *
- * While the device is offline, the first-connect budget does not apply: the
- * player waits for connectivity to return (bounded by `maxRetryDurationMs`),
- * so a station tapped in a tunnel still starts when the network comes back.
- * Any offline observation restarts the first-connect clock, so it only ever
- * measures a contiguous online stretch.
- *
- * Native platforms only — the web implementation has no automatic retry.
  */
 
 /**
@@ -219,175 +125,16 @@ import { validateIOSUpdateOptions } from './validateOptions';
  */
 
 /**
- * Android setup options: the engine-construction fields plus the Android runtime options
- * ({@link AndroidUpdateOptions} — `remoteButtonLayout`, `skipSilence`, …), all expressible at
- * launch. The consumer never has to know which is which; `setupPlayer` routes each field to
- * where it's applied.
- */
-
-/** iOS setup options: the audio-session fields plus the iOS runtime options. */
-
-/**
- * @internal The wire shape `setupPlayer` sends across the bridge: the platform bags hold only
- * construction fields, the runtime options nest under `options`, and the public `nowPlaying`
- * option arrives normalized into the two now-playing fields.
+ * Android-specific player setup options.
  */
 
 // MARK: - Lifecycle
 
 /**
- * @internal Wire shape for {@link AndroidSetupOptions}: just the engine-construction fields —
- * the runtime options travel separately under the wire payload's `options.android`.
- */
-
-/**
- * @internal Wire shape for {@link IOSSetupOptions}: just the audio-session fields — the
- * runtime options travel separately under the wire payload's `options.ios`.
- */
-
-/**
- * Public setup options: the full launch description of a player in one bag — engine
- * construction, runtime options (`capabilities`, jump intervals, …), and initial player state
- * (`playWhenReady`, `repeatMode`). Everything is applied natively in one atomic setup; there
- * is no call ordering to get right. `setupPlayer` normalizes this into the wire taxonomy —
- * consumers never see the split.
- */
-
-/** The normalized native now-playing fields, resolved from the public option. */
-
-/** Resolves the public `nowPlaying` option to the normalized native fields. */
-function resolveNowPlaying(value) {
-  if (typeof value === 'function') {
-    return {
-      autoUpdateNowPlayingMetadata: true,
-      nowPlayingMetadataFormatter: wrapNowPlayingFormatter(value)
-    };
-  }
-  // `undefined` defaults to on; `true`/`false` toggle the default mapping.
-  return {
-    autoUpdateNowPlayingMetadata: value ?? true,
-    nowPlayingMetadataFormatter: undefined
-  };
-}
-
-/**
- * Wraps a {@link FormatNowPlayingCallback} so it never resolves the native callback to `null`.
- *
- * The callback contract lets consumers `return undefined` to mean "use the default". But Nitro's
- * `Promise<T | undefined>.await()` throws `Failed to cast Object to T!` when the callback resolves
- * to null/undefined — which surfaces on Android as the misleading "Cannot reject Promise … it is
- * already resolved!" (the cast error is swallowed, then a reject is attempted on the
- * already-resolved promise). So we coalesce `undefined` to an empty update before it crosses the
- * boundary: the native side already falls back to the track's own title/artist for each missing
- * field, so `{}` is equivalent to "use the default" without ever sending a null across.
- */
-function wrapNowPlayingFormatter(formatter) {
-  return params => formatter(params) ?? {};
-}
-
-/**
- * The object's entries whose values aren't `undefined`. `null` stays: it's meaningful on some
- * fields (`progressUpdateEventInterval: null` disables progress events, `remoteButtonLayout:
- * null` empties the layout), so only `undefined` means "not provided".
- */
-function definedFields(obj) {
-  const out = {};
-  for (const key in obj) {
-    if (obj[key] !== undefined) out[key] = obj[key];
-  }
-  return out;
-}
-
-/** Spreads `value` under `key` only when it has at least one field. */
-function nonEmpty(key, value) {
-  return Object.keys(value).length > 0 ? {
-    [key]: value
-  } : {};
-}
-
-/**
- * Initializes the player with the specified options — the full launch description in one
- * declarative, atomic call. Runtime options (`capabilities`, jump intervals,
- * `remoteButtonLayout`, …) and the initial `playWhenReady` / `repeatMode` are applied
- * natively as part of setup itself, so there is no setup-then-command ordering for consumers
- * to know about, and no window where the player exists without its options.
- *
- * Calling it again reconfigures the player in place: newly provided fields are merged over
- * the previous ones, and the audio engine is rebuilt when construction-bound fields (buffers,
- * wake mode, …) changed.
- *
+ * Initializes the player with the specified options.
  * @param options - The options to initialize the player with.
- *
- * @example
- * ```ts
- * await setupPlayer({
- *   retry: true,
- *   playWhenReady: true,
- *   repeatMode: 'queue',
- *   capabilities: { favorite: true },
- *   android: {
- *     audioContentType: 'music',
- *     remoteButtonLayout: {
- *       back: 'jump-backward',
- *       forward: 'jump-forward',
- *       overflow: ['favorite']
- *     }
- *   },
- *   ios: { category: 'playback' }
- * })
- * ```
  */
 export async function setupPlayer(options = {}) {
-  const {
-    nowPlaying,
-    capabilities,
-    forwardJumpInterval,
-    backwardJumpInterval,
-    progressUpdateEventInterval,
-    android = {},
-    ios = {},
-    ...nativeSetup
-  } = options;
-
-  // Split the merged public bags back into the wire taxonomy: construction fields stay under
-  // `android` / `ios`, runtime options nest under `options`. The consumer never has to learn
-  // which is which.
-  const {
-    appKilledPlaybackBehavior,
-    skipSilence,
-    remoteButtonLayout,
-    ...androidSetup
-  } = android;
-  const {
-    playbackRates,
-    carPlayUpNextButton,
-    carPlayNowPlayingButtons,
-    ...iosSetup
-  } = ios;
-  const iosUpdate = definedFields({
-    playbackRates,
-    carPlayUpNextButton,
-    carPlayNowPlayingButtons
-  });
-  validateIOSUpdateOptions(iosUpdate);
-  const updates = definedFields({
-    capabilities,
-    forwardJumpInterval,
-    backwardJumpInterval,
-    progressUpdateEventInterval,
-    ...nonEmpty('android', definedFields({
-      appKilledPlaybackBehavior,
-      skipSilence,
-      remoteButtonLayout
-    })),
-    ...nonEmpty('ios', iosUpdate)
-  });
-  return nativeBrowser.setupPlayer({
-    ...nativeSetup,
-    ...nonEmpty('android', definedFields(androidSetup)),
-    ...nonEmpty('ios', definedFields(iosSetup)),
-    ...resolveNowPlaying(nowPlaying),
-    ...nonEmpty('options', updates)
-  });
+  return nativeBrowser.setupPlayer(options);
 }
 //# sourceMappingURL=setup.js.map

package/lib/module/features/player/setup.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","validateIOSUpdateOptions","resolveNowPlaying","value","autoUpdateNowPlayingMetadata","nowPlayingMetadataFormatter","wrapNowPlayingFormatter","undefined","formatter","params","definedFields","obj","out","key","nonEmpty","Object","keys","length","setupPlayer","options","nowPlaying","capabilities","forwardJumpInterval","backwardJumpInterval","progressUpdateEventInterval","android","ios","nativeSetup","appKilledPlaybackBehavior","skipSilence","remoteButtonLayout","androidSetup","playbackRates","carPlayUpNextButton","carPlayNowPlayingButtons","iosSetup","iosUpdate","updates"],"sourceRoot":"../../../../src","sources":["features/player/setup.ts"],"mappings":";;AAAA;;AAYA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,wBAAwB,QAAQ,mBAAmB;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsBA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA2BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AA2GA;;AA4CA;AACA;AACA;AACA;AACA;;AAgCA;;AAEA;AACA;AACA;AACA;;AAMA;AACA;AA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","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","setupPlayer","options"],"sourceRoot":"../../../../src","sources":["features/player/setup.ts"],"mappings":";;AAAA;;AAEA,SAASA,aAAa,QAAQ,cAAc;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;;AA+VA;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeC,WAAWA,CAC/BC,OAAkC,GAAG,CAAC,CAAC,EACxB;EACf,OAAOF,aAAa,CAACC,WAAW,CAACC,OAAO,CAAC;AAC3C","ignoreList":[]}