'use strict'; (function () { const VIDEO_TEXT_TRACK_SETTINGS_KEY = 'vjs-text-track-settings'; const VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW = JSON.stringify({ backgroundOpacity: '0', edgeStyle: 'uniform', }); const SUBTITLE_LOG_BATCH_MAX_ITEMS = 12; const SUBTITLE_LOG_FLUSH_DELAY_MS = 500; const IMAGE_SUBTITLE_LOOKAHEAD_SECONDS_DEFAULT = 15; const IMAGE_SUBTITLE_LOOKAHEAD_SECONDS_MAX = 30; const IMAGE_SUBTITLE_INITIAL_PREFETCH_SECONDS_DEFAULT = 60; const IMAGE_SUBTITLE_INITIAL_PREFETCH_SECONDS_MAX = 120; const IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_DEFAULT = 0.5; const IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MIN = 0.25; const IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MAX = 30; const IMAGE_SUBTITLE_TIME_MATCH_EPSILON_SECONDS = 0.02; const IMAGE_SUBTITLE_CACHE_MISS_FALLBACK_INTERVAL_MS_DEFAULT = 2000; const IMAGE_SUBTITLE_CURRENT_REQUEST_TIMEOUT_MS_DEFAULT = 4000; const IMAGE_SUBTITLE_PREFETCH_REQUEST_TIMEOUT_MS_DEFAULT = 4000; const IMAGE_SUBTITLE_PREFETCH_REQUEST_INTERVAL_MS_DEFAULT = 0; const IMAGE_SUBTITLE_PERIODIC_RESYNC_INTERVAL_MS_DEFAULT = 10000; const VIDEO_STREAM_CACHE_SW_URL = '/stream-cache-sw.js'; const VIDEO_STREAM_CACHE_NAME = 'filemanager-stream-cache-v1'; const VIDEO_STREAM_AHEAD_PREFETCH_POLL_MS_DEFAULT = 750; const VIDEO_STREAM_SEGMENT_DURATION_FALLBACK_SECONDS = 4; function formatClockTime (value) { const seconds = Number(value); if (!Number.isFinite(seconds) || seconds < 0) return '00:00'; const total = Math.floor(seconds); const hours = Math.floor(total / 3600); const minutes = Math.floor((total % 3600) / 60); const remainingSeconds = total % 60; if (hours > 0) { return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(remainingSeconds).padStart(2, '0')}`; } return `${String(minutes).padStart(2, '0')}:${String(remainingSeconds).padStart(2, '0')}`; } function roundLogNumber (value, digits = 3) { const numeric = Number(value); if (!Number.isFinite(numeric)) return null; return Number(numeric.toFixed(digits)); } function parseHeaderInt (res, name) { if (!res || !res.headers || typeof res.headers.get !== 'function') return null; const value = Number.parseInt(String(res.headers.get(name) || ''), 10); return Number.isFinite(value) ? value : null; } function parseHeaderFloat (res, name) { if (!res || !res.headers || typeof res.headers.get !== 'function') return null; const value = Number.parseFloat(String(res.headers.get(name) || '')); return Number.isFinite(value) ? value : null; } function diffMilliseconds (later, earlier) { if (!Number.isFinite(later) || !Number.isFinite(earlier)) return null; return Math.round(later - earlier); } function diffSeconds (later, earlier) { if (!Number.isFinite(later) || !Number.isFinite(earlier)) return null; return roundLogNumber(later - earlier, 3); } function base64ToBlob (base64, contentType = 'image/png') { const raw = String(base64 || '').trim(); if (!raw) return null; try { const decoded = window.atob(raw); const bytes = new Uint8Array(decoded.length); for (let index = 0; index < decoded.length; index++) { bytes[index] = decoded.charCodeAt(index); } return new Blob([bytes], { type: String(contentType || '').trim() || 'image/png' }); } catch { return null; } } function waitForImagePresentation (windowRef, imageEl) { return new Promise((resolve) => { let settled = false; let fallbackTimer = null; const raf = typeof windowRef.requestAnimationFrame === 'function' ? windowRef.requestAnimationFrame.bind(windowRef) : (fn) => windowRef.setTimeout(fn, 0); const cleanup = () => { imageEl.removeEventListener('load', onLoad); imageEl.removeEventListener('error', onError); if (fallbackTimer !== null) windowRef.clearTimeout(fallbackTimer); }; const finish = () => { if (settled) return; settled = true; cleanup(); raf(() => resolve(Date.now())); }; const onLoad = () => finish(); const onError = () => finish(); imageEl.addEventListener('load', onLoad); imageEl.addEventListener('error', onError); fallbackTimer = windowRef.setTimeout(finish, 250); if (imageEl.complete && imageEl.currentSrc) { finish(); } }); } function normaliseTrackName (name) { return String(name || '').trim().toLowerCase(); } function getTrackName (track) { if (!track || typeof track !== 'object') return ''; const label = String(track.label || '').trim(); if (label) return label; const name = String(track.name || '').trim(); if (name) return name; const language = String(track.language || '').trim(); if (language) return language; const id = String(track.id || '').trim(); if (id) return id; return ''; } function trackListToArray (trackList) { if (!trackList || typeof trackList.length !== 'number') return []; const out = []; for (let i = 0; i < trackList.length; i++) { const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null); if (track) out.push(track); } return out; } function subtitleTracksFromPlayer (player) { if (!player || typeof player.textTracks !== 'function') return []; return trackListToArray(player.textTracks()).filter((track) => { const kind = String(track.kind || '').toLowerCase(); return kind === 'subtitles' || kind === 'captions'; }); } function audioTracksFromPlayer (player) { if (!player || typeof player.audioTracks !== 'function') return []; return trackListToArray(player.audioTracks()); } function applySavedSubtitleTrack (player, savedName) { if (typeof savedName !== 'string') return; const tracks = subtitleTracksFromPlayer(player); if (!tracks.length) return; const wanted = normaliseTrackName(savedName); if (!wanted) { for (const track of tracks) track.mode = 'disabled'; return; } const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted); if (!match) return; for (const track of tracks) { track.mode = track === match ? 'showing' : 'disabled'; } } function applySavedAudioTrack (player, savedName) { if (typeof savedName !== 'string') return; const tracks = audioTracksFromPlayer(player); if (!tracks.length) return; const wanted = normaliseTrackName(savedName); if (!wanted) return; const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted); if (!match) return; for (const track of tracks) { track.enabled = track === match; } } function getSelectedSubtitleTrackName (player) { const tracks = subtitleTracksFromPlayer(player); if (!tracks.length) return null; const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing'); return active ? getTrackName(active) : ''; } function getSelectedAudioTrackName (player) { const tracks = audioTracksFromPlayer(player); if (!tracks.length) return null; const active = tracks.find((track) => !!track.enabled); return active ? getTrackName(active) : ''; } function bindTrackPrefs (player, prefs, savePrefs) { const save = typeof savePrefs === 'function' ? savePrefs : (() => { }); const applySavedTracks = () => { applySavedSubtitleTrack(player, prefs.subtitleTrackName); applySavedAudioTrack(player, prefs.audioTrackName); }; const captureSelectedTracks = () => { const subtitleTrackName = getSelectedSubtitleTrackName(player); const audioTrackName = getSelectedAudioTrackName(player); const patch = {}; if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName; if (audioTrackName !== null) patch.audioTrackName = audioTrackName; if (Object.keys(patch).length) save(patch); }; const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null; const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null; const onTrackListChange = () => captureSelectedTracks(); if (textTrackList && typeof textTrackList.addEventListener === 'function') { textTrackList.addEventListener('change', onTrackListChange); } if (audioTrackList && typeof audioTrackList.addEventListener === 'function') { audioTrackList.addEventListener('change', onTrackListChange); } return { applySavedTracks, captureSelectedTracks, detach: () => { if (textTrackList && typeof textTrackList.removeEventListener === 'function') { textTrackList.removeEventListener('change', onTrackListChange); } if (audioTrackList && typeof audioTrackList.removeEventListener === 'function') { audioTrackList.removeEventListener('change', onTrackListChange); } }, }; } function bindImageSubtitleOverlay (player, videojs, prefs, session, opts = {}) { const imageTracks = Array.isArray(session.imageSubtitleTracks) ? session.imageSubtitleTracks.map((track) => ({ label: String(track.label || '').trim() || `Subtitle ${Number(track.streamIndex || 0) + 1}`, language: String(track.language || '').trim(), isDefault: !!track.default, streamIndex: Number(track.streamIndex), })).filter((track) => Number.isInteger(track.streamIndex) && track.streamIndex >= 0) : []; if (!imageTracks.length) return null; const savePrefs = typeof opts.savePrefs === 'function' ? opts.savePrefs : (() => { }); const buildFrameRequest = typeof opts.buildFrameRequest === 'function' ? opts.buildFrameRequest : null; const buildPrefetchRequest = typeof opts.buildPrefetchRequest === 'function' ? opts.buildPrefetchRequest : buildFrameRequest; const prefetchUsesRangeRequests = !!(buildFrameRequest && buildPrefetchRequest && buildPrefetchRequest !== buildFrameRequest); const notifyError = typeof opts.onError === 'function' ? opts.onError : (() => { }); const sendSubtitleLogBatch = typeof opts.sendSubtitleLogBatch === 'function' ? opts.sendSubtitleLogBatch : null; const requestedLookaheadSeconds = Number(opts.lookaheadSeconds); const lookaheadSeconds = Number.isFinite(requestedLookaheadSeconds) ? Math.max(0, Math.min(IMAGE_SUBTITLE_LOOKAHEAD_SECONDS_MAX, requestedLookaheadSeconds)) : IMAGE_SUBTITLE_LOOKAHEAD_SECONDS_DEFAULT; const requestedCurrentRequestTimeoutMs = Number(opts.currentRequestTimeoutMs); const currentRequestTimeoutMs = Number.isFinite(requestedCurrentRequestTimeoutMs) ? Math.max(250, requestedCurrentRequestTimeoutMs) : IMAGE_SUBTITLE_CURRENT_REQUEST_TIMEOUT_MS_DEFAULT; const requestedInitialPrefetchSeconds = Number(opts.initialPrefetchSeconds); const initialPrefetchSeconds = Number.isFinite(requestedInitialPrefetchSeconds) ? Math.max(0, Math.min(IMAGE_SUBTITLE_INITIAL_PREFETCH_SECONDS_MAX, requestedInitialPrefetchSeconds)) : IMAGE_SUBTITLE_INITIAL_PREFETCH_SECONDS_DEFAULT; const requestedPrefetchRequestTimeoutMs = Number(opts.prefetchRequestTimeoutMs); const prefetchRequestTimeoutMs = Number.isFinite(requestedPrefetchRequestTimeoutMs) ? Math.max(250, requestedPrefetchRequestTimeoutMs) : IMAGE_SUBTITLE_PREFETCH_REQUEST_TIMEOUT_MS_DEFAULT; const requestedPrefetchRequestIntervalMs = Number(opts.prefetchRequestIntervalMs); const prefetchRequestIntervalMs = Number.isFinite(requestedPrefetchRequestIntervalMs) ? Math.max(0, requestedPrefetchRequestIntervalMs) : IMAGE_SUBTITLE_PREFETCH_REQUEST_INTERVAL_MS_DEFAULT; const requestedPeriodicResyncIntervalMs = Number(opts.periodicResyncIntervalMs); const periodicResyncIntervalMs = Number.isFinite(requestedPeriodicResyncIntervalMs) ? Math.max(100, requestedPeriodicResyncIntervalMs) : IMAGE_SUBTITLE_PERIODIC_RESYNC_INTERVAL_MS_DEFAULT; const requestedPrefetchStepSeconds = Number(opts.prefetchStepSeconds); const prefetchStepSecondsFixed = Number.isFinite(requestedPrefetchStepSeconds) ? Math.max(IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MIN, Math.min(IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MAX, requestedPrefetchStepSeconds)) : null; const prefetchAdaptiveStepEnabled = opts.prefetchAdaptiveStepEnabled === true; const prefetchAdaptivePacingEnabled = opts.prefetchAdaptivePacingEnabled === true; const requestedPrefetchStepSecondsMin = Number(opts.prefetchStepSecondsMin); const requestedPrefetchStepSecondsMax = Number(opts.prefetchStepSecondsMax); const prefetchStepSecondsMin = Number.isFinite(requestedPrefetchStepSecondsMin) ? Math.max(IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MIN, Math.min(IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MAX, requestedPrefetchStepSecondsMin)) : (prefetchStepSecondsFixed || IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_DEFAULT); const prefetchStepSecondsMaxRaw = Number.isFinite(requestedPrefetchStepSecondsMax) ? Math.max(IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MIN, Math.min(IMAGE_SUBTITLE_PREFETCH_STEP_SECONDS_MAX, requestedPrefetchStepSecondsMax)) : (prefetchStepSecondsFixed || prefetchStepSecondsMin); const prefetchStepSecondsMax = Math.max(prefetchStepSecondsMin, prefetchStepSecondsMaxRaw); const requestedCacheMissFallbackIntervalMs = Number(opts.cacheMissFallbackIntervalMs); const cacheMissFallbackIntervalMs = Number.isFinite(requestedCacheMissFallbackIntervalMs) ? Math.max(500, requestedCacheMissFallbackIntervalMs) : IMAGE_SUBTITLE_CACHE_MISS_FALLBACK_INTERVAL_MS_DEFAULT; const cacheMissFallbackEnabled = opts.cacheMissFallbackEnabled !== false; const currentFetchEnabled = opts.currentFetchEnabled !== false; const logToConsole = opts.logToConsole !== false; if (!buildFrameRequest) return null; const trackByStreamIndex = new Map(imageTracks.map((track) => [track.streamIndex, track])); let selectedStreamIndex = null; let menuOpen = false; let activeBucket = -1; let activeObjectUrl = null; let overlayEl = null; let overlayImgEl = null; let overlayImgElSecondary = null; let primaryBufferIndex = 0; let primaryFrameKey = null; let secondaryFrameKey = null; let menuEl = null; let buttonEl = null; let trackDisabled = false; let failureNotified = false; let lifecycleToken = 0; let currentFrameToken = 0; let currentFrameAbortController = null; let prefetchWorkerToken = 0; let prefetchAbortController = null; let prefetchPromise = null; let prefetchTargetTimeSeconds = -1; let prefetchedThroughTimeSeconds = -1; let queuedCurrentRefresh = false; let queuedCurrentRefreshForce = false; let currentFramePromise = null; let seekMarkerContainerEl = null; let seekMarkerRequestedEl = null; let seekMarkerReceivedEl = null; let lastRequestedCaptionStartTimeSeconds = null; let lastReceivedCaptionStartTimeSeconds = null; let subtitleLogSequence = 0; let subtitleLogQueue = []; let subtitleLogFlushTimer = null; let lastCacheMissFallbackAtMs = 0; let playbackClockSyncHandle = null; let cueBoundarySyncHandle = null; let periodicResyncHandle = null; let periodicResyncPending = false; const cachedSubtitleFrames = new Map(); const requestFrame = (fn) => { const playerEl = player.el && player.el(); const videoEl = playerEl ? playerEl.querySelector('video') : null; if (videoEl && typeof videoEl.requestVideoFrameCallback === 'function') { const id = videoEl.requestVideoFrameCallback((_, metadata) => { fn(metadata); }); return { kind: 'video-frame', id, videoEl }; } if (typeof window.requestAnimationFrame === 'function') { return { kind: 'raf', id: window.requestAnimationFrame(fn) }; } return { kind: 'timeout', id: window.setTimeout(fn, 16) }; }; const cancelFrameRequest = (handle) => { if (!handle || !Number.isFinite(Number(handle.id))) return; if (handle.kind === 'video-frame' && handle.videoEl && typeof handle.videoEl.cancelVideoFrameCallback === 'function') { handle.videoEl.cancelVideoFrameCallback(handle.id); return; } if (handle.kind === 'raf' && typeof window.cancelAnimationFrame === 'function') { window.cancelAnimationFrame(handle.id); return; } window.clearTimeout(handle.id); }; const flushSubtitleLogs = () => { if (!sendSubtitleLogBatch || !subtitleLogQueue.length) return; if (subtitleLogFlushTimer) { window.clearTimeout(subtitleLogFlushTimer); subtitleLogFlushTimer = null; } const batch = subtitleLogQueue; subtitleLogQueue = []; Promise.resolve(sendSubtitleLogBatch(batch)).catch(() => { // Keep subtitle diagnostics best-effort only. }); }; const scheduleSubtitleLogFlush = () => { if (!sendSubtitleLogBatch || !subtitleLogQueue.length) return; if (subtitleLogQueue.length >= SUBTITLE_LOG_BATCH_MAX_ITEMS) { flushSubtitleLogs(); return; } if (subtitleLogFlushTimer) return; subtitleLogFlushTimer = window.setTimeout(() => { subtitleLogFlushTimer = null; flushSubtitleLogs(); }, SUBTITLE_LOG_FLUSH_DELAY_MS); }; const logSubtitleEvent = (eventType, details = {}) => { const entry = { seq: ++subtitleLogSequence, loggedAtMs: Date.now(), eventType, sessionId: String(session.sessionId || '').trim() || null, streamIndex: Number.isInteger(selectedStreamIndex) ? selectedStreamIndex : null, playerTimeSeconds: roundLogNumber(player.currentTime()), ...details, }; if (logToConsole) { try { console.log('[subtitle-log]', entry); } catch { // Ignore console availability issues. } } if (!sendSubtitleLogBatch) return; subtitleLogQueue.push(entry); scheduleSubtitleLogFlush(); }; const createAbortController = () => { if (typeof AbortController !== 'function') return null; return new AbortController(); }; const abortController = (controller) => { if (!controller || typeof controller.abort !== 'function') return; try { controller.abort(); } catch { // Ignore abort races during teardown. } }; const isAbortError = (error) => { return !!(error && typeof error === 'object' && error.name === 'AbortError'); }; const armRequestTimeout = (controller, timeoutMs, onTimeout) => { if (!controller || !Number.isFinite(timeoutMs) || timeoutMs <= 0) return null; return window.setTimeout(() => { if (typeof onTimeout === 'function') onTimeout(); abortController(controller); }, timeoutMs); }; const clearRequestTimeout = (timeoutId) => { if (timeoutId === null || timeoutId === undefined) return; window.clearTimeout(timeoutId); }; const cancelCurrentFrameRequest = () => { currentFrameToken++; abortController(currentFrameAbortController); currentFrameAbortController = null; }; const cancelPrefetchRequests = ({ resetProgress = false } = {}) => { prefetchWorkerToken++; abortController(prefetchAbortController); prefetchAbortController = null; prefetchPromise = null; if (resetProgress) { prefetchTargetTimeSeconds = -1; prefetchedThroughTimeSeconds = -1; } }; const resetRequestState = () => { lifecycleToken++; cancelCurrentFrameRequest(); cancelPrefetchRequests({ resetProgress: true }); }; const stopPlaybackClockSync = () => { if (!playbackClockSyncHandle) return; cancelFrameRequest(playbackClockSyncHandle); playbackClockSyncHandle = null; stopCueBoundarySync(); stopPeriodicResync(); }; const stopCueBoundarySync = () => { if (!cueBoundarySyncHandle) return; window.clearTimeout(cueBoundarySyncHandle); cueBoundarySyncHandle = null; }; const stopPeriodicResync = () => { if (periodicResyncHandle) { window.clearInterval(periodicResyncHandle); periodicResyncHandle = null; } periodicResyncPending = false; }; const closeObjectUrl = () => { activeObjectUrl = null; primaryBufferIndex = 0; primaryFrameKey = null; secondaryFrameKey = null; }; const hideOverlay = () => { if (overlayEl) overlayEl.style.display = 'none'; if (overlayImgEl) { overlayImgEl.style.display = 'none'; overlayImgEl.removeAttribute('src'); } if (overlayImgElSecondary) { overlayImgElSecondary.style.display = 'none'; overlayImgElSecondary.removeAttribute('src'); } closeObjectUrl(); }; const getPlaybackRate = () => { const rate = Number(player.playbackRate && player.playbackRate()); return Number.isFinite(rate) && rate > 0 ? rate : 1; }; const revokeCachedFrameUrls = () => { for (const frame of cachedSubtitleFrames.values()) { if (!frame || !frame.objectUrl) continue; try { URL.revokeObjectURL(frame.objectUrl); } catch { // Ignore object URL cleanup races. } } cachedSubtitleFrames.clear(); }; const parseFrameMetadata = (res, fallbackStartTimeSeconds, fallbackSpanSeconds = prefetchStepSecondsMin) => { const rawStart = parseHeaderFloat(res, 'X-Subtitle-Frame-Start-Time'); const startTimeSeconds = Number.isFinite(rawStart) && rawStart >= 0 ? rawStart : (Number.isFinite(fallbackStartTimeSeconds) && fallbackStartTimeSeconds >= 0 ? fallbackStartTimeSeconds : null); const rawEnd = parseHeaderFloat(res, 'X-Subtitle-Frame-End-Time'); const endTimeSeconds = Number.isFinite(rawEnd) ? rawEnd : (Number.isFinite(startTimeSeconds) ? startTimeSeconds + fallbackSpanSeconds : null); const frameWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Width') || ''), 10); const frameHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Height') || ''), 10); const canvasWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Width') || ''), 10); const canvasHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Height') || ''), 10); return { startTimeSeconds, endTimeSeconds, frameWidth, frameHeight, canvasWidth, canvasHeight, }; }; const cacheFrameKey = (streamIndex, startTimeSeconds, endTimeSeconds) => { const startPart = Number.isFinite(startTimeSeconds) ? startTimeSeconds.toFixed(6) : 'none'; const endPart = Number.isFinite(endTimeSeconds) ? endTimeSeconds.toFixed(6) : 'none'; return `${streamIndex}|${startPart}|${endPart}`; }; const cacheSubtitleFrame = ({ streamIndex, blob, metadata }) => { if (!Number.isInteger(streamIndex) || streamIndex < 0) return null; if (!blob || typeof blob.size !== 'number' || blob.size <= 0) return null; const startTimeSeconds = Number.isFinite(metadata && metadata.startTimeSeconds) ? metadata.startTimeSeconds : null; const endTimeSeconds = Number.isFinite(metadata && metadata.endTimeSeconds) ? metadata.endTimeSeconds : (Number.isFinite(startTimeSeconds) ? startTimeSeconds + prefetchStepSecondsMin : null); if (!Number.isFinite(startTimeSeconds) || !Number.isFinite(endTimeSeconds) || endTimeSeconds <= startTimeSeconds) { return null; } const key = cacheFrameKey(streamIndex, startTimeSeconds, endTimeSeconds); const objectUrl = URL.createObjectURL(blob); const previous = cachedSubtitleFrames.get(key); if (previous && previous.objectUrl) { try { URL.revokeObjectURL(previous.objectUrl); } catch { // Ignore object URL cleanup races. } } const entry = { key, streamIndex, startTimeSeconds, endTimeSeconds, objectUrl, frameWidth: Number(metadata && metadata.frameWidth), frameHeight: Number(metadata && metadata.frameHeight), canvasWidth: Number(metadata && metadata.canvasWidth), canvasHeight: Number(metadata && metadata.canvasHeight), }; cachedSubtitleFrames.set(key, entry); return entry; }; const findCachedFrameForTime = (streamIndex, currentTime) => { if (!Number.isInteger(streamIndex) || streamIndex < 0) return null; if (!Number.isFinite(currentTime) || currentTime < 0) return null; let best = null; for (const frame of cachedSubtitleFrames.values()) { if (!frame || frame.streamIndex !== streamIndex) continue; if (!Number.isFinite(frame.startTimeSeconds) || !Number.isFinite(frame.endTimeSeconds)) continue; const startsAt = frame.startTimeSeconds - IMAGE_SUBTITLE_TIME_MATCH_EPSILON_SECONDS; const endsAt = frame.endTimeSeconds + IMAGE_SUBTITLE_TIME_MATCH_EPSILON_SECONDS; if (currentTime < startsAt || currentTime >= endsAt) continue; if (!best || frame.startTimeSeconds > best.startTimeSeconds) best = frame; } return best; }; const findNextCachedFrameAfterTime = (streamIndex, currentTime) => { if (!Number.isInteger(streamIndex) || streamIndex < 0) return null; if (!Number.isFinite(currentTime) || currentTime < 0) return null; let best = null; const threshold = currentTime + IMAGE_SUBTITLE_TIME_MATCH_EPSILON_SECONDS; for (const frame of cachedSubtitleFrames.values()) { if (!frame || frame.streamIndex !== streamIndex) continue; if (!Number.isFinite(frame.startTimeSeconds)) continue; if (frame.startTimeSeconds <= threshold) continue; if (!best || frame.startTimeSeconds < best.startTimeSeconds) best = frame; } return best; }; const getNextCueBoundaryTimeSeconds = (streamIndex, currentTime, currentFrame = null) => { if (!Number.isInteger(streamIndex) || streamIndex < 0) return null; if (!Number.isFinite(currentTime) || currentTime < 0) return null; const activeFrame = currentFrame || findCachedFrameForTime(streamIndex, currentTime); const nextFrameSearchTime = activeFrame && Number.isFinite(activeFrame.startTimeSeconds) && activeFrame.startTimeSeconds > currentTime ? activeFrame.startTimeSeconds : currentTime; const nextFrame = findNextCachedFrameAfterTime(streamIndex, nextFrameSearchTime); let boundaryTime = null; if (activeFrame && Number.isFinite(activeFrame.endTimeSeconds)) boundaryTime = activeFrame.endTimeSeconds; if (nextFrame && Number.isFinite(nextFrame.startTimeSeconds)) { boundaryTime = Number.isFinite(boundaryTime) ? Math.min(boundaryTime, nextFrame.startTimeSeconds) : nextFrame.startTimeSeconds; } return boundaryTime; }; const getAdaptivePrefetchStepSeconds = (currentTimeSeconds) => { if (!prefetchAdaptiveStepEnabled || prefetchStepSecondsMax <= prefetchStepSecondsMin) { return prefetchStepSecondsMax; } const nowSeconds = Number(currentTimeSeconds); const leadSeconds = Number.isFinite(prefetchedThroughTimeSeconds) && Number.isFinite(nowSeconds) ? Math.max(0, prefetchedThroughTimeSeconds - nowSeconds) : 0; const targetLeadSeconds = Math.max(2, lookaheadSeconds * 0.75); const highLeadSeconds = Math.max(targetLeadSeconds + prefetchStepSecondsMax, lookaheadSeconds * 2); const ratio = highLeadSeconds > targetLeadSeconds ? Math.max(0, Math.min(1, (leadSeconds - targetLeadSeconds) / (highLeadSeconds - targetLeadSeconds))) : 1; const rawStep = prefetchStepSecondsMin + ((prefetchStepSecondsMax - prefetchStepSecondsMin) * ratio); // Keep walker increments predictable while still allowing adaptation. return Math.max( prefetchStepSecondsMin, Math.min(prefetchStepSecondsMax, Math.round(rawStep * 4) / 4), ); }; const getPrefetchDelayMs = (currentTimeSeconds) => { if (!prefetchAdaptivePacingEnabled) return prefetchRequestIntervalMs; const nowSeconds = Number(currentTimeSeconds); const leadSeconds = Number.isFinite(prefetchedThroughTimeSeconds) && Number.isFinite(nowSeconds) ? Math.max(0, prefetchedThroughTimeSeconds - nowSeconds) : 0; const softLeadSeconds = Math.max(lookaheadSeconds, prefetchStepSecondsMax * 2); if (leadSeconds <= softLeadSeconds) return prefetchRequestIntervalMs; const excessRatio = Math.max(0, Math.min(1, (leadSeconds - softLeadSeconds) / Math.max(softLeadSeconds, 1))); return Math.round(prefetchRequestIntervalMs + (excessRatio * 250)); }; const renderSubtitleFrameOnBuffer = (frame, bufferIndex) => { if (!frame || !frame.objectUrl) return false; const targetEl = bufferIndex === 0 ? overlayImgEl : overlayImgElSecondary; if (!targetEl) return false; targetEl.src = frame.objectUrl; if (frame.frameWidth > 0 && frame.frameHeight > 0 && frame.canvasWidth > 0 && frame.canvasHeight > 0) { const widthPercent = (frame.frameWidth / frame.canvasWidth) * 100; const heightPercent = (frame.frameHeight / frame.canvasHeight) * 100; targetEl.style.width = `${widthPercent}%`; targetEl.style.height = `${heightPercent}%`; targetEl.style.maxWidth = 'none'; targetEl.style.maxHeight = 'none'; } else { targetEl.style.width = 'auto'; targetEl.style.height = 'auto'; targetEl.style.maxWidth = '100%'; targetEl.style.maxHeight = '100%'; } if (bufferIndex === 0) primaryFrameKey = frame.key; else secondaryFrameKey = frame.key; return true; }; const showPrimaryBuffer = () => { if (!overlayEl) return; const primaryEl = primaryBufferIndex === 0 ? overlayImgEl : overlayImgElSecondary; const secondaryEl = primaryBufferIndex === 0 ? overlayImgElSecondary : overlayImgEl; if (primaryEl) primaryEl.style.display = 'block'; if (secondaryEl) secondaryEl.style.display = 'none'; overlayEl.style.display = 'block'; }; const swapBuffers = () => { primaryBufferIndex = primaryBufferIndex === 0 ? 1 : 0; }; const renderSubtitleFrame = (frame) => { if (!overlayEl || !frame || !frame.objectUrl) return; if (activeObjectUrl !== frame.objectUrl) { activeObjectUrl = frame.objectUrl; renderSubtitleFrameOnBuffer(frame, primaryBufferIndex); } showPrimaryBuffer(); }; const prewarmSecondaryBuffer = (streamIndex, currentTime, currentFrame) => { if (!currentFrame || !Number.isInteger(streamIndex) || streamIndex < 0) return; const secondaryIdx = primaryBufferIndex === 0 ? 1 : 0; const secondaryKey = primaryBufferIndex === 0 ? secondaryFrameKey : primaryFrameKey; const prewarmTime = Number.isFinite(currentFrame.endTimeSeconds) && currentFrame.endTimeSeconds >= 0 ? currentFrame.endTimeSeconds : currentTime; const nextFrame = findNextCachedFrameAfterTime(streamIndex, prewarmTime); if (!nextFrame || nextFrame.key === currentFrame.key || nextFrame.key === secondaryKey) return; renderSubtitleFrameOnBuffer(nextFrame, secondaryIdx); }; const runPeriodicResyncTick = () => { if (selectedStreamIndex === null || trackDisabled) return; if (typeof player.paused === 'function' && player.paused()) return; const currentTime = Number(player.currentTime()); if (!Number.isFinite(currentTime) || currentTime < 0) return; const cachedFrame = findCachedFrameForTime(selectedStreamIndex, currentTime); if (cachedFrame) { periodicResyncPending = true; return; } periodicResyncPending = false; void refreshFrame(true, false, true); }; const ensurePeriodicResync = () => { if (selectedStreamIndex === null || trackDisabled) return; if (typeof player.paused === 'function' && player.paused()) return; if (periodicResyncHandle) return; periodicResyncHandle = window.setInterval(() => { runPeriodicResyncTick(); }, periodicResyncIntervalMs); }; const scheduleCueBoundarySync = (streamIndex, currentTime, currentFrame = null) => { stopCueBoundarySync(); if (selectedStreamIndex === null || trackDisabled) return; if (typeof player.paused === 'function' && player.paused()) return; const boundaryTime = getNextCueBoundaryTimeSeconds(streamIndex, currentTime, currentFrame); if (!Number.isFinite(boundaryTime) || boundaryTime <= currentTime) return; const delayMs = Math.max(1, Math.round(((boundaryTime - currentTime) / getPlaybackRate()) * 1000)); cueBoundarySyncHandle = window.setTimeout(() => { cueBoundarySyncHandle = null; syncOverlayToPlaybackClock(); }, delayMs); }; const syncOverlayToPlaybackClock = (frameMetadata) => { stopCueBoundarySync(); if (selectedStreamIndex === null || trackDisabled) { stopPlaybackClockSync(); return; } const metadataTime = Number(frameMetadata && frameMetadata.mediaTime); const currentTime = Number.isFinite(metadataTime) && metadataTime >= 0 ? metadataTime : Number(player.currentTime()); if (Number.isFinite(currentTime) && currentTime >= 0) { const cachedFrame = findCachedFrameForTime(selectedStreamIndex, currentTime); if (cachedFrame) { // Check if frame changed const currentFrameKey = primaryBufferIndex === 0 ? primaryFrameKey : secondaryFrameKey; if (cachedFrame.key !== currentFrameKey) { // Frame transition: check if it's pre-loaded on secondary buffer const secondaryKey = primaryBufferIndex === 0 ? secondaryFrameKey : primaryFrameKey; if (cachedFrame.key === secondaryKey) { // Swap to show pre-loaded secondary frame swapBuffers(); showPrimaryBuffer(); activeObjectUrl = cachedFrame.objectUrl; } else { // Not pre-loaded; render directly on secondary and swap const secondaryIdx = primaryBufferIndex === 0 ? 1 : 0; renderSubtitleFrameOnBuffer(cachedFrame, secondaryIdx); swapBuffers(); showPrimaryBuffer(); activeObjectUrl = cachedFrame.objectUrl; } } prewarmSecondaryBuffer(selectedStreamIndex, currentTime, cachedFrame); scheduleCueBoundarySync(selectedStreamIndex, currentTime, cachedFrame); } else { hideOverlay(); if (periodicResyncPending) { periodicResyncPending = false; void refreshFrame(true, false, true); } scheduleCueBoundarySync(selectedStreamIndex, currentTime, null); } } playbackClockSyncHandle = requestFrame(syncOverlayToPlaybackClock); }; const ensurePlaybackClockSync = () => { if (selectedStreamIndex === null || trackDisabled) return; if (playbackClockSyncHandle) return; ensurePeriodicResync(); playbackClockSyncHandle = requestFrame(syncOverlayToPlaybackClock); }; const setSeekMarkerTime = (kind, timeSeconds) => { const numericTime = Number(timeSeconds); const nextTime = Number.isFinite(numericTime) && numericTime >= 0 ? numericTime : null; if (kind === 'requested') { if (nextTime === null) { lastRequestedCaptionStartTimeSeconds = null; } else if (!Number.isFinite(lastRequestedCaptionStartTimeSeconds) || nextTime >= lastRequestedCaptionStartTimeSeconds) { lastRequestedCaptionStartTimeSeconds = nextTime; } } else if (kind === 'received') { if (nextTime === null) { lastReceivedCaptionStartTimeSeconds = null; } else if (!Number.isFinite(lastReceivedCaptionStartTimeSeconds) || nextTime >= lastReceivedCaptionStartTimeSeconds) { lastReceivedCaptionStartTimeSeconds = nextTime; } } }; const updateSeekBarMarkers = () => { if (!seekMarkerRequestedEl || !seekMarkerReceivedEl) return; const duration = Number(player.duration && player.duration()); if (!Number.isFinite(duration) || duration <= 0) { seekMarkerRequestedEl.style.display = 'none'; seekMarkerReceivedEl.style.display = 'none'; return; } const getMarkerRatio = (markerTimeSeconds) => { if (!Number.isFinite(markerTimeSeconds) || markerTimeSeconds < 0) { return null; } return Math.max(0, Math.min(1, markerTimeSeconds / duration)); }; const applyMarker = (markerEl, ratio) => { if (!Number.isFinite(ratio)) { markerEl.style.display = 'none'; return; } markerEl.style.display = 'block'; markerEl.style.left = `${(ratio * 100).toFixed(4)}%`; }; const requestedRatio = getMarkerRatio(lastRequestedCaptionStartTimeSeconds); const receivedRatio = getMarkerRatio(lastReceivedCaptionStartTimeSeconds); applyMarker(seekMarkerRequestedEl, requestedRatio); applyMarker(seekMarkerReceivedEl, receivedRatio); }; const ensureSeekBarMarkers = () => { if (seekMarkerContainerEl && seekMarkerContainerEl.isConnected) { updateSeekBarMarkers(); return; } const playerEl = player.el && player.el(); if (!playerEl) return; const seekBarEl = playerEl.querySelector('.vjs-seek-bar') || playerEl.querySelector('.vjs-progress-holder') || playerEl.querySelector('.vjs-progress-control'); if (!seekBarEl) return; const computedPosition = window.getComputedStyle(seekBarEl).position; if (computedPosition === 'static') seekBarEl.style.position = 'relative'; seekMarkerContainerEl = document.createElement('div'); seekMarkerContainerEl.className = 'vjs-image-subtitle-seek-markers'; seekMarkerContainerEl.style.position = 'absolute'; seekMarkerContainerEl.style.left = '0'; seekMarkerContainerEl.style.right = '0'; seekMarkerContainerEl.style.top = '50%'; seekMarkerContainerEl.style.height = '10px'; seekMarkerContainerEl.style.transform = 'translateY(-50%)'; seekMarkerContainerEl.style.pointerEvents = 'none'; seekMarkerContainerEl.style.zIndex = '5'; const buildBracketMarker = (direction) => { const markerEl = document.createElement('span'); markerEl.className = `vjs-image-subtitle-seek-marker vjs-image-subtitle-seek-marker-${direction}`; markerEl.style.position = 'absolute'; markerEl.style.top = '50%'; markerEl.style.width = '10px'; markerEl.style.height = '10px'; markerEl.style.transform = 'translate(-50%, -50%)'; markerEl.style.color = '#fff'; markerEl.style.fontFamily = 'monospace'; markerEl.style.fontSize = '12px'; markerEl.style.fontWeight = '700'; markerEl.style.lineHeight = '10px'; markerEl.style.textAlign = 'center'; markerEl.style.display = 'none'; markerEl.textContent = direction === 'left' ? '[' : ']'; markerEl.setAttribute('aria-hidden', 'true'); return markerEl; }; seekMarkerReceivedEl = buildBracketMarker('left'); seekMarkerRequestedEl = buildBracketMarker('right'); seekMarkerContainerEl.appendChild(seekMarkerReceivedEl); seekMarkerContainerEl.appendChild(seekMarkerRequestedEl); seekBarEl.appendChild(seekMarkerContainerEl); updateSeekBarMarkers(); }; const updateButtonState = () => { if (!buttonEl) return; const track = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null; buttonEl.setAttribute('title', track ? `Image subtitles: ${track.label}` : 'Image subtitles'); buttonEl.setAttribute('aria-pressed', selectedStreamIndex === null ? 'false' : 'true'); }; const updateMenuState = () => { if (!menuEl) return; const items = menuEl.querySelectorAll('[data-image-subtitle-stream-index]'); for (const itemEl of items) { const value = itemEl.getAttribute('data-image-subtitle-stream-index'); const isSelected = value === (selectedStreamIndex === null ? 'off' : String(selectedStreamIndex)); itemEl.classList.toggle('is-selected', isSelected); itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false'); itemEl.style.background = isSelected ? 'rgba(90, 196, 255, 0.28)' : 'transparent'; itemEl.style.fontWeight = isSelected ? '600' : '400'; itemEl.style.boxShadow = isSelected ? 'inset 0 0 0 1px rgba(90, 196, 255, 0.55)' : 'none'; } }; const closeMenu = () => { menuOpen = false; if (menuEl) menuEl.style.display = 'none'; }; const openMenu = () => { menuOpen = true; if (menuEl) { updateMenuState(); menuEl.style.display = 'block'; } }; const toggleMenu = () => { if (menuOpen) closeMenu(); else openMenu(); }; const saveSelection = () => { const selectedTrack = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null; savePrefs({ imageSubtitleTrackStreamIndex: selectedStreamIndex, imageSubtitleTrackName: selectedTrack ? selectedTrack.label : null, }); }; const disableTrack = () => { trackDisabled = true; selectedStreamIndex = null; activeBucket = -1; stopPlaybackClockSync(); stopPeriodicResync(); setSeekMarkerTime('requested', null); setSeekMarkerTime('received', null); updateSeekBarMarkers(); resetRequestState(); hideOverlay(); updateButtonState(); updateMenuState(); saveSelection(); if (!failureNotified) { failureNotified = true; notifyError(); } }; const setSelectedStreamIndex = (streamIndex, { persist = true } = {}) => { const nextStreamIndex = Number.isInteger(streamIndex) ? streamIndex : null; if (nextStreamIndex !== null && !trackByStreamIndex.has(nextStreamIndex)) return; trackDisabled = false; failureNotified = false; selectedStreamIndex = nextStreamIndex; activeBucket = -1; setSeekMarkerTime('requested', null); setSeekMarkerTime('received', null); updateSeekBarMarkers(); resetRequestState(); hideOverlay(); updateButtonState(); updateMenuState(); if (persist) saveSelection(); if (selectedStreamIndex !== null) { ensurePlaybackClockSync(); if (initialPrefetchSeconds > 0) { queueLookaheadPrefetch(0, { reset: true, includeCurrentTime: true, maxTargetTimeSeconds: initialPrefetchSeconds, }); } void refreshFrame(); } else { stopPeriodicResync(); stopPlaybackClockSync(); } }; const queueLookaheadPrefetch = (currentTime, { reset = false, includeCurrentTime = false, maxTargetTimeSeconds = null, } = {}) => { if (selectedStreamIndex === null) return; if (trackDisabled) return; const durationSeconds = Number(player.duration && player.duration()); const knownVideoEndSeconds = Number.isFinite(durationSeconds) && durationSeconds > 0 ? durationSeconds : null; const bufferedVideoEndSeconds = (() => { const candidates = []; const fromPlayer = Number(player.bufferedEnd && player.bufferedEnd()); if (Number.isFinite(fromPlayer) && fromPlayer >= 0) candidates.push(fromPlayer); const tech = typeof player.tech === 'function' ? player.tech(true) : null; const mediaEl = tech && typeof tech.el === 'function' ? tech.el() : (player.el && player.el() ? player.el().querySelector('video') : null); const ranges = mediaEl && mediaEl.buffered; if (ranges && typeof ranges.length === 'number' && ranges.length > 0 && typeof ranges.end === 'function') { try { const endTime = Number(ranges.end(ranges.length - 1)); if (Number.isFinite(endTime) && endTime >= 0) candidates.push(endTime); } catch { // Ignore buffered range read races. } } if (!candidates.length) return null; return Math.max(...candidates); })(); const startTime = includeCurrentTime ? currentTime : currentTime + prefetchStepSecondsMin; const uncappedEndTime = Math.max( currentTime + lookaheadSeconds, Number.isFinite(bufferedVideoEndSeconds) ? bufferedVideoEndSeconds : -1, Number.isFinite(knownVideoEndSeconds) ? knownVideoEndSeconds : -1, ); const capEndTime = Number.isFinite(maxTargetTimeSeconds) && maxTargetTimeSeconds >= 0 ? maxTargetTimeSeconds : null; let endTime = Number.isFinite(capEndTime) ? Math.min(uncappedEndTime, capEndTime) : uncappedEndTime; if (Number.isFinite(knownVideoEndSeconds)) { endTime = Math.min(endTime, knownVideoEndSeconds); } if (!Number.isFinite(startTime) || !Number.isFinite(endTime) || endTime <= startTime) return; if (reset || prefetchedThroughTimeSeconds < 0) { cancelPrefetchRequests({ resetProgress: true }); prefetchedThroughTimeSeconds = includeCurrentTime ? currentTime - prefetchStepSecondsMin : currentTime; } else if (prefetchedThroughTimeSeconds < currentTime) { // Keep the prefetch frontier at or ahead of current playback so // prefetch catches buffered-ahead range instead of replaying stale lag. prefetchedThroughTimeSeconds = currentTime; } prefetchTargetTimeSeconds = Math.max(prefetchTargetTimeSeconds, endTime); if (prefetchPromise) return; const workerToken = ++prefetchWorkerToken; const workerLifecycleToken = lifecycleToken; const controller = createAbortController(); prefetchAbortController = controller; prefetchPromise = (async () => { while (true) { if (selectedStreamIndex === null || trackDisabled) return; if (workerToken !== prefetchWorkerToken || workerLifecycleToken !== lifecycleToken) return; const stepSeconds = getAdaptivePrefetchStepSeconds(Number(player.currentTime())); const nextTime = prefetchedThroughTimeSeconds < 0 ? startTime : prefetchedThroughTimeSeconds + stepSeconds; if (!Number.isFinite(nextTime) || nextTime > prefetchTargetTimeSeconds + 1e-6) return; const requestedRangeEndTimeSeconds = Math.min(prefetchTargetTimeSeconds, nextTime + stepSeconds); const prefetchProgressTimeSeconds = prefetchUsesRangeRequests ? requestedRangeEndTimeSeconds : nextTime; const request = buildPrefetchRequest({ streamIndex: selectedStreamIndex, currentTime: nextTime, endTime: requestedRangeEndTimeSeconds, session, }); if (!request || !request.url) return; const prefetchRequestStartedAtMs = Date.now(); const prefetchRequestId = `prefetch-${workerToken}-${Math.round(nextTime * 1000)}`; logSubtitleEvent('subtitle_png_requested', { requestId: prefetchRequestId, requestKind: 'prefetch', requestUrl: String(request.url || ''), requestedAtMs: prefetchRequestStartedAtMs, requestedVideoTimeSeconds: roundLogNumber(nextTime), requestedRangeEndTimeSeconds: roundLogNumber(requestedRangeEndTimeSeconds), }); let prefetchTimedOut = false; const timeoutId = armRequestTimeout(controller, prefetchRequestTimeoutMs, () => { prefetchTimedOut = true; }); try { const res = await fetch(request.url, { method: request.method || 'GET', headers: request.headers, credentials: request.credentials, signal: controller ? controller.signal : undefined, }); clearRequestTimeout(timeoutId); if (workerToken !== prefetchWorkerToken || workerLifecycleToken !== lifecycleToken) return; const responseMeta = { requestId: prefetchRequestId, requestKind: 'prefetch', status: res.status, serverRequestReceivedAtMs: parseHeaderInt(res, 'X-Subtitle-Request-Received-At-Ms'), serverResponseSentAtMs: parseHeaderInt(res, 'X-Subtitle-Response-Sent-At-Ms'), shouldShowAtVideoTimeSeconds: parseHeaderFloat(res, 'X-Subtitle-Frame-Start-Time'), subtitleEndTimeSeconds: parseHeaderFloat(res, 'X-Subtitle-Frame-End-Time'), responseHeadersReceivedAtMs: Date.now(), requestedVideoTimeSeconds: roundLogNumber(nextTime), requestedRangeEndTimeSeconds: roundLogNumber(requestedRangeEndTimeSeconds), }; logSubtitleEvent('subtitle_png_sent', { ...responseMeta, serverProcessingMs: diffMilliseconds(responseMeta.serverResponseSentAtMs, responseMeta.serverRequestReceivedAtMs), sentToHeadersReceivedMs: diffMilliseconds(responseMeta.responseHeadersReceivedAtMs, responseMeta.serverResponseSentAtMs), }); setSeekMarkerTime('requested', prefetchProgressTimeSeconds); const receivedMarkerTime = Number.isFinite(responseMeta.shouldShowAtVideoTimeSeconds) ? responseMeta.shouldShowAtVideoTimeSeconds : prefetchProgressTimeSeconds; setSeekMarkerTime('received', receivedMarkerTime); updateSeekBarMarkers(); if (res.status === 204) { const frameStatus = String(res.headers.get('X-Subtitle-Frame-Status') || '').toLowerCase(); logSubtitleEvent('subtitle_png_not_available', { ...responseMeta, frameStatus, }); if (frameStatus === 'error') return; prefetchedThroughTimeSeconds = prefetchProgressTimeSeconds; if (prefetchUsesRangeRequests) { setSeekMarkerTime('requested', prefetchedThroughTimeSeconds); setSeekMarkerTime('received', prefetchedThroughTimeSeconds); updateSeekBarMarkers(); } const waitMs = getPrefetchDelayMs(Number(player.currentTime())); if (waitMs > 0) { await new Promise((resolve) => window.setTimeout(resolve, waitMs)); } continue; } if (!res.ok) return; const receivedAtMs = Date.now(); let cachedFrameEntry = null; let receivedBlobBytes = 0; if (/application\/json/i.test(String(res.headers.get('Content-Type') || ''))) { const body = await res.json().catch(() => null); if (String(body && body.status || '').toLowerCase() === 'error') return; const responseFrames = Array.isArray(body && body.frames) ? body.frames : []; for (const frame of responseFrames) { if (!frame) continue; const blob = base64ToBlob(frame.frameBase64, frame.contentType || 'image/png'); if (!blob || !blob.size) continue; receivedBlobBytes += Number(blob.size) || 0; const cached = cacheSubtitleFrame({ streamIndex: selectedStreamIndex, blob, metadata: { startTimeSeconds: Number(frame.startTimeSeconds), endTimeSeconds: Number(frame.endTimeSeconds), frameWidth: Number(frame.width), frameHeight: Number(frame.height), canvasWidth: Number(frame.canvasWidth), canvasHeight: Number(frame.canvasHeight), }, }); if (cached) cachedFrameEntry = cached; } responseMeta.shouldShowAtVideoTimeSeconds = Number.isFinite(Number(body && body.startTimeSeconds)) ? Number(body.startTimeSeconds) : responseMeta.shouldShowAtVideoTimeSeconds; responseMeta.subtitleEndTimeSeconds = Number.isFinite(Number(body && body.endTimeSeconds)) ? Number(body.endTimeSeconds) : responseMeta.subtitleEndTimeSeconds; } else { const payload = await res.arrayBuffer(); receivedBlobBytes = Number(payload && payload.byteLength || 0); const metadata = parseFrameMetadata(res, nextTime, stepSeconds); const blob = new Blob([payload], { type: String(res.headers.get('Content-Type') || '').trim() || 'image/png', }); cachedFrameEntry = cacheSubtitleFrame({ streamIndex: selectedStreamIndex, blob, metadata, }); } // When foreground fetches are disabled, current-time rendering is // cache-only and may otherwise wait for a later timeupdate tick. // Render immediately if this prefetched frame covers current time. if (cachedFrameEntry) { const nowTime = Number(player.currentTime()); if (Number.isFinite(nowTime) && nowTime >= 0) { const cachedForCurrentTime = findCachedFrameForTime(selectedStreamIndex, nowTime); if (cachedForCurrentTime) { renderSubtitleFrame(cachedForCurrentTime); } } } logSubtitleEvent('subtitle_png_received', { ...responseMeta, receivedAtMs, sentToReceivedMs: diffMilliseconds(receivedAtMs, responseMeta.serverResponseSentAtMs), requestedToReceivedMs: diffMilliseconds(receivedAtMs, prefetchRequestStartedAtMs), blobBytes: receivedBlobBytes, }); prefetchedThroughTimeSeconds = prefetchProgressTimeSeconds; if (prefetchUsesRangeRequests) { setSeekMarkerTime('requested', prefetchedThroughTimeSeconds); setSeekMarkerTime('received', prefetchedThroughTimeSeconds); updateSeekBarMarkers(); } const waitMs = getPrefetchDelayMs(Number(player.currentTime())); if (waitMs > 0) { await new Promise((resolve) => window.setTimeout(resolve, waitMs)); } } catch (error) { clearRequestTimeout(timeoutId); if (prefetchTimedOut) { logSubtitleEvent('subtitle_png_request_failed', { requestId: prefetchRequestId, requestKind: 'prefetch', requestedAtMs: prefetchRequestStartedAtMs, errorName: 'AbortError', errorMessage: `Prefetch subtitle request timed out after ${Math.round(prefetchRequestTimeoutMs)}ms`, }); return; } if (isAbortError(error)) return; logSubtitleEvent('subtitle_png_request_failed', { requestId: prefetchRequestId, requestKind: 'prefetch', requestedAtMs: prefetchRequestStartedAtMs, errorName: error && error.name ? String(error.name) : null, errorMessage: error && error.message ? String(error.message) : String(error || ''), }); return; } } })().finally(() => { if (workerToken !== prefetchWorkerToken) return; prefetchAbortController = null; prefetchPromise = null; }); }; const refreshFrame = async (force = false, allowCurrentFetchOverride = false, preservePrefetchState = false) => { if (selectedStreamIndex === null) return; if (!overlayEl || !overlayImgEl) return; if (trackDisabled) return; if (currentFramePromise && !force) { queuedCurrentRefresh = true; return; } const currentTime = Number(player.currentTime()); if (!Number.isFinite(currentTime) || currentTime < 0) return; const bucket = Math.floor(currentTime * 4); if (!force && bucket === activeBucket) return; activeBucket = bucket; const cachedFrame = findCachedFrameForTime(selectedStreamIndex, currentTime); if (cachedFrame) { setSeekMarkerTime('requested', currentTime); setSeekMarkerTime('received', cachedFrame.startTimeSeconds); updateSeekBarMarkers(); renderSubtitleFrame(cachedFrame); queueLookaheadPrefetch(currentTime, { reset: force }); return; } if (!currentFetchEnabled && !allowCurrentFetchOverride) { hideOverlay(); const nowMs = Date.now(); const shouldFallbackFetch = cacheMissFallbackEnabled && nowMs - lastCacheMissFallbackAtMs >= cacheMissFallbackIntervalMs; if (shouldFallbackFetch) { lastCacheMissFallbackAtMs = nowMs; logSubtitleEvent('subtitle_cache_miss_fallback_fetch', { requestKind: 'current', requestedAtMs: nowMs, requestedVideoTimeSeconds: roundLogNumber(currentTime), }); // Safety net for occasional cache key/window mismatches. // Uses normal current-frame path but does not reset prefetch state, // so background subtitle lead can continue growing while playing. return refreshFrame(true, true, true); } queueLookaheadPrefetch(currentTime, { reset: force, includeCurrentTime: true, }); return; } const refreshLifecycleToken = lifecycleToken; if (force && currentFramePromise) { cancelCurrentFrameRequest(); } if (currentFramePromise) { queuedCurrentRefresh = true; queuedCurrentRefreshForce = queuedCurrentRefreshForce || !!force; return; } cancelCurrentFrameRequest(); if (force && !preservePrefetchState) cancelPrefetchRequests({ resetProgress: true }); const token = ++currentFrameToken; const requestId = `current-${token}`; const requestStartedAtMs = Date.now(); const controller = createAbortController(); currentFrameAbortController = controller; const request = buildFrameRequest({ streamIndex: selectedStreamIndex, currentTime, session, }); if (!request || !request.url) { disableTrack(); return; } logSubtitleEvent('subtitle_png_requested', { requestId, requestKind: 'current', requestUrl: String(request.url || ''), requestedAtMs: requestStartedAtMs, requestedVideoTimeSeconds: roundLogNumber(currentTime), }); const frameRequestPromise = (async () => { let currentTimedOut = false; const timeoutId = armRequestTimeout(controller, currentRequestTimeoutMs, () => { currentTimedOut = true; }); try { const res = await fetch(request.url, { method: request.method || 'GET', headers: request.headers, credentials: request.credentials, signal: controller ? controller.signal : undefined, }); clearRequestTimeout(timeoutId); if (token !== currentFrameToken || refreshLifecycleToken !== lifecycleToken) return; const responseMeta = { requestId, requestKind: 'current', status: res.status, serverRequestReceivedAtMs: parseHeaderInt(res, 'X-Subtitle-Request-Received-At-Ms'), serverResponseSentAtMs: parseHeaderInt(res, 'X-Subtitle-Response-Sent-At-Ms'), shouldShowAtVideoTimeSeconds: parseHeaderFloat(res, 'X-Subtitle-Frame-Start-Time'), subtitleEndTimeSeconds: parseHeaderFloat(res, 'X-Subtitle-Frame-End-Time'), responseHeadersReceivedAtMs: Date.now(), requestedVideoTimeSeconds: roundLogNumber(currentTime), }; logSubtitleEvent('subtitle_png_sent', { ...responseMeta, serverProcessingMs: diffMilliseconds(responseMeta.serverResponseSentAtMs, responseMeta.serverRequestReceivedAtMs), sentToHeadersReceivedMs: diffMilliseconds(responseMeta.responseHeadersReceivedAtMs, responseMeta.serverResponseSentAtMs), }); setSeekMarkerTime('requested', currentTime); const receivedMarkerTime = Number.isFinite(responseMeta.shouldShowAtVideoTimeSeconds) ? responseMeta.shouldShowAtVideoTimeSeconds : currentTime; setSeekMarkerTime('received', receivedMarkerTime); updateSeekBarMarkers(); if (res.status === 204) { const frameStatus = String(res.headers.get('X-Subtitle-Frame-Status') || '').toLowerCase(); logSubtitleEvent('subtitle_png_not_available', { ...responseMeta, frameStatus, }); hideOverlay(); if (frameStatus === 'error') disableTrack(); else queueLookaheadPrefetch(currentTime, { reset: force && !preservePrefetchState }); return; } if (!res.ok) { disableTrack(); return; } const blob = await res.blob(); if (token !== currentFrameToken || refreshLifecycleToken !== lifecycleToken) return; const receivedAtMs = Date.now(); logSubtitleEvent('subtitle_png_received', { ...responseMeta, receivedAtMs, sentToReceivedMs: diffMilliseconds(receivedAtMs, responseMeta.serverResponseSentAtMs), requestedToReceivedMs: diffMilliseconds(receivedAtMs, requestStartedAtMs), blobBytes: Number(blob && blob.size || 0), }); if (!blob || blob.size === 0) { disableTrack(); return; } const cachedFrameEntry = cacheSubtitleFrame({ streamIndex: selectedStreamIndex, blob, metadata: parseFrameMetadata(res, currentTime, prefetchStepSecondsMin), }); if (cachedFrameEntry) renderSubtitleFrame(cachedFrameEntry); void waitForImagePresentation(window, overlayImgEl).then((shownAtMs) => { if (token !== currentFrameToken || refreshLifecycleToken !== lifecycleToken) return; const shownAtVideoTimeSeconds = roundLogNumber(player.currentTime()); logSubtitleEvent('subtitle_png_shown', { ...responseMeta, receivedAtMs, shownAtMs, shownAtVideoTimeSeconds, sentToReceivedMs: diffMilliseconds(receivedAtMs, responseMeta.serverResponseSentAtMs), receivedToShownMs: diffMilliseconds(shownAtMs, receivedAtMs), shouldVsShownDiffSeconds: diffSeconds(shownAtVideoTimeSeconds, responseMeta.shouldShowAtVideoTimeSeconds), }); }); queueLookaheadPrefetch(currentTime, { reset: force && !preservePrefetchState }); } catch (error) { clearRequestTimeout(timeoutId); if (currentTimedOut) { logSubtitleEvent('subtitle_png_request_failed', { requestId, requestKind: 'current', requestedAtMs: requestStartedAtMs, errorName: 'AbortError', errorMessage: `Current subtitle request timed out after ${Math.round(currentRequestTimeoutMs)}ms`, }); return; } if (isAbortError(error)) return; logSubtitleEvent('subtitle_png_request_failed', { requestId, requestKind: 'current', requestedAtMs: requestStartedAtMs, errorName: error && error.name ? String(error.name) : null, errorMessage: error && error.message ? String(error.message) : String(error || ''), }); if (token === currentFrameToken && refreshLifecycleToken === lifecycleToken) disableTrack(); } })(); currentFramePromise = frameRequestPromise; frameRequestPromise.finally(() => { if (currentFramePromise !== frameRequestPromise) return; currentFrameAbortController = null; currentFramePromise = null; if (!queuedCurrentRefresh) return; const queuedForce = queuedCurrentRefreshForce; queuedCurrentRefresh = false; queuedCurrentRefreshForce = false; void refreshFrame(queuedForce); }); return currentFramePromise; }; const dispose = () => { stopPlaybackClockSync(); stopCueBoundarySync(); stopPeriodicResync(); resetRequestState(); flushSubtitleLogs(); closeMenu(); hideOverlay(); if (seekMarkerContainerEl) seekMarkerContainerEl.remove(); seekMarkerContainerEl = null; seekMarkerRequestedEl = null; seekMarkerReceivedEl = null; revokeCachedFrameUrls(); if (overlayEl) overlayEl.remove(); if (menuEl) menuEl.remove(); player.imageSubtitleOverlayController = null; buttonEl = null; }; overlayEl = document.createElement('div'); overlayEl.className = 'video-subtitle-overlay'; overlayEl.style.position = 'absolute'; overlayEl.style.left = '0'; overlayEl.style.right = '0'; overlayEl.style.bottom = '3rem'; overlayEl.style.display = 'none'; overlayEl.style.zIndex = '3'; overlayEl.style.pointerEvents = 'none'; overlayEl.style.textAlign = 'center'; overlayEl.style.padding = '0 0.75rem'; overlayEl.style.maxHeight = '70%'; overlayEl.style.overflow = 'hidden'; overlayImgEl = document.createElement('img'); overlayImgEl.alt = 'Image subtitles'; overlayImgEl.style.display = 'none'; overlayImgEl.style.margin = '0 auto'; overlayImgEl.style.objectFit = 'contain'; overlayImgEl.style.filter = 'drop-shadow(0 2px 2px rgba(0, 0, 0, 0.7))'; overlayImgEl.style.maxWidth = '100%'; overlayImgEl.style.height = 'auto'; overlayEl.appendChild(overlayImgEl); overlayImgElSecondary = document.createElement('img'); overlayImgElSecondary.alt = 'Image subtitles (buffered)'; overlayImgElSecondary.style.display = 'none'; overlayImgElSecondary.style.margin = '0 auto'; overlayImgElSecondary.style.objectFit = 'contain'; overlayImgElSecondary.style.filter = 'drop-shadow(0 2px 2px rgba(0, 0, 0, 0.7))'; overlayImgElSecondary.style.maxWidth = '100%'; overlayImgElSecondary.style.height = 'auto'; overlayEl.appendChild(overlayImgElSecondary); menuEl = document.createElement('div'); menuEl.className = 'video-subtitle-overlay-menu'; menuEl.style.position = 'absolute'; menuEl.style.right = '0.75rem'; menuEl.style.bottom = 'calc(3rem + 0.5rem)'; menuEl.style.minWidth = '14rem'; menuEl.style.maxWidth = '20rem'; menuEl.style.background = 'rgba(12, 12, 12, 0.96)'; menuEl.style.border = '1px solid rgba(255, 255, 255, 0.15)'; menuEl.style.borderRadius = '0.5rem'; menuEl.style.boxShadow = '0 12px 28px rgba(0, 0, 0, 0.35)'; menuEl.style.padding = '0.35rem'; menuEl.style.display = 'none'; menuEl.style.zIndex = '4'; const buildMenuItem = (label, streamIndex, isSelected) => { const itemEl = document.createElement('button'); itemEl.type = 'button'; itemEl.className = 'video-subtitle-overlay-menu-item'; itemEl.setAttribute('data-image-subtitle-stream-index', streamIndex === null ? 'off' : String(streamIndex)); itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false'); itemEl.style.display = 'block'; itemEl.style.width = '100%'; itemEl.style.margin = '0'; itemEl.style.padding = '0.5rem 0.75rem'; itemEl.style.border = '0'; itemEl.style.borderRadius = '0.35rem'; itemEl.style.background = isSelected ? 'rgba(255, 255, 255, 0.18)' : 'transparent'; itemEl.style.color = '#fff'; itemEl.style.textAlign = 'left'; itemEl.style.cursor = 'pointer'; itemEl.textContent = label; itemEl.addEventListener('click', () => { setSelectedStreamIndex(streamIndex); closeMenu(); }); return itemEl; }; menuEl.appendChild(buildMenuItem('Off', null, false)); for (const track of imageTracks) { menuEl.appendChild(buildMenuItem(track.label, track.streamIndex, false)); } const registerButton = () => { if (!videojs || typeof videojs.getComponent !== 'function' || typeof videojs.registerComponent !== 'function') return; if (videojs.getComponent('ImageSubtitleButton')) return; const Button = videojs.getComponent('Button'); class ImageSubtitleButton extends Button { buildCSSClass () { return `${super.buildCSSClass()} vjs-image-subtitle-button`; } createEl () { const el = super.createEl(); el.type = 'button'; el.setAttribute('title', 'Image subtitles'); el.setAttribute('aria-label', 'Image subtitles'); el.innerHTML = ''; return el; } handleClick () { const controller = this.player().imageSubtitleOverlayController; if (controller) controller.toggleMenu(); } } videojs.registerComponent('ImageSubtitleButton', ImageSubtitleButton); }; const attachUi = () => { if (!player.el()) return; registerButton(); if (overlayEl.parentElement !== player.el()) player.el().appendChild(overlayEl); if (menuEl.parentElement !== player.el()) player.el().appendChild(menuEl); const controlBar = typeof player.getChild === 'function' ? player.getChild('controlBar') : null; if (controlBar && typeof controlBar.addChild === 'function' && !buttonEl) { const button = controlBar.addChild('ImageSubtitleButton', {}); buttonEl = button && typeof button.el === 'function' ? button.el() : null; updateButtonState(); } }; const applySavedTracks = () => { if (prefs.imageSubtitleTrackName === null || prefs.imageSubtitleTrackStreamIndex === null) { setSelectedStreamIndex(null, { persist: false }); return; } const savedName = normaliseTrackName(prefs.imageSubtitleTrackName); if (savedName) { const savedByName = imageTracks.find((track) => normaliseTrackName(track.label) === savedName) || null; if (savedByName) { setSelectedStreamIndex(savedByName.streamIndex, { persist: false }); return; } } const savedIndex = Number(prefs.imageSubtitleTrackStreamIndex); if (Number.isInteger(savedIndex) && trackByStreamIndex.has(savedIndex)) { setSelectedStreamIndex(savedIndex, { persist: false }); return; } const defaultTrack = imageTracks.find((track) => track.isDefault) || null; if (defaultTrack) { setSelectedStreamIndex(defaultTrack.streamIndex, { persist: false }); return; } setSelectedStreamIndex(null, { persist: false }); }; const applySavedTracksIfNeeded = () => { if (selectedStreamIndex !== null || trackDisabled) return; applySavedTracks(); }; player.imageSubtitleOverlayController = { toggleMenu, closeMenu, applySavedTracks, captureSelectedTracks: saveSelection, detach: dispose, }; player.on('timeupdate', () => { void refreshFrame(); }); player.on('seeking', () => { void refreshFrame(true); }); player.on('seeked', () => { void refreshFrame(true); }); player.on('play', () => { void refreshFrame(true); }); player.on('play', ensurePlaybackClockSync); player.on('pause', stopPlaybackClockSync); player.on('ended', stopPlaybackClockSync); player.on('ratechange', () => { void refreshFrame(true); }); player.on('fullscreenchange', () => { closeMenu(); void refreshFrame(true); }); player.on('loadedmetadata', applySavedTracksIfNeeded); player.on('loadedplaylist', applySavedTracksIfNeeded); player.on('dispose', dispose); player.ready(() => { attachUi(); ensureSeekBarMarkers(); updateMenuState(); updateButtonState(); updateSeekBarMarkers(); applySavedTracksIfNeeded(); if (menuOpen) openMenu(); }); const onDurationHints = () => { ensureSeekBarMarkers(); updateSeekBarMarkers(); if (selectedStreamIndex === null || trackDisabled) return; const currentTime = Number(player.currentTime()); if (!Number.isFinite(currentTime) || currentTime < 0) return; queueLookaheadPrefetch(currentTime, { includeCurrentTime: true, }); }; player.on('durationchange', onDurationHints); player.on('loadedmetadata', onDurationHints); return player.imageSubtitleOverlayController; } function formatDurationForDebug (seconds) { const value = Number(seconds); if (!Number.isFinite(value) || value < 0) return 'unknown'; const totalSeconds = Math.floor(value); const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0'); const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0'); const ss = String(totalSeconds % 60).padStart(2, '0'); return `${hh}:${mm}:${ss}`; } function installDurationFallback (player, originalDuration, duration) { if (!player || !originalDuration || player.__filemanagerDurationFallback) return; player.__filemanagerDurationFallback = true; player.duration = function durationWithFallback (...args) { if (args.length) return originalDuration(...args); const current = Number(originalDuration()); return Number.isFinite(current) && current >= duration * 0.95 ? current : duration; }; } function normaliseVideoDuration (player, durationSeconds) { const duration = Number(durationSeconds); if (!player || !Number.isFinite(duration) || duration <= 0) return; let originalDuration = null; let durationWasChanged = false; try { originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null; installDurationFallback(player, originalDuration, duration); if (player.__filemanagerDurationApplied) return; const current = originalDuration ? Number(originalDuration()) : NaN; const withinTolerance = Number.isFinite(current) && current >= duration * 0.95; console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`); if (withinTolerance) { player.__filemanagerDurationApplied = true; return; } if (originalDuration) { durationWasChanged = true; originalDuration(duration); } } catch { // Ignore players that do not support setting duration. } try { const updated = originalDuration ? Number(originalDuration()) : NaN; if (Number.isFinite(updated) && updated >= duration * 0.95) { player.__filemanagerDurationApplied = true; if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange'); return; } player.__filemanagerDurationApplied = true; if (typeof player.trigger === 'function') player.trigger('durationchange'); } catch { // Ignore duration fallback failures. } } function ensureVideoPlaybackUi (player, durationSeconds) { if (!player || typeof player.on !== 'function') return; const forceVodUi = () => { normaliseVideoDuration(player, durationSeconds); try { if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function') { player.liveTracker.stopTracking(); } } catch { // Ignore live tracker availability issues. } try { if (typeof player.removeClass === 'function') { player.removeClass('vjs-live'); } } catch { // Ignore class update failures. } try { const display = player.el && player.el() && player.el().querySelector('.vjs-live-display'); if (display) display.style.display = 'none'; } catch { // Ignore missing DOM. } }; player.ready(forceVodUi); player.on('loadedmetadata', forceVodUi); player.on('durationchange', forceVodUi); player.on('loadedplaylist', forceVodUi); } function configureVideoJsBuffering (videojs, opts = {}) { if (opts.enabled === false) return; if (!videojs || !videojs.Vhs || videojs.__filemanagerBufferingConfigured) return; videojs.__filemanagerBufferingConfigured = true; const seconds = Number(opts.seconds); const bufferSeconds = Number.isFinite(seconds) && seconds > 0 ? seconds : 60 * 60; try { videojs.Vhs.GOAL_BUFFER_LENGTH = bufferSeconds; videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = bufferSeconds; videojs.Vhs.BUFFER_LOW_WATER_LINE = Math.max(30, Math.floor(bufferSeconds / 2)); videojs.Vhs.MAX_BUFFER_LOW_WATER_LINE = bufferSeconds; } catch { // Ignore builds that do not expose VHS buffer configuration. } } function enableVideoStreamClientCache () { if (typeof navigator === 'undefined' || !navigator.serviceWorker || typeof navigator.serviceWorker.register !== 'function') { return Promise.resolve(false); } if (window.__filemanagerVideoStreamCacheSwPromise) { return window.__filemanagerVideoStreamCacheSwPromise; } window.__filemanagerVideoStreamCacheSwPromise = navigator.serviceWorker.register(VIDEO_STREAM_CACHE_SW_URL, { scope: '/', updateViaCache: 'none', }).then(() => true).catch(() => false); return window.__filemanagerVideoStreamCacheSwPromise; } function videoStreamCachePrefixFromPlaylistUrl (playlistUrl) { const raw = String(playlistUrl || '').trim(); if (!raw) return null; let parsed = null; try { parsed = new URL(raw, window.location.origin); } catch { return null; } const pathname = String(parsed.pathname || ''); if (!pathname) return null; const lastSlashIndex = pathname.lastIndexOf('/'); const basePath = lastSlashIndex >= 0 ? pathname.slice(0, lastSlashIndex + 1) : '/'; return `${parsed.origin}${basePath}`; } function clearVideoStreamClientCache (playlistUrl) { const prefix = videoStreamCachePrefixFromPlaylistUrl(playlistUrl); if (!prefix || typeof caches === 'undefined' || typeof caches.open !== 'function') { return Promise.resolve(); } return caches.open(VIDEO_STREAM_CACHE_NAME).then(async (cache) => { const requests = await cache.keys(); const deletions = []; for (const request of requests) { const requestUrl = request && request.url ? String(request.url) : ''; if (!requestUrl.startsWith(prefix)) continue; deletions.push(cache.delete(request)); } await Promise.all(deletions); }).catch(() => { // Keep cache cleanup best-effort only. }); } function parseHlsManifest (manifestText) { const lines = String(manifestText || '').split(/\r?\n/); const childPlaylists = []; const mediaAssets = []; const mediaSegmentUris = []; const mediaSegments = []; let expectPlaylistUri = false; let segmentCursorSeconds = 0; let pendingSegmentDurationSeconds = null; for (const rawLine of lines) { const line = String(rawLine || '').trim(); if (!line) continue; if (line.startsWith('#')) { if (/^#EXT-X-STREAM-INF/i.test(line)) { expectPlaylistUri = true; continue; } const segmentDurationMatch = line.match(/^#EXTINF\s*:\s*([0-9]+(?:\.[0-9]+)?)/i); if (segmentDurationMatch) { const parsed = Number.parseFloat(segmentDurationMatch[1]); pendingSegmentDurationSeconds = Number.isFinite(parsed) && parsed > 0 ? parsed : VIDEO_STREAM_SEGMENT_DURATION_FALLBACK_SECONDS; continue; } const mapMatch = line.match(/^#EXT-X-MAP\s*:\s*.*?URI="([^"]+)"/i); if (mapMatch && mapMatch[1]) mediaAssets.push(mapMatch[1]); continue; } if (expectPlaylistUri || /\.m3u8(?:$|\?)/i.test(line)) { childPlaylists.push(line); expectPlaylistUri = false; } else { mediaAssets.push(line); mediaSegmentUris.push(line); if (Number.isFinite(pendingSegmentDurationSeconds) && pendingSegmentDurationSeconds > 0) { const startTimeSeconds = segmentCursorSeconds; segmentCursorSeconds += pendingSegmentDurationSeconds; mediaSegments.push({ uri: line, startTimeSeconds, endTimeSeconds: segmentCursorSeconds, }); } pendingSegmentDurationSeconds = null; } } return { childPlaylists, mediaAssets, mediaSegmentUris, mediaSegments, endList: /#EXT-X-ENDLIST/i.test(String(manifestText || '')), }; } function inferSegmentEndSecondsFromAssetUrl (assetUrl) { const value = String(assetUrl || ''); if (!value) return null; let pathname = value; try { pathname = new URL(value, window.location.href).pathname || value; } catch { // Ignore URL parsing failures and fall back to raw value matching. } const match = pathname.match(/_segment_(\d+)(?:\.[a-z0-9]+)?(?:$|\?)/i) || pathname.match(/(?:^|[/._-])seg(?:ment)?[_-]?(\d+)(?:\.[a-z0-9]+)?(?:$|\?)/i); if (!match) return null; const segmentIndex = Number.parseInt(match[1], 10); if (!Number.isInteger(segmentIndex) || segmentIndex < 0) return null; return (segmentIndex + 1) * VIDEO_STREAM_SEGMENT_DURATION_FALLBACK_SECONDS; } function bindStreamAheadSeekMarker (player, streamAheadPrefetch, opts = {}) { if (!player || typeof player.on !== 'function' || !streamAheadPrefetch) return null; const markerChar = String(opts.markerChar || ':').slice(0, 1) || ':'; const markerColor = String(opts.markerColor || '#d6d6d6'); const showTimeTooltip = opts.showTimeTooltip === true; let markerEl = null; let markerContainerEl = null; let cachedThroughSeconds = null; let cachedThroughRatio = null; let detachProgressListener = null; const currentDuration = () => { const duration = Number(player.duration && player.duration()); return Number.isFinite(duration) && duration > 0 ? duration : null; }; const updateMarker = () => { if (!markerEl) return; const duration = currentDuration(); if (!duration || !Number.isFinite(cachedThroughSeconds) || cachedThroughSeconds < 0) { markerEl.style.display = 'none'; return; } const ratioFromSeconds = Number.isFinite(cachedThroughSeconds) ? Math.max(0, Math.min(1, cachedThroughSeconds / duration)) : null; const ratioFromSections = Number.isFinite(cachedThroughRatio) ? Math.max(0, Math.min(1, cachedThroughRatio)) : null; const ratio = Number.isFinite(ratioFromSeconds) ? ratioFromSeconds : ratioFromSections; if (!Number.isFinite(ratio) || ratio <= 0) { markerEl.style.display = 'none'; return; } markerEl.style.display = 'block'; markerEl.style.left = `${(ratio * 100).toFixed(4)}%`; if (showTimeTooltip) { if (Number.isFinite(cachedThroughSeconds)) { markerEl.title = `Walker cached through ${formatClockTime(cachedThroughSeconds)}`; } else if (Number.isFinite(cachedThroughRatio)) { markerEl.title = `Walker cached through ${Math.round(cachedThroughRatio * 100)}%`; } else { markerEl.title = 'Walker cached through'; } } else { markerEl.removeAttribute('title'); } }; const ensureMarker = () => { if (markerContainerEl && markerContainerEl.isConnected) { updateMarker(); return; } const playerEl = player.el && player.el(); if (!playerEl) return; const seekBarEl = playerEl.querySelector('.vjs-seek-bar') || playerEl.querySelector('.vjs-progress-holder') || playerEl.querySelector('.vjs-progress-control'); if (!seekBarEl) return; const computedPosition = window.getComputedStyle(seekBarEl).position; if (computedPosition === 'static') seekBarEl.style.position = 'relative'; markerContainerEl = document.createElement('div'); markerContainerEl.className = 'vjs-stream-ahead-cache-marker-container'; markerContainerEl.style.position = 'absolute'; markerContainerEl.style.left = '0'; markerContainerEl.style.right = '0'; markerContainerEl.style.top = '50%'; markerContainerEl.style.height = '10px'; markerContainerEl.style.transform = 'translateY(-50%)'; markerContainerEl.style.pointerEvents = 'none'; markerContainerEl.style.zIndex = '4'; markerEl = document.createElement('span'); markerEl.className = 'vjs-stream-ahead-cache-marker'; markerEl.style.position = 'absolute'; markerEl.style.top = '50%'; markerEl.style.width = '10px'; markerEl.style.height = '10px'; markerEl.style.transform = 'translate(-50%, -50%)'; markerEl.style.color = markerColor; markerEl.style.fontFamily = 'monospace'; markerEl.style.fontSize = '12px'; markerEl.style.fontWeight = '700'; markerEl.style.lineHeight = '10px'; markerEl.style.textAlign = 'center'; markerEl.style.display = 'none'; markerEl.style.textShadow = '0 0 2px rgba(0, 0, 0, 0.65)'; markerEl.textContent = markerChar; markerEl.setAttribute('aria-hidden', 'true'); if (showTimeTooltip) { markerEl.title = 'Walker cached through 00:00'; } markerContainerEl.appendChild(markerEl); seekBarEl.appendChild(markerContainerEl); updateMarker(); }; const onDurationHint = () => { ensureMarker(); updateMarker(); }; player.on('loadedmetadata', onDurationHint); player.on('durationchange', onDurationHint); player.on('loadedplaylist', onDurationHint); player.ready(onDurationHint); if (typeof streamAheadPrefetch.subscribe === 'function') { detachProgressListener = streamAheadPrefetch.subscribe((status) => { const nextCachedThrough = status && Number.isFinite(Number(status.cachedThroughSeconds)) ? Number(status.cachedThroughSeconds) : null; cachedThroughSeconds = nextCachedThrough; cachedThroughRatio = status && Number.isFinite(Number(status.cachedThroughRatio)) ? Number(status.cachedThroughRatio) : null; ensureMarker(); updateMarker(); }); } else if (typeof streamAheadPrefetch.getStatus === 'function') { const status = streamAheadPrefetch.getStatus(); cachedThroughSeconds = status && Number.isFinite(Number(status.cachedThroughSeconds)) ? Number(status.cachedThroughSeconds) : null; cachedThroughRatio = status && Number.isFinite(Number(status.cachedThroughRatio)) ? Number(status.cachedThroughRatio) : null; ensureMarker(); updateMarker(); } return { detach: () => { if (typeof detachProgressListener === 'function') { try { detachProgressListener(); } catch { /* ignore detach races */ } detachProgressListener = null; } if (markerContainerEl && markerContainerEl.parentNode) { markerContainerEl.parentNode.removeChild(markerContainerEl); } markerContainerEl = null; markerEl = null; }, }; } function bindStreamAheadPrefetch (opts = {}) { const basePlaylistUrl = String(opts.playlistUrl || '').trim(); if (!basePlaylistUrl) return null; const pollIntervalMsRaw = Number(opts.pollIntervalMs); const pollIntervalMs = Number.isFinite(pollIntervalMsRaw) && pollIntervalMsRaw >= 0 ? pollIntervalMsRaw : VIDEO_STREAM_AHEAD_PREFETCH_POLL_MS_DEFAULT; const headers = opts.headers; const credentials = opts.credentials; const playlistStatusByUrl = new Map(); const knownPlaylistUrls = new Set([basePlaylistUrl]); const fetchedAssetUrls = new Set(); const segmentEndSecondsByAssetUrl = new Map(); const discoveredSegmentUrls = new Set(); const fetchedSegmentUrls = new Set(); const progressListeners = new Set(); const controller = typeof AbortController === 'function' ? new AbortController() : null; let stopped = false; let cachedThroughSeconds = null; let cachedThroughRatio = null; let fetchedTimelineAssetCount = 0; const recalculateSegmentRatio = () => { const totalSegments = discoveredSegmentUrls.size; if (totalSegments <= 0) { cachedThroughRatio = null; return; } cachedThroughRatio = Math.max(0, Math.min(1, fetchedSegmentUrls.size / totalSegments)); }; const resolveUrl = (value, parentUrl) => { try { return new URL(String(value || '').trim(), parentUrl || window.location.href).toString(); } catch { return null; } }; const wait = (ms) => new Promise((resolve) => window.setTimeout(resolve, ms)); const fetchText = async (url) => { const res = await fetch(url, { method: 'GET', headers, credentials, cache: 'no-store', signal: controller ? controller.signal : undefined, }); if (!res || !res.ok) return null; return res.text(); }; const fetchAsset = async (url) => { const res = await fetch(url, { method: 'GET', headers, credentials, signal: controller ? controller.signal : undefined, }); if (!res || !res.ok) return false; // Ensure body fully reads so browser/service-worker caches the asset bytes. await res.arrayBuffer(); return true; }; const getStatus = () => ({ cachedThroughSeconds, cachedThroughRatio, knownPlaylistCount: knownPlaylistUrls.size, fetchedAssetCount: fetchedAssetUrls.size, fetchedTimelineAssetCount, totalSegmentCount: discoveredSegmentUrls.size, fetchedSegmentCount: fetchedSegmentUrls.size, allPlaylistsComplete: Array.from(knownPlaylistUrls).every((url) => playlistStatusByUrl.get(url) === true), stopped, }); const appearsTimelineAsset = (assetUrl) => /(?:\.ts|\.m4s|\.mp4|\.aac|\.m4a)(?:$|\?)/i.test(String(assetUrl || '')); const emitProgress = () => { const status = getStatus(); for (const listener of Array.from(progressListeners)) { try { listener(status); } catch { // Keep progress listeners best-effort only. } } }; const workerPromise = (async () => { while (!stopped) { const nextAssetUrlSet = new Set(); for (const playlistUrl of Array.from(knownPlaylistUrls)) { if (stopped) return; const manifestText = await fetchText(playlistUrl).catch(() => null); if (!manifestText) continue; const parsed = parseHlsManifest(manifestText); playlistStatusByUrl.set(playlistUrl, !!parsed.endList); for (const child of parsed.childPlaylists) { const resolved = resolveUrl(child, playlistUrl); if (!resolved) continue; knownPlaylistUrls.add(resolved); if (!playlistStatusByUrl.has(resolved)) playlistStatusByUrl.set(resolved, false); } for (const asset of parsed.mediaAssets) { const resolved = resolveUrl(asset, playlistUrl); if (!resolved || fetchedAssetUrls.has(resolved)) continue; nextAssetUrlSet.add(resolved); } for (const segment of parsed.mediaSegments) { if (!segment || !segment.uri) continue; const resolved = resolveUrl(segment.uri, playlistUrl); if (!resolved) continue; if (!Number.isFinite(segment.endTimeSeconds) || segment.endTimeSeconds < 0) continue; segmentEndSecondsByAssetUrl.set(resolved, Number(segment.endTimeSeconds)); } for (const segmentUri of parsed.mediaSegmentUris) { const resolved = resolveUrl(segmentUri, playlistUrl); if (!resolved) continue; discoveredSegmentUrls.add(resolved); } } recalculateSegmentRatio(); emitProgress(); const nextAssetUrls = Array.from(nextAssetUrlSet); for (const assetUrl of nextAssetUrls) { if (stopped) return; const fetched = await fetchAsset(assetUrl).catch(() => false); if (!fetched) continue; fetchedAssetUrls.add(assetUrl); if (discoveredSegmentUrls.has(assetUrl)) { fetchedSegmentUrls.add(assetUrl); } const mappedSegmentEndSeconds = segmentEndSecondsByAssetUrl.get(assetUrl); const inferredSegmentEndSeconds = inferSegmentEndSecondsFromAssetUrl(assetUrl); let fallbackSegmentEndSeconds = null; if (!Number.isFinite(mappedSegmentEndSeconds) && !Number.isFinite(inferredSegmentEndSeconds) && appearsTimelineAsset(assetUrl)) { fetchedTimelineAssetCount += 1; fallbackSegmentEndSeconds = fetchedTimelineAssetCount * VIDEO_STREAM_SEGMENT_DURATION_FALLBACK_SECONDS; } const segmentEndSeconds = [mappedSegmentEndSeconds, inferredSegmentEndSeconds, fallbackSegmentEndSeconds] .filter((value) => Number.isFinite(value)) .reduce((maxValue, value) => (value > maxValue ? value : maxValue), -1); if (Number.isFinite(segmentEndSeconds)) { if (!Number.isFinite(cachedThroughSeconds) || segmentEndSeconds > cachedThroughSeconds) { cachedThroughSeconds = segmentEndSeconds; } } recalculateSegmentRatio(); emitProgress(); } const allPlaylistsComplete = Array.from(knownPlaylistUrls).every((url) => playlistStatusByUrl.get(url) === true); if (allPlaylistsComplete && !nextAssetUrls.length) { emitProgress(); return; } if (pollIntervalMs > 0) { await wait(pollIntervalMs); } } })(); return { stop: () => { stopped = true; if (controller && typeof controller.abort === 'function') { try { controller.abort(); } catch { /* ignore abort races */ } } emitProgress(); }, done: () => workerPromise, getStatus, subscribe: (listener) => { if (typeof listener !== 'function') return () => { }; progressListeners.add(listener); try { listener(getStatus()); } catch { /* ignore listener failures */ } return () => { progressListeners.delete(listener); }; }, }; } function applyDefaultTextTrackPrefs () { try { localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW); } catch { // Ignore localStorage failures. } } window.FilemanagerSharedVideoPlayer = { applyDefaultTextTrackPrefs, bindImageSubtitleOverlay, bindStreamAheadPrefetch, bindStreamAheadSeekMarker, bindTrackPrefs, clearVideoStreamClientCache, configureVideoJsBuffering, enableVideoStreamClientCache, ensureVideoPlaybackUi, normaliseVideoDuration, }; }());