@5stones/react-native-audio-browser 0.1.0

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

@@ -0,0 +1,176 @@
+"use strict";
+
+import { nativeBrowser } from '../../native';
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
+
+// MARK: - Types
+
+/**
+ * Player capabilities control which media controls are available to the user.
+ * All capabilities are enabled by default - only specify ones you want to disable.
+ *
+ * @example
+ * ```typescript
+ * // Disable shuffle and repeat for a simple player
+ * updateOptions({
+ *   capabilities: {
+ *     shuffleMode: false,
+ *     repeatMode: false,
+ *   }
+ * })
+ * ```
+ */
+
+/**
+ * Buttons that can be assigned to Android notification button slots.
+ * These represent the interactive buttons users can tap in the notification.
+ */
+
+/**
+ * Configuration for notification button layout on Android.
+ * Allows explicit control over which buttons appear in which slots.
+ *
+ * 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 buttons as primary
+ * notificationButtons: {
+ *   back: 'jump-backward',
+ *   forward: 'jump-forward',
+ *   overflow: ['favorite']
+ * }
+ *
+ * // Music-style: skip as primary, jump as secondary
+ * notificationButtons: {
+ *   back: 'skip-to-previous',
+ *   forward: 'skip-to-next',
+ *   backSecondary: 'jump-backward',
+ *   forwardSecondary: 'jump-forward'
+ * }
+ * ```
+ */
+
+/**
+ * AppKilledPlaybackBehavior options:
+ * - `'continue-playback'`: This option will continue playing audio in the
+ *   background when the app is removed from recents. The notification remains.
+ *   This is the default.
+ * - `'pause-playback'`: This option will pause playing audio in the background
+ *   when the app is removed from recents. The notification remains and can be
+ *   used to resume playback.
+ * - `'stop-playback-and-remove-notification'`: This option will stop playing
+ *   audio in the background when the app is removed from recents. The
+ *   notification is removed and can't be used to resume playback. Users would
+ *   need to open the app again to start playing audio.
+ */
+
+/**
+ * Current player options with resolved defaults.
+ * This is what you receive from getOptions() - all properties are present with their current values.
+ * Platform-specific properties (android/ios) are only available on their respective platforms.
+ *
+ * @example
+ * ```typescript
+ * const options = getOptions();
+ * 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)
+ * ```
+ */
+
+/**
+ * Partial options for updating player configuration.
+ * Only specify the properties you want to change - all properties are optional.
+ * Use null to reset properties to their defaults.
+ *
+ * @example
+ * ```typescript
+ * // Update only repeat mode
+ * updateOptions({ repeatMode: 'track' });
+ *
+ * // Disable specific capabilities
+ * updateOptions({
+ *   capabilities: { shuffleMode: false, repeatMode: false }
+ * });
+ *
+ * // Disable progress events by setting to null
+ * updateOptions({
+ *   progressUpdateEventInterval: null
+ * });
+ *
+ * // Platform-specific options
+ * updateOptions({
+ *   android: { skipSilence: true },
+ *   ios: { likeOptions: { isActive: true, title: 'Love' } }
+ * });
+ * ```
+ */
+
+// MARK: - Functions
+
+/**
+ * Updates the configuration for the components.
+ * Pass only the properties you want to change - all properties are optional.
+ *
+ * @param options - The partial options to update. Only changed properties need to be specified.
+ * @see {@link getOptions} to get current options
+ * @example
+ * ```typescript
+ * // Update single property
+ * updateOptions({ repeatMode: 'track' });
+ *
+ * // Disable specific capabilities
+ * updateOptions({
+ *   capabilities: { shuffleMode: false },
+ *   progressUpdateEventInterval: 0.5
+ * });
+ * ```
+ */
+export function updateOptions(options) {
+  nativeBrowser.updateOptions(options);
+}
+
+// MARK: - Getters
+
+/**
+ * Gets the current player options with resolved defaults.
+ * Returns all current option values - use this to read the current state.
+ *
+ * @returns The current player options with all properties resolved to their current values
+ * @example
+ * ```typescript
+ * const options = getOptions();
+ * if (options.repeatMode === 'track') {
+ *   // Handle track repeat mode
+ * }
+ * ```
+ */
+export function getOptions() {
+  return nativeBrowser.getOptions();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to player options changes.
+ * @param callback - Called when the player options change
+ * @returns Cleanup function to unsubscribe
+ */
+export const onOptionsChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOptionsChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current player options and updates when they change.
+ * @returns The current player options
+ */
+export function useOptions() {
+  return useNativeUpdatedValue(getOptions, onOptionsChanged);
+}
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","updateOptions","options","getOptions","onOptionsChanged","emitterize","cb","useOptions"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAIzE;;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

@@ -0,0 +1,140 @@
+"use strict";
+
+// MARK: - Types
+
+import { nativeBrowser } from '../../native';
+
+/**
+ * AndroidAudioContentType options:
+ * - `'music'`: Content type value to use when the content type is music. See
+ *   https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_MUSIC
+ * - `'speech'`: Content type value to use when the content type is speech. See
+ *   https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_SPEECH
+ * - `'sonification'`: Content type value to use when the content type is a
+ *   sound used to accompany a user action, such as a beep or sound effect
+ *   expressing a key click, or event, such as the type of a sound for a bonus
+ *   being received in a game. These sounds are mostly synthesized or short
+ *   Foley sounds. See
+ *   https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_SONIFICATION
+ * - `'movie'`: Content type value to use when the content type is a soundtrack,
+ *   typically accompanying a movie or TV program.
+ * - `'unknown'`: Content type value to use when the content type is unknown, or
+ *   other than the ones defined. See
+ *   https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_UNKNOWN
+ */
+
+/**
+ * IOSCategory options:
+ * - `'playback'`: The category for playing recorded music or other sounds that
+ *   are central to the successful use of your app. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616509-playback
+ * - `'playAndRecord'`: The category for recording (input) and playback (output)
+ *   of audio, such as for a Voice over Internet Protocol (VoIP) app. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616568-playandrecord
+ * - `'multiRoute'`: The category for routing distinct streams of audio data to
+ *   different output devices at the same time. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616484-multiroute
+ * - `'ambient'`: The category for an app in which sound playback is nonprimary
+ *   — that is, your app also works with the sound turned off. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616560-ambient
+ * - `'soloAmbient'`: The default audio session category. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616488-soloambient
+ * - `'record'`: The category for recording audio while also silencing playback
+ *   audio. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616451-record
+ */
+
+/**
+ * IOSCategoryMode options:
+ * - `'default'`: The default audio session mode. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616579-default
+ * - `'gameChat'`: A mode that the GameKit framework sets on behalf of an
+ *   application that uses GameKit's voice chat service. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616511-gamechat
+ * - `'measurement'`: A mode that indicates that your app is performing
+ *   measurement of audio input or output. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616608-measurement
+ * - `'moviePlayback'`: A mode that indicates that your app is playing back
+ *   movie content. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616623-movieplayback
+ * - `'spokenAudio'`: A mode used for continuous spoken audio to pause the audio
+ *   when another app plays a short audio prompt. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616510-spokenaudio
+ * - `'videoChat'`: A mode that indicates that your app is engaging in online
+ *   video conferencing. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616590-videochat
+ * - `'videoRecording'`: A mode that indicates that your app is recording a
+ *   movie. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616535-videorecording
+ * - `'voiceChat'`: A mode that indicates that your app is performing two-way
+ *   voice communication, such as using Voice over Internet Protocol (VoIP). See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/1616455-voicechat
+ * - `'voicePrompt'`: A mode that indicates that your app plays audio using
+ *   text-to-speech. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/mode/2962803-voiceprompt
+ */
+
+/**
+ * IOSCategoryOptions options:
+ * - `'mixWithOthers'`: An option that indicates whether audio from this session
+ *   mixes with audio from active sessions in other audio apps. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1616611-mixwithothers
+ * - `'duckOthers'`: An option that reduces the volume of other audio sessions
+ *   while audio from this session plays. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1616618-duckothers
+ * - `'interruptSpokenAudioAndMixWithOthers'`: An option that determines whether
+ *   to pause spoken audio content from other sessions when your app plays its
+ *   audio. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1616534-interruptspokenaudioandmixwithot
+ * - `'allowBluetooth'`: An option that determines whether Bluetooth hands-free
+ *   devices appear as available input routes. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1616518-allowbluetooth
+ * - `'allowBluetoothA2DP'`: An option that determines whether you can stream
+ *   audio from this session to Bluetooth devices that support the Advanced
+ *   Audio Distribution Profile (A2DP). See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1771735-allowbluetootha2dp
+ * - `'allowAirPlay'`: An option that determines whether you can stream audio
+ *   from this session to AirPlay devices. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1771736-allowairplay
+ * - `'defaultToSpeaker'`: An option that determines whether audio from the
+ *   session defaults to the built-in speaker instead of the receiver. See
+ *   https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions/1616462-defaulttospeaker
+ */
+
+/**
+ * IOSCategoryPolicy options:
+ * - `'default'`: See
+ *   https://developer.apple.com/documentation/avfoundation/avaudiosession/routesharingpolicy/default
+ * - `'longFormAudio'`: See
+ *   https://developer.apple.com/documentation/avfoundation/avaudiosession/routesharingpolicy/longformaudio
+ * - `'longFormVideo'`: See
+ *   https://developer.apple.com/documentation/avfoundation/avaudiosession/routesharingpolicy/longformvideo
+ */
+
+/**
+ * Configuration for retry behavior.
+ */
+
+/**
+ * AndroidWakeMode options:
+ * - `'none'`: No wake locks are held. The device may go to sleep during playback.
+ * - `'local'`: Holds a PowerManager.WakeLock during playback to prevent CPU sleep.
+ *   Suitable for local media playback with the screen off.
+ * - `'network'`: Holds both PowerManager.WakeLock and WifiManager.WifiLock during playback.
+ *   Suitable for streaming media over WiFi with the screen off.
+ */
+
+/**
+ * Android-specific player setup options.
+ */
+
+// MARK: - Lifecycle
+
+/**
+ * Initializes the player with the specified options.
+ * @param options - The options to initialize the player with.
+ */
+export async function setupPlayer(options = {}) {
+  return nativeBrowser.setupPlayer(options);
+}
+//# sourceMappingURL=setup.js.map

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

@@ -0,0 +1 @@
+{"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":[]}

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

@@ -0,0 +1,46 @@
+"use strict";
+
+import { nativeBrowser } from '../../native';
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
+
+/**
+ * Event data for when the active track changes.
+ */
+
+// MARK: - Getters
+
+/**
+ * Gets the active track or undefined if there is no current track.
+ */
+export function getActiveTrack() {
+  return nativeBrowser.getActiveTrack() ?? undefined;
+}
+
+/**
+ * Gets the index of the active track in the queue or undefined if there is no
+ * current track.
+ */
+export function getActiveTrackIndex() {
+  return nativeBrowser.getActiveTrackIndex() ?? undefined;
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to active track change events.
+ * @param callback - Called when the active track changes
+ * @returns Cleanup function to unsubscribe
+ */
+export const onActiveTrackChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackActiveTrackChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current active track and updates when it changes.
+ * @returns The current active track or undefined
+ */
+export function useActiveTrack() {
+  return useNativeUpdatedValue(getActiveTrack, onActiveTrackChanged, 'track');
+}
+//# sourceMappingURL=activeTrack.js.map

package/lib/module/features/queue/activeTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getActiveTrack","undefined","getActiveTrackIndex","onActiveTrackChanged","emitterize","cb","onPlaybackActiveTrackChanged","useActiveTrack"],"sourceRoot":"../../../../src","sources":["features/queue/activeTrack.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAE5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;AACA;AACA;;AAcA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAsB;EAClD,OAAOH,aAAa,CAACG,cAAc,CAAC,CAAC,IAAIC,SAAS;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAuB;EACxD,OAAOL,aAAa,CAACK,mBAAmB,CAAC,CAAC,IAAID,SAAS;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,oBAAoB,GAC/BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,4BAA4B,GAAGD,EACxD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,cAAcA,CAAA,EAAsB;EAClD,OAAOR,qBAAqB,CAACC,cAAc,EAAEG,oBAAoB,EAAE,OAAO,CAAC;AAC7E","ignoreList":[]}

package/lib/module/features/queue/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+export * from './queue';
+export * from './activeTrack';
+export * from './repeatMode';
+export * from './shuffle';
+//# sourceMappingURL=index.js.map

package/lib/module/features/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["features/queue/index.ts"],"mappings":";;AAAA,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,cAAc;AAC5B,cAAc,WAAW","ignoreList":[]}

package/lib/module/features/queue/queue.js

@@ -0,0 +1,162 @@
+"use strict";
+
+import { nativeBrowser } from '../../native';
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
+
+// MARK: - Types
+
+/**
+ * Event data for when the playback queue has ended.
+ */
+
+// MARK: - Queue Management
+
+/**
+ * Adds one or more tracks to the queue.
+ * @param tracks - The tracks to add to the queue.
+ * @param insertBeforeIndex - (Optional) The index to insert the tracks before.
+ * By default the tracks will be added to the end of the queue.
+ */
+
+/**
+ * Adds a track to the queue.
+ * @param track - The track to add to the queue.
+ * @param insertBeforeIndex - (Optional) The index to insert the track before.
+ * By default the track will be added to the end of the queue.
+ */
+
+export function add(tracks, insertBeforeIndex = -1) {
+  const addTracks = Array.isArray(tracks) ? tracks : [tracks];
+  if (addTracks.length > 0) {
+    nativeBrowser.add(addTracks, insertBeforeIndex);
+  }
+}
+
+/**
+ * Replaces the current track or loads the track as the first in the queue.
+ * @param track - The track to load.
+ */
+export function load(track) {
+  nativeBrowser.load(track);
+}
+
+/**
+ * Move a track within the queue.
+ * @param fromIndex - The index of the track to be moved.
+ * @param toIndex - The index to move the track to. If the index is larger than
+ * the size of the queue, then the track is moved to the end of the queue.
+ */
+export function move(fromIndex, toIndex) {
+  nativeBrowser.move(fromIndex, toIndex);
+}
+
+/**
+ * Removes multiple tracks from the queue by their indexes.
+ *
+ * If the current track is removed, the next track will activated. If the
+ * current track was the last track in the queue, the first track will be
+ * activated.
+ *
+ * @param indexes - The indexes of the tracks to be removed.
+ */
+
+/**
+ * Removes a track from the queue by its index.
+ *
+ * If the current track is removed, the next track will activated. If the
+ * current track was the last track in the queue, the first track will be
+ * activated.
+ *
+ * @param index - The index of the track to be removed.
+ */
+
+export function remove(indexOrIndexes) {
+  nativeBrowser.remove(Array.isArray(indexOrIndexes) ? indexOrIndexes : [indexOrIndexes]);
+}
+
+/**
+ * Clears any upcoming tracks from the queue.
+ */
+export function removeUpcomingTracks() {
+  nativeBrowser.removeUpcomingTracks();
+}
+
+/**
+ * Skips to a track in the queue.
+ * @param index - The index of the track to skip to.
+ * @param initialPosition - (Optional) The initial position to seek to in seconds.
+ */
+export function skip(index, initialPosition) {
+  nativeBrowser.skip(index, initialPosition);
+}
+
+/**
+ * Skips to the next track in the queue.
+ * @param initialPosition - (Optional) The initial position to seek to in seconds.
+ */
+export function skipToNext(initialPosition) {
+  nativeBrowser.skipToNext(initialPosition);
+}
+
+/**
+ * Skips to the previous track in the queue.
+ * @param initialPosition - (Optional) The initial position to seek to in seconds.
+ */
+export function skipToPrevious(initialPosition) {
+  nativeBrowser.skipToPrevious(initialPosition);
+}
+
+/**
+ * Sets the queue.
+ * @param tracks - The tracks to set as the queue.
+ */
+export function setQueue(tracks) {
+  nativeBrowser.setQueue(tracks);
+}
+
+// MARK: - Getters
+
+/**
+ * Gets a track object from the queue.
+ * @param index - The index of the track.
+ * @returns The track object or undefined if there isn't a track object at that index.
+ */
+export function getTrack(index) {
+  return nativeBrowser.getTrack(index);
+}
+
+/**
+ * Gets the whole queue.
+ */
+export function getQueue() {
+  return nativeBrowser.getQueue();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to playback queue ended events.
+ * @param callback - Called when playback has paused due to reaching the end of the queue
+ * @returns Cleanup function to unsubscribe
+ */
+export const onQueueEnded = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackQueueEnded = cb);
+
+/**
+ * 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 Cleanup function to unsubscribe
+ */
+export const onQueueChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackQueueChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current queue and updates when it changes.
+ * @returns The current queue
+ */
+export function useQueue() {
+  return useNativeUpdatedValue(getQueue, onQueueChanged);
+}
+//# sourceMappingURL=queue.js.map

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

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

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

@@ -0,0 +1,52 @@
+"use strict";
+
+import { nativeBrowser } from '../../native';
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
+
+// MARK: - Types
+
+/**
+ * RepeatMode options:
+ * - `'off'`: Playback stops when the last track in the queue has finished
+ *   playing.
+ * - `'track'`: Repeats the current track infinitely during ongoing playback.
+ * - `'queue'`: Repeats the entire queue infinitely.
+ */
+
+// MARK: - Getters
+
+/**
+ * Gets the current repeat mode.
+ */
+export function getRepeatMode() {
+  return nativeBrowser.getRepeatMode();
+}
+
+/**
+ * Sets the repeat mode.
+ * @param repeatMode - The repeat mode to set
+ */
+export function setRepeatMode(repeatMode) {
+  nativeBrowser.setRepeatMode(repeatMode);
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to repeat mode changes.
+ * @param callback - Called when repeat mode changes
+ * @returns Cleanup function to unsubscribe
+ */
+export const onRepeatModeChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackRepeatModeChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current repeat mode and updates when it changes.
+ * @returns The current repeat mode
+ */
+export function useRepeatMode() {
+  return useNativeUpdatedValue(getRepeatMode, onRepeatModeChanged, 'repeatMode');
+}
+//# sourceMappingURL=repeatMode.js.map

package/lib/module/features/queue/repeatMode.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getRepeatMode","setRepeatMode","repeatMode","onRepeatModeChanged","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,OAAOH,aAAa,CAACG,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,UAAsB,EAAE;EACpDL,aAAa,CAACI,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAOA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAOR,qBAAqB,CAACC,aAAa,EAAEG,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}

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

@@ -0,0 +1,50 @@
+"use strict";
+
+import { nativeBrowser } from '../../native';
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
+
+// MARK: - Getters
+
+/**
+ * Gets whether shuffle mode is enabled.
+ */
+export function getShuffle() {
+  return nativeBrowser.getShuffleEnabled();
+}
+
+/**
+ * Sets whether shuffle mode is enabled.
+ * When enabled, tracks play in a randomized order.
+ * @param enabled - Whether to enable shuffle mode
+ */
+export function setShuffle(enabled) {
+  nativeBrowser.setShuffleEnabled(enabled);
+}
+
+/**
+ * Toggles shuffle mode on/off.
+ */
+export function toggleShuffle() {
+  setShuffle(!getShuffle());
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to shuffle mode changes.
+ * @param callback - Called when shuffle mode changes
+ * @returns Cleanup function to unsubscribe
+ */
+export const onShuffleChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackShuffleModeChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns whether shuffle mode is enabled and updates when it changes.
+ * @returns Whether shuffle mode is enabled
+ */
+export function useShuffle() {
+  return useNativeUpdatedValue(getShuffle, onShuffleChanged);
+}
+//# sourceMappingURL=shuffle.js.map

package/lib/module/features/queue/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getShuffle","getShuffleEnabled","setShuffle","enabled","setShuffleEnabled","toggleShuffle","onShuffleChanged","emitterize","cb","onPlaybackShuffleModeChanged","useShuffle"],"sourceRoot":"../../../../src","sources":["features/queue/shuffle.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOH,aAAa,CAACI,iBAAiB,CAAC,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,OAAgB,EAAQ;EACjDN,aAAa,CAACO,iBAAiB,CAACD,OAAO,CAAC;AAC1C;;AAEA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAS;EACpCH,UAAU,CAAC,CAACF,UAAU,CAAC,CAAC,CAAC;AAC3B;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMM,gBAAgB,GAAGR,kBAAkB,CAACS,UAAU,CAC1DC,EAAE,IAAMX,aAAa,CAACY,4BAA4B,GAAGD,EACxD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOX,qBAAqB,CAACC,UAAU,EAAEM,gBAAgB,CAAC;AAC5D","ignoreList":[]}

package/lib/module/features/rating.js

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