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

package/lib/commonjs/web/player/NowPlayingManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["NowPlayingManager","onNowPlayingChanged","updateNowPlaying","update","currentTrack","duration","override","metadata","title","artist","album","artwork","description","mediaId","src","url","genre","getNowPlaying","undefined","clearNowPlayingOverride","exports"],"sourceRoot":"../../../../src","sources":["web/player/NowPlayingManager.ts"],"mappings":";;;;;;AAGA;AACA;AACA;AACA;AACA;AACO,MAAMA,iBAAiB,CAAC;EAG7B;EACAC,mBAAmB,GAA2CA,CAAA,KAAM,CAAC,CAAC;;EAEtE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CACdC,MAAoC,EACpCC,YAA+B,EAC/BC,QAAgB,EACV;IACN,IAAI,CAACC,QAAQ,GAAGH,MAAM;IAEtB,IAAI,CAACC,YAAY,EAAE;IAEnB,MAAMG,QAA4B,GAAGJ,MAAM,GACvC;MACEK,KAAK,EAAEL,MAAM,CAACK,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACzCC,MAAM,EAAEN,MAAM,CAACM,MAAM,IAAIL,YAAY,CAACK,MAAM;MAC5CC,KAAK,EAAEN,YAAY,CAACM,KAAK;MACzBC,OAAO,EAAEP,YAAY,CAACO,OAAO;MAC7BC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAET,YAAY,CAACU,GAAG,IAAIV,YAAY,CAACW,GAAG;MAC7CC,KAAK,EAAEZ,YAAY,CAACY,KAAK;MACzBX;IACF,CAAC,GACD;MACEG,KAAK,EAAEJ,YAAY,CAACI,KAAK;MACzBC,MAAM,EAAEL,YAAY,CAACK,MAAM;MAC3BC,KAAK,EAAEN,YAAY,CAACM,KAAK;MACzBC,OAAO,EAAEP,YAAY,CAACO,OAAO;MAC7BC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAET,YAAY,CAACU,GAAG,IAAIV,YAAY,CAACW,GAAG;MAC7CC,KAAK,EAAEZ,YAAY,CAACY,KAAK;MACzBX;IACF,CAAC;IAEL,IAAI,CAACJ,mBAAmB,CAACM,QAAQ,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEU,aAAaA,CACXb,YAA+B,EAC/BC,QAAgB,EACgB;IAChC,IAAI,CAACD,YAAY,EAAE,OAAOc,SAAS;IAEnC,OAAO;MACLV,KAAK,EAAE,IAAI,CAACF,QAAQ,EAAEE,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACjDC,MAAM,EAAE,IAAI,CAACH,QAAQ,EAAEG,MAAM,IAAIL,YAAY,CAACK,MAAM;MACpDC,KAAK,EAAEN,YAAY,CAACM,KAAK;MACzBC,OAAO,EAAEP,YAAY,CAACO,OAAO;MAC7BC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAET,YAAY,CAACU,GAAG,IAAIV,YAAY,CAACW,GAAG;MAC7CC,KAAK,EAAEZ,YAAY,CAACY,KAAK;MACzBX;IACF,CAAC;EACH;;EAEA;AACF;AACA;AACA;EACEc,uBAAuBA,CAAA,EAAS;IAC9B,IAAI,CAACb,QAAQ,GAAGY,SAAS;EAC3B;AACF;AAACE,OAAA,CAAApB,iBAAA,GAAAA,iBAAA","ignoreList":[]}
+{"version":3,"names":["_artwork","require","NowPlayingManager","onNowPlayingChanged","updateNowPlaying","update","currentTrack","duration","override","metadata","title","artist","album","artwork","artworkUrl","description","mediaId","src","url","genre","getNowPlaying","undefined","clearNowPlayingOverride","exports"],"sourceRoot":"../../../../src","sources":["web/player/NowPlayingManager.ts"],"mappings":";;;;;;AAEA,IAAAA,QAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMC,iBAAiB,CAAC;EAG7B;EACAC,mBAAmB,GAA2CA,CAAA,KAAM,CAAC,CAAC;;EAEtE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CACdC,MAAoC,EACpCC,YAA+B,EAC/BC,QAAgB,EACV;IACN,IAAI,CAACC,QAAQ,GAAGH,MAAM;IAEtB,IAAI,CAACC,YAAY,EAAE;IAEnB,MAAMG,QAA4B,GAAGJ,MAAM,GACvC;MACEK,KAAK,EAAEL,MAAM,CAACK,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACzCC,MAAM,EAAEN,MAAM,CAACM,MAAM,IAAIL,YAAY,CAACK,MAAM;MAC5CC,KAAK,EAAEP,MAAM,CAACO,KAAK,IAAIN,YAAY,CAACM,KAAK;MACzCC,OAAO,EAAE,IAAAC,mBAAU,EAACR,YAAY,CAACO,OAAO,CAAC;MACzCE,WAAW,EAAET,YAAY,CAACS,WAAW;MACrCC,OAAO,EAAEV,YAAY,CAACW,GAAG,IAAIX,YAAY,CAACY,GAAG;MAC7CC,KAAK,EAAEb,YAAY,CAACa,KAAK;MACzBZ;IACF,CAAC,GACD;MACEG,KAAK,EAAEJ,YAAY,CAACI,KAAK;MACzBC,MAAM,EAAEL,YAAY,CAACK,MAAM;MAC3BC,KAAK,EAAEN,YAAY,CAACM,KAAK;MACzBC,OAAO,EAAE,IAAAC,mBAAU,EAACR,YAAY,CAACO,OAAO,CAAC;MACzCE,WAAW,EAAET,YAAY,CAACS,WAAW;MACrCC,OAAO,EAAEV,YAAY,CAACW,GAAG,IAAIX,YAAY,CAACY,GAAG;MAC7CC,KAAK,EAAEb,YAAY,CAACa,KAAK;MACzBZ;IACF,CAAC;IAEL,IAAI,CAACJ,mBAAmB,CAACM,QAAQ,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEW,aAAaA,CACXd,YAA+B,EAC/BC,QAAgB,EACgB;IAChC,IAAI,CAACD,YAAY,EAAE,OAAOe,SAAS;IAEnC,OAAO;MACLX,KAAK,EAAE,IAAI,CAACF,QAAQ,EAAEE,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACjDC,MAAM,EAAE,IAAI,CAACH,QAAQ,EAAEG,MAAM,IAAIL,YAAY,CAACK,MAAM;MACpDC,KAAK,EAAE,IAAI,CAACJ,QAAQ,EAAEI,KAAK,IAAIN,YAAY,CAACM,KAAK;MACjDC,OAAO,EAAE,IAAAC,mBAAU,EAACR,YAAY,CAACO,OAAO,CAAC;MACzCE,WAAW,EAAET,YAAY,CAACS,WAAW;MACrCC,OAAO,EAAEV,YAAY,CAACW,GAAG,IAAIX,YAAY,CAACY,GAAG;MAC7CC,KAAK,EAAEb,YAAY,CAACa,KAAK;MACzBZ;IACF,CAAC;EACH;;EAEA;AACF;AACA;AACA;EACEe,uBAAuBA,CAAA,EAAS;IAC9B,IAAI,CAACd,QAAQ,GAAGa,SAAS;EAC3B;AACF;AAACE,OAAA,CAAArB,iBAAA,GAAAA,iBAAA","ignoreList":[]}

