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

package/lib/commonjs/features/errors.js

@@ -0,0 +1,165 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getFormattedNavigationError = getFormattedNavigationError;
+exports.getNavigationError = getNavigationError;
+exports.getPlaybackError = getPlaybackError;
+exports.onPlaybackError = exports.onNavigationError = exports.onFormattedNavigationError = void 0;
+exports.useFormattedNavigationError = useFormattedNavigationError;
+exports.useNavigationError = useNavigationError;
+exports.usePlaybackError = usePlaybackError;
+var _native = require("../native");
+var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../utils/useNativeUpdatedValue");
+// Re-export for Nitro spec
+
+/**
+ * Emitted when a playback error occurs.
+ */
+
+/**
+ * Type of navigation error that occurred.
+ *
+ * - `'content-not-found'` - No route configured for the requested path, or route resolution
+ *   returned no content. This is a configuration issue, not an HTTP 404 from the server.
+ * - `'network-error'` - Network request failed (connection error, timeout, no internet).
+ * - `'http-error'` - Server returned a non-2xx HTTP status code, or returned 2xx but response
+ *   parsing failed. Check `statusCode` and `statusCodeSuccess` for details.
+ * - `'callback-error'` - The browse callback returned an error (e.g., `{ error: 'message' }`).
+ *   Use this for business logic errors like authentication failures or subscription requirements.
+ * - `'unknown-error'` - An unexpected error occurred (e.g., invalid configuration).
+ */
+
+/**
+ * Emitted when a navigation error occurs.
+ */
+
+// MARK: - Getters
+
+/**
+ * Gets the current playback error, if any.
+ * @returns The current error or undefined if there is no error
+ */
+function getPlaybackError() {
+  return _native.nativeBrowser.getPlaybackError();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to playback error events.
+ * @param callback - Called when a playback error occurs
+ * @returns Cleanup function to unsubscribe
+ */
+const onPlaybackError = exports.onPlaybackError = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackError = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current playback error and updates when it changes.
+ * @returns The current playback error or undefined
+ */
+function usePlaybackError() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getPlaybackError, onPlaybackError, 'error');
+}
+
+// MARK: - Navigation Error
+
+/**
+ * Gets the current navigation error, if any.
+ * @returns The current navigation error or undefined if there is no error
+ */
+function getNavigationError() {
+  const error = _native.nativeBrowser.getNavigationError();
+  return error ?? undefined;
+}
+
+/**
+ * Subscribes to navigation error events.
+ * @param callback - Called when a navigation error occurs
+ * @returns Cleanup function to unsubscribe
+ */
+const onNavigationError = exports.onNavigationError = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onNavigationError = cb);
+
+/**
+ * Hook that returns the current navigation error and updates when it changes.
+ * @returns The current navigation error or undefined
+ */
+function useNavigationError() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getNavigationError, onNavigationError, 'error');
+}
+
+// MARK: - Formatted Navigation Error
+
+/**
+ * Gets the current navigation error formatted for display.
+ * Native formats the error using the configured `formatNavigationError` callback,
+ * or falls back to default formatting.
+ *
+ * @returns Formatted error with title and message, or undefined if no error
+ */
+function getFormattedNavigationError() {
+  return _native.nativeBrowser.getFormattedNavigationError() ?? undefined;
+}
+
+/**
+ * Subscribes to formatted navigation error changes.
+ * @param callback - Called when the formatted navigation error changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onFormattedNavigationError = exports.onFormattedNavigationError = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onFormattedNavigationError = cb);
+
+/**
+ * Hook that returns the current navigation error formatted for display.
+ *
+ * Native formats the error using the `formatNavigationError` callback configured
+ * in {@link BrowserConfiguration}, or falls back to default English messages.
+ *
+ * The same formatted error is used by CarPlay and Android Auto error dialogs,
+ * ensuring consistent error presentation across your app and external controllers.
+ *
+ * @returns Formatted error with title and message, or undefined if no error
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * const error = useFormattedNavigationError()
+ *
+ * if (error) {
+ *   return <ErrorView title={error.title} message={error.message} />
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Configure custom formatting - override only specific errors or routes
+ * configureBrowser({
+ *   formatNavigationError: ({ error, defaultFormatted, path }) => {
+ *     // Custom message for specific routes
+ *     if (error.code === 'network-error' && path.startsWith('/json-api')) {
+ *       return {
+ *         title: 'API Server Not Running',
+ *         message: 'Start the API server first'
+ *       }
+ *     }
+ *     if (error.code === 'http-error') {
+ *       return {
+ *         title: t('error.serverError'),
+ *         message: t('error.httpMessage', { status: error.statusCode })
+ *       }
+ *     }
+ *     // Use default for other error types
+ *     return defaultFormatted
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link BrowserConfiguration.formatNavigationError} - Configure custom error formatting
+ * @see {@link useNavigationError} - Access the raw error with code and status details
+ */
+function useFormattedNavigationError() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getFormattedNavigationError, onFormattedNavigationError);
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getPlaybackError","nativeBrowser","onPlaybackError","exports","NativeUpdatedValue","emitterize","cb","usePlaybackError","useNativeUpdatedValue","getNavigationError","error","undefined","onNavigationError","useNavigationError","getFormattedNavigationError","onFormattedNavigationError","useFormattedNavigationError"],"sourceRoot":"../../../src","sources":["features/errors.ts"],"mappings":";;;;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAQA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACO,SAASG,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOC,qBAAa,CAACD,gBAAgB,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,eAAe,GAAAC,OAAA,CAAAD,eAAA,GAC1BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAML,qBAAa,CAACC,eAAe,GAAGI,EAC3C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAO,IAAAC,4CAAqB,EAACR,gBAAgB,EAAEE,eAAe,EAAE,OAAO,CAAC;AAC1E;;AAEA;;AAEA;AACA;AACA;AACA;AACO,SAASO,kBAAkBA,CAAA,EAAgC;EAChE,MAAMC,KAAK,GAAGT,qBAAa,CAACQ,kBAAkB,CAAC,CAAC;EAChD,OAAOC,KAAK,IAAIC,SAAS;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMC,iBAAiB,GAAAT,OAAA,CAAAS,iBAAA,GAC5BR,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAML,qBAAa,CAACW,iBAAiB,GAAGN,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACO,SAASO,kBAAkBA,CAAA,EAAgC;EAChE,OAAO,IAAAL,4CAAqB,EAACC,kBAAkB,EAAEG,iBAAiB,EAAE,OAAO,CAAC;AAC9E;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,qBAAa,CAACa,2BAA2B,CAAC,CAAC,IAAIH,SAAS;AACjE;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMI,0BAA0B,GAAAZ,OAAA,CAAAY,0BAAA,GAAGX,sCAAkB,CAACC,UAAU,CAEpEC,EAAE,IAAML,qBAAa,CAACc,0BAA0B,GAAGT,EAAG,CAAC;;AAE1D;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;AACO,SAASU,2BAA2BA,CAAA,EAE7B;EACZ,OAAO,IAAAR,4CAAqB,EAC1BM,2BAA2B,EAC3BC,0BACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/features/favorites.js

