react-native-audio-browser 0.1.1 → 0.2.0-next.1

package/ios/TrackPlayerCallbacks.swift

@@ -64,18 +64,12 @@ protocol TrackPlayerCallbacks: PlaybackCoordinatorCallbacks {
   /// Called when change playback position is triggered remotely.
   func remoteChangePlaybackPosition(position: Double)
 
-  /// Called when set rating is triggered remotely.
-  func remoteSetRating(rating: Any)
-
   /// Called when play from ID is triggered remotely.
   func remotePlayId(id: String, index: Int?)
 
   /// Called when play from search is triggered remotely.
   func remotePlaySearch(query: String)
 
-  /// Called when like is triggered remotely.
-  func remoteLike()
-
   /// Called when repeat mode change is triggered remotely (CarPlay/lock screen).
   func remoteChangeRepeatMode(mode: RepeatMode)
 

package/ios/TrackSelector.swift

@@ -23,7 +23,7 @@ import os.log
 @MainActor
 class TrackSelector {
   private let logger = Logger(subsystem: "com.audiobrowser", category: "TrackSelector")
-  nonisolated(unsafe) private let browserManager: any TrackSelectionBrowser
+  private nonisolated(unsafe) let browserManager: any TrackSelectionBrowser
 
   nonisolated init(browserManager: any TrackSelectionBrowser) {
     self.browserManager = browserManager
@@ -57,7 +57,7 @@ class TrackSelector {
   /// Handles contextual URL expansion, queue reuse, and handler interception.
   func select(
     track: Track,
-    player: some TrackSelectionPlayer
+    player: some TrackSelectionPlayer,
   ) async -> SelectionResult {
     let url = track.url
 
@@ -85,7 +85,7 @@ class TrackSelector {
   private func handleContextualUrl(
     _ url: String,
     track: Track,
-    player: some TrackSelectionPlayer
+    player: some TrackSelectionPlayer,
   ) async -> SelectionResult {
     let parentPath = BrowserPathHelper.stripTrackId(url)
     let trackId = BrowserPathHelper.extractTrackId(url)
@@ -126,9 +126,9 @@ class TrackSelector {
 
   private func handlePlayableTrack(
     _ track: Track,
-    player: some TrackSelectionPlayer
+    player _: some TrackSelectionPlayer,
   ) async -> SelectionResult {
-    return await singleTrackResult(track)
+    await singleTrackResult(track)
   }
 
   private func singleTrackResult(_ track: Track) async -> SelectionResult {

package/ios/Util/ArtworkImageFetcher.swift

@@ -1,7 +1,7 @@
 import Kingfisher
 import NitroModules
-import UIKit
 import os.log
+import UIKit
 
 /// Single entry point for loading artwork images from URLs via Kingfisher.
 enum ArtworkImageFetcher {
@@ -15,7 +15,9 @@ enum ArtworkImageFetcher {
     if let headers = source.headers, !headers.isEmpty {
       let modifier = AnyModifier { request in
         var request = request
-        for (key, value) in headers { request.setValue(value, forHTTPHeaderField: key) }
+        for (key, value) in headers {
+          request.setValue(value, forHTTPHeaderField: key)
+        }
         return request
       }
       options.append(.requestModifier(modifier))

package/ios/Util/NetworkMonitor.swift

@@ -15,13 +15,15 @@ final class NetworkMonitor: @unchecked Sendable {
   private(set) var isOnline: Bool = false {
     didSet {
       if oldValue != isOnline {
-        logger.info("Network status changed: \(oldValue) -> \(self.isOnline)")
+        logger.notice("Network status changed: \(oldValue) -> \(self.isOnline)")
         onChanged?(isOnline)
       }
     }
   }
 
-  /// Callback invoked when network state changes
+  /// Invoked on every connectivity change. Wired centrally in `HybridAudioBrowser.setupPlayer` and
+  /// fans out to the JS event bridge, the now-playing re-render (so the offline/online label tracks
+  /// connectivity), and the player's reconnect-reload.
   var onChanged: ((Bool) -> Void)?
 
   // MARK: - Initialization
@@ -42,7 +44,7 @@ final class NetworkMonitor: @unchecked Sendable {
 
     // Read initial state after starting (currentPath is now valid)
     let initialStatus = monitor.currentPath.status == .satisfied
-    logger.info("NetworkMonitor initialized, initial isOnline=\(initialStatus)")
+    logger.notice("NetworkMonitor initialized, initial isOnline=\(initialStatus)")
     isOnline = initialStatus
   }
 
@@ -63,3 +65,5 @@ final class NetworkMonitor: @unchecked Sendable {
     destroy()
   }
 }
+
+extension NetworkMonitor: NetworkStatusProviding {}

package/ios/Util/OnceValue.swift

@@ -1,5 +1,19 @@
 import Foundation
 
+/// Guards a continuation that two racing tasks may try to resume, so exactly
+/// one wins (see `OnceValue.wait(timeout:)`).
+private final class OneShot: @unchecked Sendable {
+  private let lock = NSLock()
+  private var claimed = false
+  func claim() -> Bool {
+    lock.lock()
+    defer { lock.unlock() }
+    if claimed { return false }
+    claimed = true
+    return true
+  }
+}
+
 /// A thread-safe primitive that resolves to a value once, allowing multiple waiters.
 /// Once resolved, all current and future `wait()` calls return immediately with the value.
 final class OnceValue<T: Sendable>: @unchecked Sendable {
@@ -60,6 +74,26 @@ final class OnceValue<T: Sendable>: @unchecked Sendable {
     }
   }
 
+  /// Waits for the value to be resolved, giving up after `timeout`.
+  /// Returns the value, or nil if the timeout elapses first.
+  ///
+  /// Continuations aren't cancellable, so the internal waiter stays registered
+  /// past a timeout; it resumes harmlessly (into a one-shot guard) if the value
+  /// resolves later.
+  func wait(timeout: Duration) async -> T? {
+    let oneShot = OneShot()
+    return await withCheckedContinuation { continuation in
+      Task {
+        let value = await self.wait()
+        if oneShot.claim() { continuation.resume(returning: value) }
+      }
+      Task {
+        try? await Task.sleep(for: timeout)
+        if oneShot.claim() { continuation.resume(returning: nil) }
+      }
+    }
+  }
+
   /// Resets the value, allowing it to be resolved again.
   /// Any pending waiters will continue waiting for the next resolve.
   func reset() {

package/lib/commonjs/features/browser-config.js

@@ -0,0 +1,227 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SEARCH_ROUTE_PATH = void 0;
+exports.toNativeConfig = toNativeConfig;
+exports.validateBrowserConfiguration = validateBrowserConfiguration;
+// ─────────────────────────────────────────────────────────────────────────────
+// Configuration Transformation
+//
+// Lowers the public BrowserConfiguration into the flattened native shape.
+// Deliberately NOT re-exported from features/index.ts — these helpers are
+// internal (and unit-tested directly), not public API.
+// ─────────────────────────────────────────────────────────────────────────────
+
+function isCallback(source) {
+  return typeof source === 'function';
+}
+function isObjectValue(value) {
+  return typeof value === 'object' && value !== null;
+}
+function isTransformableRequestConfig(source) {
+  if (!isObjectValue(source)) return false;
+  // Any RequestConfig key marks a request config. A static ResolvedTrack
+  // shares none of these at the top level (its per-track request override is
+  // nested under `request`).
+  return 'baseUrl' in source || 'path' in source || 'headers' in source || 'query' in source || 'method' in source || 'body' in source || 'contentType' in source || 'userAgent' in source || 'transform' in source || 'transformSync' in source;
+}
+function isRouteConfig(source) {
+  if (!isObjectValue(source)) return false;
+  // `browse`/`media` keys only exist on RouteConfig. `artwork` also exists on
+  // a static ResolvedTrack — but there it is a string URL, while RouteConfig's
+  // is a config object, so only an object-valued `artwork` marks a RouteConfig.
+  return 'browse' in source || 'media' in source || isObjectValue(source.artwork);
+}
+function splitLayer(layer) {
+  if (!layer) return {};
+  // A function is a resolver thunk; an object is a static layer config. (The
+  // `request`/`browse` layer fields are object-only today, so this is
+  // unambiguous — unlike route/search sources which already accept a callback.)
+  if (isCallback(layer)) {
+    const resolve = layer;
+    // Normalize the sync-or-async resolver to Promise-only for the bridge so it
+    // never sees a `T | Promise<T>` variant (which misreads the async case).
+    // Resolvers run once per content generation, so the wrap costs nothing.
+    return {
+      resolver: () => Promise.resolve(resolve())
+    };
+  }
+  return {
+    config: layer
+  };
+}
+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 — the endpoint returns a page object whose
+  // children are the tabs (same shape as a browse endpoint).
+  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__';
+
+// Exported for hasSearch() in browser.ts, which inspects the lowered config.
+// DEFAULT_ROUTE_PATH and TABS_ROUTE_PATH are not needed outside this module.
+const SEARCH_ROUTE_PATH = exports.SEARCH_ROUTE_PATH = '__search__';
+function flattenRoutes(routes, tabs, search) {
+  const entries = [];
+
+  // Add explicit routes. The '*' key is the optional custom default — it maps to
+  // the __default__ entry (used when no other route matches). Without it, an
+  // unmatched browse path is fetched via request + browse config applied to the
+  // path (handled natively), so no __default__ entry is needed.
+  if (routes) {
+    for (const [path, source] of Object.entries(routes)) {
+      entries.push(flattenRouteEntry(path === '*' ? DEFAULT_ROUTE_PATH : path, source));
+    }
+  }
+
+  // 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;
+}
+
+/** Android Auto / CarPlay display at most this many tabs. */
+const MAX_TABS = 4;
+
+/**
+ * Dev-only sanity checks for a BrowserConfiguration. Warns (never throws) on
+ * mistakes the type system cannot catch: reserved route keys, route values
+ * that match no source shape (and would be served as garbage static content),
+ * and platform display limits. Called by configureBrowser under __DEV__.
+ */
+function validateBrowserConfiguration(config) {
+  const warn = message => console.warn(`[react-native-audio-browser] configureBrowser: ${message}`);
+  if (config.routes) {
+    for (const [path, source] of Object.entries(config.routes)) {
+      if (path !== '*' && path.startsWith('__')) {
+        warn(`route "${path}" uses the reserved "__" prefix and will conflict ` + `with internal routing entries. Rename the route.`);
+        continue;
+      }
+      if (!isCallback(source) && !isRouteConfig(source) && !isTransformableRequestConfig(source)) {
+        // Falls through to the static-page branch; a page needs url + title.
+        const page = source;
+        if (typeof page.url !== 'string' || typeof page.title !== 'string') {
+          warn(`route "${path}" matched no source shape — expected a callback, ` + `a request config ({ baseUrl, path, headers, ... }), a ` + `RouteConfig ({ browse, media, artwork }), or a static page ` + `({ url, title, children? }). It will be served as static ` + `content and likely render a blank screen.`);
+        }
+      }
+    }
+  }
+  if (Array.isArray(config.tabs) && config.tabs.length > MAX_TABS) {
+    warn(`${config.tabs.length} tabs configured; Android Auto and CarPlay ` + `display at most ${MAX_TABS} — extra tabs will not be shown.`);
+  }
+}
+function toNativeConfig(config) {
+  const request = splitLayer(config.request);
+  const browse = splitLayer(config.browse);
+  return {
+    path: config.path,
+    request: request.config,
+    requestResolver: request.resolver,
+    browse: browse.config,
+    browseResolver: browse.resolver,
+    media: config.media,
+    artwork: config.artwork,
+    nowPlayingArtwork: config.nowPlayingArtwork,
+    routes: flattenRoutes(config.routes, config.tabs, config.search),
+    singleTrack: config.singleTrack,
+    handleTrackLoad: config.handleTrackLoad,
+    androidControllerOfflineError: config.androidControllerOfflineError,
+    carPlayLoadingTitle: config.carPlayLoadingTitle,
+    resolveAlbumUrl: config.resolveAlbumUrl,
+    formatNavigationError: config.formatNavigationError
+  };
+}
+//# sourceMappingURL=browser-config.js.map

package/lib/commonjs/features/browser-config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isCallback","source","isObjectValue","value","isTransformableRequestConfig","isRouteConfig","artwork","splitLayer","layer","resolve","resolver","Promise","config","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","DEFAULT_ROUTE_PATH","exports","flattenRoutes","routes","tabs","search","entries","Object","push","length","undefined","MAX_TABS","validateBrowserConfiguration","warn","message","console","startsWith","page","toNativeConfig","request","requestResolver","browseResolver","nowPlayingArtwork","singleTrack","handleTrackLoad","androidControllerOfflineError","carPlayLoadingTitle","resolveAlbumUrl","formatNavigationError"],"sourceRoot":"../../../src","sources":["features/browser-config.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/features/browser.js

@@ -4,10 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.configureBrowser = configureBrowser;
+exports.getBrowserConfiguration = getBrowserConfiguration;
 exports.getContent = getContent;
 exports.getPath = getPath;
 exports.getTabs = getTabs;
 exports.hasSearch = hasSearch;
+exports.invalidateAllContent = void 0;
 exports.navigate = navigate;
 exports.onTabsChanged = exports.onPathChanged = exports.onContentChanged = exports.notifyContentChanged = void 0;
 exports.search = search;
@@ -17,160 +19,8 @@ exports.useTabs = useTabs;
 var _native = require("../native");
 var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
 var _useNativeUpdatedValue = require("../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,
-    handleTrackLoad: config.handleTrackLoad,
-    androidControllerOfflineError: config.androidControllerOfflineError,
-    carPlayUpNextButton: config.carPlayUpNextButton,
-    carPlayNowPlayingButtons: config.carPlayNowPlayingButtons,
-    formatNavigationError: config.formatNavigationError
-  };
-}
+var _browserConfig = require("./browser-config");
+let currentConfiguration;
 
 /**
  * Configures the browser with routes, tabs, and other settings.
@@ -179,13 +29,30 @@ function toNativeConfig(config) {
  * - Android Auto / CarPlay browsing integration
  * - Playback of browsable tracks via navigate()
  *
+ * Calling this again REPLACES the entire configuration (no merging) and
+ * re-runs initial navigation — external browse UIs such as CarPlay reset to
+ * the first tab. For values that change at runtime (base URL, locale, auth
+ * token), don't reconfigure: read them inside a `request`/`browse` resolver
+ * or a `transform`, and call {@link invalidateAllContent} so every surface
+ * re-fetches in place.
+ *
  * @param configuration - Browser configuration including routes, tabs, media config, etc.
  *
  * @example
  * ```ts
  * configureBrowser({
+ *   request: { baseUrl: 'https://api.example.com' },
  *   routes: {
- *     '/albums/:id': { path: '/api/albums/:id' }
+ *     // `{id}` is a route parameter — see the `routes` docs for matching rules.
+ *     '/albums/{id}': async ({ routeParams }) => fetchAlbumPage(routeParams?.id),
+ *     // Remapping a browse path to a different API path requires a transform;
+ *     // a static `path` on a request config does NOT rewrite the path.
+ *     '/artists/{id}': {
+ *       transformSync: (request, routeParams) => ({
+ *         ...request,
+ *         path: `/api/v2/artists/${routeParams?.id}`
+ *       })
+ *     }
  *   },
  *   tabs: [
  *     { title: 'Home', url: '/' },
@@ -195,7 +62,24 @@ function toNativeConfig(config) {
  * ```
  */
 function configureBrowser(configuration) {
-  _native.nativeBrowser.configuration = toNativeConfig(configuration);
+  // __DEV__ is a React Native global; absent under plain node (vitest).
+  if (typeof __DEV__ !== 'undefined' && __DEV__) {
+    (0, _browserConfig.validateBrowserConfiguration)(configuration);
+  }
+  currentConfiguration = configuration;
+  _native.nativeBrowser.configuration = (0, _browserConfig.toNativeConfig)(configuration);
+}
+
+/**
+ * Returns the configuration last passed to {@link configureBrowser}, in its
+ * original public shape (the native getter exposes only the lowered internal
+ * form). `undefined` until the browser is configured.
+ *
+ * Treat the returned object as read-only: it is the live reference, and
+ * mutating it does NOT reconfigure the browser — call configureBrowser again.
+ */
+function getBrowserConfiguration() {
+  return currentConfiguration;
 }
 function navigate(pathOrTrack) {
   if (typeof pathOrTrack === 'string') {
@@ -243,12 +127,29 @@ const notifyContentChanged = path => {
 };
 
 /**
- * Returns whether search functionality is configured via `configureBrowser({ search: ... })`.
+ * Invalidates all cached browse content and refreshes every currently-displayed
+ * browse surface. Use when something app-wide changed (locale switch, sign-out,
+ * etc.) and every browse path should re-fetch from its route handler — unlike
+ * {@link notifyContentChanged}, which targets a single path.
+ *
+ * @example
+ * ```ts
+ * // After the user changes the app language
+ * invalidateAllContent()
+ * ```
  */
 exports.notifyContentChanged = notifyContentChanged;
+const invalidateAllContent = () => {
+  _native.nativeBrowser.invalidateAllContent();
+};
+
+/**
+ * Returns whether search functionality is configured via `configureBrowser({ search: ... })`.
+ */
+exports.invalidateAllContent = invalidateAllContent;
 function hasSearch() {
   const config = _native.nativeBrowser.configuration;
-  const searchRoute = config.routes?.find(r => r.path === SEARCH_ROUTE_PATH);
+  const searchRoute = config.routes?.find(r => r.path === _browserConfig.SEARCH_ROUTE_PATH);
   return !!(searchRoute?.searchCallback || searchRoute?.searchConfig);
 }