package/lib/commonjs/web/player/OptionsManager.js

@@ -43,27 +43,19 @@ class OptionsManager {
 
     // Store merged options
     this.options = mergedOptions;
-
-    // Call callback with full Options type (including repeatMode)
-    const fullOptions = {
-      forwardJumpInterval: mergedOptions.forwardJumpInterval ?? 15,
-      backwardJumpInterval: mergedOptions.backwardJumpInterval ?? 15,
-      progressUpdateEventInterval: mergedOptions.progressUpdateEventInterval ?? 15,
-      capabilities: mergedOptions.capabilities ?? {},
-      repeatMode: mergedOptions.repeatMode
-    };
-    this.onOptionsChanged(fullOptions);
+    this.onOptionsChanged(this.toOptions());
   }
 
-  /**
-   * Gets current player options (excluding repeatMode).
-   */
+  /** The current options in their resolved shape. */
   getOptions() {
+    return this.toOptions();
+  }
+  toOptions() {
     return {
-      forwardJumpInterval: this.options.forwardJumpInterval,
-      backwardJumpInterval: this.options.backwardJumpInterval,
-      progressUpdateEventInterval: this.options.progressUpdateEventInterval,
-      capabilities: this.options.capabilities
+      forwardJumpInterval: this.options.forwardJumpInterval ?? 15,
+      backwardJumpInterval: this.options.backwardJumpInterval ?? 15,
+      progressUpdateEventInterval: this.options.progressUpdateEventInterval ?? null,
+      capabilities: this.options.capabilities ?? {}
     };
   }
 

