prismcast 1.5.2 → 1.7.0

package/dist/streaming/preroll.d.ts

@@ -0,0 +1,126 @@
+import type { Express } from "express";
+import type { PlaylistSegmentEntry } from "./playlistBuilder.js";
+export type PrerollCodec = "h264" | "hevc";
+/**
+ * Returns true when the specified preroll variant has been generated and is ready to serve.
+ * @param codec - The preroll codec variant to check.
+ */
+export declare function isPrerollReady(codec: PrerollCodec): boolean;
+/**
+ * Returns the number of preroll segments available for the specified codec. Used by the segmenter to determine the preroll-to-real segment index boundary.
+ * @param codec - The preroll codec variant.
+ * @returns The count of preroll media segments.
+ */
+export declare function getPrerollSegmentCount(codec: PrerollCodec): number;
+/**
+ * Returns the duration of a specific preroll segment in seconds. Used by the segmenter's generatePlaylist() for EXTINF values when preroll entries are in the sliding
+ * window.
+ * @param codec - The preroll codec variant.
+ * @param index - The zero-based segment index.
+ * @returns The segment duration in seconds.
+ */
+export declare function getPrerollSegmentDuration(codec: PrerollCodec, index: number): number;
+/**
+ * Returns the total duration of all preroll segments in seconds. Used by the fmp4Segmenter to compute PTS offsets that make Chrome's real content timestamps continue
+ * from where the preroll ended, eliminating the PTS discontinuity at the preroll-to-live boundary.
+ * @param codec - The preroll codec variant.
+ * @returns The sum of all preroll segment durations in seconds.
+ */
+export declare function getPrerollTotalDurationSec(codec: PrerollCodec): number;
+/**
+ * Returns the maximum duration across all preroll segments for the specified codec, rounded up to the nearest integer. Used for TARGETDURATION computation in the
+ * composite playlist.
+ * @param codec - The preroll codec variant.
+ * @returns The ceiling of the maximum preroll segment duration.
+ */
+export declare function getPrerollMaxDuration(codec: PrerollCodec): number;
+/**
+ * Returns the preroll codec that should be used for new streams. HEVC is preferred when the GPU supports HEVC hardware encoding (matching the capture codec), with
+ * H.264 as the fallback. If the preferred variant was not generated (e.g., HEVC generation failed), falls back to whichever variant is available.
+ * @returns The codec to use for preroll, or "h264" as the default.
+ */
+export declare function getPrerollCodec(): PrerollCodec;
+/**
+ * Generates preroll fMP4 variants at startup. Uses the bundled ffmpeg-for-homebridge binary (which includes both libx264 and libx265) to guarantee encoder
+ * availability regardless of the user's system FFmpeg installation. The H.264 variant is always generated. The HEVC variant is generated when the GPU supports HEVC
+ * hardware encoding, so the preroll codec can match the capture codec at the preroll-to-live boundary.
+ *
+ * Each variant spawns FFmpeg to create PREROLL_TOTAL_DURATION seconds of black frame + silence as fragmented MP4, then splits the output into an init segment
+ * (ftyp + moov) and individual media segments (moof + mdat pairs) using the MP4 box parser. Each segment has naturally monotonic PTS because it comes from a
+ * continuous FFmpeg encode. If the bundled FFmpeg is unavailable or a variant fails, the system degrades gracefully — the blocking stream setup path is used instead.
+ */
+export declare function generatePreroll(): Promise<void>;
+/**
+ * Options for computing the composite playlist sliding window when preroll is active.
+ */
+export interface PrerollWindowOptions {
+    currentSegmentIndex: number;
+    maxSegments: number;
+    prerollSegmentCount: number;
+    realSegmentCount: number;
+}
+/**
+ * Computes the sliding window start index for a composite playlist containing both preroll and real segments. The start index is determined by three constraints:
+ * (1) never negative, (2) the standard sliding window rule (current index minus window size), and (3) the preroll cap that limits how many preroll entries appear in
+ * the window. The third constraint is the key addition — it prevents clients from playing through many seconds of remaining preroll before reaching live content.
+ *
+ * @param options - Window computation parameters.
+ * @returns The start index for the composite playlist window.
+ */
+export declare function computePrerollWindow(options: PrerollWindowOptions): number;
+/**
+ * Options for building preroll segment entries.
+ */
+export interface PrerollEntryOptions {
+    baseUrl: string;
+    codec: PrerollCodec;
+    extension: string;
+    prerollSegmentCount: number;
+    startIndex: number;
+}
+/**
+ * Builds an array of playlist segment entries for preroll segments within the given index range. Each entry has an absolute URL pointing to the global /preroll/ route
+ * and the duration extracted from the preroll segment cache. No per-segment metadata tags (DISCONTINUITY, PROGRAM-DATE-TIME, etc.) are set — preroll is synthetic
+ * placeholder content.
+ *
+ * @param options - Entry construction parameters.
+ * @returns Ordered array of preroll segment entries for the builder.
+ */
+export declare function buildPrerollEntries(options: PrerollEntryOptions): PlaylistSegmentEntry[];
+/**
+ * Computes how many preroll segments should be visible based on elapsed wall-clock time since the preroll started. The initial window (PREROLL_INITIAL_WINDOW segments)
+ * is revealed immediately so the client has enough content to begin playback per the HLS 3-from-end rule. Additional segments are revealed one at a time as wall-clock
+ * time passes — each new segment appears when enough time has elapsed for the client to have consumed the prior content beyond the initial window.
+ *
+ * @param codec - The preroll codec variant.
+ * @param prerollStartTime - Wall-clock time when the preroll began.
+ * @returns The number of preroll segments to reveal.
+ */
+export declare function computeProgressiveReveal(codec: PrerollCodec, prerollStartTime: Date): number;
+/**
+ * Generates a progressive HLS playlist referencing the global preroll segments for the specified codec. The playlist simulates a live stream by revealing segments
+ * based on elapsed wall-clock time since the preroll started. On each client poll, more segments become visible — the client sees new content appear and keeps playing
+ * without stalling.
+ *
+ * The playlist uses absolute URLs because preroll segments are served at global routes (/preroll/:codec/*) while the playlist itself is served under /hls/:name/.
+ * Without absolute URLs, the client would request /hls/:name/preroll/... which does not exist. The playlist omits #EXT-X-ENDLIST so it behaves as a live playlist —
+ * the client polls for updates and receives the real content playlist when ready.
+ *
+ * PROGRAM-DATE-TIME is intentionally omitted from the preroll playlist. Preroll is synthetic placeholder content — assigning it wall-clock timestamps would be
+ * misleading and would create a backward time jump at the preroll-to-live boundary (preroll PDT would overshoot real content PDT because the preroll covers 30
+ * seconds of content but real content typically arrives in ~15 seconds). PDT is emitted only on real segments once the segmenter produces them.
+ *
+ * @param baseUrl - The server's external URL (e.g., "http://192.168.1.100:5589").
+ * @param codec - The preroll codec variant.
+ * @param startingSequence - The MEDIA-SEQUENCE offset. Zero for fresh starts. For resume streams, this is set to the saved segment index so the preroll
+ *   playlist continues from the prior session's sequence range rather than restarting at 0.
+ * @param prerollStartTime - Wall-clock time when the preroll began. Used to compute elapsed time and determine how many segments to reveal.
+ * @returns The complete HLS playlist string, or an empty string if the preroll is not ready.
+ */
+export declare function generatePrerollPlaylist(baseUrl: string, codec: PrerollCodec, startingSequence: number, prerollStartTime: Date): string;
+/**
+ * Registers the preroll segment routes on the Express application. Routes are codec-prefixed (/preroll/:codec/init.mp4 and /preroll/:codec/segmentN.m4s) so each
+ * variant is served at a distinct path. The cached preroll buffers are served with immutable cache headers since the content never changes after generation.
+ * @param app - The Express application.
+ */
+export declare function setupPrerollRoutes(app: Express): void;