@@ -0,0 +1,101 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.onFavoriteChanged = void 0;
+exports.setActiveTrackFavorited = setActiveTrackFavorited;
+exports.setFavorites = setFavorites;
+exports.toggleActiveTrackFavorited = toggleActiveTrackFavorited;
+var _native = require("../native");
+var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
+// MARK: - Setters
+
+/**
+ * Sets the favorited state of the currently playing track.
+ * Updates the heart icon in media controllers (notification, Android Auto).
+ *
+ * Use this for programmatic favorite changes (e.g., from a favorite button in your app).
+ * For heart button taps from media controllers, use `onFavoriteChanged` instead -
+ * the native side handles those automatically.
+ *
+ * @param favorited - Whether the track is favorited
+ *
+ * @example
+ * ```ts
+ * setActiveTrackFavorited(true)
+ * ```
+ */
+function setActiveTrackFavorited(favorited) {
+  _native.nativeBrowser.setActiveTrackFavorited(favorited);
+}
+
+/**
+ * Toggles the favorited state of the currently playing track.
+ *
+ * @example
+ * ```ts
+ * // In a button handler
+ * toggleActiveTrackFavorited()
+ * ```
+ */
+function toggleActiveTrackFavorited() {
+  _native.nativeBrowser.toggleActiveTrackFavorited();
+}
+
+/**
+ * Sets the list of favorited track source identifiers.
+ *
+ * This syncs your app's favorites with the native favorites cache, enabling
+ * the heart button in media controllers (notification, Android Auto, CarPlay)
+ * to show the correct state.
+ *
+ * Note: This is only needed if the tracks provided to AudioBrowser do not
+ * include the `favorited` field. If your API already includes favorite state in
+ * track responses, the native favorites cache is populated automatically during browsing.
+ *
+ * When the heart button is tapped in media controllers or when you call
+ * `setActiveTrackFavorited()`, the native favorites cache is automatically
+ * updated. You only need to call this on app launch to hydrate the cache.
+ *
+ * @param favorites - Array of favorited track `src` values
+ *
+ * @example
+ * ```ts
+ * const favoriteSrcs = await loadFavoritesFromStorage()
+ * setFavorites(favoriteSrcs)
+ * ```
+ */
+function setFavorites(favorites) {
+  _native.nativeBrowser.setFavorites(favorites);
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Event data for when the favorite state of the active track changes.
+ * Emitted when the user taps the heart button in a media controller (notification, Android Auto, CarPlay).
+ */
+
+/**
+ * Subscribes to favorite state change events.
+ * Called when the user taps the heart button in a media controller.
+ * The native side has already updated the track's favorite state and UI.
+ *
+ * @param callback - Called with the track and its new favorite state
+ * @returns Cleanup function to unsubscribe
+ *
+ * @example
+ * ```ts
+ * const unsubscribe = onFavoriteChanged.addListener(({ track, favorited }) => {
+ *   // Persist the change to your backend/storage
+ *   if (favorited) {
+ *     addToFavorites(track)
+ *   } else {
+ *     removeFromFavorites(track)
+ *   }
+ * })
+ * ```
+ */
+const onFavoriteChanged = exports.onFavoriteChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onFavoriteChanged = cb);
+//# sourceMappingURL=favorites.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","setActiveTrackFavorited","favorited","nativeBrowser","toggleActiveTrackFavorited","setFavorites","favorites","onFavoriteChanged","exports","NativeUpdatedValue","emitterize","cb"],"sourceRoot":"../../../src","sources":["features/favorites.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,mBAAA,GAAAD,OAAA;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,uBAAuBA,CAACC,SAAkB,EAAQ;EAChEC,qBAAa,CAACF,uBAAuB,CAACC,SAAS,CAAC;AAClD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,0BAA0BA,CAAA,EAAS;EACjDD,qBAAa,CAACC,0BAA0B,CAAC,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,YAAYA,CAACC,SAAmB,EAAQ;EACtDH,qBAAa,CAACE,YAAY,CAACC,SAAS,CAAC;AACvC;;AAEA;;AAEA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAC5BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMR,qBAAa,CAACI,iBAAiB,GAAGI,EAC7C,CAAC","ignoreList":[]}

