@scarlett-player/hls 0.5.3 → 1.0.0

package/dist/{chunk-5JANLXKE.js → chunk-OEPNMGNQ.js}

@@ -44,6 +44,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;
+}
 
 // src/event-map.ts
 var HLS_ERROR_TYPES = {
@@ -118,6 +130,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?.();
@@ -305,6 +325,7 @@ function setupVideoEventHandlers(video, api) {
 export {
   formatLevel,
   mapLevels,
+  getInitialBandwidthEstimate,
   setupHlsEventHandlers,
   setupVideoEventHandlers
 };

package/dist/index.cjs

@@ -133,6 +133,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;
+}
 
 // src/event-map.ts
 var HLS_ERROR_TYPES = {
@@ -207,6 +219,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?.();
@@ -401,6 +421,7 @@ var DEFAULT_CONFIG = {
   maxMaxBufferLength: 600,
   backBufferLength: 30,
   enableWorker: true,
+  capLevelToPlayerSize: true,
   // Error recovery settings
   maxNetworkRetries: 3,
   maxMediaRetries: 2,
@@ -470,11 +491,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,
@@ -745,7 +768,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()) {

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { H as HLSPluginConfig, I as IHLSPlugin } from './types-Df2TUpPu.cjs';
-export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-Df2TUpPu.cjs';
+import { H as HLSPluginConfig, I as IHLSPlugin } from './types-CRKmNxEW.cjs';
+export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-CRKmNxEW.cjs';
 import '@scarlett-player/core';
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HLSPluginConfig, I as IHLSPlugin } from './types-Df2TUpPu.js';
-export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-Df2TUpPu.js';
+import { H as HLSPluginConfig, I as IHLSPlugin } from './types-CRKmNxEW.js';
+export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-CRKmNxEW.js';
 import '@scarlett-player/core';
 
 /**

package/dist/index.js

@@ -1,9 +1,10 @@
 import {
   formatLevel,
+  getInitialBandwidthEstimate,
   mapLevels,
   setupHlsEventHandlers,
   setupVideoEventHandlers
-} from "./chunk-5JANLXKE.js";
+} from "./chunk-OEPNMGNQ.js";
 
 // src/hls-loader.ts
 var hlsConstructor = null;
@@ -67,6 +68,7 @@ var DEFAULT_CONFIG = {
   maxMaxBufferLength: 600,
   backBufferLength: 30,
   enableWorker: true,
+  capLevelToPlayerSize: true,
   // Error recovery settings
   maxNetworkRetries: 3,
   maxMediaRetries: 2,
@@ -136,11 +138,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,
@@ -411,7 +415,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()) {

package/dist/light.cjs

@@ -207,6 +207,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?.();

package/dist/light.d.cts

@@ -1,5 +1,5 @@
-import { H as HLSPluginConfig, I as IHLSPlugin } from './types-Df2TUpPu.cjs';
-export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-Df2TUpPu.cjs';
+import { H as HLSPluginConfig, I as IHLSPlugin } from './types-CRKmNxEW.cjs';
+export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-CRKmNxEW.cjs';
 import '@scarlett-player/core';
 
 /**

package/dist/light.d.ts

@@ -1,5 +1,5 @@
-import { H as HLSPluginConfig, I as IHLSPlugin } from './types-Df2TUpPu.js';
-export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-Df2TUpPu.js';
+import { H as HLSPluginConfig, I as IHLSPlugin } from './types-CRKmNxEW.js';
+export { a as HLSError, b as HLSLiveInfo, c as HLSQualityLevel } from './types-CRKmNxEW.js';
 import '@scarlett-player/core';
 
 /**

package/dist/light.js

@@ -3,7 +3,7 @@ import {
   mapLevels,
   setupHlsEventHandlers,
   setupVideoEventHandlers
-} from "./chunk-5JANLXKE.js";
+} from "./chunk-OEPNMGNQ.js";
 
 // src/hls-loader-light.ts
 var hlsConstructor = null;

package/dist/{types-Df2TUpPu.d.cts → types-CRKmNxEW.d.cts}

@@ -26,6 +26,10 @@ interface HLSPluginConfig {
     maxNetworkRetries?: number;
     /** Max media error retries before giving up (default: 2) */
     maxMediaRetries?: number;
+    /** Cap quality to player element dimensions (default: true) */
+    capLevelToPlayerSize?: boolean;
+    /** Override initial bandwidth estimate in bits per second */
+    initialBandwidthEstimate?: number;
     /** Base retry delay in milliseconds (default: 1000) */
     retryDelayMs?: number;
     /** Exponential backoff multiplier (default: 2) */

package/dist/{types-Df2TUpPu.d.ts → types-CRKmNxEW.d.ts}

@@ -26,6 +26,10 @@ interface HLSPluginConfig {
     maxNetworkRetries?: number;
     /** Max media error retries before giving up (default: 2) */
     maxMediaRetries?: number;
+    /** Cap quality to player element dimensions (default: true) */
+    capLevelToPlayerSize?: boolean;
+    /** Override initial bandwidth estimate in bits per second */
+    initialBandwidthEstimate?: number;
     /** Base retry delay in milliseconds (default: 1000) */
     retryDelayMs?: number;
     /** Exponential backoff multiplier (default: 2) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scarlett-player/hls",
-  "version": "0.5.3",
+  "version": "1.0.0",
   "description": "HLS Provider Plugin for Scarlett Player",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@scarlett-player/core": "^0.5.3",
+    "@scarlett-player/core": "^1.0.0",
     "hls.js": "^1.5.0"
   },
   "peerDependenciesMeta": {
@@ -37,7 +37,7 @@
     "vitest": "^1.6.0",
     "@vitest/coverage-v8": "^1.6.0",
     "jsdom": "^24.0.0",
-    "@scarlett-player/core": "0.5.3"
+    "@scarlett-player/core": "1.0.0"
   },
   "keywords": [
     "video",