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

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

@@ -0,0 +1,182 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getOptions = getOptions;
+exports.onOptionsChanged = void 0;
+exports.updateOptions = updateOptions;
+exports.useOptions = useOptions;
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../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
+ * });
+ * ```
+ */
+function updateOptions(options) {
+  _native.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
+ * }
+ * ```
+ */
+function getOptions() {
+  return _native.nativeBrowser.getOptions();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to player options changes.
+ * @param callback - Called when the player options change
+ * @returns Cleanup function to unsubscribe
+ */
+const onOptionsChanged = exports.onOptionsChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onOptionsChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current player options and updates when they change.
+ * @returns The current player options
+ */
+function useOptions() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getOptions, onOptionsChanged);
+}
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"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":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAIA;;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

@@ -0,0 +1,143 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setupPlayer = setupPlayer;
+var _native = require("../../native");
+// MARK: - Types
+
+/**
+ * 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.
+ */
+async function setupPlayer(options = {}) {
+  return _native.nativeBrowser.setupPlayer(options);
+}
+//# sourceMappingURL=setup.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getActiveTrack = getActiveTrack;
+exports.getActiveTrackIndex = getActiveTrackIndex;
+exports.onActiveTrackChanged = void 0;
+exports.useActiveTrack = useActiveTrack;
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
+/**
+ * Event data for when the active track changes.
+ */
+
+// MARK: - Getters
+
+/**
+ * Gets the active track or undefined if there is no current track.
+ */
+function getActiveTrack() {
+  return _native.nativeBrowser.getActiveTrack() ?? undefined;
+}
+
+/**
+ * Gets the index of the active track in the queue or undefined if there is no
+ * current track.
+ */
+function getActiveTrackIndex() {
+  return _native.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
+ */
+const onActiveTrackChanged = exports.onActiveTrackChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackActiveTrackChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current active track and updates when it changes.
+ * @returns The current active track or undefined
+ */
+function useActiveTrack() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getActiveTrack, onActiveTrackChanged, 'track');
+}
+//# sourceMappingURL=activeTrack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getActiveTrack","nativeBrowser","undefined","getActiveTrackIndex","onActiveTrackChanged","exports","NativeUpdatedValue","emitterize","cb","onPlaybackActiveTrackChanged","useActiveTrack","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/activeTrack.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;AACA;AACA;;AAcA;;AAEA;AACA;AACA;AACO,SAASG,cAAcA,CAAA,EAAsB;EAClD,OAAOC,qBAAa,CAACD,cAAc,CAAC,CAAC,IAAIE,SAAS;AACpD;;AAEA;AACA;AACA;AACA;AACO,SAASC,mBAAmBA,CAAA,EAAuB;EACxD,OAAOF,qBAAa,CAACE,mBAAmB,CAAC,CAAC,IAAID,SAAS;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,GAC/BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMP,qBAAa,CAACQ,4BAA4B,GAAGD,EACxD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASE,cAAcA,CAAA,EAAsB;EAClD,OAAO,IAAAC,4CAAqB,EAACX,cAAc,EAAEI,oBAAoB,EAAE,OAAO,CAAC;AAC7E","ignoreList":[]}

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

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _queue = require("./queue");
+Object.keys(_queue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _queue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _queue[key];
+    }
+  });
+});
+var _activeTrack = require("./activeTrack");
+Object.keys(_activeTrack).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _activeTrack[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _activeTrack[key];
+    }
+  });
+});
+var _repeatMode = require("./repeatMode");
+Object.keys(_repeatMode).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _repeatMode[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _repeatMode[key];
+    }
+  });
+});
+var _shuffle = require("./shuffle");
+Object.keys(_shuffle).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _shuffle[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _shuffle[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_queue","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_activeTrack","_repeatMode","_shuffle"],"sourceRoot":"../../../../src","sources":["features/queue/index.ts"],"mappings":";;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,MAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,MAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,MAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,YAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,YAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,YAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,YAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,WAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,WAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,WAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,WAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,QAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,QAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,QAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,QAAA,CAAAP,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,177 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.add = add;
+exports.getQueue = getQueue;
+exports.getTrack = getTrack;
+exports.load = load;
+exports.move = move;
+exports.onQueueEnded = exports.onQueueChanged = void 0;
+exports.remove = remove;
+exports.removeUpcomingTracks = removeUpcomingTracks;
+exports.setQueue = setQueue;
+exports.skip = skip;
+exports.skipToNext = skipToNext;
+exports.skipToPrevious = skipToPrevious;
+exports.useQueue = useQueue;
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../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.
+ */
+
+function add(tracks, insertBeforeIndex = -1) {
+  const addTracks = Array.isArray(tracks) ? tracks : [tracks];
+  if (addTracks.length > 0) {
+    _native.nativeBrowser.add(addTracks, insertBeforeIndex);
+  }
+}
+
+/**
+ * Replaces the current track or loads the track as the first in the queue.
+ * @param track - The track to load.
+ */
+function load(track) {
+  _native.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.
+ */
+function move(fromIndex, toIndex) {
+  _native.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.
+ */
+
+function remove(indexOrIndexes) {
+  _native.nativeBrowser.remove(Array.isArray(indexOrIndexes) ? indexOrIndexes : [indexOrIndexes]);
+}
+
+/**
+ * Clears any upcoming tracks from the queue.
+ */
+function removeUpcomingTracks() {
+  _native.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.
+ */
+function skip(index, initialPosition) {
+  _native.nativeBrowser.skip(index, initialPosition);
+}
+
+/**
+ * Skips to the next track in the queue.
+ * @param initialPosition - (Optional) The initial position to seek to in seconds.
+ */
+function skipToNext(initialPosition) {
+  _native.nativeBrowser.skipToNext(initialPosition);
+}
+
+/**
+ * Skips to the previous track in the queue.
+ * @param initialPosition - (Optional) The initial position to seek to in seconds.
+ */
+function skipToPrevious(initialPosition) {
+  _native.nativeBrowser.skipToPrevious(initialPosition);
+}
+
+/**
+ * Sets the queue.
+ * @param tracks - The tracks to set as the queue.
+ */
+function setQueue(tracks) {
+  _native.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.
+ */
+function getTrack(index) {
+  return _native.nativeBrowser.getTrack(index);
+}
+
+/**
+ * Gets the whole queue.
+ */
+function getQueue() {
+  return _native.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
+ */
+const onQueueEnded = exports.onQueueEnded = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.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
+ */
+const onQueueChanged = exports.onQueueChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackQueueChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current queue and updates when it changes.
+ * @returns The current queue
+ */
+function useQueue() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getQueue, onQueueChanged);
+}
+//# sourceMappingURL=queue.js.map

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

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