package/lib/commonjs/features/index.js

@@ -0,0 +1,160 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _output = require("./output");
+Object.keys(_output).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _output[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _output[key];
+    }
+  });
+});
+var _playback = require("./playback");
+Object.keys(_playback).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _playback[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _playback[key];
+    }
+  });
+});
+var _player = require("./player");
+Object.keys(_player).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _player[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _player[key];
+    }
+  });
+});
+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 _battery = require("./battery");
+Object.keys(_battery).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _battery[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _battery[key];
+    }
+  });
+});
+var _browser = require("./browser");
+Object.keys(_browser).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _browser[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _browser[key];
+    }
+  });
+});
+var _equalizer = require("./equalizer");
+Object.keys(_equalizer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _equalizer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _equalizer[key];
+    }
+  });
+});
+var _errors = require("./errors");
+Object.keys(_errors).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _errors[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _errors[key];
+    }
+  });
+});
+var _favorites = require("./favorites");
+Object.keys(_favorites).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _favorites[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _favorites[key];
+    }
+  });
+});
+var _metadata = require("./metadata");
+Object.keys(_metadata).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _metadata[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _metadata[key];
+    }
+  });
+});
+var _network = require("./network");
+Object.keys(_network).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _network[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _network[key];
+    }
+  });
+});
+var _nowPlaying = require("./nowPlaying");
+Object.keys(_nowPlaying).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _nowPlaying[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _nowPlaying[key];
+    }
+  });
+});
+var _remoteControls = require("./remoteControls");
+Object.keys(_remoteControls).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _remoteControls[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _remoteControls[key];
+    }
+  });
+});
+var _sleepTimer = require("./sleepTimer");
+Object.keys(_sleepTimer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _sleepTimer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _sleepTimer[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_output","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_playback","_player","_queue","_battery","_browser","_equalizer","_errors","_favorites","_metadata","_network","_nowPlaying","_remoteControls","_sleepTimer"],"sourceRoot":"../../../src","sources":["features/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/features/metadata.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.onTrackMetadata = exports.onTimedMetadata = exports.onChapterMetadata = void 0;
+var _native = require("../native");
+var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
+// MARK: - Types
+
+/**
+ * Metadata update for the now playing notification.
+ * Pass to `updateNowPlaying()` to override what's shown in the notification/lock screen.
+ * Pass `null` to clear overrides and revert to track metadata.
+ */
+
+/**
+ * Timed metadata received during playback.
+ * Contains metadata from ICY streams (radio) or ID3 frames.
+ */
+
+/**
+ * Static track metadata from the media file.
+ * Contains standardized metadata fields.
+ */
+
+/**
+ * Chapter metadata with time range.
+ * Used for podcast chapters, audiobook chapters, etc.
+ */
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to chapter metadata events.
+ * @param callback - Called when chapter metadata is received
+ * @returns Cleanup function to unsubscribe
+ */
+const onChapterMetadata = exports.onChapterMetadata = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onChapterMetadata = cb);
+
+/**
+ * Subscribes to track metadata events.
+ * @param callback - Called when static track metadata is received
+ * @returns Cleanup function to unsubscribe
+ */
+const onTrackMetadata = exports.onTrackMetadata = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onTrackMetadata = cb);
+
+/**
+ * Subscribes to timed metadata events (ICY/ID3 from live streams).
+ * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
+ * @returns Cleanup function to unsubscribe
+ */
+const onTimedMetadata = exports.onTimedMetadata = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onTimedMetadata = cb);
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","onChapterMetadata","exports","NativeUpdatedValue","emitterize","cb","nativeBrowser","onTrackMetadata","onTimedMetadata"],"sourceRoot":"../../../src","sources":["features/metadata.ts"],"mappings":";;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AAGA;;AAoCA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;;AAoBA;AACA;AACA;AACA;;AAYA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAE3DC,EAAE,IAAMC,qBAAa,CAACL,iBAAiB,GAAGI,EAAG,CAAC;;AAEjD;AACA;AACA;AACA;AACA;AACO,MAAME,eAAe,GAAAL,OAAA,CAAAK,eAAA,GAAGJ,sCAAkB,CAACC,UAAU,CACzDC,EAAE,IAAMC,qBAAa,CAACC,eAAe,GAAGF,EAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACO,MAAMG,eAAe,GAAAN,OAAA,CAAAM,eAAA,GAAGL,sCAAkB,CAACC,UAAU,CACzDC,EAAE,IAAMC,qBAAa,CAACE,eAAe,GAAGH,EAC3C,CAAC","ignoreList":[]}