package/dist/streaming/preroll.js

@@ -0,0 +1,434 @@
+import { LOG, getBundledFFmpegPath } from "../utils/index.js";
+import { createMP4BoxParser, offsetMoofTimestamps, parseMoovTrackInfo } from "./mp4Parser.js";
+import { CONFIG } from "../config/index.js";
+import { buildPlaylist } from "./playlistBuilder.js";
+import { getEffectiveViewport } from "../config/presets.js";
+import { getGpuCapabilities } from "../browser/display.js";
+import { spawn } from "node:child_process";
+// Total duration of preroll content in seconds. FFmpeg generates this much continuous black+silence fMP4, which is then split into individual segments at keyframe
+// boundaries. The configured duration provides ample coverage for the slowest providers with the progressive playlist delivering content in real time for the full
+// tune duration.
+const PREROLL_TOTAL_DURATION = 30;
+// Number of segments to reveal immediately on the first preroll playlist request. The HLS spec (RFC 8216 Section 6.3.3) says a client should start playback 3 target
+// durations from the end of a live playlist, so 4 segments gives the client 3 playable segments plus one buffer.
+const PREROLL_INITIAL_WINDOW = 4;
+// Cached preroll variants keyed by codec label ("h264", "hevc"). Generated once at startup, reused for all streams. The H.264 variant is always generated; the HEVC
+// variant is generated when the GPU supports HEVC hardware encoding.
+const prerollVariants = new Map();
+// Public Accessors.
+/**
+ * Returns true when the specified preroll variant has been generated and is ready to serve.
+ * @param codec - The preroll codec variant to check.
+ */
+export function isPrerollReady(codec) {
+    const variant = prerollVariants.get(codec);
+    return (variant !== undefined) && (variant.mediaSegments.length > 0);
+}
+/**
+ * Returns the number of preroll segments available for the specified codec. Used by the segmenter to determine the preroll-to-real segment index boundary.
+ * @param codec - The preroll codec variant.
+ * @returns The count of preroll media segments.
+ */
+export function getPrerollSegmentCount(codec) {
+    return prerollVariants.get(codec)?.mediaSegments.length ?? 0;
+}
+/**
+ * Returns the duration of a specific preroll segment in seconds. Used by the segmenter's generatePlaylist() for EXTINF values when preroll entries are in the sliding
+ * window.
+ * @param codec - The preroll codec variant.
+ * @param index - The zero-based segment index.
+ * @returns The segment duration in seconds.
+ */
+export function getPrerollSegmentDuration(codec, index) {
+    return prerollVariants.get(codec)?.durations[index] ?? 2;
+}
+/**
+ * Returns the total duration of all preroll segments in seconds. Used by the fmp4Segmenter to compute PTS offsets that make Chrome's real content timestamps continue
+ * from where the preroll ended, eliminating the PTS discontinuity at the preroll-to-live boundary.
+ * @param codec - The preroll codec variant.
+ * @returns The sum of all preroll segment durations in seconds.
+ */
+export function getPrerollTotalDurationSec(codec) {
+    const variant = prerollVariants.get(codec);
+    if (!variant) {
+        return 0;
+    }
+    let total = 0;
+    for (const duration of variant.durations) {
+        total += duration;
+    }
+    return total;
+}
+/**
+ * Returns the maximum duration across all preroll segments for the specified codec, rounded up to the nearest integer. Used for TARGETDURATION computation in the
+ * composite playlist.
+ * @param codec - The preroll codec variant.
+ * @returns The ceiling of the maximum preroll segment duration.
+ */
+export function getPrerollMaxDuration(codec) {
+    const variant = prerollVariants.get(codec);
+    if (!variant || (variant.durations.length === 0)) {
+        return 2;
+    }
+    let max = 0;
+    for (const duration of variant.durations) {
+        if (duration > max) {
+            max = duration;
+        }
+    }
+    return Math.ceil(max);
+}
+/**
+ * Returns the preroll codec that should be used for new streams. HEVC is preferred when the GPU supports HEVC hardware encoding (matching the capture codec), with
+ * H.264 as the fallback. If the preferred variant was not generated (e.g., HEVC generation failed), falls back to whichever variant is available.
+ * @returns The codec to use for preroll, or "h264" as the default.
+ */
+export function getPrerollCodec() {
+    const preferHevc = getGpuCapabilities()?.hevcHardwareEncoding === true;
+    const preferred = preferHevc ? "hevc" : "h264";
+    if (isPrerollReady(preferred)) {
+        return preferred;
+    }
+    // Fall back: if the preferred variant failed to generate, use the other one.
+    const fallback = preferHevc ? "h264" : "hevc";
+    if (isPrerollReady(fallback)) {
+        return fallback;
+    }
+    return "h264";
+}
+// Preroll Generation.
+/**
+ * Generates preroll fMP4 variants at startup. Uses the bundled ffmpeg-for-homebridge binary (which includes both libx264 and libx265) to guarantee encoder
+ * availability regardless of the user's system FFmpeg installation. The H.264 variant is always generated. The HEVC variant is generated when the GPU supports HEVC
+ * hardware encoding, so the preroll codec can match the capture codec at the preroll-to-live boundary.
+ *
+ * Each variant spawns FFmpeg to create PREROLL_TOTAL_DURATION seconds of black frame + silence as fragmented MP4, then splits the output into an init segment
+ * (ftyp + moov) and individual media segments (moof + mdat pairs) using the MP4 box parser. Each segment has naturally monotonic PTS because it comes from a
+ * continuous FFmpeg encode. If the bundled FFmpeg is unavailable or a variant fails, the system degrades gracefully — the blocking stream setup path is used instead.
+ */
+export async function generatePreroll() {
+    const ffmpegBin = getBundledFFmpegPath();
+    if (!ffmpegBin) {
+        LOG.warn("Bundled FFmpeg is not available. Preroll generation skipped — startup playlists will have no segments.");
+        return;
+    }
+    // Use the effective viewport to match the resolution Chrome MediaRecorder will produce. This prevents a resolution mismatch at the preroll-to-live discontinuity
+    // boundary.
+    const viewport = getEffectiveViewport(CONFIG);
+    const size = String(viewport.width) + "x" + String(viewport.height);
+    // Generate the H.264 variant. Baseline profile and level 3.1 match Chrome's MediaRecorder output (confirmed via parseMoovCodecConfig telemetry). Slow preset and
+    // CRF 18 produce higher quality — acceptable for a short duration of simple content generated once at startup.
+    await generateVariant(ffmpegBin, "h264", [
+        "-c:v", "libx264", "-preset", "slow", "-tune", "stillimage", "-profile:v", "baseline", "-level", "3.1", "-pix_fmt", "yuv420p",
+        "-crf", "18"
+    ], size);
+    // Generate the HEVC variant when the GPU supports HEVC hardware encoding. The libx265 encoder does not support the -tune stillimage option (libx264-specific), so
+    // we omit it. The -tag:v hvc1 flag ensures the output uses the hvc1 box type (matching Chrome's MediaRecorder HEVC output) rather than libx265's default hev1.
+    if (getGpuCapabilities()?.hevcHardwareEncoding === true) {
+        await generateVariant(ffmpegBin, "hevc", [
+            "-c:v", "libx265", "-preset", "slow", "-profile:v", "main", "-pix_fmt", "yuv420p",
+            "-crf", "18", "-tag:v", "hvc1"
+        ], size);
+    }
+}
+/**
+ * Generates a single preroll variant (H.264 or HEVC) and stores it in the variant cache. Constructs the FFmpeg argument list from shared parameters (input sources,
+ * duration, GOP size, audio codec, fMP4 output flags) combined with the codec-specific video encoder arguments.
+ * @param ffmpegBin - Path to the FFmpeg executable.
+ * @param codec - The codec label for this variant.
+ * @param videoArgs - Codec-specific FFmpeg arguments for the video encoder (e.g., "-c:v libx264 -preset slow ...").
+ * @param size - The output resolution as "WxH".
+ */
+async function generateVariant(ffmpegBin, codec, videoArgs, size) {
+    const args = [
+        "-hide_banner", "-nostats", "-loglevel", "warning",
+        "-f", "lavfi", "-i", "color=black:size=" + size + ":rate=30:duration=" + String(PREROLL_TOTAL_DURATION),
+        "-f", "lavfi", "-i", "anullsrc=r=48000:cl=stereo",
+        "-t", String(PREROLL_TOTAL_DURATION),
+        ...videoArgs,
+        "-g", "60",
+        "-c:a", "aac", "-b:a", "128000",
+        "-f", "mp4",
+        "-movflags", "frag_keyframe+empty_moov+default_base_moof+skip_sidx+skip_trailer",
+        "-flush_packets", "1",
+        "pipe:1"
+    ];
+    try {
+        const output = await spawnAndCollect(ffmpegBin, args);
+        const variant = splitPrerollBuffers(output);
+        if (variant && (variant.mediaSegments.length > 0)) {
+            prerollVariants.set(codec, variant);
+            const totalSize = variant.mediaSegments.reduce((sum, seg) => sum + seg.length, 0);
+            LOG.debug("streaming:preroll", "Preroll %s ready: %d segments, init=%d bytes, media=%d bytes total.", codec, variant.mediaSegments.length, variant.initSegment.length, totalSize);
+        }
+        else {
+            LOG.warn("Preroll %s generation produced incomplete output.", codec);
+        }
+    }
+    catch (error) {
+        LOG.warn("Preroll %s generation failed: %s.", codec, error instanceof Error ? error.message : String(error));
+    }
+}
+// Internal Helpers.
+/**
+ * Spawns FFmpeg with the given arguments and collects all stdout output into a single Buffer. Used for one-shot operations like preroll generation where the entire
+ * output fits in memory.
+ * @param ffmpegBin - Path to the FFmpeg executable.
+ * @param args - FFmpeg command-line arguments.
+ * @returns Promise resolving to the complete stdout output as a Buffer.
+ */
+async function spawnAndCollect(ffmpegBin, args) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const ffmpeg = spawn(ffmpegBin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        ffmpeg.stdout.on("data", (chunk) => {
+            chunks.push(chunk);
+        });
+        ffmpeg.stderr.on("data", (data) => {
+            const message = data.toString().trim();
+            if (message.length > 0) {
+                LOG.debug("streaming:preroll", "FFmpeg: %s", message);
+            }
+        });
+        ffmpeg.on("error", (error) => {
+            reject(error);
+        });
+        ffmpeg.on("exit", (code) => {
+            if (code !== 0) {
+                reject(new Error("FFmpeg exited with code " + String(code) + "."));
+                return;
+            }
+            resolve(Buffer.concat(chunks));
+        });
+    });
+}
+/**
+ * Splits an fMP4 buffer into an init segment (ftyp + moov) and individual media segments (moof + mdat pairs) using the MP4 box parser. The init segment contains codec
+ * configuration needed by the HLS client to initialize its decoder. Each moof+mdat pair becomes a distinct segment buffer with naturally monotonic PTS timestamps.
+ *
+ * Duration extraction: the moov box is parsed with parseMoovTrackInfo() to get per-track timescales. Each moof is then parsed with offsetMoofTimestamps() (with an
+ * empty offset map for pure pass-through) to extract per-track trun durations. The maximum duration across tracks (converted to seconds via timescale) becomes the
+ * segment's EXTINF duration.
+ *
+ * @param data - The complete fMP4 output from FFmpeg.
+ * @returns The parsed variant, or null if the output was incomplete.
+ */
+function splitPrerollBuffers(data) {
+    const initBoxes = [];
+    const mediaSegments = [];
+    const durations = [];
+    let moovBox = null;
+    // Accumulator for the current moof+mdat pair. A segment is finalized when the mdat following a moof arrives.
+    let pendingMoof = null;
+    const parser = createMP4BoxParser((box) => {
+        if ((box.type === "ftyp") || (box.type === "moov")) {
+            initBoxes.push(box.data);
+            if (box.type === "moov") {
+                moovBox = box.data;
+            }
+        }
+        else if (box.type === "moof") {
+            // Start a new segment. If there's an orphaned moof without a following mdat (shouldn't happen with well-formed fMP4), it gets overwritten.
+            pendingMoof = box.data;
+        }
+        else if (box.type === "mdat") {
+            // Finalize the current segment by combining the pending moof with this mdat.
+            if (pendingMoof) {
+                mediaSegments.push(Buffer.concat([pendingMoof, box.data]));
+                pendingMoof = null;
+            }
+        }
+    });
+    parser.push(data);
+    parser.flush();
+    if (initBoxes.length === 0) {
+        return null;
+    }
+    const initSegment = Buffer.concat(initBoxes);
+    // Extract per-segment durations from the moov timescales and moof trun sample durations. The moov provides the timescale for converting raw sample durations to
+    // seconds. Each moof's traf/trun boxes contain the accumulated sample durations for that fragment.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- moovBox is set inside the parser callback; TS can't track closure mutations.
+    if (moovBox && (mediaSegments.length > 0)) {
+        const trackInfoMap = parseMoovTrackInfo(moovBox);
+        // Build a timescale lookup from trackId to timescale.
+        const timescales = new Map();
+        for (const [trackId, info] of trackInfoMap) {
+            timescales.set(trackId, info.timescale);
+        }
+        // Extract duration from each segment's moof box. The offsetMoofTimestamps function with an empty offset map acts as a pure reader — it returns per-track
+        // durations without modifying the buffer (it writes back the same tfdt values it read since the offset is 0). A fresh map is created per segment to prevent
+        // state accumulation across iterations.
+        for (const segment of mediaSegments) {
+            // The segment buffer is moof+mdat concatenated. The moof is the first box — parse it to find its size.
+            if (segment.length < 8) {
+                durations.push(2);
+                continue;
+            }
+            const moofSize = segment.readUInt32BE(0);
+            const moofData = segment.subarray(0, moofSize);
+            // Extract per-track durations from the moof. Take the maximum across tracks and convert to seconds.
+            const trackResults = offsetMoofTimestamps(moofData, new Map());
+            let maxDurationSec = 0;
+            for (const [trackId, result] of trackResults) {
+                const timescale = timescales.get(trackId);
+                if (timescale && (result.duration > 0n)) {
+                    const seconds = Number(result.duration) / timescale;
+                    if (seconds > maxDurationSec) {
+                        maxDurationSec = seconds;
+                    }
+                }
+            }
+            // Fall back to 2 seconds if duration extraction failed (shouldn't happen with well-formed FFmpeg output).
+            durations.push(maxDurationSec > 0 ? maxDurationSec : 2);
+        }
+    }
+    return { durations, initSegment, mediaSegments };
+}
+// Preroll Compositor.
+// Maximum number of preroll entries allowed in a composite playlist window. When the composite playlist first appears, the client may be mid-stream in the progressive
+// preroll playlist at a low segment index. Limiting preroll entries forces MEDIA-SEQUENCE past the client's current position, causing it to seek forward to near the
+// live edge rather than playing through many seconds of remaining preroll before reaching real content.
+const MAX_PREROLL_IN_WINDOW = 3;
+/**
+ * Computes the sliding window start index for a composite playlist containing both preroll and real segments. The start index is determined by three constraints:
+ * (1) never negative, (2) the standard sliding window rule (current index minus window size), and (3) the preroll cap that limits how many preroll entries appear in
+ * the window. The third constraint is the key addition — it prevents clients from playing through many seconds of remaining preroll before reaching live content.
+ *
+ * @param options - Window computation parameters.
+ * @returns The start index for the composite playlist window.
+ */
+export function computePrerollWindow(options) {
+    const totalAvailable = options.prerollSegmentCount + options.realSegmentCount;
+    const windowSize = Math.min(totalAvailable, options.maxSegments);
+    return Math.max(0, options.currentSegmentIndex - windowSize, options.prerollSegmentCount - MAX_PREROLL_IN_WINDOW);
+}
+/**
+ * Builds an array of playlist segment entries for preroll segments within the given index range. Each entry has an absolute URL pointing to the global /preroll/ route
+ * and the duration extracted from the preroll segment cache. No per-segment metadata tags (DISCONTINUITY, PROGRAM-DATE-TIME, etc.) are set — preroll is synthetic
+ * placeholder content.
+ *
+ * @param options - Entry construction parameters.
+ * @returns Ordered array of preroll segment entries for the builder.
+ */
+export function buildPrerollEntries(options) {
+    const entries = [];
+    for (let i = options.startIndex; i < options.prerollSegmentCount; i++) {
+        entries.push({
+            duration: getPrerollSegmentDuration(options.codec, i),
+            url: options.baseUrl + "/preroll/" + options.codec + "/segment" + String(i) + options.extension
+        });
+    }
+    return entries;
+}
+/**
+ * Computes how many preroll segments should be visible based on elapsed wall-clock time since the preroll started. The initial window (PREROLL_INITIAL_WINDOW segments)
+ * is revealed immediately so the client has enough content to begin playback per the HLS 3-from-end rule. Additional segments are revealed one at a time as wall-clock
+ * time passes — each new segment appears when enough time has elapsed for the client to have consumed the prior content beyond the initial window.
+ *
+ * @param codec - The preroll codec variant.
+ * @param prerollStartTime - Wall-clock time when the preroll began.
+ * @returns The number of preroll segments to reveal.
+ */
+export function computeProgressiveReveal(codec, prerollStartTime) {
+    const variant = prerollVariants.get(codec);
+    if (!variant) {
+        return 0;
+    }
+    const totalSegments = variant.mediaSegments.length;
+    const elapsedSec = (Date.now() - prerollStartTime.getTime()) / 1000;
+    let revealCount = Math.min(PREROLL_INITIAL_WINDOW, totalSegments);
+    // Compute the total duration of the initial window. Segments beyond this threshold are revealed progressively — each one becomes visible when elapsed time
+    // exceeds the cumulative duration of all segments before it, minus the initial window's duration (since those were available from the start).
+    let initialWindowDuration = 0;
+    for (let i = 0; i < Math.min(PREROLL_INITIAL_WINDOW, totalSegments); i++) {
+        initialWindowDuration += variant.durations[i] ?? 2;
+    }
+    let cumulativeDuration = initialWindowDuration;
+    for (let i = PREROLL_INITIAL_WINDOW; i < totalSegments; i++) {
+        cumulativeDuration += variant.durations[i] ?? 2;
+        if (elapsedSec < (cumulativeDuration - initialWindowDuration)) {
+            break;
+        }
+        revealCount = i + 1;
+    }
+    return revealCount;
+}
+// Playlist Generation.
+/**
+ * Generates a progressive HLS playlist referencing the global preroll segments for the specified codec. The playlist simulates a live stream by revealing segments
+ * based on elapsed wall-clock time since the preroll started. On each client poll, more segments become visible — the client sees new content appear and keeps playing
+ * without stalling.
+ *
+ * The playlist uses absolute URLs because preroll segments are served at global routes (/preroll/:codec/*) while the playlist itself is served under /hls/:name/.
+ * Without absolute URLs, the client would request /hls/:name/preroll/... which does not exist. The playlist omits #EXT-X-ENDLIST so it behaves as a live playlist —
+ * the client polls for updates and receives the real content playlist when ready.
+ *
+ * PROGRAM-DATE-TIME is intentionally omitted from the preroll playlist. Preroll is synthetic placeholder content — assigning it wall-clock timestamps would be
+ * misleading and would create a backward time jump at the preroll-to-live boundary (preroll PDT would overshoot real content PDT because the preroll covers 30
+ * seconds of content but real content typically arrives in ~15 seconds). PDT is emitted only on real segments once the segmenter produces them.
+ *
+ * @param baseUrl - The server's external URL (e.g., "http://192.168.1.100:5589").
+ * @param codec - The preroll codec variant.
+ * @param startingSequence - The MEDIA-SEQUENCE offset. Zero for fresh starts. For resume streams, this is set to the saved segment index so the preroll
+ *   playlist continues from the prior session's sequence range rather than restarting at 0.
+ * @param prerollStartTime - Wall-clock time when the preroll began. Used to compute elapsed time and determine how many segments to reveal.
+ * @returns The complete HLS playlist string, or an empty string if the preroll is not ready.
+ */
+export function generatePrerollPlaylist(baseUrl, codec, startingSequence, prerollStartTime) {
+    if (!isPrerollReady(codec)) {
+        return "";
+    }
+    const revealCount = computeProgressiveReveal(codec, prerollStartTime);
+    const entries = buildPrerollEntries({ baseUrl, codec, extension: ".m4s", prerollSegmentCount: revealCount, startIndex: 0 });
+    return buildPlaylist({
+        initialMapUri: baseUrl + "/preroll/" + codec + "/init.mp4",
+        mediaSequence: startingSequence,
+        targetDuration: getPrerollMaxDuration(codec),
+        version: 7
+    }, entries);
+}
+// Route Setup.
+/**
+ * Registers the preroll segment routes on the Express application. Routes are codec-prefixed (/preroll/:codec/init.mp4 and /preroll/:codec/segmentN.m4s) so each
+ * variant is served at a distinct path. The cached preroll buffers are served with immutable cache headers since the content never changes after generation.
+ * @param app - The Express application.
+ */
+export function setupPrerollRoutes(app) {
+    app.get("/preroll/:codec/init.mp4", (req, res) => {
+        const codec = req.params.codec;
+        const variant = ((codec === "h264") || (codec === "hevc")) ? prerollVariants.get(codec) : undefined;
+        if (!variant) {
+            res.status(404).send("Preroll not available.");
+            return;
+        }
+        res.setHeader("Cache-Control", "public, max-age=86400");
+        res.setHeader("Content-Type", "video/mp4");
+        res.send(variant.initSegment);
+    });
+    // Parameterized route serves individual preroll segment buffers. Each segment contains a distinct moof+mdat pair with unique PTS values from the continuous FFmpeg
+    // output. The init.mp4 exact route above takes priority over this catch-all for init segment requests.
+    app.get("/preroll/:codec/:segment", (req, res) => {
+        const codec = req.params.codec;
+        const variant = ((codec === "h264") || (codec === "hevc")) ? prerollVariants.get(codec) : undefined;
+        if (!variant) {
+            res.status(404).send("Preroll not available.");
+            return;
+        }
+        // Extract the segment index from the filename (e.g., "segment5.m4s" -> 5).
+        const segmentParam = req.params.segment;
+        const match = (typeof segmentParam === "string") ? /^segment(\d+)\.m4s$/.exec(segmentParam) : null;
+        if (!match) {
+            res.status(404).send("Preroll not available.");
+            return;
+        }
+        const index = parseInt(match[1], 10);
+        if ((index < 0) || (index >= variant.mediaSegments.length)) {
+            res.status(404).send("Preroll segment not found.");
+            return;
+        }
+        res.setHeader("Cache-Control", "public, max-age=86400");
+        res.setHeader("Content-Type", "video/mp4");
+        res.send(variant.mediaSegments[index]);
+    });
+}
+//# sourceMappingURL=preroll.js.map

package/dist/streaming/preroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preroll.js","sourceRoot":"","sources":["../../src/streaming/preroll.ts"],"names":[],"mappings":"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"}

package/dist/streaming/pretune.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Starts the pretune polling loop. Should be called on server startup after show info polling is initialized.
+ */
+export declare function startPretunePolling(): void;
+/**
+ * Stops the pretune polling loop and clears all pending timers. Should be called on server shutdown.
+ */
+export declare function stopPretunePolling(): void;