package/lib/commonjs/web/player/OptionsManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["_TrackPlayer","require","OptionsManager","options","forwardJumpInterval","backwardJumpInterval","progressUpdateEventInterval","repeatMode","RepeatMode","Off","capabilities","onOptionsChanged","updateOptions","undefined","Error","mergedOptions","fullOptions","getOptions","getRepeatMode","setRepeatMode","mode","exports"],"sourceRoot":"../../../../src","sources":["web/player/OptionsManager.ts"],"mappings":";;;;;;AAMA,IAAAA,YAAA,GAAAC,OAAA;AAMA;AACA;AACA;AACA;AACO,MAAMC,cAAc,CAAC;EAClBC,OAAO,GAAoB;IACjCC,mBAAmB,EAAE,EAAE;IACvBC,oBAAoB,EAAE,EAAE;IACxBC,2BAA2B,EAAE,IAAI;IACjCC,UAAU,EAAEC,uBAAU,CAACC,GAAG;IAC1BC,YAAY,EAAE,CAAC;EACjB,CAAC;;EAED;EACAC,gBAAgB,GAA+BA,CAAA,KAAM,CAAC,CAAC;;EAEvD;AACF;AACA;AACA;AACA;AACA;EACEC,aAAaA,CAACT,OAA4B,EAAQ;IAChD,IACEA,OAAO,CAACG,2BAA2B,KAAK,IAAI,IAC5CH,OAAO,CAACG,2BAA2B,KAAKO,SAAS,IACjD,OAAOV,OAAO,CAACG,2BAA2B,KAAK,QAAQ,EACvD;MACA,MAAM,IAAIQ,KAAK,CAAC,wCAAwC,CAAC;IAC3D;;IAEA;IACA,MAAMC,aAA8B,GAAG;MACrC,GAAG,IAAI,CAACZ,OAAO;MACfC,mBAAmB,EACjBD,OAAO,CAACC,mBAAmB,IAAI,IAAI,CAACD,OAAO,CAACC,mBAAmB;MACjEC,oBAAoB,EAClBF,OAAO,CAACE,oBAAoB,IAAI,IAAI,CAACF,OAAO,CAACE,oBAAoB;MACnEK,YAAY,EAAEP,OAAO,CAACO,YAAY,IAAI,IAAI,CAACP,OAAO,CAACO,YAAY;MAC/DJ,2BAA2B,EACzBH,OAAO,CAACG,2BAA2B,KAAK,IAAI,GACxC,IAAI,GACHH,OAAO,CAACG,2BAA2B,IACpC,IAAI,CAACH,OAAO,CAACG;IACrB,CAAC;;IAED;IACA,IAAI,CAACH,OAAO,GAAGY,aAAa;;IAE5B;IACA,MAAMC,WAAoB,GAAG;MAC3BZ,mBAAmB,EAAEW,aAAa,CAACX,mBAAmB,IAAI,EAAE;MAC5DC,oBAAoB,EAAEU,aAAa,CAACV,oBAAoB,IAAI,EAAE;MAC9DC,2BAA2B,EACzBS,aAAa,CAACT,2BAA2B,IAAI,EAAE;MACjDI,YAAY,EAAEK,aAAa,CAACL,YAAY,IAAI,CAAC,CAAC;MAC9CH,UAAU,EAAEQ,aAAa,CAACR;IAC5B,CAAC;IACD,IAAI,CAACI,gBAAgB,CAACK,WAAW,CAAC;EACpC;;EAEA;AACF;AACA;EACEC,UAAUA,CAAA,EAAkB;IAC1B,OAAO;MACLb,mBAAmB,EAAE,IAAI,CAACD,OAAO,CAACC,mBAAmB;MACrDC,oBAAoB,EAAE,IAAI,CAACF,OAAO,CAACE,oBAAoB;MACvDC,2BAA2B,EAAE,IAAI,CAACH,OAAO,CAACG,2BAA2B;MACrEI,YAAY,EAAE,IAAI,CAACP,OAAO,CAACO;IAC7B,CAAC;EACH;;EAEA;AACF;AACA;EACEQ,aAAaA,CAAA,EAAmB;IAC9B,OAAO,IAAI,CAACf,OAAO,CAACI,UAAU;EAChC;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEY,aAAaA,CAACC,IAAoB,EAAQ;IACxC,IAAI,CAACjB,OAAO,CAACI,UAAU,GAAGa,IAAI;EAChC;AACF;AAACC,OAAA,CAAAnB,cAAA,GAAAA,cAAA","ignoreList":[]}
+{"version":3,"names":["_TrackPlayer","require","OptionsManager","options","forwardJumpInterval","backwardJumpInterval","progressUpdateEventInterval","repeatMode","RepeatMode","Off","capabilities","onOptionsChanged","updateOptions","undefined","Error","mergedOptions","toOptions","getOptions","getRepeatMode","setRepeatMode","mode","exports"],"sourceRoot":"../../../../src","sources":["web/player/OptionsManager.ts"],"mappings":";;;;;;AAMA,IAAAA,YAAA,GAAAC,OAAA;AAMA;AACA;AACA;AACA;AACO,MAAMC,cAAc,CAAC;EAClBC,OAAO,GAAoB;IACjCC,mBAAmB,EAAE,EAAE;IACvBC,oBAAoB,EAAE,EAAE;IACxBC,2BAA2B,EAAE,IAAI;IACjCC,UAAU,EAAEC,uBAAU,CAACC,GAAG;IAC1BC,YAAY,EAAE,CAAC;EACjB,CAAC;;EAED;EACAC,gBAAgB,GAA+BA,CAAA,KAAM,CAAC,CAAC;;EAEvD;AACF;AACA;AACA;AACA;AACA;EACEC,aAAaA,CAACT,OAA4B,EAAQ;IAChD,IACEA,OAAO,CAACG,2BAA2B,KAAK,IAAI,IAC5CH,OAAO,CAACG,2BAA2B,KAAKO,SAAS,IACjD,OAAOV,OAAO,CAACG,2BAA2B,KAAK,QAAQ,EACvD;MACA,MAAM,IAAIQ,KAAK,CAAC,wCAAwC,CAAC;IAC3D;;IAEA;IACA,MAAMC,aAA8B,GAAG;MACrC,GAAG,IAAI,CAACZ,OAAO;MACfC,mBAAmB,EACjBD,OAAO,CAACC,mBAAmB,IAAI,IAAI,CAACD,OAAO,CAACC,mBAAmB;MACjEC,oBAAoB,EAClBF,OAAO,CAACE,oBAAoB,IAAI,IAAI,CAACF,OAAO,CAACE,oBAAoB;MACnEK,YAAY,EAAEP,OAAO,CAACO,YAAY,IAAI,IAAI,CAACP,OAAO,CAACO,YAAY;MAC/DJ,2BAA2B,EACzBH,OAAO,CAACG,2BAA2B,KAAK,IAAI,GACxC,IAAI,GACHH,OAAO,CAACG,2BAA2B,IACpC,IAAI,CAACH,OAAO,CAACG;IACrB,CAAC;;IAED;IACA,IAAI,CAACH,OAAO,GAAGY,aAAa;IAE5B,IAAI,CAACJ,gBAAgB,CAAC,IAAI,CAACK,SAAS,CAAC,CAAC,CAAC;EACzC;;EAEA;EACAC,UAAUA,CAAA,EAAY;IACpB,OAAO,IAAI,CAACD,SAAS,CAAC,CAAC;EACzB;EAEQA,SAASA,CAAA,EAAY;IAC3B,OAAO;MACLZ,mBAAmB,EAAE,IAAI,CAACD,OAAO,CAACC,mBAAmB,IAAI,EAAE;MAC3DC,oBAAoB,EAAE,IAAI,CAACF,OAAO,CAACE,oBAAoB,IAAI,EAAE;MAC7DC,2BAA2B,EACzB,IAAI,CAACH,OAAO,CAACG,2BAA2B,IAAI,IAAI;MAClDI,YAAY,EAAE,IAAI,CAACP,OAAO,CAACO,YAAY,IAAI,CAAC;IAC9C,CAAC;EACH;;EAEA;AACF;AACA;EACEQ,aAAaA,CAAA,EAAmB;IAC9B,OAAO,IAAI,CAACf,OAAO,CAACI,UAAU;EAChC;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEY,aAAaA,CAACC,IAAoB,EAAQ;IACxC,IAAI,CAACjB,OAAO,CAACI,UAAU,GAAGa,IAAI;EAChC;AACF;AAACC,OAAA,CAAAnB,cAAA,GAAAA,cAAA","ignoreList":[]}

