mattebox 0.1.0

package/dist/protocols/dash-live/index.js

@@ -0,0 +1,188 @@
+import { parse } from '../dash-cmaf/parse.js';
+import { registerLiveNamespace } from '../live-shared.js';
+const MPD_TOKEN = 'dash:live:mpd';
+const UTC_TOKEN = 'dash:live:utc';
+const TICK_TOKEN = 'dash-live:reload';
+const CLOCK_TOKEN = 'dash-live:clock';
+/** Fallback hold-back when the MPD suggests nothing, in seconds. */
+const DEFAULT_HOLD_BACK = 10;
+/** Fallback DVR depth, in seconds. */
+const DEFAULT_TIME_SHIFT = 60;
+/** Window movement below this is not worth a fact, in seconds. */
+const WINDOW_QUANTUM = 0.5;
+const INITIAL = {
+    manifestUrl: null,
+    skew: null,
+    utcPending: false,
+    tickPending: false,
+    clockPending: false,
+    lastWindowEnd: -1,
+    lastWallClock: null,
+};
+/** The window arithmetic; null when it cannot move or is not worth a fact. */
+function windowUpdate(state, live) {
+    if (live.availabilityStart === undefined || state.lastWallClock === null)
+        return null;
+    const now = state.lastWallClock + (state.skew ?? 0);
+    const end = now - live.availabilityStart;
+    if (end <= 0 || Math.abs(end - state.lastWindowEnd) < WINDOW_QUANTUM)
+        return null;
+    const start = Math.max(0, end - (live.timeShiftDepth ?? DEFAULT_TIME_SHIFT));
+    const edge = Math.max(start, end - (live.holdBack ?? DEFAULT_HOLD_BACK));
+    return {
+        next: { ...state, lastWindowEnd: end },
+        fact: feed({ type: 'LIVE_WINDOW_CHANGED', start, end, edge }),
+    };
+}
+/**
+ * Whether this slice owns the presentation's live window: a dynamic MPD,
+ * which ISO 23009-1 requires to carry availabilityStartTime. An HLS live
+ * presentation is live too but has no availability start; its window is
+ * read from playlists by hls-live, and reloading its master as an MPD on
+ * a one-second clock is only noise.
+ */
+function drivesWindow(presentation) {
+    return presentation?.isLive === true && presentation.live?.availabilityStart !== undefined;
+}
+/** Loops a message back into the bus through a zero-delay schedule effect. */
+function feed(message) {
+    // biome-ignore lint/suspicious/noThenProperty: `then` is the schedule effect's field name from the message taxonomy
+    return { kind: 'schedule', token: 'dash-live:loopback', delayMs: 0, then: message };
+}
+function tick(delaySeconds) {
+    return {
+        kind: 'schedule',
+        token: TICK_TOKEN,
+        delayMs: Math.max(500, delaySeconds * 1000),
+        // biome-ignore lint/suspicious/noThenProperty: `then` is the schedule effect's field name from the message taxonomy
+        then: { type: 'TICK', token: TICK_TOKEN },
+    };
+}
+/** The one-second clock loop that slides the window while playback stalls. */
+function clockTick() {
+    return {
+        kind: 'schedule',
+        token: CLOCK_TOKEN,
+        delayMs: 1000,
+        // biome-ignore lint/suspicious/noThenProperty: `then` is the schedule effect's field name from the message taxonomy
+        then: { type: 'TICK', token: CLOCK_TOKEN },
+    };
+}
+const reduceDashLive = (slice, msg, kernel) => {
+    let state = slice ?? INITIAL;
+    // Any stamped fact refreshes the clock cache first, so every later
+    // branch computes with the newest wall time.
+    if ((msg.type === 'TIME_UPDATE' || msg.type === 'SEGMENT_LOADED') &&
+        msg.wallClock !== undefined) {
+        state = { ...state, lastWallClock: msg.wallClock };
+    }
+    if (msg.type === 'LOAD')
+        return [{ ...INITIAL, manifestUrl: msg.url }, []];
+    if (msg.type === 'UNLOAD' || msg.type === 'DETACH')
+        return [INITIAL, []];
+    if (msg.type === 'MANIFEST_LOADED') {
+        if (!drivesWindow(msg.presentation))
+            return [state, []];
+        const effects = [];
+        let next = state;
+        const server = msg.presentation.live.timeServer;
+        if (server !== undefined && state.skew === null && !state.utcPending) {
+            if (server.scheme.endsWith(':direct') || server.scheme.endsWith(':direct:2014')) {
+                // The value is the date itself; skew resolves on the next fact
+                // carrying a wall clock. Treated as zero until then.
+                next = { ...next, skew: null };
+            }
+            else if (server.value !== '') {
+                effects.push({ kind: 'fetch', token: UTC_TOKEN, url: server.value });
+                next = { ...next, utcPending: true };
+            }
+        }
+        if (!next.tickPending) {
+            effects.push(tick(msg.presentation.live.updatePeriod ?? 4));
+            next = { ...next, tickPending: true };
+        }
+        if (!next.clockPending) {
+            effects.push(clockTick());
+            next = { ...next, clockPending: true };
+        }
+        const window = windowUpdate(next, msg.presentation.live);
+        if (window !== null) {
+            next = window.next;
+            effects.push(window.fact);
+        }
+        return [next, effects];
+    }
+    if (msg.type === 'TICK' && msg.token === CLOCK_TOKEN) {
+        if (!drivesWindow(kernel.presentation)) {
+            return [{ ...state, clockPending: false }, []];
+        }
+        let next = { ...state, clockPending: true };
+        if (msg.wallClock !== undefined)
+            next = { ...next, lastWallClock: msg.wallClock };
+        const effects = [clockTick()];
+        const live = kernel.presentation.live;
+        if (live !== undefined) {
+            const window = windowUpdate(next, live);
+            if (window !== null) {
+                next = window.next;
+                effects.push(window.fact);
+            }
+        }
+        return [next, effects];
+    }
+    if (msg.type === 'TICK' && msg.token === TICK_TOKEN) {
+        if (state.manifestUrl === null || !drivesWindow(kernel.presentation)) {
+            return [{ ...state, tickPending: false }, []];
+        }
+        return [
+            { ...state, tickPending: false },
+            [{ kind: 'fetch', token: MPD_TOKEN, url: state.manifestUrl }],
+        ];
+    }
+    if (msg.type === 'SEGMENT_LOADED' && msg.trackId === UTC_TOKEN) {
+        const serverTime = Date.parse(new TextDecoder().decode(msg.bytes).trim());
+        if (!Number.isFinite(serverTime) || msg.wallClock === undefined) {
+            return [{ ...state, utcPending: false }, []];
+        }
+        return [{ ...state, skew: serverTime / 1000 - msg.wallClock, utcPending: false }, []];
+    }
+    if (msg.type === 'SEGMENT_LOADED' && msg.trackId === MPD_TOKEN) {
+        if (state.manifestUrl === null)
+            return [state, []];
+        const result = parse(new TextDecoder().decode(msg.bytes), state.manifestUrl);
+        const effects = [];
+        let next = state;
+        if (result.presentation !== null) {
+            effects.push(feed({ type: 'MANIFEST_LOADED', presentation: result.presentation }));
+            if (result.presentation.isLive && result.presentation.live !== undefined) {
+                const window = windowUpdate(next, result.presentation.live);
+                if (window !== null) {
+                    next = window.next;
+                    effects.push(window.fact);
+                }
+            }
+        }
+        return [next, effects];
+    }
+    // Every wall-clock-stamped fact can slide the window.
+    if ((msg.type === 'TIME_UPDATE' || msg.type === 'SEGMENT_LOADED') &&
+        drivesWindow(kernel.presentation)) {
+        const window = windowUpdate(state, kernel.presentation.live);
+        if (window !== null)
+            return [window.next, [window.fact]];
+    }
+    return [state, []];
+};
+/** The stage factory. Requires dash-cmaf; the loader enforces it. */
+export default function dashLive() {
+    return {
+        name: 'dash-live',
+        provides: ['dash-live'],
+        requires: ['dash-cmaf'],
+        install(ctx) {
+            ctx.reduce('dash-live', reduceDashLive);
+            registerLiveNamespace(ctx);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/protocols/dash-live/index.js.map

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

package/dist/protocols/hls-cmaf/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The hls-cmaf protocol adapter as a stage. Inert module: exports a
+ * factory, registers nothing at import time.
+ *
+ * The choreography is a slice reducer, so the whole protocol lives inside
+ * the message loop and the trace: manifest bytes arrive as SEGMENT_LOADED
+ * facts, parsing is pure, and results loop back through zero-delay
+ * schedule effects carrying MANIFEST_LOADED. Media playlists fetch under
+ * `hls:pl:` tokens the transport correlates back by token.
+ */
+import type { Stage } from '../../types/stage.js';
+/**
+ * The stage factory. `mattebox({ stages: [hlsCmaf()] })` is all a consumer
+ * needs for HLS-CMAF VOD.
+ */
+export default function hlsCmaf(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/protocols/hls-cmaf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocols/hls-cmaf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AA6LlD;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,IAAI,KAAK,CAQvC"}

package/dist/protocols/hls-cmaf/index.js

@@ -0,0 +1,189 @@
+/**
+ * The hls-cmaf protocol adapter as a stage. Inert module: exports a
+ * factory, registers nothing at import time.
+ *
+ * The choreography is a slice reducer, so the whole protocol lives inside
+ * the message loop and the trace: manifest bytes arrive as SEGMENT_LOADED
+ * facts, parsing is pure, and results loop back through zero-delay
+ * schedule effects carrying MANIFEST_LOADED. Media playlists fetch under
+ * `hls:pl:` tokens the transport correlates back by token.
+ */
+import { normalizeMimeType } from '../../kernel/mime.js';
+import { mergePlaylist, parse, parseMediaPlaylist } from './parse.js';
+const PLAYLIST_TOKEN = 'hls:pl:';
+/** The playlist MIME types, RFC 8216 §4: the registered type and the three in common use. */
+const MANIFEST_TYPES = [
+    'application/vnd.apple.mpegurl',
+    'application/x-mpegurl',
+    'audio/mpegurl',
+    'audio/x-mpegurl',
+];
+const INITIAL = { manifestUrl: null, mimeType: null, pending: {} };
+/**
+ * Whether this adapter owns the manifest bytes. An explicit mimeType
+ * decides alone: a foreign type declines without reading, an own type
+ * parses without sniffing, so a broken playlist reports a parse failure
+ * instead of falling through. Without one, RFC 8216 §4.3.1.1: the first
+ * line of every playlist is #EXTM3U.
+ */
+function claims(state, text) {
+    if (state.mimeType !== null)
+        return MANIFEST_TYPES.includes(state.mimeType);
+    return text.trimStart().startsWith('#EXTM3U');
+}
+function findRendition(presentation, renditionId) {
+    for (const period of presentation.periods) {
+        for (const track of period.tracks) {
+            for (const rendition of track.renditions) {
+                if (rendition.id === renditionId)
+                    return { rendition, track };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * The renditions whose media playlists still need fetching: every rendition of
+ * every active track. Fetching only the "chosen" one is not enough, because ABR
+ * (or any switch policy) selects independently and can pick a rendition this
+ * slice would not have; its segments would then stay empty and the scheduler
+ * would stall the moment ABR ramped onto it, which looks like playback dying
+ * once the buffer drains. Fetching all of an active track's playlists means the
+ * rendition ABR lands on is already loaded, and a switch never stalls.
+ */
+function neededPlaylists(kernel) {
+    const presentation = kernel.presentation;
+    if (presentation === null)
+        return [];
+    const activeIds = new Set(['video', 'audio', 'text']
+        .map((contentType) => kernel.tracks.active.get(contentType))
+        .filter((id) => id !== undefined));
+    const needed = [];
+    for (const period of presentation.periods) {
+        for (const track of period.tracks) {
+            if (!activeIds.has(track.id))
+                continue;
+            for (const rendition of track.renditions) {
+                if (rendition.playlistUrl !== undefined &&
+                    Array.isArray(rendition.segments) &&
+                    rendition.segments.length === 0) {
+                    needed.push(rendition);
+                }
+            }
+        }
+    }
+    return needed;
+}
+/** Loops a message back into the bus through a zero-delay schedule effect. */
+function feed(message) {
+    // biome-ignore lint/suspicious/noThenProperty: `then` is the schedule effect's field name from the message taxonomy
+    return { kind: 'schedule', token: 'hls:loopback', delayMs: 0, then: message };
+}
+function loopBack(presentation) {
+    return feed({ type: 'MANIFEST_LOADED', presentation });
+}
+const reduceHls = (slice, msg, kernel) => {
+    const state = slice ?? INITIAL;
+    if (msg.type === 'LOAD') {
+        return [
+            {
+                manifestUrl: msg.url,
+                mimeType: msg.mimeType === undefined ? null : normalizeMimeType(msg.mimeType),
+                pending: {},
+            },
+            [],
+        ];
+    }
+    if (msg.type === 'UNLOAD' || msg.type === 'DETACH') {
+        return [INITIAL, []];
+    }
+    if (msg.type === 'SEGMENT_LOADED' && msg.trackId === 'manifest' && state.manifestUrl !== null) {
+        const text = new TextDecoder().decode(msg.bytes);
+        // Declining returns no effect; the kernel reports bytes nobody claims.
+        if (!claims(state, text))
+            return [state, []];
+        const result = parse(text, state.manifestUrl);
+        if (result.presentation === null) {
+            return [
+                state,
+                [
+                    feed({
+                        type: 'MANIFEST_FAILED',
+                        error: result.error ?? {
+                            category: 'manifest',
+                            code: 'MANIFEST_PARSE_FAILED',
+                            fatal: true,
+                            recoverable: false,
+                        },
+                    }),
+                ],
+            ];
+        }
+        return [state, [loopBack(result.presentation)]];
+    }
+    if (msg.type === 'SEGMENT_LOADED' && msg.trackId.startsWith(PLAYLIST_TOKEN)) {
+        const renditionId = state.pending[msg.trackId];
+        if (renditionId === undefined || kernel.presentation === null)
+            return [state, []];
+        const site = findRendition(kernel.presentation, renditionId);
+        const pending = { ...state.pending };
+        delete pending[msg.trackId];
+        if (site === null || site.rendition.playlistUrl === undefined) {
+            return [{ ...state, pending }, []];
+        }
+        const text = new TextDecoder().decode(msg.bytes);
+        const media = parseMediaPlaylist(text, site.rendition.playlistUrl);
+        if (media.playlist === null) {
+            return [
+                { ...state, pending },
+                [
+                    feed({
+                        type: 'MANIFEST_FAILED',
+                        error: media.error ?? {
+                            category: 'manifest',
+                            code: 'MANIFEST_PARSE_FAILED',
+                            fatal: true,
+                            recoverable: false,
+                        },
+                    }),
+                ],
+            ];
+        }
+        const merged = mergePlaylist(kernel.presentation, renditionId, media.playlist);
+        return [{ ...state, pending }, [loopBack(merged)]];
+    }
+    // After a manifest lands, a selection changes, or time moves, fetch any
+    // media playlist the current selection still lacks. Selection is its own
+    // trigger: on a paused or stalled element no TIME_UPDATE ever comes, and
+    // a track whose playlist never loads is one the element can never play.
+    if (msg.type === 'MANIFEST_LOADED' || msg.type === 'SELECT_TRACK' || msg.type === 'TIME_UPDATE') {
+        const needed = neededPlaylists(kernel).filter((rendition) => !Object.values(state.pending).includes(rendition.id));
+        if (needed.length === 0)
+            return [state, []];
+        const effects = [];
+        const pending = { ...state.pending };
+        for (const rendition of needed) {
+            const token = `${PLAYLIST_TOKEN}${rendition.id}`;
+            if (pending[token] !== undefined)
+                continue;
+            pending[token] = rendition.id;
+            effects.push({ kind: 'fetch', token, url: rendition.playlistUrl });
+        }
+        return [{ ...state, pending }, effects];
+    }
+    return [state, []];
+};
+/**
+ * The stage factory. `mattebox({ stages: [hlsCmaf()] })` is all a consumer
+ * needs for HLS-CMAF VOD.
+ */
+export default function hlsCmaf() {
+    return {
+        name: 'hls-cmaf',
+        provides: ['hls-cmaf', ...MANIFEST_TYPES],
+        install(ctx) {
+            ctx.reduce('hls', reduceHls);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/protocols/hls-cmaf/index.js.map

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

package/dist/protocols/hls-cmaf/lexer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Line-based m3u8 tokenizer. RFC 8216 §4. The attribute-list tokenizer is
+ * a real one: quoted values may contain commas, so splitting on ',' fails
+ * on real manifests.
+ */
+export interface TagLine {
+    readonly kind: 'tag';
+    readonly name: string;
+    /** The raw text after the colon, untokenized. */
+    readonly value: string;
+    readonly attributes: Readonly<Record<string, string>>;
+}
+export interface UriLine {
+    readonly kind: 'uri';
+    readonly uri: string;
+}
+export type Line = TagLine | UriLine;
+/**
+ * RFC 8216 §4.2: comma-separated KEY=VALUE pairs where a quoted-string
+ * value may contain commas. Walk characters; never split.
+ */
+export declare function parseAttributeList(text: string): Record<string, string>;
+/** Tokenizes a playlist into tag and URI lines. Comments and blanks drop. */
+export declare function lex(text: string): readonly Line[];
+//# sourceMappingURL=lexer.d.ts.map

package/dist/protocols/hls-cmaf/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../../src/protocols/hls-cmaf/lexer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAarC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BvE;AAED,6EAA6E;AAC7E,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAqBjD"}

package/dist/protocols/hls-cmaf/lexer.js

@@ -0,0 +1,81 @@
+/**
+ * Line-based m3u8 tokenizer. RFC 8216 §4. The attribute-list tokenizer is
+ * a real one: quoted values may contain commas, so splitting on ',' fails
+ * on real manifests.
+ */
+/** Tags with attribute lists; everything else keeps its raw value. */
+const ATTRIBUTE_TAGS = new Set([
+    'EXT-X-STREAM-INF',
+    'EXT-X-MEDIA',
+    'EXT-X-MAP',
+    'EXT-X-KEY',
+    'EXT-X-SESSION-KEY',
+    'EXT-X-I-FRAME-STREAM-INF',
+    'EXT-X-CONTENT-STEERING',
+]);
+/**
+ * RFC 8216 §4.2: comma-separated KEY=VALUE pairs where a quoted-string
+ * value may contain commas. Walk characters; never split.
+ */
+export function parseAttributeList(text) {
+    const out = {};
+    let at = 0;
+    while (at < text.length) {
+        const eq = text.indexOf('=', at);
+        if (eq === -1)
+            break;
+        const key = text.slice(at, eq).trim();
+        at = eq + 1;
+        let value;
+        if (text[at] === '"') {
+            const close = text.indexOf('"', at + 1);
+            if (close === -1) {
+                value = text.slice(at + 1);
+                at = text.length;
+            }
+            else {
+                value = text.slice(at + 1, close);
+                at = close + 1;
+            }
+        }
+        else {
+            let end = text.indexOf(',', at);
+            if (end === -1)
+                end = text.length;
+            value = text.slice(at, end).trim();
+            at = end;
+        }
+        if (key !== '')
+            out[key] = value;
+        // Skip the separating comma, when present.
+        if (text[at] === ',')
+            at += 1;
+    }
+    return out;
+}
+/** Tokenizes a playlist into tag and URI lines. Comments and blanks drop. */
+export function lex(text) {
+    const lines = [];
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (line === '')
+            continue;
+        if (!line.startsWith('#')) {
+            lines.push({ kind: 'uri', uri: line });
+            continue;
+        }
+        if (!line.startsWith('#EXT'))
+            continue; // a comment
+        const colon = line.indexOf(':');
+        const name = colon === -1 ? line.slice(1) : line.slice(1, colon);
+        const value = colon === -1 ? '' : line.slice(colon + 1);
+        lines.push({
+            kind: 'tag',
+            name,
+            value,
+            attributes: ATTRIBUTE_TAGS.has(name) ? parseAttributeList(value) : {},
+        });
+    }
+    return lines;
+}
+//# sourceMappingURL=lexer.js.map

package/dist/protocols/hls-cmaf/lexer.js.map

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

package/dist/protocols/hls-cmaf/parse.d.ts

@@ -0,0 +1,57 @@
+/**
+ * m3u8 into the IR. Pure: no fetching, no state, no side effects. URLs are
+ * resolved here, against the playlist's own URL, and stored absolute;
+ * downstream code never does URL arithmetic.
+ *
+ * The HLS variant problem: EXT-X-STREAM-INF describes a bundle of one
+ * video rendition plus an audio group plus a subtitle group. The adapter
+ * decomposes variants into a video track with renditions, hoists
+ * EXT-X-MEDIA entries into their own tracks, and records the bundle in the
+ * coupling table as data. Generic descriptors only; the kernel routes.
+ */
+import type { MatteboxError } from '../../types/error.js';
+import type { Presentation, ProtectionInfo, Segment, SegmentRef } from '../../types/ir.js';
+export interface ParseResult {
+    readonly presentation: Presentation | null;
+    readonly error: MatteboxError | null;
+}
+export interface MediaPlaylist {
+    readonly segments: readonly Segment[];
+    readonly init: SegmentRef | null;
+    readonly targetDuration: number;
+    readonly mediaSequence: number;
+    readonly endlist: boolean;
+    readonly playlistType: string | null;
+    readonly protection: ProtectionInfo | null;
+    /** From the first EXT-X-PROGRAM-DATE-TIME: `wallClock` epoch seconds at `presentationTime`. */
+    readonly dateAnchor?: {
+        readonly wallClock: number;
+        readonly presentationTime: number;
+    };
+}
+export interface MediaPlaylistResult {
+    readonly playlist: MediaPlaylist | null;
+    readonly error: MatteboxError | null;
+}
+/**
+ * Rewrites the legacy decimal AVC codec form some packagers still emit into
+ * the RFC 6381 hex form MSE demands. `avc1.66.30` (profile 66, level 30) is
+ * accepted by Firefox but rejected by Chrome's isTypeSupported, which is why a
+ * stream like Unified Streaming's plays audio but no video on one browser and
+ * nothing on the other. The constraint byte is not carried in this form, so it
+ * is emitted as zero; the real flags ride in the avcC the transmux writes.
+ */
+export declare function normalizeAvcCodec(codec: string): string;
+/** parse a media playlist body into segments. */
+export declare function parseMediaPlaylist(text: string, baseUrl: string): MediaPlaylistResult;
+/** parse either playlist form into a Presentation. Never throws. */
+export declare function parse(text: string, baseUrl: string): ParseResult;
+/**
+ * Immutably merges a fetched media playlist into the rendition that
+ * referenced it. Duration, liveness, init, and protection all come from
+ * the media playlist; the presentation learns them here. On a live refresh
+ * the new window is rebased onto the running timeline first, so segment start
+ * times stay absolute across reloads.
+ */
+export declare function mergePlaylist(presentation: Presentation, renditionId: string, playlist: MediaPlaylist): Presentation;
+//# sourceMappingURL=parse.d.ts.map

package/dist/protocols/hls-cmaf/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/protocols/hls-cmaf/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAGV,YAAY,EACZ,cAAc,EAEd,OAAO,EAGP,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CACzF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAkED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAiBD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAsHrF;AAiBD,oEAAoE;AACpE,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CA4PhE;AA+BD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,GACtB,YAAY,CAqEd"}