@scarlett-player/embed 0.5.2 → 1.0.0

package/dist/embed.audio.js

@@ -43,6 +43,18 @@ function mapLevels(levels, _currentLevel) {
     codec: level.codecSet
   }));
 }
+function getInitialBandwidthEstimate(overrideBps) {
+  const HLS_DEFAULT_ESTIMATE = 5e5;
+  if (overrideBps !== void 0 && overrideBps > 0) {
+    return overrideBps;
+  }
+  const connection = navigator.connection;
+  if (connection?.downlink && connection.downlink > 0) {
+    const bps = connection.downlink * 1e6;
+    return Math.round(bps * 0.85);
+  }
+  return HLS_DEFAULT_ESTIMATE;
+}
 var HLS_ERROR_TYPES = {
   NETWORK_ERROR: "networkError",
   MEDIA_ERROR: "mediaError",
@@ -113,6 +125,14 @@ function setupHlsEventHandlers(hls, api, callbacks) {
     });
     callbacks.onLevelSwitched?.(data.level);
   });
+  let lastBandwidthUpdate = 0;
+  addHandler("hlsFragLoaded", () => {
+    const now = Date.now();
+    if (now - lastBandwidthUpdate >= 2e3 && hls.bandwidthEstimate) {
+      lastBandwidthUpdate = now;
+      api.setState("bandwidth", Math.round(hls.bandwidthEstimate));
+    }
+  });
   addHandler("hlsFragBuffered", () => {
     api.setState("buffering", false);
     callbacks.onBufferUpdate?.();
@@ -123,12 +143,44 @@ function setupHlsEventHandlers(hls, api, callbacks) {
   addHandler("hlsLevelLoaded", (_event, data) => {
     if (data.details?.live !== void 0) {
       api.setState("live", data.details.live);
+      if (data.details.live) {
+        const video = hls.media;
+        if (video && video.seekable && video.seekable.length > 0) {
+          const start = video.seekable.start(0);
+          const end = video.seekable.end(video.seekable.length - 1);
+          api.setState("seekableRange", { start, end });
+          const threshold = (data.details.targetduration ?? 3) * 3;
+          const isAtLiveEdge = end - video.currentTime < threshold;
+          api.setState("liveEdge", isAtLiveEdge);
+          const latency = end - video.currentTime;
+          api.setState("liveLatency", Math.max(0, latency));
+        }
+      }
       callbacks.onLiveUpdate?.();
     }
   });
   addHandler("hlsError", (_event, data) => {
     const error = parseHlsError(data);
-    api.logger.warn("HLS error", { error });
+    const isBufferHoleSeek = !error.fatal && (error.details?.includes("bufferStalledError") || data.reason?.includes("buffer holes"));
+    if (isBufferHoleSeek) {
+      api.logger.debug(`HLS buffer recovery: ${error.reason || error.details}`, {
+        details: error.details,
+        reason: error.reason
+      });
+    } else if (error.fatal) {
+      api.logger.error(`HLS fatal error: ${error.details} (type=${error.type})`, {
+        type: error.type,
+        details: error.details,
+        url: error.url
+      });
+    } else {
+      api.logger.warn(`HLS error: ${error.details} (type=${error.type}, fatal=${error.fatal})`, {
+        type: error.type,
+        details: error.details,
+        fatal: error.fatal,
+        url: error.url
+      });
+    }
     callbacks.onError?.(error);
   });
   return () => {
@@ -150,6 +202,8 @@ function setupVideoEventHandlers(video, api) {
   addHandler("playing", () => {
     api.setState("playing", true);
     api.setState("paused", false);
+    api.setState("waiting", false);
+    api.setState("buffering", false);
     api.setState("playbackState", "playing");
   });
   addHandler("pause", () => {
@@ -166,6 +220,15 @@ function setupVideoEventHandlers(video, api) {
   addHandler("timeupdate", () => {
     api.setState("currentTime", video.currentTime);
     api.emit("playback:timeupdate", { currentTime: video.currentTime });
+    const isLive = api.getState("live");
+    if (isLive && video.seekable && video.seekable.length > 0) {
+      const start = video.seekable.start(0);
+      const end = video.seekable.end(video.seekable.length - 1);
+      api.setState("seekableRange", { start, end });
+      const isAtLiveEdge = end - video.currentTime < 10;
+      api.setState("liveEdge", isAtLiveEdge);
+      api.setState("liveLatency", Math.max(0, end - video.currentTime));
+    }
   });
   addHandler("durationchange", () => {
     api.setState("duration", video.duration || 0);
@@ -312,6 +375,7 @@ var DEFAULT_CONFIG$3 = {
   maxMaxBufferLength: 600,
   backBufferLength: 30,
   enableWorker: true,
+  capLevelToPlayerSize: true,
   // Error recovery settings
   maxNetworkRetries: 3,
   maxMediaRetries: 2,
@@ -381,11 +445,13 @@ function createHLSPlugin(config) {
     startPosition: mergedConfig.startPosition,
     startLevel: -1,
     // Auto quality selection (ABR)
+    abrEwmaDefaultEstimate: getInitialBandwidthEstimate(mergedConfig.initialBandwidthEstimate),
     lowLatencyMode: mergedConfig.lowLatencyMode,
     maxBufferLength: mergedConfig.maxBufferLength,
     maxMaxBufferLength: mergedConfig.maxMaxBufferLength,
     backBufferLength: mergedConfig.backBufferLength,
     enableWorker: mergedConfig.enableWorker,
+    capLevelToPlayerSize: mergedConfig.capLevelToPlayerSize,
     // Minimize hls.js internal retries - we handle retries ourselves
     fragLoadingMaxRetry: 1,
     manifestLoadingMaxRetry: 1,
@@ -656,7 +722,10 @@ function createHLSPlugin(config) {
       currentSrc = src;
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
-      if (isHlsJsSupported()) {
+      if (api.getState("airplayActive") && supportsNativeHLS()) {
+        api.logger.info("Using native HLS (AirPlay active)");
+        await loadNative(src);
+      } else if (isHlsJsSupported()) {
         api.logger.info("Using hls.js for HLS playback");
         await loadWithHlsJs(src);
       } else if (supportsNativeHLS()) {
@@ -1518,7 +1587,9 @@ var DEFAULT_CONFIG$1 = {
   persist: false,
   persistKey: "scarlett-playlist",
   shuffle: false,
-  repeat: "none"
+  repeat: "none",
+  autoLoad: true,
+  advanceDelay: 0
 };
 function generateId() {
   return `track-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
@@ -1662,6 +1733,9 @@ function createPlaylistPlugin(config) {
     }
     api?.setState("mediaType", track.type || "audio");
     emitChange();
+    if (mergedConfig.autoLoad !== false && track.src) {
+      api?.emit("media:load-request", { src: track.src, autoplay: true });
+    }
   };
   const plugin = {
     id: "playlist",
@@ -1676,12 +1750,20 @@ function createPlaylistPlugin(config) {
       if (shuffle && tracks.length > 0) {
         generateShuffleOrder();
       }
+      let advanceTimeout = null;
       const unsubEnded = api.on("playback:ended", () => {
         if (!mergedConfig.autoAdvance) return;
         const nextIdx = getNextIndex();
         if (nextIdx >= 0) {
-          api?.logger.debug("Auto-advancing to next track", { nextIdx });
-          setCurrentTrack(nextIdx);
+          const advance = () => {
+            api?.logger.debug("Auto-advancing to next track", { nextIdx });
+            setCurrentTrack(nextIdx);
+          };
+          if (mergedConfig.advanceDelay) {
+            advanceTimeout = setTimeout(advance, mergedConfig.advanceDelay);
+          } else {
+            advance();
+          }
         } else {
           api?.logger.info("Playlist ended");
           api?.emit("playlist:ended", void 0);
@@ -1689,6 +1771,10 @@ function createPlaylistPlugin(config) {
       });
       api.onDestroy(() => {
         unsubEnded();
+        if (advanceTimeout) {
+          clearTimeout(advanceTimeout);
+          advanceTimeout = null;
+        }
         persistPlaylist();
       });
     },
@@ -3673,6 +3759,13 @@ class ScarlettPlayer {
         await this.pluginManager.initPlugin(id);
       }
     }
+    this.eventBus.on("media:load-request", async ({ src, autoplay }) => {
+      if (this.stateManager.getValue("chromecastActive")) return;
+      await this.load(src);
+      if (autoplay !== false) {
+        await this.play();
+      }
+    });
     if (this.initialSrc) {
       await this.load(this.initialSrc);
     }
@@ -3880,8 +3973,9 @@ class ScarlettPlayer {
    */
   setPlaybackRate(rate) {
     this.checkDestroyed();
-    this.stateManager.set("playbackRate", rate);
-    this.eventBus.emit("playback:ratechange", { rate });
+    const clampedRate = Math.max(0.0625, Math.min(16, rate));
+    this.stateManager.set("playbackRate", clampedRate);
+    this.eventBus.emit("playback:ratechange", { rate: clampedRate });
   }
   /**
    * Set autoplay state.
@@ -4010,6 +4104,13 @@ class ScarlettPlayer {
     }
     const provider = this._currentProvider;
     if (typeof provider.setLevel === "function") {
+      if (index !== -1) {
+        const levels = this.getQualities();
+        if (levels.length > 0 && (index < 0 || index >= levels.length)) {
+          this.logger.warn(`Invalid quality index: ${index} (available: ${levels.length})`);
+          return;
+        }
+      }
       provider.setLevel(index);
       this.eventBus.emit("quality:change", {
         quality: index === -1 ? "auto" : `level-${index}`,
@@ -4250,18 +4351,40 @@ class ScarlettPlayer {
    * @private
    */
   detectMimeType(source) {
-    const ext = source.split(".").pop()?.toLowerCase();
+    let path = source;
+    try {
+      path = new URL(source).pathname;
+    } catch {
+      const noQuery = source.split("?")[0] ?? source;
+      path = noQuery.split("#")[0] ?? noQuery;
+    }
+    const ext = path.split(".").pop()?.toLowerCase() ?? "";
     switch (ext) {
       case "m3u8":
         return "application/x-mpegURL";
       case "mpd":
         return "application/dash+xml";
       case "mp4":
+      case "m4v":
         return "video/mp4";
       case "webm":
         return "video/webm";
       case "ogg":
+      case "ogv":
         return "video/ogg";
+      case "mov":
+        return "video/quicktime";
+      case "mkv":
+        return "video/x-matroska";
+      case "mp3":
+        return "audio/mpeg";
+      case "wav":
+        return "audio/wav";
+      case "flac":
+        return "audio/flac";
+      case "aac":
+      case "m4a":
+        return "audio/mp4";
       default:
         return "video/mp4";
     }
@@ -4470,6 +4593,12 @@ async function createEmbedPlayer(container, config, pluginCreators2, availableTy
         artwork: config.artwork || config.poster || config.playlist?.[0]?.artwork
       }));
     }
+    if (pluginCreators2.watermark && config.watermark) {
+      plugins.push(pluginCreators2.watermark(config.watermark));
+    }
+    if (pluginCreators2.captions) {
+      plugins.push(pluginCreators2.captions(config.captions || {}));
+    }
     if (pluginCreators2.analytics && config.analytics?.beaconUrl) {
       plugins.push(pluginCreators2.analytics({
         beaconUrl: config.analytics.beaconUrl,
@@ -4587,7 +4716,7 @@ function setupAutoInit(pluginCreators2, availableTypes) {
     }
   }
 }
-const VERSION = "0.3.0-audio";
+const VERSION = "0.5.3-audio";
 const AVAILABLE_TYPES = ["audio", "audio-mini"];
 const pluginCreators = {
   hls: createHLSPlugin,