package/lib/commonjs/web/player/RemoteCommandController.js

@@ -0,0 +1,96 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RemoteCommandController = void 0;
+var _MediaSessionManager = require("./MediaSessionManager");
+/**
+ * The slice of the player the remote-command bridge drives. Picked straight from
+ * the spec so the contract can never drift from the real surface.
+ */
+
+/**
+ * Bridges the OS media controls (lockscreen / notification / hardware media
+ * keys, via the browser Media Session API) to the player:
+ *
+ *  - mirrors now-playing metadata, playback state and scrubber position *out*, and
+ *  - routes incoming commands *in* — preferring a consumer-provided handler,
+ *    otherwise running the default transport action, then always emitting the
+ *    observation event. This matches the native HybridAudioBrowser/AudioBrowser
+ *    contract exactly.
+ *
+ * A no-op when the Media Session API is unavailable (handled by the underlying
+ * {@link MediaSessionManager}).
+ */
+class RemoteCommandController {
+  constructor(host) {
+    this.host = host;
+    // Handlers are read live (inside each arrow) so consumers can assign them
+    // after construction and still be honoured.
+    this.mediaSession = new _MediaSessionManager.MediaSessionManager({
+      play: () => this.run(host.handleRemotePlay, undefined, () => host.play(), () => host.onRemotePlay()),
+      pause: () => this.run(host.handleRemotePause, undefined, () => host.pause(), () => host.onRemotePause()),
+      stop: () => this.run(host.handleRemoteStop, undefined, () => host.stop(), () => host.onRemoteStop()),
+      next: () => this.run(host.handleRemoteNext, undefined, () => host.skipToNext(), () => host.onRemoteNext()),
+      previous: () => this.run(host.handleRemotePrevious, undefined, () => host.skipToPrevious(), () => host.onRemotePrevious()),
+      seek: position => this.run(host.handleRemoteSeek, {
+        position
+      }, () => host.seekTo(position), event => host.onRemoteSeek(event)),
+      jumpForward: interval => this.run(host.handleRemoteJumpForward, {
+        interval
+      }, () => host.seekBy(interval), event => host.onRemoteJumpForward(event)),
+      jumpBackward: interval => this.run(host.handleRemoteJumpBackward, {
+        interval
+      }, () => host.seekBy(-interval), event => host.onRemoteJumpBackward(event))
+    });
+  }
+
+  /** Publishes now-playing metadata to the OS media controls. */
+  setMetadata(metadata) {
+    this.mediaSession.setMetadata(metadata);
+  }
+
+  /** Reflects the current playing/paused/stopped state in the OS controls. */
+  syncPlaybackState() {
+    const playback = this.host.getPlayback();
+    if (playback.state === 'none') {
+      this.mediaSession.setPlaybackState('none');
+    } else if (this.host.getPlayingState().playing) {
+      this.mediaSession.setPlaybackState('playing');
+    } else {
+      this.mediaSession.setPlaybackState('paused');
+    }
+  }
+
+  /** Pushes the latest scrubber position to the OS controls. */
+  updateProgress() {
+    const {
+      duration,
+      position
+    } = this.host.getProgress();
+    // The web player has no variable-rate playback, so the rate is always 1.
+    // (Live radio has no seekable timeline anyway — the position is cleared.)
+    this.mediaSession.setPositionState({
+      duration,
+      position,
+      playbackRate: 1
+    });
+  }
+
+  /** Removes handlers and clears metadata/state. Call on teardown. */
+  dispose() {
+    this.mediaSession.dispose();
+  }
+
+  /**
+   * The remote-command contract: run the consumer handler if present, otherwise
+   * the default transport action, then always emit the observation event.
+   */
+  run(handler, event, fallback, emit) {
+    if (handler) handler(event);else fallback();
+    emit(event);
+  }
+}
+exports.RemoteCommandController = RemoteCommandController;
+//# sourceMappingURL=RemoteCommandController.js.map

