react-native-audio-browser 0.0.1 → 0.1.0-next.1

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

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getPlayingState = getPlayingState;
+exports.onPlayingState = void 0;
+exports.usePlayingState = usePlayingState;
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
+// MARK: - Types
+
+// MARK: - Getters
+
+/**
+ * Gets the playing state (playing and buffering flags).
+ */
+function getPlayingState() {
+  return _native.nativeBrowser.getPlayingState();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to playing state changes.
+ * @param callback - Called when playing or buffering state changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onPlayingState = exports.onPlayingState = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackPlayingState = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current playing state and updates when it changes.
+ * @returns The current playing state (playing and buffering flags)
+ */
+function usePlayingState() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getPlayingState, onPlayingState);
+}
+//# sourceMappingURL=playing.js.map

package/lib/commonjs/features/playback/playing.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getPlayingState","nativeBrowser","onPlayingState","exports","NativeUpdatedValue","emitterize","cb","onPlaybackPlayingState","usePlayingState","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/playback/playing.ts"],"mappings":";;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAOA;;AAEA;AACA;AACA;AACO,SAASG,eAAeA,CAAA,EAAiB;EAC9C,OAAOC,qBAAa,CAACD,eAAe,CAAC,CAAC;AACxC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,cAAc,GAAAC,OAAA,CAAAD,cAAA,GAAGE,sCAAkB,CAACC,UAAU,CACxDC,EAAE,IAAML,qBAAa,CAACM,sBAAsB,GAAGD,EAClD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASE,eAAeA,CAAA,EAAiB;EAC9C,OAAO,IAAAC,4CAAqB,EAACT,eAAe,EAAEE,cAAc,CAAC;AAC/D","ignoreList":[]}

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

@@ -0,0 +1,104 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getProgress = getProgress;
+exports.onProgressUpdated = void 0;
+exports.usePolledProgress = usePolledProgress;
+exports.useProgress = useProgress;
+var _react = require("react");
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
+var _state = require("./state");
+// MARK: - Types
+
+/**
+ * Event data for playback progress updates.
+ */
+
+// MARK: - Getters
+
+/**
+ * Gets information on the progress of the currently active track, including its
+ * current playback position in seconds, buffered position in seconds and
+ * duration in seconds.
+ */
+function getProgress() {
+  return _native.nativeBrowser.getProgress();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to playback progress updates.
+ * @param callback - Called periodically with playback progress updates
+ * @returns Cleanup function to unsubscribe
+ */
+const onProgressUpdated = exports.onProgressUpdated = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackProgressUpdated = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current playback progress and updates when it changes.
+ *
+ * Progress update frequency is controlled globally via `updateOptions({ progressUpdateEventInterval })`.
+ * @returns The current playback progress
+ */
+function useProgress() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getProgress, onProgressUpdated);
+}
+
+/**
+ * Hook that returns the current playback progress and updates via polling.
+ *
+ * Use this when you need custom polling behavior instead of event-based updates.
+ *
+ * @param updateInterval - Update interval in milliseconds (default: 1000)
+ * @returns The current playback progress
+ */
+function usePolledProgress(updateInterval = 1000) {
+  const [state, setState] = (0, _react.useState)({
+    position: 0,
+    duration: 0,
+    buffered: 0
+  });
+  (0, _react.useEffect)(() => {
+    let mounted = true;
+    const update = () => {
+      try {
+        const {
+          position,
+          duration,
+          buffered
+        } = getProgress();
+        if (!mounted) return;
+        setState(currentState => position === currentState.position && duration === currentState.duration && buffered === currentState.buffered ? currentState : {
+          position,
+          duration,
+          buffered
+        });
+      } catch {
+        // Ignore failures (e.g., before setup)
+      }
+    };
+
+    // Update immediately on playback state changes
+    const unsubscribeState = _state.onPlaybackChanged.addListener(update);
+    const poll = () => {
+      update();
+      if (!mounted) return;
+      setTimeout(() => {
+        if (mounted) poll();
+      }, updateInterval);
+    };
+    poll();
+    return () => {
+      mounted = false;
+      unsubscribeState();
+    };
+  }, [updateInterval]);
+  return state;
+}
+//# sourceMappingURL=progress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_native","_NativeUpdatedValue","_useNativeUpdatedValue","_state","getProgress","nativeBrowser","onProgressUpdated","exports","NativeUpdatedValue","emitterize","cb","onPlaybackProgressUpdated","useProgress","useNativeUpdatedValue","usePolledProgress","updateInterval","state","setState","useState","position","duration","buffered","useEffect","mounted","update","currentState","unsubscribeState","onPlaybackChanged","addListener","poll","setTimeout"],"sourceRoot":"../../../../src","sources":["features/playback/progress.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,mBAAA,GAAAF,OAAA;AACA,IAAAG,sBAAA,GAAAH,OAAA;AACA,IAAAI,MAAA,GAAAJ,OAAA;AAEA;;AAiBA;AACA;AACA;;AAMA;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASK,WAAWA,CAAA,EAAa;EACtC,OAAOC,qBAAa,CAACD,WAAW,CAAC,CAAC;AACpC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAC5BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAML,qBAAa,CAACM,yBAAyB,GAAGD,EACrD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,WAAWA,CAAA,EAAa;EACtC,OAAO,IAAAC,4CAAqB,EAACT,WAAW,EAAEE,iBAAiB,CAAC;AAC9D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,iBAAiBA,CAACC,cAAc,GAAG,IAAI,EAAY;EACjE,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAG,IAAAC,eAAQ,EAAW;IAC3CC,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE;EACZ,CAAC,CAAC;EAEF,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAIC,OAAO,GAAG,IAAI;IAElB,MAAMC,MAAM,GAAGA,CAAA,KAAM;MACnB,IAAI;QACF,MAAM;UAAEL,QAAQ;UAAEC,QAAQ;UAAEC;QAAS,CAAC,GAAGjB,WAAW,CAAC,CAAC;QACtD,IAAI,CAACmB,OAAO,EAAE;QAEdN,QAAQ,CAAEQ,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;IACA,MAAMK,gBAAgB,GAAGC,wBAAiB,CAACC,WAAW,CAACJ,MAAM,CAAC;IAE9D,MAAMK,IAAI,GAAGA,CAAA,KAAM;MACjBL,MAAM,CAAC,CAAC;MACR,IAAI,CAACD,OAAO,EAAE;MACdO,UAAU,CAAC,MAAM;QACf,IAAIP,OAAO,EAAEM,IAAI,CAAC,CAAC;MACrB,CAAC,EAAEd,cAAc,CAAC;IACpB,CAAC;IAEDc,IAAI,CAAC,CAAC;IAEN,OAAO,MAAM;MACXN,OAAO,GAAG,KAAK;MACfG,gBAAgB,CAAC,CAAC;IACpB,CAAC;EACH,CAAC,EAAE,CAACX,cAAc,CAAC,CAAC;EAEpB,OAAOC,KAAK;AACd","ignoreList":[]}