package/lib/commonjs/features/network.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getOnline = getOnline;
+exports.onOnlineChanged = void 0;
+exports.useOnline = useOnline;
+var _native = require("../native");
+var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../utils/useNativeUpdatedValue");
+// MARK: - Getters
+
+/**
+ * Gets the current network connectivity state.
+ * @returns true if the device is online, false otherwise
+ */
+function getOnline() {
+  return _native.nativeBrowser.getOnline();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to network connectivity changes.
+ * @param callback - Called when network state changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onOnlineChanged = exports.onOnlineChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onOnlineChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current network connectivity state and updates when it changes.
+ * @returns true if the device is online, false otherwise
+ */
+function useOnline() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getOnline, onOnlineChanged);
+}
+//# sourceMappingURL=network.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getOnline","nativeBrowser","onOnlineChanged","exports","NativeUpdatedValue","emitterize","cb","useOnline","useNativeUpdatedValue"],"sourceRoot":"../../../src","sources":["features/network.ts"],"mappings":";;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAEA;AACA;AACA;AACA;AACO,SAASG,SAASA,CAAA,EAAY;EACnC,OAAOC,qBAAa,CAACD,SAAS,CAAC,CAAC;AAClC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAME,eAAe,GAAAC,OAAA,CAAAD,eAAA,GAAGE,sCAAkB,CAACC,UAAU,CACzDC,EAAE,IAAML,qBAAa,CAACC,eAAe,GAAGI,EAC3C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASC,SAASA,CAAA,EAAY;EACnC,OAAO,IAAAC,4CAAqB,EAACR,SAAS,EAAEE,eAAe,CAAC;AAC1D","ignoreList":[]}

