@scarlett-player/hls 1.7.0 → 1.8.1

package/README.md

@@ -11,16 +11,14 @@ npm install @scarlett-player/core @scarlett-player/hls
 ## Usage
 
 ```typescript
-import { ScarlettPlayer } from '@scarlett-player/core';
+import { createPlayer } from '@scarlett-player/core';
 import { createHLSPlugin } from '@scarlett-player/hls';
 
-const player = new ScarlettPlayer({
+const player = await createPlayer({
   container: document.getElementById('player'),
+  src: 'https://example.com/video.m3u8',
   plugins: [createHLSPlugin()],
 });
-
-await player.init();
-await player.load('https://example.com/video.m3u8');
 ```
 
 ## Features
@@ -44,6 +42,8 @@ All options are optional; defaults shown.
 
 ```typescript
 createHLSPlugin({
+  debug: false,                 // hls.js debug logging
+
   // Buffering
   maxBufferLength: 30,          // Forward buffer target (seconds)
   maxMaxBufferLength: 600,      // Hard forward buffer cap (seconds)
@@ -96,15 +96,15 @@ import { createHLSPlugin } from '@scarlett-player/hls/light';
 ## Quality Selection
 
 ```typescript
-// Get available qualities
+// Get available qualities (HLSQualityLevel[], empty on native Safari HLS)
 const qualities = player.getQualities();
-// [{ index: 0, height: 1080, bitrate: 5000000 }, ...]
+// [{ index: 0, width: 1920, height: 1080, bitrate: 5000000, label: '1080p', codec: 'avc1,mp4a' }, ...]
 
-// Set quality (use -1 for auto)
-player.setQuality(0);  // Highest quality
+// Set quality by index (use -1 for auto)
+player.setQuality(0);
 player.setQuality(-1); // Auto/ABR
 
