@readium/navigator 2.4.0-beta.10 → 2.4.0-beta.11

package/dist/index.js

@@ -3622,7 +3622,7 @@ const Ct = class Ct extends bt {
     ), Reflect.defineProperty(t.navigator, "epubReadingSystem", {
       value: {
         name: "readium-ts-toolkit",
-        version: "2.4.0-beta.10",
+        version: "2.4.0-beta.11",
         hasFeature: (n, r = "") => {
           switch (n) {
             case "dom-manipulation":
@@ -10083,7 +10083,7 @@ class Be {
 }
 class Es {
   constructor(t) {
-    this.audioContext = null, this.sourceNode = null, this.gainNode = null, this.listeners = {}, this.currentVolume = 1, this.currentPlaybackRate = 1, this.isMutedValue = !1, this.isPlayingValue = !1, this.isPausedValue = !1, this.isLoadingValue = !1, this.isLoadedValue = !1, this.isEndedValue = !1, this.isStoppedValue = !1, this.worklet = null, this.webAudioActive = !1, this.boundOnCanPlayThrough = this.onCanPlayThrough.bind(this), this.boundOnTimeUpdate = this.onTimeUpdate.bind(this), this.boundOnError = this.onError.bind(this), this.boundOnEnded = this.onEnded.bind(this), this.boundOnStalled = this.onStalled.bind(this), this.boundOnEmptied = this.onEmptied.bind(this), this.boundOnSuspend = this.onSuspend.bind(this), this.boundOnWaiting = this.onWaiting.bind(this), this.boundOnLoadedMetadata = this.onLoadedMetadata.bind(this), this.boundOnSeeking = this.onSeeking.bind(this), this.boundOnSeeked = this.onSeeked.bind(this), this.boundOnPlay = this.onPlay.bind(this), this.boundOnPlaying = this.onPlaying.bind(this), this.boundOnPause = this.onPause.bind(this), this.boundOnProgress = this.onProgress.bind(this), this.playback = t.playback, this.mediaElement = document.createElement("audio"), this.mediaElement.addEventListener("canplaythrough", this.boundOnCanPlayThrough), this.mediaElement.addEventListener("timeupdate", this.boundOnTimeUpdate), this.mediaElement.addEventListener("error", this.boundOnError), this.mediaElement.addEventListener("ended", this.boundOnEnded), this.mediaElement.addEventListener("stalled", this.boundOnStalled), this.mediaElement.addEventListener("emptied", this.boundOnEmptied), this.mediaElement.addEventListener("suspend", this.boundOnSuspend), this.mediaElement.addEventListener("waiting", this.boundOnWaiting), this.mediaElement.addEventListener("loadedmetadata", this.boundOnLoadedMetadata), this.mediaElement.addEventListener("seeking", this.boundOnSeeking), this.mediaElement.addEventListener("seeked", this.boundOnSeeked), this.mediaElement.addEventListener("play", this.boundOnPlay), this.mediaElement.addEventListener("playing", this.boundOnPlaying), this.mediaElement.addEventListener("pause", this.boundOnPause), this.mediaElement.addEventListener("progress", this.boundOnProgress), this.mediaElement.currentTime = this.playback.state.currentTime;
+    this.audioContext = null, this.sourceNode = null, this.gainNode = null, this.listeners = {}, this.isMutedValue = !1, this.isPlayingValue = !1, this.isPausedValue = !1, this.isLoadingValue = !1, this.isLoadedValue = !1, this.isEndedValue = !1, this.isStoppedValue = !1, this.worklet = null, this.webAudioActive = !1, this.boundOnCanPlayThrough = this.onCanPlayThrough.bind(this), this.boundOnTimeUpdate = this.onTimeUpdate.bind(this), this.boundOnError = this.onError.bind(this), this.boundOnEnded = this.onEnded.bind(this), this.boundOnStalled = this.onStalled.bind(this), this.boundOnEmptied = this.onEmptied.bind(this), this.boundOnSuspend = this.onSuspend.bind(this), this.boundOnWaiting = this.onWaiting.bind(this), this.boundOnLoadedMetadata = this.onLoadedMetadata.bind(this), this.boundOnSeeking = this.onSeeking.bind(this), this.boundOnSeeked = this.onSeeked.bind(this), this.boundOnPlay = this.onPlay.bind(this), this.boundOnPlaying = this.onPlaying.bind(this), this.boundOnPause = this.onPause.bind(this), this.boundOnProgress = this.onProgress.bind(this), this.playback = t.playback, this.mediaElement = document.createElement("audio"), this.mediaElement.addEventListener("canplaythrough", this.boundOnCanPlayThrough), this.mediaElement.addEventListener("timeupdate", this.boundOnTimeUpdate), this.mediaElement.addEventListener("error", this.boundOnError), this.mediaElement.addEventListener("ended", this.boundOnEnded), this.mediaElement.addEventListener("stalled", this.boundOnStalled), this.mediaElement.addEventListener("emptied", this.boundOnEmptied), this.mediaElement.addEventListener("suspend", this.boundOnSuspend), this.mediaElement.addEventListener("waiting", this.boundOnWaiting), this.mediaElement.addEventListener("loadedmetadata", this.boundOnLoadedMetadata), this.mediaElement.addEventListener("seeking", this.boundOnSeeking), this.mediaElement.addEventListener("seeked", this.boundOnSeeked), this.mediaElement.addEventListener("play", this.boundOnPlay), this.mediaElement.addEventListener("playing", this.boundOnPlaying), this.mediaElement.addEventListener("pause", this.boundOnPause), this.mediaElement.addEventListener("progress", this.boundOnProgress), this.mediaElement.currentTime = this.playback.state.currentTime;
   }
   /**
    * Adds an event listener to the audio engine.
@@ -10103,23 +10103,6 @@ class Es {
       (i) => i !== e
     ));
   }
-  deactivateWebAudio() {
-    this.worklet && (this.worklet.destroy(), this.worklet = null), this.sourceNode && (this.sourceNode.disconnect(), this.sourceNode = null), this.gainNode && (this.gainNode.disconnect(), this.gainNode = null), this.webAudioActive = !1;
-  }
-  /**
-   * Sets the media element for playback.
-   * @param element The HTML audio element to use.
-   */
-  setMediaElement(t) {
-    if (this.mediaElement.removeEventListener("canplaythrough", this.boundOnCanPlayThrough), this.mediaElement.removeEventListener("timeupdate", this.boundOnTimeUpdate), this.mediaElement.removeEventListener("error", this.boundOnError), this.mediaElement.removeEventListener("ended", this.boundOnEnded), this.mediaElement.removeEventListener("stalled", this.boundOnStalled), this.mediaElement.removeEventListener("emptied", this.boundOnEmptied), this.mediaElement.removeEventListener("suspend", this.boundOnSuspend), this.mediaElement.removeEventListener("waiting", this.boundOnWaiting), this.mediaElement.removeEventListener("loadedmetadata", this.boundOnLoadedMetadata), this.mediaElement.removeEventListener("seeking", this.boundOnSeeking), this.mediaElement.removeEventListener("seeked", this.boundOnSeeked), this.mediaElement.removeEventListener("play", this.boundOnPlay), this.mediaElement.removeEventListener("playing", this.boundOnPlaying), this.mediaElement.removeEventListener("pause", this.boundOnPause), this.mediaElement.removeEventListener("progress", this.boundOnProgress), this.mediaElement.pause(), this.isPlayingValue = !1, this.isPausedValue = !1, this.sourceNode && (this.sourceNode.disconnect(), this.sourceNode = null), this.mediaElement = t, this.mediaElement.addEventListener("canplaythrough", this.boundOnCanPlayThrough), this.mediaElement.addEventListener("timeupdate", this.boundOnTimeUpdate), this.mediaElement.addEventListener("error", this.boundOnError), this.mediaElement.addEventListener("ended", this.boundOnEnded), this.mediaElement.addEventListener("stalled", this.boundOnStalled), this.mediaElement.addEventListener("emptied", this.boundOnEmptied), this.mediaElement.addEventListener("suspend", this.boundOnSuspend), this.mediaElement.addEventListener("waiting", this.boundOnWaiting), this.mediaElement.addEventListener("loadedmetadata", this.boundOnLoadedMetadata), this.mediaElement.addEventListener("seeking", this.boundOnSeeking), this.mediaElement.addEventListener("seeked", this.boundOnSeeked), this.mediaElement.addEventListener("play", this.boundOnPlay), this.mediaElement.addEventListener("playing", this.boundOnPlaying), this.mediaElement.addEventListener("pause", this.boundOnPause), this.mediaElement.addEventListener("progress", this.boundOnProgress), this.mediaElement.volume = this.isMutedValue ? 0 : this.currentVolume, this.mediaElement.playbackRate = this.currentPlaybackRate, this.webAudioActive)
-      try {
-        const e = this.getOrCreateAudioContext();
-        this.sourceNode = new MediaElementAudioSourceNode(e, { mediaElement: this.mediaElement }), this.gainNode || (this.gainNode = e.createGain(), this.gainNode.connect(e.destination)), this.worklet?.workletNode ? this.sourceNode.connect(this.worklet.workletNode) : this.sourceNode.connect(this.gainNode);
-      } catch {
-        this.deactivateWebAudio();
-      }
-    this.mediaElement.readyState >= 1 && this.onLoadedMetadata(new Event("loadedmetadata")), this.mediaElement.seekable.length > 0 && this.onProgress(), this.mediaElement.readyState >= 4 ? this.onCanPlayThrough() : (this.isLoadingValue = !0, this.isLoadedValue = !1);
-  }
   // Ensure AudioContext is running
   async ensureAudioContextRunning() {
     this.audioContext || (this.audioContext = new AudioContext()), this.audioContext.state === "suspended" && await this.audioContext.resume();
@@ -10210,14 +10193,14 @@ class Es {
    */
   setVolume(t) {
     if (t < 0) {
-      this.currentVolume = 0, this.mediaElement.volume = 0, this.gainNode && (this.gainNode.gain.value = 0), this.isMutedValue = !0;
+      this.mediaElement.volume = 0, this.gainNode && (this.gainNode.gain.value = 0), this.isMutedValue = !0;
       return;
     }
     if (t > 1) {
       this.setVolume(t / 100);
       return;
     }
-    this.currentVolume = t, this.mediaElement.volume = t, this.gainNode && (this.gainNode.gain.value = t);
+    this.mediaElement.volume = t, this.gainNode && (this.gainNode.gain.value = t);
   }
   /**
    * Skips [seconds] either forward or backward if [seconds] is negative.
@@ -10286,7 +10269,7 @@ class Es {
    * Sets the playback rate of the audio resource with pitch preservation.
    */
   setPlaybackRate(t, e) {
-    this.currentPlaybackRate = t, this.mediaElement.playbackRate = t, e ? "preservesPitch" in this.mediaElement ? this.mediaElement.preservesPitch = !0 : this.activateWebAudio().then(() => {
+    this.mediaElement.playbackRate = t, e ? "preservesPitch" in this.mediaElement ? this.mediaElement.preservesPitch = !0 : this.activateWebAudio().then(() => {
       this.worklet ? this.worklet.updatePitchFactor(1 / t) : (this.sourceNode && (this.sourceNode.disconnect(), this.sourceNode = null), Be.createWorklet({
         ctx: this.getOrCreateAudioContext(),
         mediaElement: this.mediaElement,
@@ -10324,6 +10307,13 @@ class Es {
   get isWebAudioActive() {
     return this.webAudioActive;
   }
+  /**
+   * Changes the src of the primary media element without swapping the element.
+   * Preserves the RemotePlayback session and all attached event listeners.
+   */
+  changeSrc(t) {
+    this.mediaElement.src !== t && (this.mediaElement.pause(), this.isPlayingValue = !1, this.isPausedValue = !1, this.isLoadedValue = !1, this.isLoadingValue = !0, this.isEndedValue = !1, this.webAudioActive && (this.mediaElement.crossOrigin = "anonymous"), this.mediaElement.src = t, this.mediaElement.load());
+  }
   /**
    * Returns the HTML media element used for playback.
    */
@@ -10453,8 +10443,8 @@ class Fi {
 }
 const Ui = 1, Ii = 1;
 class xs {
-  constructor(t, e) {
-    this.pool = /* @__PURE__ */ new Map(), this._audioEngine = t, this._publication = e, this._supportedAudioTypes = this.detectSupportedAudioTypes();
+  constructor(t, e, i = {}) {
+    this.pool = /* @__PURE__ */ new Map(), this._audioEngine = t, this._publication = e, this._supportedAudioTypes = this.detectSupportedAudioTypes(), i.disableRemotePlayback && (this._audioEngine.getMediaElement().disableRemotePlayback = !0);
   }
   detectSupportedAudioTypes() {
     const t = document.createElement("audio"), e = /* @__PURE__ */ new Set();
@@ -10497,10 +10487,12 @@ class xs {
   /**
    * Updates the pool around the given index: ensures elements exist within
    * the LOWER_BOUNDARY and disposes those beyond the UPPER_BOUNDARY.
+   * The current track is excluded — the primary engine element represents it.
    */
   update(t) {
     const e = this._publication.readingOrder.items, i = /* @__PURE__ */ new Set();
     for (let n = 0; n < e.length; n++) {
+      if (n === t) continue;
       const r = this.pickPlayableHref(e[n]);
       n >= t - Ii && n <= t + Ii ? (this.ensure(r), i.add(r)) : n >= t - Ui && n <= t + Ui && this.pool.has(r) && i.add(r);
     }
@@ -10508,12 +10500,17 @@ class xs {
       i.has(n) || (r.removeAttribute("src"), r.load(), this.pool.delete(n));
   }
   /**
-   * Sets the current audio for playback at the given track index.
-   * The element is always sourced from the pool — never loaded ad-hoc on the engine.
+   * Sets the current audio for playback at the given track index by changing
+   * the src on the persistent primary element. This preserves the RemotePlayback
+   * session and any Web Audio graph connections across track changes.
    */
   setCurrentAudio(t, e) {
-    const i = this.pickPlayableHref(this._publication.readingOrder.items[t]), n = this.ensure(i);
-    this.audioEngine.setMediaElement(n), this.pool.delete(i), this.update(t);
+    const i = this.pickPlayableHref(this._publication.readingOrder.items[t]);
+    if (this.audioEngine.changeSrc(i), this.pool.has(i)) {
+      const n = this.pool.get(i);
+      n.removeAttribute("src"), n.load(), this.pool.delete(i);
+    }
+    this.update(t);
   }
   destroy() {
     this.audioEngine.stop();
@@ -10600,7 +10597,7 @@ class As extends dr {
     preferences: {},
     defaults: {}
   }) {
-    if (super(), this.positionPollInterval = null, this.navigationId = 0, this._playIntent = !1, this._preferencesEditor = null, this._mediaSessionEnabled = !1, this._navigatorProtector = null, this._keyboardPeripheralsManager = null, this._suspiciousActivityListener = null, this._keyboardPeripheralListener = null, this.pub = t, this.listeners = Os(e), this._preferences = new oe(n.preferences), this._defaults = new Cs(n.defaults), this._settings = new Ni(this._preferences, this._defaults), i)
+    if (super(), this.positionPollInterval = null, this.navigationId = 0, this._playIntent = !1, this._preferencesEditor = null, this._mediaSessionEnabled = !1, this._navigatorProtector = null, this._keyboardPeripheralsManager = null, this._suspiciousActivityListener = null, this._keyboardPeripheralListener = null, this._isNavigating = !1, this.pub = t, this.listeners = Os(e), this._preferences = new oe(n.preferences), this._defaults = new Cs(n.defaults), this._settings = new Ni(this._preferences, this._defaults), i)
       this.currentLocation = this.ensureLocatorLocations(i);
     else {
       const u = this.pub.readingOrder.items[0];
@@ -10626,8 +10623,10 @@ class As extends dr {
         index: o
       }
     });
-    this.pool = new xs(l, t);
-    const h = n.contentProtection || {}, c = this.mergeKeyboardPeripherals(
+    this.pool = new xs(l, t, n.contentProtection);
+    const h = n.contentProtection || {};
+    this._contentProtection = h;
+    const c = this.mergeKeyboardPeripherals(
       h,
       n.keyboardPeripherals || []
     );
@@ -10636,9 +10635,10 @@ class As extends dr {
       m === "context_menu" ? this.listeners.contextMenu(y) : this.listeners.contentProtection(m, y);
     }, window.addEventListener(st, this._suspiciousActivityListener)), c.length > 0 && (this._keyboardPeripheralsManager = new He({ keyboardPeripherals: c }), this._keyboardPeripheralListener = (u) => {
       this.listeners.peripheral(u.detail);
-    }, window.addEventListener(ot, this._keyboardPeripheralListener)), this.setupEventListeners(), this.applyPreferences(), this.pool.setCurrentAudio(o, "forward"), this.waitForLoadedAndSeeked(a).then(() => {
-      this.listeners.trackLoaded(this.pool.audioEngine.getMediaElement()), this._notifyTimelineChange(this.currentLocator), this.listeners.positionChanged(this.currentLocator);
+    }, window.addEventListener(ot, this._keyboardPeripheralListener)), this.setupEventListeners(), this.applyPreferences(), this._isNavigating = !0, this.pool.setCurrentAudio(o, "forward"), this.waitForLoadedAndSeeked(a).then(() => {
+      this._isNavigating = !1, this.listeners.trackLoaded(this.pool.audioEngine.getMediaElement()), this._notifyTimelineChange(this.currentLocator), this.listeners.positionChanged(this.currentLocator), this._setupRemotePlayback();
     }).catch(() => {
+      this._isNavigating = !1;
     });
   }
   get settings() {
@@ -10751,13 +10751,13 @@ class As extends dr {
         fragments: [`t=${this.duration}`]
       })), this.listeners.trackEnded(this.currentLocator), this.canGoForward && (await this.nextTrack(), this._settings.autoPlay && this.play());
     }), this.pool.audioEngine.on("play", () => {
-      this.startPositionPolling(), this.listeners.play(this.currentLocator);
+      this._isNavigating || (this.startPositionPolling(), this.listeners.play(this.currentLocator));
     }), this.pool.audioEngine.on("playing", () => {
-      this.listeners.stalled(!1);
+      this._isNavigating || this.listeners.stalled(!1);
     }), this.pool.audioEngine.on("pause", () => {
-      this.stopPositionPolling(), this.listeners.pause(this.currentLocator);
+      this._isNavigating || (this.stopPositionPolling(), this.listeners.pause(this.currentLocator));
     }), this.pool.audioEngine.on("seeked", () => {
-      if (this.listeners.seeking(!1), !this.isPlaying) {
+      if (!this._isNavigating && (this.listeners.seeking(!1), !this.isPlaying)) {
         const t = this.currentTime, e = this.duration, i = e > 0 ? t / e : 0;
         this.currentLocation = this.currentLocation.copyWithLocations(new E({
           position: this.currentTrackIndex(),
@@ -10765,8 +10765,24 @@ class As extends dr {
           fragments: [`t=${t}`]
         })), this._notifyTimelineChange(this.currentLocation), this.listeners.positionChanged(this.currentLocation);
       }
-    }), this.pool.audioEngine.on("seeking", () => this.listeners.seeking(!0)), this.pool.audioEngine.on("waiting", () => this.listeners.seeking(!0)), this.pool.audioEngine.on("stalled", () => this.listeners.stalled(!0)), this.pool.audioEngine.on("canplaythrough", () => this.listeners.stalled(!1)), this.pool.audioEngine.on("progress", (t) => this.listeners.seekable(t)), this.pool.audioEngine.on("loadedmetadata", () => {
-      this.listeners.metadataLoaded(this.pool.audioEngine.duration());
+    }), this.pool.audioEngine.on("seeking", () => {
+      this._isNavigating || this.listeners.seeking(!0);
+    }), this.pool.audioEngine.on("waiting", () => {
+      this._isNavigating || this.listeners.seeking(!0);
+    }), this.pool.audioEngine.on("stalled", () => {
+      this._isNavigating || this.listeners.stalled(!0);
+    }), this.pool.audioEngine.on("canplaythrough", () => {
+      this._isNavigating || this.listeners.stalled(!1);
+    }), this.pool.audioEngine.on("progress", (t) => {
+      this._isNavigating || this.listeners.seekable(t);
+    }), this.pool.audioEngine.on("loadedmetadata", () => {
+      const t = this.pool.audioEngine.getMediaElement(), e = {
+        duration: this.pool.audioEngine.duration(),
+        textTracks: t.textTracks,
+        readyState: t.readyState,
+        networkState: t.networkState
+      };
+      this.listeners.metadataLoaded(e);
     });
   }
   setupMediaSession() {
@@ -10806,13 +10822,13 @@ class As extends dr {
         return;
       }
       const a = ++this.navigationId, l = r >= this.currentTrackIndex() ? "forward" : "backward", h = this.isPlaying || this._playIntent;
-      if (this._playIntent = h, this.stopPositionPolling(), this.pool.setCurrentAudio(r, l), this.currentLocation = t.copyWithLocations(t.locations), await this.waitForLoadedAndSeeked(o, a), a !== this.navigationId) {
+      if (this._playIntent = h, this._isNavigating = !0, this.stopPositionPolling(), this.pool.setCurrentAudio(r, l), this.currentLocation = t.copyWithLocations(t.locations), await this.waitForLoadedAndSeeked(o, a), this._isNavigating = !1, a !== this.navigationId) {
         i(!1);
         return;
       }
       this.listeners.trackLoaded(this.pool.audioEngine.getMediaElement()), this._notifyTimelineChange(this.currentLocator), this.listeners.positionChanged(this.currentLocator), this._settings.enableMediaSession && this.updateMediaSessionMetadata(), h && this.play(), i(!0);
     } catch (n) {
-      console.error("Failed to go to locator:", n), i(!1);
+      this._isNavigating = !1, console.error("Failed to go to locator:", n), i(!1);
     } finally {
       this._playIntent = !1;
     }
@@ -10890,6 +10906,22 @@ class As extends dr {
   get canGoForward() {
     return this.currentTrackIndex() < this.pub.readingOrder.items.length - 1;
   }
+  /**
+   * The RemotePlayback object for the primary media element.
+   * Because the element is never swapped, this reference is stable for the
+   * lifetime of the navigator — host apps can store it and call `.prompt()`,
+   * `.watchAvailability()`, etc. directly.
+   */
+  get remotePlayback() {
+    return this.pool.audioEngine.getMediaElement().remote;
+  }
+  /** Wires up the optional remotePlaybackStateChanged listener. Called once after initial load. */
+  _setupRemotePlayback() {
+    if (this._contentProtection.disableRemotePlayback)
+      return;
+    const t = this.remotePlayback;
+    t && (t.onconnecting = () => this.listeners.remotePlaybackStateChanged?.("connecting"), t.onconnect = () => this.listeners.remotePlaybackStateChanged?.("connected"), t.ondisconnect = () => this.listeners.remotePlaybackStateChanged?.("disconnected"));
+  }
   destroyMediaSession() {
     "mediaSession" in navigator && (navigator.mediaSession.metadata = null, navigator.mediaSession.setActionHandler("play", null), navigator.mediaSession.setActionHandler("pause", null), navigator.mediaSession.setActionHandler("previoustrack", null), navigator.mediaSession.setActionHandler("nexttrack", null), navigator.mediaSession.setActionHandler("seekbackward", null), navigator.mediaSession.setActionHandler("seekforward", null));
   }