package/lib/commonjs/features/playback/rate.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getRate = getRate;
+exports.setRate = setRate;
+var _native = require("../../native");
+// MARK: - Getters
+
+/**
+ * Gets the playback rate where 0.5 would be half speed, 1 would be
+ * regular speed and 2 would be double speed etc.
+ */
+function getRate() {
+  return _native.nativeBrowser.getRate();
+}
+
+// MARK: - Setters
+
+/**
+ * Sets the playback rate.
+ * @param rate - The playback rate to change to, where 0.5 would be half speed,
+ * 1 would be regular speed, 2 would be double speed etc.
+ */
+function setRate(rate) {
+  _native.nativeBrowser.setRate(rate);
+}
+//# sourceMappingURL=rate.js.map

package/lib/commonjs/features/playback/rate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","getRate","nativeBrowser","setRate","rate"],"sourceRoot":"../../../../src","sources":["features/playback/rate.ts"],"mappings":";;;;;;;AAEA,IAAAA,OAAA,GAAAC,OAAA;AAFA;;AAIA;AACA;AACA;AACA;AACO,SAASC,OAAOA,CAAA,EAAW;EAChC,OAAOC,qBAAa,CAACD,OAAO,CAAC,CAAC;AAChC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASE,OAAOA,CAACC,IAAY,EAAQ;EAC1CF,qBAAa,CAACC,OAAO,CAACC,IAAI,CAAC;AAC7B","ignoreList":[]}

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

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getPlayback = getPlayback;
+exports.onPlaybackChanged = void 0;
+exports.usePlayback = usePlayback;
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
+// MARK: - Types
+
+/**
+ * PlaybackState options:
+ * - `'none'`: Indicates that the player is idle (initial state, or no track
+ *   loaded)
+ * - `'ready'`: Indicates that the player has loaded a track and is ready to
+ *   play (but paused)
+ * - `'playing'`: Indicates that the player is currently playing
+ * - `'paused'`: Indicates that the player is currently paused
+ * - `'stopped'`: Indicates that the player is currently stopped
+ * - `'loading'`: Indicates that the initial load of the item is occurring.
+ * - `'buffering'`: Indicates that the player is currently loading more data
+ *   before it can continue playing or is ready to start playing.
+ * - `'error'`: Indicates that playback of the current item failed. Call
+ *   `AudioBrowser.getError()` to get more information on the type of error that
+ *   occurred. Call `AudioBrowser.retry()` or `AudioBrowser.play()` to try to play
+ *   the item again.
+ * - `'ended'`: Indicates that playback stopped due to the end of the queue
+ *   being reached.
+ */
+
+// MARK: - Getters
+
+/**
+ * Gets the playback state and error (if any) of the player.
+ * @see {@link PlaybackState} for possible state values
+ */
+function getPlayback() {
+  return _native.nativeBrowser.getPlayback();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to playback state changes.
+ * @param callback - Called when the playback state changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onPlaybackChanged = exports.onPlaybackChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current playback state and updates when it changes.
+ * @returns The current playback state
+ */
+function usePlayback() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getPlayback, onPlaybackChanged);
+}
+//# sourceMappingURL=state.js.map