package/lib/commonjs/features/nowPlaying.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getNowPlaying = getNowPlaying;
+exports.onNowPlayingChanged = void 0;
+exports.updateNowPlaying = updateNowPlaying;
+exports.useNowPlaying = useNowPlaying;
+var _native = require("../native");
+var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../utils/useNativeUpdatedValue");
+// MARK: - Functions
+
+/**
+ * Updates the now playing notification metadata.
+ * Pass null/undefined to clear overrides and revert to track metadata.
+ *
+ * @example
+ * ```ts
+ * // Override notification with stream metadata
+ * updateNowPlaying({
+ *   title: streamMetadata.title,
+ *   artist: streamMetadata.artist,
+ * })
+ *
+ * // Clear overrides, revert to track metadata
+ * updateNowPlaying(null)
+ * ```
+ */
+function updateNowPlaying(update) {
+  _native.nativeBrowser.updateNowPlaying(update ?? undefined);
+}
+
+/**
+ * Gets the current now playing metadata (override if set, else track metadata).
+ */
+function getNowPlaying() {
+  return _native.nativeBrowser.getNowPlaying() ?? undefined;
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to now playing metadata change events.
+ * Fires when updateNowPlaying is called or when the track changes.
+ * @param callback - Called when now playing metadata changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onNowPlayingChanged = exports.onNowPlayingChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onNowPlayingChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current now playing metadata and updates when it changes.
+ * @returns The current now playing metadata or undefined
+ */
+function useNowPlaying() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getNowPlaying, onNowPlayingChanged);
+}
+//# sourceMappingURL=nowPlaying.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","updateNowPlaying","update","nativeBrowser","undefined","getNowPlaying","onNowPlayingChanged","exports","NativeUpdatedValue","emitterize","cb","useNowPlaying","useNativeUpdatedValue"],"sourceRoot":"../../../src","sources":["features/nowPlaying.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAGA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,gBAAgBA,CAACC,MAA+B,EAAQ;EACtEC,qBAAa,CAACF,gBAAgB,CAACC,MAAM,IAAIE,SAAS,CAAC;AACrD;;AAEA;AACA;AACA;AACO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAOF,qBAAa,CAACE,aAAa,CAAC,CAAC,IAAID,SAAS;AACnD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAME,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAC9BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMP,qBAAa,CAACG,mBAAmB,GAAGI,EAC/C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAO,IAAAC,4CAAqB,EAACP,aAAa,EAAEC,mBAAmB,CAAC;AAClE","ignoreList":[]}

package/lib/commonjs/features/output.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getIosOutput = getIosOutput;
+exports.onIosOutputChanged = void 0;
+exports.openIosOutputPicker = openIosOutputPicker;
+exports.useIosOutput = useIosOutput;
+var _native = require("../native");
+var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
+var _useNativeUpdatedValue = require("../utils/useNativeUpdatedValue");
+// MARK: - Actions
+
+/**
+ * Opens the system output picker (iOS only).
+ * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
+ * No-op on Android.
+ */
+function openIosOutputPicker() {
+  _native.nativeBrowser.openIosOutputPicker();
+}
+
+// MARK: - Getters
+
+/**
+ * Gets the current audio output info.
+ * Always returns a value on iOS, undefined on Android.
+ */
+function getIosOutput() {
+  return _native.nativeBrowser.getIosOutput();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to output state changes (iOS only).
+ * Never fires on Android.
+ * @param callback - Called with output info when output changes
+ * @returns Cleanup function to unsubscribe
+ */
+const onIosOutputChanged = exports.onIosOutputChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onIosOutputChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current audio output info.
+ * Updates when the output changes (e.g., AirPods connected/disconnected).
+ * Always returns a value on iOS, undefined on Android.
+ */
+function useIosOutput() {
+  return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getIosOutput, onIosOutputChanged);
+}
+//# sourceMappingURL=output.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","openIosOutputPicker","nativeBrowser","getIosOutput","onIosOutputChanged","exports","NativeUpdatedValue","emitterize","cb","useIosOutput","useNativeUpdatedValue"],"sourceRoot":"../../../src","sources":["features/output.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAIA;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASG,mBAAmBA,CAAA,EAAS;EAC1CC,qBAAa,CAACD,mBAAmB,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACO,SAASE,YAAYA,CAAA,EAA0B;EACpD,OAAOD,qBAAa,CAACC,YAAY,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,kBAAkB,GAAAC,OAAA,CAAAD,kBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC5DC,EAAE,IAAMN,qBAAa,CAACE,kBAAkB,GAAGI,EAC9C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,YAAYA,CAAA,EAA0B;EACpD,OAAO,IAAAC,4CAAqB,EAACP,YAAY,EAAEC,kBAAkB,CAAC;AAChE","ignoreList":[]}