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

package/lib/module/features/browser.js

@@ -0,0 +1,257 @@
+"use strict";
+
+import { nativeBrowser } from '../native';
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Configuration Transformation
+// ─────────────────────────────────────────────────────────────────────────────
+
+function isCallback(source) {
+  return typeof source === 'function';
+}
+function isTransformableRequestConfig(source) {
+  if (typeof source !== 'object' || source === null) return false;
+  const obj = source;
+  // Has request config properties (not a ResolvedTrack which has 'title')
+  return 'baseUrl' in obj || 'path' in obj || 'headers' in obj || 'query' in obj || 'transform' in obj;
+}
+function isRouteConfig(source) {
+  if (typeof source !== 'object' || source === null) return false;
+  const obj = source;
+  // RouteConfig has browse/media/artwork properties at the top level
+  return 'browse' in obj || 'media' in obj && !('baseUrl' in obj);
+}
+function flattenBrowseSource(source) {
+  if (!source) return {};
+  if (isCallback(source)) return {
+    browseCallback: source
+  };
+  if (isTransformableRequestConfig(source)) return {
+    browseConfig: source
+  };
+  return {
+    browseStatic: source
+  };
+}
+
+/**
+ * Converts a SearchSource to a NativeRouteEntry for the __search__ path.
+ */
+function searchSourceToRouteEntry(source) {
+  if (isCallback(source)) {
+    return {
+      path: SEARCH_ROUTE_PATH,
+      searchCallback: source
+    };
+  }
+  return {
+    path: SEARCH_ROUTE_PATH,
+    searchConfig: source
+  };
+}
+
+/**
+ * Wraps a Track[] into a ResolvedTrack for tabs.
+ * Tabs are represented as a special route that returns children.
+ */
+function wrapTracksAsResolvedTrack(tracks) {
+  return {
+    url: TABS_ROUTE_PATH,
+    title: 'Tabs',
+    children: tracks
+  };
+}
+
+/**
+ * Converts a TabsSource to a NativeRouteEntry for the __tabs__ path.
+ * Track[] is wrapped in ResolvedTrack, callbacks are wrapped to return ResolvedTrack.
+ */
+function tabsSourceToRouteEntry(source) {
+  if (Array.isArray(source)) {
+    // Static Track[] - wrap as ResolvedTrack
+    return {
+      path: TABS_ROUTE_PATH,
+      browseStatic: wrapTracksAsResolvedTrack(source)
+    };
+  }
+  if (isCallback(source)) {
+    // Callback returning Track[] - wrap to return ResolvedTrack
+    const wrappedCallback = async () => {
+      const tracks = await source();
+      return wrapTracksAsResolvedTrack(tracks);
+    };
+    return {
+      path: TABS_ROUTE_PATH,
+      browseCallback: wrappedCallback
+    };
+  }
+
+  // TransformableRequestConfig - native will handle wrapping the response
+  return {
+    path: TABS_ROUTE_PATH,
+    browseConfig: source
+  };
+}
+function flattenRouteEntry(path, source) {
+  if (isRouteConfig(source)) {
+    return {
+      path,
+      ...flattenBrowseSource(source.browse),
+      media: source.media,
+      artwork: source.artwork
+    };
+  }
+  return {
+    path,
+    ...flattenBrowseSource(source)
+  };
+}
+
+/** Internal path used for the default/root browse source */
+const DEFAULT_ROUTE_PATH = '__default__';
+
+/** Internal path used for navigation tabs */
+const TABS_ROUTE_PATH = '__tabs__';
+
+/** Internal path used for search */
+const SEARCH_ROUTE_PATH = '__search__';
+function flattenRoutes(routes, rootBrowse, tabs, search) {
+  const entries = [];
+
+  // Add explicit routes
+  if (routes) {
+    for (const [path, source] of Object.entries(routes)) {
+      entries.push(flattenRouteEntry(path, source));
+    }
+  }
+
+  // Add root browse as default fallback
+  if (rootBrowse) {
+    entries.push(flattenRouteEntry(DEFAULT_ROUTE_PATH, rootBrowse));
+  }
+
+  // Add tabs as special route
+  if (tabs) {
+    entries.push(tabsSourceToRouteEntry(tabs));
+  }
+
+  // Add search as special route
+  if (search) {
+    entries.push(searchSourceToRouteEntry(search));
+  }
+  return entries.length > 0 ? entries : undefined;
+}
+function toNativeConfig(config) {
+  return {
+    path: config.path,
+    request: config.request,
+    media: config.media,
+    artwork: config.artwork,
+    routes: flattenRoutes(config.routes, config.browse, config.tabs, config.search),
+    singleTrack: config.singleTrack,
+    androidControllerOfflineError: config.androidControllerOfflineError,
+    carPlayUpNextButton: config.carPlayUpNextButton,
+    carPlayNowPlayingButtons: config.carPlayNowPlayingButtons,
+    formatNavigationError: config.formatNavigationError
+  };
+}
+
+/**
+ * Configures the browser with routes, tabs, and other settings.
+ * Also registers the browser with the player to enable:
+ * - Media URL transformation for authenticated playback
+ * - Android Auto / CarPlay browsing integration
+ * - Playback of browsable tracks via navigate()
+ *
+ * @param configuration - Browser configuration including routes, tabs, media config, etc.
+ *
+ * @example
+ * ```ts
+ * configureBrowser({
+ *   routes: {
+ *     '/albums/:id': { path: '/api/albums/:id' }
+ *   },
+ *   tabs: [
+ *     { title: 'Home', url: '/' },
+ *     { title: 'Search', url: '/search' }
+ *   ]
+ * })
+ * ```
+ */
+export function configureBrowser(configuration) {
+  nativeBrowser.configuration = toNativeConfig(configuration);
+}
+export function navigate(pathOrTrack) {
+  if (typeof pathOrTrack === 'string') {
+    return nativeBrowser.navigatePath(pathOrTrack);
+  } else {
+    return nativeBrowser.navigateTrack(pathOrTrack);
+  }
+}
+export function getPath() {
+  return nativeBrowser.path;
+}
+export const onPathChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPathChanged = cb);
+export function usePath() {
+  return useNativeUpdatedValue(getPath, onPathChanged);
+}
+export function getContent() {
+  return nativeBrowser.getContent();
+}
+export const onContentChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onContentChanged = cb);
+export function useContent() {
+  return useNativeUpdatedValue(getContent, onContentChanged);
+}
+export function getTabs() {
+  return nativeBrowser.tabs;
+}
+export const onTabsChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onTabsChanged = cb);
+export function useTabs() {
+  return useNativeUpdatedValue(getTabs, onTabsChanged);
+}
+
+/**
+ * Notifies external media controllers (Android Auto, CarPlay) that content
+ * at the specified path has changed and should be refreshed.
+ *
+ * @param path - The path where content has changed (e.g., '/favorites')
+ *
+ * @example
+ * ```ts
+ * // After adding a track to favorites
+ * notifyContentChanged('/favorites')
+ * ```
+ */
+export const notifyContentChanged = path => {
+  nativeBrowser.notifyContentChanged(path);
+};
+
+/**
+ * Returns whether search functionality is configured via `configureBrowser({ search: ... })`.
+ */
+export function hasSearch() {
+  const config = nativeBrowser.configuration;
+  const searchRoute = config.routes?.find(r => r.path === SEARCH_ROUTE_PATH);
+  return !!(searchRoute?.searchCallback || searchRoute?.searchConfig);
+}
+
+/**
+ * Searches for tracks using the configured search source.
+ *
+ * @param query - The search query string
+ * @returns Promise resolving to an array of matching tracks
+ *
+ * @see {@link configureBrowser}
+ *
+ * @example
+ * ```ts
+ * const results = await search('jazz')
+ * console.log(`Found ${results.length} tracks`)
+ * ```
+ */
+export async function search(query) {
+  return nativeBrowser.onSearch(query);
+}
+//# sourceMappingURL=browser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","isCallback","source","isTransformableRequestConfig","obj","isRouteConfig","flattenBrowseSource","browseCallback","browseConfig","browseStatic","searchSourceToRouteEntry","path","SEARCH_ROUTE_PATH","searchCallback","searchConfig","wrapTracksAsResolvedTrack","tracks","url","TABS_ROUTE_PATH","title","children","tabsSourceToRouteEntry","Array","isArray","wrappedCallback","flattenRouteEntry","browse","media","artwork","DEFAULT_ROUTE_PATH","flattenRoutes","routes","rootBrowse","tabs","search","entries","Object","push","length","undefined","toNativeConfig","config","request","singleTrack","androidControllerOfflineError","carPlayUpNextButton","carPlayNowPlayingButtons","formatNavigationError","configureBrowser","configuration","navigate","pathOrTrack","navigatePath","navigateTrack","getPath","onPathChanged","emitterize","cb","usePath","getContent","onContentChanged","useContent","getTabs","onTabsChanged","useTabs","notifyContentChanged","hasSearch","searchRoute","find","r","query","onSearch"],"sourceRoot":"../../../src","sources":["features/browser.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/features/equalizer.js