package/lib/commonjs/features/playback/state.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getPlayback","nativeBrowser","onPlaybackChanged","exports","NativeUpdatedValue","emitterize","cb","usePlayback","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/playback/state.ts"],"mappings":";;;;;;;;AACA,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;AACA;AACA;AACA;AACA;;AAiBA;;AAEA;AACA;AACA;AACA;AACO,SAASG,WAAWA,CAAA,EAAa;EACtC,OAAOC,qBAAa,CAACD,WAAW,CAAC,CAAC;AACpC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC3DC,EAAE,IAAML,qBAAa,CAACC,iBAAiB,GAAGI,EAC7C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAO,IAAAC,4CAAqB,EAACR,WAAW,EAAEE,iBAAiB,CAAC;AAC9D","ignoreList":[]}

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

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSystemVolume = getSystemVolume;
+exports.getVolume = getVolume;
+exports.onSystemVolumeChanged = void 0;
+exports.setSystemVolume = setSystemVolume;
+exports.setVolume = setVolume;
+exports.useSystemVolume = useSystemVolume;
+var _native = require("../../native");
+var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
+// MARK: - Getters
+
+/**
+ * Gets the volume of the player as a number between 0 and 1.
+ */
+function getVolume() {
+  return _native.nativeBrowser.getVolume();
+}
+
+/**
+ * Gets the current system volume as a number between 0 and 1.
+ */
+function getSystemVolume() {
+  return _native.nativeBrowser.getSystemVolume();
+}
+
+// MARK: - Setters
+
+/**
+ * Sets the volume of the player.
+ * @param level - The volume as a number between 0 and 1.
+ */
+function setVolume(level) {
+  _native.nativeBrowser.setVolume(level);
+}
+
+/**
+ * Sets the system volume.
+ * @param level - The volume as a number between 0 and 1.
+ * @note On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
+ */
+function setSystemVolume(level) {
+  _native.nativeBrowser.setSystemVolume(level);
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to system volume changes.
+ * @param callback - Called when the system volume changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onSystemVolumeChanged = exports.onSystemVolumeChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onSystemVolumeChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current system volume and updates when it changes.
+ * @returns The current system volume (0 to 1)
+ */
+function useSystemVolume() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getSystemVolume, onSystemVolumeChanged);
+}
+//# sourceMappingURL=volume.js.map

package/lib/commonjs/features/playback/volume.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getVolume","nativeBrowser","getSystemVolume","setVolume","level","setSystemVolume","onSystemVolumeChanged","exports","NativeUpdatedValue","emitterize","cb","useSystemVolume","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/playback/volume.ts"],"mappings":";;;;;;;;;;;AAEA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAJA;;AAMA;AACA;AACA;AACO,SAASG,SAASA,CAAA,EAAW;EAClC,OAAOC,qBAAa,CAACD,SAAS,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACO,SAASE,eAAeA,CAAA,EAAW;EACxC,OAAOD,qBAAa,CAACC,eAAe,CAAC,CAAC;AACxC;;AAEA;;AAEA;AACA;AACA;AACA;AACO,SAASC,SAASA,CAACC,KAAa,EAAQ;EAC7CH,qBAAa,CAACE,SAAS,CAACC,KAAK,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAACD,KAAa,EAAQ;EACnDH,qBAAa,CAACI,eAAe,CAACD,KAAK,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,qBAAqB,GAAAC,OAAA,CAAAD,qBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC/DC,EAAE,IAAMT,qBAAa,CAACK,qBAAqB,GAAGI,EACjD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAAA,EAAW;EACxC,OAAO,IAAAC,4CAAqB,EAACV,eAAe,EAAEI,qBAAqB,CAAC;AACtE","ignoreList":[]}

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

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _setup = require("./setup");
+Object.keys(_setup).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _setup[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _setup[key];
+    }
+  });
+});
+var _options = require("./options");
+Object.keys(_options).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _options[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _options[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_setup","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_options"],"sourceRoot":"../../../../src","sources":["features/player/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,QAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,QAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,QAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,QAAA,CAAAL,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

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":";;;;;;;;;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":[]}