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

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

@@ -10,13 +10,11 @@ exports.useOptions = useOptions;
 var _native = require("../../native");
 var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
 var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
-var _validateOptions = require("./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
@@ -31,64 +29,34 @@ var _validateOptions = require("./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'
  * }
  * ```
  */
@@ -115,32 +83,13 @@ var _validateOptions = require("./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.
@@ -148,6 +97,9 @@ var _validateOptions = require("./validateOptions");
  *
  * @example
  * ```typescript
+ * // Update only repeat mode
+ * updateOptions({ repeatMode: 'track' });
+ *
  * // Disable specific capabilities
  * updateOptions({
  *   capabilities: { shuffleMode: false, repeatMode: false }
@@ -160,16 +112,12 @@ var _validateOptions = require("./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
 
 /**
@@ -180,6 +128,9 @@ var _validateOptions = require("./validateOptions");
  * @see {@link getOptions} to get current options
  * @example
  * ```typescript
+ * // Update single property
+ * updateOptions({ repeatMode: 'track' });
+ *
  * // Disable specific capabilities
  * updateOptions({
  *   capabilities: { shuffleMode: false },
@@ -188,7 +139,6 @@ var _validateOptions = require("./validateOptions");
  * ```
  */
 function updateOptions(options) {
-  (0, _validateOptions.validateIOSUpdateOptions)(options.ios);
   _native.nativeBrowser.updateOptions(options);
 }
 
@@ -202,8 +152,8 @@ function updateOptions(options) {
  * @example
  * ```typescript
  * const options = getOptions();
- * if (options.capabilities.shuffleMode === false) {
- *   // Shuffle is disabled
+ * if (options.repeatMode === 'track') {
+ *   // Handle track repeat mode
  * }
  * ```
  */
@@ -216,7 +166,7 @@ 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
  */
 const onOptionsChanged = exports.onOptionsChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onOptionsChanged = cb);
 

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

@@ -1 +1 @@
-{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","_validateOptions","updateOptions","options","validateIOSUpdateOptions","ios","nativeBrowser","getOptions","onOptionsChanged","exports","NativeUpdatedValue","emitterize","cb","useOptions","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;;;;;;;;AAEA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AACA,IAAAG,gBAAA,GAAAH,OAAA;AAEA;;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;AACO,SAASI,aAAaA,CAACC,OAAsB,EAAQ;EAC1D,IAAAC,yCAAwB,EAACD,OAAO,CAACE,GAAG,CAAC;EACrCC,qBAAa,CAACJ,aAAa,CAACC,OAAO,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,UAAUA,CAAA,EAAY;EACpC,OAAOD,qBAAa,CAACC,UAAU,CAAC,CAAC;AACnC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMC,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC1DC,EAAE,IAAMN,qBAAa,CAACE,gBAAgB,GAAGI,EAC5C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAO,IAAAC,4CAAqB,EAACP,UAAU,EAAEC,gBAAgB,CAAC;AAC5D","ignoreList":[]}
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","updateOptions","options","nativeBrowser","getOptions","onOptionsChanged","exports","NativeUpdatedValue","emitterize","cb","useOptions","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;;;;;;;;AAEA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;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;AACO,SAASG,aAAaA,CAACC,OAAsB,EAAQ;EAC1DC,qBAAa,CAACF,aAAa,CAACC,OAAO,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOD,qBAAa,CAACC,UAAU,CAAC,CAAC;AACnC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMC,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC1DC,EAAE,IAAMN,qBAAa,CAACE,gBAAgB,GAAGI,EAC5C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAO,IAAAC,4CAAqB,EAACP,UAAU,EAAEC,gBAAgB,CAAC;AAC5D","ignoreList":[]}

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

@@ -5,82 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.setupPlayer = setupPlayer;
 var _native = require("../../native");
-var _validateOptions = require("./validateOptions");
 // MARK: - Types
 
-/**
- * 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:
  * - `'music'`: Content type value to use when the content type is music. See
@@ -190,26 +116,6 @@ var _validateOptions = require("./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.
  */
 
 /**
@@ -222,175 +128,16 @@ var _validateOptions = require("./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' }
- * })
- * ```
  */
 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
-  });
-  (0, _validateOptions.validateIOSUpdateOptions)(iosUpdate);
-  const updates = definedFields({
-    capabilities,
-    forwardJumpInterval,
-    backwardJumpInterval,
-    progressUpdateEventInterval,
-    ...nonEmpty('android', definedFields({
-      appKilledPlaybackBehavior,
-      skipSilence,
-      remoteButtonLayout
-    })),
-    ...nonEmpty('ios', iosUpdate)
-  });
-  return _native.nativeBrowser.setupPlayer({
-    ...nativeSetup,
-    ...nonEmpty('android', definedFields(androidSetup)),
-    ...nonEmpty('ios', definedFields(iosSetup)),
-    ...resolveNowPlaying(nowPlaying),
-    ...nonEmpty('options', updates)
-  });
+  return _native.nativeBrowser.setupPlayer(options);
 }
 //# sourceMappingURL=setup.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["_native","require","_validateOptions","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","validateIOSUpdateOptions","updates","nativeBrowser"],"sourceRoot":"../../../../src","sources":["features/player/setup.ts"],"mappings":";;;;;;AAYA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAD,OAAA;AAbA;;AAeA;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;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;;AA0EA;;AAMA;AACA,SAASE,iBAAiBA,CACxBC,KAAuC,EACjB;EACtB,IAAI,OAAOA,KAAK,KAAK,UAAU,EAAE;IAC/B,OAAO;MACLC,4BAA4B,EAAE,IAAI;MAClCC,2BAA2B,EAAEC,uBAAuB,CAACH,KAAK;IAC5D,CAAC;EACH;EACA;EACA,OAAO;IACLC,4BAA4B,EAAED,KAAK,IAAI,IAAI;IAC3CE,2BAA2B,EAAEE;EAC/B,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASD,uBAAuBA,CAC9BE,SAAmC,EACT;EAC1B,OAAQC,MAAM,IAAKD,SAAS,CAACC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASC,aAAaA,CAAmBC,GAAM,EAAc;EAC3D,MAAMC,GAAe,GAAG,CAAC,CAAC;EAC1B,KAAK,MAAMC,GAAG,IAAIF,GAAG,EAAE;IACrB,IAAIA,GAAG,CAACE,GAAG,CAAC,KAAKN,SAAS,EAAEK,GAAG,CAACC,GAAG,CAAC,GAAGF,GAAG,CAACE,GAAG,CAAC;EACjD;EACA,OAAOD,GAAG;AACZ;;AAEA;AACA,SAASE,QAAQA,CACfD,GAAM,EACNV,KAAQ,EACU;EAClB,OAAOY,MAAM,CAACC,IAAI,CAACb,KAAK,CAAC,CAACc,MAAM,GAAG,CAAC,GAC/B;IAAE,CAACJ,GAAG,GAAGV;EAAM,CAAC,GACjB,CAAC,CAAC;AACR;;AAEA;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;AACO,eAAee,WAAWA,CAC/BC,OAA2B,GAAG,CAAC,CAAC,EACjB;EACf,MAAM;IACJC,UAAU;IACVC,YAAY;IACZC,mBAAmB;IACnBC,oBAAoB;IACpBC,2BAA2B;IAC3BC,OAAO,GAAG,CAAC,CAAC;IACZC,GAAG,GAAG,CAAC,CAAC;IACR,GAAGC;EACL,CAAC,GAAGR,OAAO;;EAEX;EACA;EACA;EACA,MAAM;IACJS,yBAAyB;IACzBC,WAAW;IACXC,kBAAkB;IAClB,GAAGC;EACL,CAAC,GAAGN,OAAO;EACX,MAAM;IACJO,aAAa;IACbC,mBAAmB;IACnBC,wBAAwB;IACxB,GAAGC;EACL,CAAC,GAAGT,GAAG;EACP,MAAMU,SAAS,GAAG1B,aAAa,CAAC;IAC9BsB,aAAa;IACbC,mBAAmB;IACnBC;EACF,CAAC,CAAC;EACF,IAAAG,yCAAwB,EAACD,SAAS,CAAC;EAEnC,MAAME,OAA4B,GAAG5B,aAAa,CAAC;IACjDW,YAAY;IACZC,mBAAmB;IACnBC,oBAAoB;IACpBC,2BAA2B;IAC3B,GAAGV,QAAQ,CACT,SAAS,EACTJ,aAAa,CAAC;MACZkB,yBAAyB;MACzBC,WAAW;MACXC;IACF,CAAC,CACH,CAAC;IACD,GAAGhB,QAAQ,CAAC,KAAK,EAAEsB,SAAS;EAC9B,CAAC,CAAC;EAEF,OAAOG,qBAAa,CAACrB,WAAW,CAAC;IAC/B,GAAGS,WAAW;IACd,GAAGb,QAAQ,CAAC,SAAS,EAAEJ,aAAa,CAACqB,YAAY,CAAC,CAAC;IACnD,GAAGjB,QAAQ,CAAC,KAAK,EAAEJ,aAAa,CAACyB,QAAQ,CAAC,CAAC;IAC3C,GAAGjC,iBAAiB,CAACkB,UAAU,CAAC;IAChC,GAAGN,QAAQ,CAAC,SAAS,EAAEwB,OAAO;EAChC,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["_native","require","setupPlayer","options","nativeBrowser"],"sourceRoot":"../../../../src","sources":["features/player/setup.ts"],"mappings":";;;;;;AAEA,IAAAA,OAAA,GAAAC,OAAA;AAFA;;AAIA;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;AACO,eAAeC,WAAWA,CAC/BC,OAAkC,GAAG,CAAC,CAAC,EACxB;EACf,OAAOC,qBAAa,CAACF,WAAW,CAACC,OAAO,CAAC;AAC3C","ignoreList":[]}

package/lib/commonjs/features/queue/activeTrack.js

@@ -36,7 +36,7 @@ function getActiveTrackIndex() {
 /**
  * Subscribes to active track change events.
  * @param callback - Called when the active track changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 const onActiveTrackChanged = exports.onActiveTrackChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackActiveTrackChanged = cb);
 

package/lib/commonjs/features/queue/queue.js

@@ -123,18 +123,11 @@ function skipToPrevious(initialPosition) {
 }
 
 /**
- * Sets (replaces) the queue.
- *
- * This does not change the play/pause state: the player keeps playing if it was
- * playing and stays paused if it was paused. Call `play` explicitly to
- * start playback.
- *
+ * Sets the queue.
  * @param tracks - The tracks to set as the queue.
- * @param startIndex - (Optional) The index of the track to make active.
- * @param startPosition - (Optional) The position in seconds to start the active track from.
  */
-function setQueue(tracks, startIndex, startPosition) {
-  _native.nativeBrowser.setQueue(tracks, startIndex, startPosition);
+function setQueue(tracks) {
+  _native.nativeBrowser.setQueue(tracks);
 }
 
 // MARK: - Getters
@@ -160,7 +153,7 @@ function getQueue() {
 /**
  * Subscribes to playback queue ended events.
  * @param callback - Called when playback has paused due to reaching the end of the queue
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 const onQueueEnded = exports.onQueueEnded = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackQueueEnded = cb);
 
@@ -168,7 +161,7 @@ const onQueueEnded = exports.onQueueEnded = _NativeUpdatedValue.NativeUpdatedVal
  * Subscribes to queue change events.
  * Called when tracks are added, removed, reordered, or when track metadata changes.
  * @param callback - Called with the updated queue
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 const onQueueChanged = exports.onQueueChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackQueueChanged = cb);
 

package/lib/commonjs/features/queue/queue.js.map

@@ -1 +1 @@
-{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","nativeBrowser","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","exports","NativeUpdatedValue","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","useQueue","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","nativeBrowser","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","getTrack","getQueue","onQueueEnded","exports","NativeUpdatedValue","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","useQueue","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/features/queue/repeatMode.js

@@ -42,7 +42,7 @@ function setRepeatMode(repeatMode) {
 /**
  * Subscribes to repeat mode changes.
  * @param callback - Called when repeat mode changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 const onRepeatModeChanged = exports.onRepeatModeChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackRepeatModeChanged = cb);
 

package/lib/commonjs/features/queue/shuffle.js

@@ -41,7 +41,7 @@ function toggleShuffle() {
 /**
  * Subscribes to shuffle mode changes.
  * @param callback - Called when shuffle mode changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 const onShuffleChanged = exports.onShuffleChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackShuffleModeChanged = cb);
 

package/lib/commonjs/features/rating.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=rating.js.map

package/lib/commonjs/features/rating.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["features/rating.ts"],"mappings":"","ignoreList":[]}