@@ -0,0 +1,60 @@
+"use strict";
+
+import { nativeBrowser } from '../native';
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
+// MARK: - Getters
+
+/**
+ * Gets the current equalizer settings (Android only).
+ * @returns Equalizer settings, or undefined if not available
+ */
+export function getEqualizerSettings() {
+  return nativeBrowser.getEqualizerSettings();
+}
+
+// MARK: - Setters
+
+/**
+ * Enables or disables the equalizer (Android only).
+ * @param enabled - Whether to enable the equalizer
+ */
+export function setEqualizerEnabled(enabled) {
+  nativeBrowser.setEqualizerEnabled(enabled);
+}
+
+/**
+ * Sets the equalizer to a preset (Android only).
+ * @param preset - The name of the preset to apply
+ */
+export function setEqualizerPreset(preset) {
+  nativeBrowser.setEqualizerPreset(preset);
+}
+
+/**
+ * Sets custom equalizer band levels (Android only).
+ * @param levels - Array of level values for each band (in millibels)
+ */
+export function setEqualizerLevels(levels) {
+  nativeBrowser.setEqualizerLevels(levels);
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to equalizer settings changes (Android only).
+ * @param callback - Called when equalizer settings change
+ * @returns Cleanup function to unsubscribe
+ */
+export const onEqualizerChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onEqualizerChanged = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current equalizer settings and updates when they change (Android only).
+ * @returns Current equalizer settings, or undefined if not available
+ */
+export function useEqualizerSettings() {
+  return useNativeUpdatedValue(getEqualizerSettings, onEqualizerChanged);
+}
+//# sourceMappingURL=equalizer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getEqualizerSettings","setEqualizerEnabled","enabled","setEqualizerPreset","preset","setEqualizerLevels","levels","onEqualizerChanged","emitterize","cb","useEqualizerSettings"],"sourceRoot":"../../../src","sources":["features/equalizer.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AAEzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;AAItE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAkC;EACpE,OAAOH,aAAa,CAACG,oBAAoB,CAAC,CAAC;AAC7C;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAACC,OAAgB,EAAQ;EAC1DL,aAAa,CAACI,mBAAmB,CAACC,OAAO,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAACC,MAAc,EAAQ;EACvDP,aAAa,CAACM,kBAAkB,CAACC,MAAM,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAACC,MAAgB,EAAQ;EACzDT,aAAa,CAACQ,kBAAkB,CAACC,MAAM,CAAC;AAC1C;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAC7BT,kBAAkB,CAACU,UAAU,CAC1BC,EAAE,IAAMZ,aAAa,CAACU,kBAAkB,GAAGE,EAC9C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAkC;EACpE,OAAOX,qBAAqB,CAACC,oBAAoB,EAAEO,kBAAkB,CAAC;AACxE","ignoreList":[]}

package/lib/module/features/errors.js

@@ -0,0 +1,156 @@
+"use strict";
+
+import { nativeBrowser } from '../native';
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+import { useNativeUpdatedValue } from '../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
+ */
+export function getPlaybackError() {
+  return nativeBrowser.getPlaybackError();
+}
+
+// MARK: - Event Callbacks
+
+/**
+ * Subscribes to playback error events.
+ * @param callback - Called when a playback error occurs
+ * @returns Cleanup function to unsubscribe
+ */
+export const onPlaybackError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackError = cb);
+
+// MARK: - Hooks
+
+/**
+ * Hook that returns the current playback error and updates when it changes.
+ * @returns The current playback error or undefined
+ */
+export function usePlaybackError() {
+  return 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
+ */
+export function getNavigationError() {
+  const error = nativeBrowser.getNavigationError();
+  return error ?? undefined;
+}
+
+/**
+ * Subscribes to navigation error events.
+ * @param callback - Called when a navigation error occurs
+ * @returns Cleanup function to unsubscribe
+ */
+export const onNavigationError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onNavigationError = cb);
+
+/**
+ * Hook that returns the current navigation error and updates when it changes.
+ * @returns The current navigation error or undefined
+ */
+export function useNavigationError() {
+  return 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
+ */
+export function getFormattedNavigationError() {
+  return nativeBrowser.getFormattedNavigationError() ?? undefined;
+}
+
+/**
+ * Subscribes to formatted navigation error changes.
+ * @param callback - Called when the formatted navigation error changes
+ * @returns Cleanup function to unsubscribe
+ */
+export const onFormattedNavigationError = NativeUpdatedValue.emitterize(cb => 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
+ */
+export function useFormattedNavigationError() {
+  return useNativeUpdatedValue(getFormattedNavigationError, onFormattedNavigationError);
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlaybackError","onPlaybackError","emitterize","cb","usePlaybackError","getNavigationError","error","undefined","onNavigationError","useNavigationError","getFormattedNavigationError","onFormattedNavigationError","useFormattedNavigationError"],"sourceRoot":"../../../src","sources":["features/errors.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AAEzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAQA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BH,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOL,qBAAqB,CAACC,gBAAgB,EAAEC,eAAe,EAAE,OAAO,CAAC;AAC1E;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,kBAAkBA,CAAA,EAAgC;EAChE,MAAMC,KAAK,GAAGT,aAAa,CAACQ,kBAAkB,CAAC,CAAC;EAChD,OAAOC,KAAK,IAAIC,SAAS;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BV,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACW,iBAAiB,GAAGL,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACA,OAAO,SAASM,kBAAkBA,CAAA,EAAgC;EAChE,OAAOV,qBAAqB,CAACM,kBAAkB,EAAEG,iBAAiB,EAAE,OAAO,CAAC;AAC9E;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,aAAa,CAACa,2BAA2B,CAAC,CAAC,IAAIH,SAAS;AACjE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,0BAA0B,GAAGb,kBAAkB,CAACI,UAAU,CAEpEC,EAAE,IAAMN,aAAa,CAACc,0BAA0B,GAAGR,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;AACA,OAAO,SAASS,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,qBAAqB,CAC1BW,2BAA2B,EAC3BC,0BACF,CAAC;AACH","ignoreList":[]}

package/lib/module/features/favorites.js

@@ -0,0 +1,95 @@
+"use strict";
+
+import { nativeBrowser } from '../native';
+import { NativeUpdatedValue } from '../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)
+ * ```
+ */
+export function setActiveTrackFavorited(favorited) {
+  nativeBrowser.setActiveTrackFavorited(favorited);
+}
+
+/**
+ * Toggles the favorited state of the currently playing track.
+ *
+ * @example
+ * ```ts
+ * // In a button handler
+ * toggleActiveTrackFavorited()
+ * ```
+ */
+export function toggleActiveTrackFavorited() {
+  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)
+ * ```
+ */
+export function setFavorites(favorites) {
+  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)
+ *   }
+ * })
+ * ```
+ */
+export const onFavoriteChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onFavoriteChanged = cb);
+//# sourceMappingURL=favorites.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","setActiveTrackFavorited","favorited","toggleActiveTrackFavorited","setFavorites","favorites","onFavoriteChanged","emitterize","cb"],"sourceRoot":"../../../src","sources":["features/favorites.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AAEzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,SAAkB,EAAQ;EAChEH,aAAa,CAACE,uBAAuB,CAACC,SAAS,CAAC;AAClD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAAS;EACjDJ,aAAa,CAACI,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;AACA,OAAO,SAASC,YAAYA,CAACC,SAAmB,EAAQ;EACtDN,aAAa,CAACK,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;AACA,OAAO,MAAMC,iBAAiB,GAC5BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACO,iBAAiB,GAAGE,EAC7C,CAAC","ignoreList":[]}

package/lib/module/features/index.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/**
+ * Feature-based exports - each feature includes:
+ * - Event types
+ * - Getters (get*)
+ * - Setters (set*)
+ * - Event callbacks (on*)
+ * - React hooks (use*)
+ */
+
+export * from './output';
+export * from './playback';
+export * from './player';
+export * from './queue';
+export * from './battery';
+export * from './browser';
+export * from './equalizer';
+export * from './errors';
+export * from './favorites';
+export * from './metadata';
+export * from './network';
+export * from './nowPlaying';
+export * from './remoteControls';
+export * from './sleepTimer';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["features/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,UAAU;AACxB,cAAc,YAAY;AAC1B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,aAAa;AAC3B,cAAc,UAAU;AACxB,cAAc,aAAa;AAC3B,cAAc,YAAY;AAC1B,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,kBAAkB;AAChC,cAAc,cAAc","ignoreList":[]}

package/lib/module/features/metadata.js

@@ -0,0 +1,51 @@
+"use strict";
+
+import { nativeBrowser } from '../native';
+import { NativeUpdatedValue } from '../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
+ */
+export const onChapterMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onChapterMetadata = cb);
+
+/**
+ * Subscribes to track metadata events.
+ * @param callback - Called when static track metadata is received
+ * @returns Cleanup function to unsubscribe
+ */
+export const onTrackMetadata = NativeUpdatedValue.emitterize(cb => 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
+ */
+export const onTimedMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onTimedMetadata = cb);
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","onChapterMetadata","emitterize","cb","onTrackMetadata","onTimedMetadata"],"sourceRoot":"../../../src","sources":["features/metadata.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAGhE;;AAoCA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;;AAoBA;AACA;AACA;AACA;;AAYA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGD,kBAAkB,CAACE,UAAU,CAE3DC,EAAE,IAAMJ,aAAa,CAACE,iBAAiB,GAAGE,EAAG,CAAC;;AAEjD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGJ,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACK,eAAe,GAAGD,EAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,eAAe,GAAGL,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACM,eAAe,GAAGF,EAC3C,CAAC","ignoreList":[]}