-// Get current quality
+// Get current quality index (-1 while auto)
 const current = player.getCurrentQuality();
 ```
 

package/dist/{chunk-NU6WD6KW.js → chunk-VD46AQJB.js}

@@ -222,8 +222,14 @@ function setupVideoEventHandlers(video, api) {
     video.addEventListener(event, handler);
     handlers.push({ event, handler });
   };
+  const syncEndedFromElement = () => {
+    if (video.ended || !api.getState("ended")) return;
+    api.setState("ended", false);
+    api.setState("playbackState", video.paused ? "paused" : "playing");
+  };
   addHandler("play", () => {
     api.setState("paused", false);
+    syncEndedFromElement();
   });
   addHandler("playing", () => {
     api.setState("playing", true);
@@ -231,6 +237,7 @@ function setupVideoEventHandlers(video, api) {
     api.setState("waiting", false);
     api.setState("buffering", false);
     api.setState("playbackState", "playing");
+    syncEndedFromElement();
   });
   addHandler("pause", () => {
     api.setState("playing", false);
@@ -285,6 +292,7 @@ function setupVideoEventHandlers(video, api) {
   });
   addHandler("seeking", () => {
     api.setState("seeking", true);
+    syncEndedFromElement();
   });
   addHandler("seeked", () => {
     api.setState("seeking", false);
@@ -392,6 +400,9 @@ function createValidatingPlaylistLoader(Hls) {
   };
 }
 
+// src/version.ts
+var PKG_VERSION = true ? "1.8.1" : "0.0.0-dev";
+
 // src/create-hls-plugin.ts
 var DEFAULT_CONFIG = {
   debug: false,
@@ -450,6 +461,10 @@ function createHLSPluginWith(loader, variant, config) {
   let onlineListener = null;
   let reconnectTriggerError = null;
   let reconnectExhausted = false;
+  const applyPoster = () => {
+    if (!video) return;
+    video.poster = api?.getState("poster") || "";
+  };
   const getOrCreateVideo = () => {
     if (video) return video;
     const existing = api?.container.querySelector("video");
@@ -462,10 +477,7 @@ function createHLSPluginWith(loader, variant, config) {
     video.preload = "metadata";
     video.controls = false;
     video.playsInline = true;
-    const poster = api?.getState("poster");
-    if (poster) {
-      video.poster = poster;
-    }
+    applyPoster();
     api?.container.appendChild(video);
     return video;
   };
@@ -1008,7 +1020,7 @@ function createHLSPluginWith(loader, variant, config) {
   const plugin = {
     id: "hls-provider",
     name: variant.name,
-    version: "1.0.0",
+    version: PKG_VERSION,
     type: "provider",
     description: variant.description,
     canPlay(src) {
@@ -1099,6 +1111,9 @@ function createHLSPluginWith(loader, variant, config) {
         };
         window.addEventListener("online", onlineListener);
       }
+      const unsubPoster = api.subscribeToState((event) => {
+        if (event.key === "poster") applyPoster();
+      });
       api.onDestroy(() => {
         unsubPlay();
         unsubPause();
@@ -1107,6 +1122,7 @@ function createHLSPluginWith(loader, variant, config) {
         unsubMute();
         unsubRate();
         unsubQuality();
+        unsubPoster();
       });
     },
     async destroy() {
@@ -1132,6 +1148,7 @@ function createHLSPluginWith(loader, variant, config) {
       hasPlayedContent = false;
       cleanup(new Error("HLS load cancelled: superseded by a new load"));
       currentSrc = src;
+      applyPoster();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
       if (api.getState("airplayActive") && loader.supportsNativeHLS()) {

package/dist/index.cjs

@@ -317,8 +317,14 @@ function setupVideoEventHandlers(video, api) {
     video.addEventListener(event, handler);
     handlers.push({ event, handler });
   };
+  const syncEndedFromElement = () => {
+    if (video.ended || !api.getState("ended")) return;
+    api.setState("ended", false);
+    api.setState("playbackState", video.paused ? "paused" : "playing");
+  };
   addHandler("play", () => {
     api.setState("paused", false);
+    syncEndedFromElement();
   });
   addHandler("playing", () => {
     api.setState("playing", true);
@@ -326,6 +332,7 @@ function setupVideoEventHandlers(video, api) {
     api.setState("waiting", false);
     api.setState("buffering", false);
     api.setState("playbackState", "playing");
+    syncEndedFromElement();
   });
   addHandler("pause", () => {
     api.setState("playing", false);
@@ -380,6 +387,7 @@ function setupVideoEventHandlers(video, api) {
   });
   addHandler("seeking", () => {
     api.setState("seeking", true);
+    syncEndedFromElement();
   });
   addHandler("seeked", () => {
     api.setState("seeking", false);
@@ -498,6 +506,9 @@ function sanitizeUrl(url) {
   }
 }
 
+// src/version.ts
+var PKG_VERSION = true ? "1.8.1" : "0.0.0-dev";
+
 // src/create-hls-plugin.ts
 var DEFAULT_CONFIG = {
   debug: false,
@@ -556,6 +567,10 @@ function createHLSPluginWith(loader, variant, config) {
   let onlineListener = null;
   let reconnectTriggerError = null;
   let reconnectExhausted = false;
+  const applyPoster = () => {
+    if (!video) return;
+    video.poster = api?.getState("poster") || "";
+  };
   const getOrCreateVideo = () => {
     if (video) return video;
     const existing = api?.container.querySelector("video");
@@ -568,10 +583,7 @@ function createHLSPluginWith(loader, variant, config) {
     video.preload = "metadata";
     video.controls = false;
     video.playsInline = true;
-    const poster = api?.getState("poster");
-    if (poster) {
-      video.poster = poster;
-    }
+    applyPoster();
     api?.container.appendChild(video);
     return video;
   };
@@ -1114,7 +1126,7 @@ function createHLSPluginWith(loader, variant, config) {
   const plugin = {
     id: "hls-provider",
     name: variant.name,
-    version: "1.0.0",
+    version: PKG_VERSION,
     type: "provider",
     description: variant.description,
     canPlay(src) {
@@ -1205,6 +1217,9 @@ function createHLSPluginWith(loader, variant, config) {
         };
         window.addEventListener("online", onlineListener);
       }
+      const unsubPoster = api.subscribeToState((event) => {
+        if (event.key === "poster") applyPoster();
+      });
       api.onDestroy(() => {
         unsubPlay();
         unsubPause();
@@ -1213,6 +1228,7 @@ function createHLSPluginWith(loader, variant, config) {
         unsubMute();
         unsubRate();
         unsubQuality();
+        unsubPoster();
       });
     },
     async destroy() {
@@ -1238,6 +1254,7 @@ function createHLSPluginWith(loader, variant, config) {
       hasPlayedContent = false;
       cleanup(new Error("HLS load cancelled: superseded by a new load"));
       currentSrc = src;
+      applyPoster();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
       if (api.getState("airplayActive") && loader.supportsNativeHLS()) {

package/dist/index.d.cts

@@ -20,9 +20,10 @@ import '@scarlett-player/core';
  *
  * @example
  * ```ts
+ * import { createPlayer } from '@scarlett-player/core';
  * import { createHLSPlugin } from '@scarlett-player/hls';
  *
