@openplayerjs/hls 3.4.0 → 3.4.1

package/dist/index.js

@@ -36690,6 +36690,18 @@ class HlsMediaEngine extends BaseMediaEngine {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "seenCueIds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "onCue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         const { hlsClass, ...hlsConfig } = config;
         this.HlsClass = hlsClass ?? Hls;
         this.hlsConfig = hlsConfig;
@@ -36706,7 +36718,7 @@ class HlsMediaEngine extends BaseMediaEngine {
             const u = new URL(source.src, window.location.href);
             return u.pathname.endsWith('.m3u8');
         }
-        catch {
+        catch /* istanbul ignore next */ {
             return source.src.split('?')[0].endsWith('.m3u8');
         }
     }
@@ -36720,6 +36732,11 @@ class HlsMediaEngine extends BaseMediaEngine {
             backBufferLength: 90,
             renderTextTracksNatively: true,
             enableWebVTT: true,
+            // Surface EXT-X-DATERANGE tags and ID3 frames as metadata TextTrack cues so
+            // consumers can detect SCTE-35 splice points via the standard DOM cuechange API without
+            // any engine-specific event coupling.
+            enableDateRangeMetadataCues: true,
+            enableID3MetadataCues: true,
             ...this.hlsConfig,
         });
         this.adapter.loadSource(ctx.activeSource?.src || '');
@@ -36783,6 +36800,28 @@ class HlsMediaEngine extends BaseMediaEngine {
             ctx.core.isLive = details.live;
             ctx.events.emit('media:duration', details.totalduration);
         }, EVENT_OPTIONS);
+        this.onAdapterEvent(this.HlsClass.Events.LEVEL_UPDATED, (_, { details }) => {
+            if (!this.onCue)
+                return;
+            const dateRanges = details?.dateRanges;
+            if (!dateRanges)
+                return;
+            for (const [id, range] of Object.entries(dateRanges)) {
+                if (!range || this.seenCueIds.has(id))
+                    continue;
+                const attr = range.attr;
+                const scte35Out = attr?.['SCTE35-OUT'];
+                if (!scte35Out)
+                    continue;
+                this.seenCueIds.add(id);
+                this.onCue({
+                    id,
+                    scte35Out,
+                    plannedDuration: typeof range.plannedDuration === 'number' ? range.plannedDuration : undefined,
+                    startDate: range.startDate instanceof Date ? range.startDate : undefined,
+                });
+            }
+        }, EVENT_OPTIONS);
         this.onAdapterEvent(this.HlsClass.Events.FRAG_PARSING_METADATA, (_, data) => ctx.events.emit('playback:metadataready', { data }), EVENT_OPTIONS);
         this.onAdapterEvent(this.HlsClass.Events.SUBTITLE_TRACKS_UPDATED, () => ctx.events.emit('texttrack:listchange'), EVENT_OPTIONS);
         this.onAdapterEvent(this.HlsClass.Events.ERROR, (_, data) => {
@@ -36818,6 +36857,27 @@ class HlsMediaEngine extends BaseMediaEngine {
             ctx.events.emit('playback:error', data);
         }, EVENT_OPTIONS);
     }
+    /**
+     * Attach a separate hls.js instance to an arbitrary video element without
+     * touching the main engine state. Intended for ad creatives that are HLS
+     * streams — the caller owns the returned dispose function and must call it
+     * when the ad ends (or on any teardown path).
+     */
+    attachMedia(video, src) {
+        const hls = new this.HlsClass({ autoStartLoad: true, ...this.hlsConfig });
+        hls.loadSource(src);
+        hls.attachMedia(video);
+        return () => {
+            try {
+                hls.stopLoad();
+            }
+            catch {
+                /* ignore */
+            }
+            hls.detachMedia();
+            hls.destroy();
+        };
+    }
     detach() {
         this.unbindCommands();
         this.unbindMediaEvents();
@@ -36826,6 +36886,7 @@ class HlsMediaEngine extends BaseMediaEngine {
         this.adapter?.destroy();
         this.adapter = null;
         this.startedLoad = false;
+        this.seenCueIds.clear();
     }
     onAdapterEvent(event, handler, options) {
         if (!this.adapter)