package/lib/commonjs/web/player/RemoteCommandController.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_MediaSessionManager","require","RemoteCommandController","constructor","host","mediaSession","MediaSessionManager","play","run","handleRemotePlay","undefined","onRemotePlay","pause","handleRemotePause","onRemotePause","stop","handleRemoteStop","onRemoteStop","next","handleRemoteNext","skipToNext","onRemoteNext","previous","handleRemotePrevious","skipToPrevious","onRemotePrevious","seek","position","handleRemoteSeek","seekTo","event","onRemoteSeek","jumpForward","interval","handleRemoteJumpForward","seekBy","onRemoteJumpForward","jumpBackward","handleRemoteJumpBackward","onRemoteJumpBackward","setMetadata","metadata","syncPlaybackState","playback","getPlayback","state","setPlaybackState","getPlayingState","playing","updateProgress","duration","getProgress","setPositionState","playbackRate","dispose","handler","fallback","emit","exports"],"sourceRoot":"../../../../src","sources":["web/player/RemoteCommandController.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,221 @@
+"use strict";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 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.
+export const 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__.
+ */
+export 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.`);
+  }
+}
+export 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/module/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","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/module/features/browser.js

@@ -3,161 +3,8 @@
 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,
-    handleTrackLoad: config.handleTrackLoad,
-    androidControllerOfflineError: config.androidControllerOfflineError,
-    carPlayUpNextButton: config.carPlayUpNextButton,
-    carPlayNowPlayingButtons: config.carPlayNowPlayingButtons,
-    formatNavigationError: config.formatNavigationError
-  };
-}
+import { SEARCH_ROUTE_PATH, toNativeConfig, validateBrowserConfiguration } from './browser-config';
+let currentConfiguration;
 
 /**
  * Configures the browser with routes, tabs, and other settings.
@@ -166,13 +13,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: '/' },
@@ -182,8 +46,25 @@ function toNativeConfig(config) {
  * ```
  */
 export function configureBrowser(configuration) {
+  // __DEV__ is a React Native global; absent under plain node (vitest).
+  if (typeof __DEV__ !== 'undefined' && __DEV__) {
+    validateBrowserConfiguration(configuration);
+  }
+  currentConfiguration = configuration;
   nativeBrowser.configuration = 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.
+ */
+export function getBrowserConfiguration() {
+  return currentConfiguration;
+}
 export function navigate(pathOrTrack) {
   if (typeof pathOrTrack === 'string') {
     return nativeBrowser.navigatePath(pathOrTrack);
@@ -229,6 +110,22 @@ export const notifyContentChanged = path => {
   nativeBrowser.notifyContentChanged(path);
 };
 
+/**
+ * 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()
+ * ```
+ */
+export const invalidateAllContent = () => {
+  nativeBrowser.invalidateAllContent();
+};
+
 /**
  * Returns whether search functionality is configured via `configureBrowser({ search: ... })`.
  */