- * const player = new ScarlettPlayer({
+ * const player = await createPlayer({
  *   container: document.getElementById('player'),
  *   plugins: [createHLSPlugin()],
  * });

package/dist/index.d.ts

@@ -20,9 +20,10 @@ import '@scarlett-player/core';
  *
  * @example
  * ```ts
+ * import { createPlayer } from '@scarlett-player/core';
  * import { createHLSPlugin } from '@scarlett-player/hls';
  *
- * const player = new ScarlettPlayer({
+ * const player = await createPlayer({
  *   container: document.getElementById('player'),
  *   plugins: [createHLSPlugin()],
  * });

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   __export,
   createHLSPluginWith,
   sanitizeUrl
-} from "./chunk-NU6WD6KW.js";
+} from "./chunk-VD46AQJB.js";
 
 // src/hls-loader.ts
 var hls_loader_exports = {};

package/dist/light.cjs

@@ -317,8 +317,14 @@ function setupVideoEventHandlers(video, api) {
     video.addEventListener(event, handler);
     handlers.push({ event, handler });
   };
+  const syncEndedFromElement = () => {
+    if (video.ended || !api.getState("ended")) return;
+    api.setState("ended", false);
+    api.setState("playbackState", video.paused ? "paused" : "playing");
+  };
   addHandler("play", () => {
     api.setState("paused", false);
+    syncEndedFromElement();
   });
   addHandler("playing", () => {
     api.setState("playing", true);
@@ -326,6 +332,7 @@ function setupVideoEventHandlers(video, api) {
     api.setState("waiting", false);
     api.setState("buffering", false);
     api.setState("playbackState", "playing");
+    syncEndedFromElement();
   });
   addHandler("pause", () => {
     api.setState("playing", false);
@@ -380,6 +387,7 @@ function setupVideoEventHandlers(video, api) {
   });
   addHandler("seeking", () => {
     api.setState("seeking", true);
+    syncEndedFromElement();
   });
   addHandler("seeked", () => {
     api.setState("seeking", false);
@@ -498,6 +506,9 @@ function sanitizeUrl(url) {
   }
 }
 
+// src/version.ts
+var PKG_VERSION = true ? "1.8.1" : "0.0.0-dev";
+
 // src/create-hls-plugin.ts
 var DEFAULT_CONFIG = {
   debug: false,
@@ -556,6 +567,10 @@ function createHLSPluginWith(loader, variant, config) {
   let onlineListener = null;
   let reconnectTriggerError = null;
   let reconnectExhausted = false;
+  const applyPoster = () => {
+    if (!video) return;
+    video.poster = api?.getState("poster") || "";
+  };
   const getOrCreateVideo = () => {
     if (video) return video;
     const existing = api?.container.querySelector("video");
@@ -568,10 +583,7 @@ function createHLSPluginWith(loader, variant, config) {
     video.preload = "metadata";
     video.controls = false;
     video.playsInline = true;
-    const poster = api?.getState("poster");
-    if (poster) {
-      video.poster = poster;
-    }
+    applyPoster();
     api?.container.appendChild(video);
     return video;
   };
@@ -1114,7 +1126,7 @@ function createHLSPluginWith(loader, variant, config) {
   const plugin = {
     id: "hls-provider",
     name: variant.name,
-    version: "1.0.0",
+    version: PKG_VERSION,
     type: "provider",
     description: variant.description,
     canPlay(src) {
@@ -1205,6 +1217,9 @@ function createHLSPluginWith(loader, variant, config) {
         };
         window.addEventListener("online", onlineListener);
       }
+      const unsubPoster = api.subscribeToState((event) => {
+        if (event.key === "poster") applyPoster();
+      });
       api.onDestroy(() => {
         unsubPlay();
         unsubPause();
@@ -1213,6 +1228,7 @@ function createHLSPluginWith(loader, variant, config) {
         unsubMute();
         unsubRate();
         unsubQuality();
+        unsubPoster();
       });
     },
     async destroy() {
@@ -1238,6 +1254,7 @@ function createHLSPluginWith(loader, variant, config) {
       hasPlayedContent = false;
       cleanup(new Error("HLS load cancelled: superseded by a new load"));
       currentSrc = src;
+      applyPoster();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
       if (api.getState("airplayActive") && loader.supportsNativeHLS()) {

package/dist/light.js

@@ -2,7 +2,7 @@ import {
   __export,
   createHLSPluginWith,
   sanitizeUrl
-} from "./chunk-NU6WD6KW.js";
+} from "./chunk-VD46AQJB.js";
 
 // src/hls-loader-light.ts
 var hls_loader_light_exports = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scarlett-player/hls",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "HLS Provider Plugin for Scarlett Player",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,8 +22,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@scarlett-player/core": "^1.0.3",
-    "hls.js": "^1.5.0"
+    "@scarlett-player/core": "^1.8.0",
+    "hls.js": "^1.6.0"
   },
   "peerDependenciesMeta": {
     "hls.js": {
@@ -37,7 +37,7 @@
     "vitest": "^1.6.0",
     "@vitest/coverage-v8": "^1.6.0",
     "jsdom": "^24.0.0",
-    "@scarlett-player/core": "1.7.0"
+    "@scarlett-player/core": "1.8.1"
   },
   "keywords": [
     "video",
@@ -58,10 +58,11 @@
   },
   "homepage": "https://scarlettplayer.com",
   "scripts": {
-    "build": "tsup src/index.ts src/light.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts src/light.ts --format esm,cjs --dts --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "test": "vitest --run",
     "test:watch": "vitest",
-    "test:coverage": "vitest --coverage"
+    "test:coverage": "vitest --coverage",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json"
   }
 }