mattebox 0.1.0

package/dist/stages/abr-persist/index.js

@@ -0,0 +1,44 @@
+const INITIAL = { seeded: false, lastSaved: 0 };
+const SAVE_EVENT = 'abr-persist:save';
+/** Relative drift that triggers a save. */
+const DRIFT = 0.2;
+export default function abrPersist(storage) {
+    return {
+        name: 'abr-persist',
+        requires: ['abr'],
+        install(ctx) {
+            const remembered = storage.get();
+            const reduce = (slice, msg, kernel) => {
+                const state = slice ?? INITIAL;
+                if (msg.type === 'LOAD' && !state.seeded && remembered !== null && remembered > 0) {
+                    const effects = [
+                        {
+                            kind: 'schedule',
+                            token: 'abr-persist:seed',
+                            delayMs: 0,
+                            // biome-ignore lint/suspicious/noThenProperty: `then` is the schedule effect's field name from the message taxonomy
+                            then: { type: 'THROUGHPUT_SAMPLE', bps: remembered, trackId: 'abr-persist' },
+                        },
+                    ];
+                    return [{ ...state, seeded: true, lastSaved: remembered }, effects];
+                }
+                if (msg.type === 'SEGMENT_LOADED') {
+                    const current = kernel.stats.throughputEwma;
+                    if (current > 0 && Math.abs(current - state.lastSaved) > state.lastSaved * DRIFT) {
+                        return [
+                            { ...state, lastSaved: current },
+                            [{ kind: 'emit', event: SAVE_EVENT, payload: current }],
+                        ];
+                    }
+                }
+                return [state, []];
+            };
+            ctx.reduce('abr-persist', reduce);
+            return ctx.on(SAVE_EVENT, (bps) => {
+                if (typeof bps === 'number')
+                    storage.set(Math.round(bps));
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/abr-persist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stages/abr-persist/index.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,GAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAE9D,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,2CAA2C;AAC3C,MAAM,KAAK,GAAG,GAAG,CAAC;AAElB,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAA0B;IAC3D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,OAAO,CAAC,GAAG;YACT,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,MAAM,GAA+B,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;gBAChE,MAAM,KAAK,GAAG,KAAK,IAAI,OAAO,CAAC;gBAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBAClF,MAAM,OAAO,GAAa;wBACxB;4BACE,IAAI,EAAE,UAAU;4BAChB,KAAK,EAAE,kBAAkB;4BACzB,OAAO,EAAE,CAAC;4BACV,oHAAoH;4BACpH,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE;yBAC7E;qBACF,CAAC;oBACF,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;gBACtE,CAAC;gBACD,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBAClC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;oBAC5C,IAAI,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;wBACjF,OAAO;4BACL,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE;4BAChC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;yBACxD,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrB,CAAC,CAAC;YACF,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,MAAsB,CAAC,CAAC;YAClD,OAAO,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stages/aes-128/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * aes-128 as a stage: full-segment AES-CBC decryption for HLS EXT-X-KEY
+ * METHOD=AES-128 (RFC 8216 §4.3.2.4). One transform step, ordered ahead of
+ * every container step, so the transmux and the probe only ever see clear
+ * bytes. Keys are fetched through the transport's request path and cached
+ * by URL; the IV is the playlist's or, absent one, the media sequence
+ * number. SAMPLE-AES is not this: it decrypts inside the elementary stream
+ * and stays deferred (docs/16).
+ */
+import type { SegmentKey } from '../../types/ir.js';
+import type { Stage } from '../../types/stage.js';
+/** The 16-byte IV: the explicit hex one, or the sequence number big-endian. */
+export declare function ivFor(key: SegmentKey, seq: number): Uint8Array;
+export default function aes128(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/aes-128/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/aes-128/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAKlD,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAW9D;AAmBD,MAAM,CAAC,OAAO,UAAU,MAAM,IAAI,KAAK,CAiDtC"}

package/dist/stages/aes-128/index.js

@@ -0,0 +1,78 @@
+/** Before the transmux (100) and the codec probe (5), which must read clear bytes. */
+const DECRYPT_ORDER = 1;
+/** The 16-byte IV: the explicit hex one, or the sequence number big-endian. */
+export function ivFor(key, seq) {
+    const iv = new Uint8Array(16);
+    if (key.iv !== undefined) {
+        const hex = key.iv.slice(-32).padStart(32, '0');
+        for (let i = 0; i < 16; i += 1)
+            iv[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+        return iv;
+    }
+    const view = new DataView(iv.buffer);
+    view.setUint32(8, Math.floor(seq / 2 ** 32));
+    view.setUint32(12, seq >>> 0);
+    return iv;
+}
+function findSegment(state, renditionId, seq) {
+    if (state.presentation === null || renditionId === '')
+        return null;
+    for (const period of state.presentation.periods) {
+        for (const track of period.tracks) {
+            for (const rendition of track.renditions) {
+                if (rendition.id !== renditionId || !Array.isArray(rendition.segments))
+                    continue;
+                return rendition.segments.find((segment) => segment.seq === seq) ?? null;
+            }
+        }
+    }
+    return null;
+}
+export default function aes128() {
+    return {
+        name: 'aes-128',
+        // media-transform routes appends through the pipeline; the step itself
+        // leaves timing alone, so it is not media-time-normalized.
+        provides: ['aes-128', 'media-transform'],
+        install(ctx) {
+            const keys = new Map();
+            function keyFor(uri) {
+                let pending = keys.get(uri);
+                if (pending === undefined) {
+                    pending = ctx
+                        .request(uri, {})
+                        .then(async (response) => {
+                        if (!response.ok)
+                            throw new Error(`key fetch failed: HTTP ${response.status}`);
+                        const raw = await response.arrayBuffer();
+                        if (raw.byteLength !== 16)
+                            throw new Error(`key is ${raw.byteLength} bytes, not 16`);
+                        return crypto.subtle.importKey('raw', raw, { name: 'AES-CBC' }, false, ['decrypt']);
+                    })
+                        .catch((err) => {
+                        // A failed fetch is not cached: the next segment retries it.
+                        keys.delete(uri);
+                        throw err;
+                    });
+                    keys.set(uri, pending);
+                }
+                return pending;
+            }
+            ctx.registerTransform({
+                name: 'aes-128',
+                order: DECRYPT_ORDER,
+                async transform(data, meta) {
+                    const segment = findSegment(ctx.getState(), meta.renditionId, meta.seq);
+                    const key = segment?.key;
+                    if (key === undefined)
+                        return data;
+                    const cryptoKey = await keyFor(key.uri);
+                    const clear = await crypto.subtle.decrypt({ name: 'AES-CBC', iv: ivFor(key, meta.seq) }, cryptoKey, data);
+                    return new Uint8Array(clear);
+                },
+            });
+            return () => keys.clear();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/aes-128/index.js.map

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

package/dist/stages/alt-audio/index.d.ts

@@ -0,0 +1,4 @@
+import type { Stage } from '../../types/stage.js';
+/** The stage factory. */
+export default function altAudio(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/alt-audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/alt-audio/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAmGlD,yBAAyB;AACzB,MAAM,CAAC,OAAO,UAAU,QAAQ,IAAI,KAAK,CAWxC"}

package/dist/stages/alt-audio/index.js

@@ -0,0 +1,90 @@
+const INITIAL = { preferredLang: null };
+/** Audio tracks with their group parsed from the `group:name` id convention. */
+function audioTracks(kernel) {
+    const out = [];
+    for (const period of kernel.presentation?.periods ?? []) {
+        for (const track of period.tracks) {
+            if (track.contentType !== 'audio')
+                continue;
+            const colon = track.id.indexOf(':');
+            out.push({
+                id: track.id,
+                group: colon === -1 ? track.id : track.id.slice(0, colon),
+                lang: track.lang ?? null,
+                isDefault: track.role === 'main',
+            });
+        }
+    }
+    return out;
+}
+/** The audio group the active video rendition's coupling requires, or null. */
+function requiredGroup(kernel) {
+    const activeVideo = kernel.quality.active;
+    if (activeVideo === null)
+        return null;
+    const coupling = kernel.presentation?.couplings.find((c) => c.renditionId === activeVideo);
+    return coupling?.requires.audio ?? null;
+}
+/** Picks the audio track in `group`, preferring a language, then default, then first. */
+function pickInGroup(tracks, group, preferredLang) {
+    const inGroup = tracks.filter((t) => t.group === group);
+    if (inGroup.length === 0)
+        return null;
+    return ((preferredLang !== null ? inGroup.find((t) => t.lang === preferredLang) : undefined) ??
+        inGroup.find((t) => t.isDefault) ??
+        inGroup[0]);
+}
+/** Loops a command back into the bus through a zero-delay schedule effect. */
+function select(trackId) {
+    return {
+        kind: 'schedule',
+        token: 'alt-audio:select',
+        delayMs: 0,
+        // biome-ignore lint/suspicious/noThenProperty: `then` is the schedule effect's field name from the message taxonomy
+        then: { type: 'SELECT_TRACK', trackId },
+    };
+}
+const reduceAltAudio = (slice, msg, kernel) => {
+    const state = slice ?? INITIAL;
+    if (msg.type === 'LOAD' || msg.type === 'UNLOAD' || msg.type === 'DETACH') {
+        return [INITIAL, []];
+    }
+    // Remember an explicit audio selection as a language preference.
+    if (msg.type === 'SELECT_TRACK') {
+        const chosen = audioTracks(kernel).find((t) => t.id === msg.trackId);
+        if (chosen?.lang != null)
+            return [{ preferredLang: chosen.lang }, []];
+        return [state, []];
+    }
+    // A manifest landing or a video rendition change may require a different
+    // audio group. Reconcile the active audio track to it.
+    if (msg.type === 'MANIFEST_LOADED' || msg.type === 'SEGMENT_LOADED') {
+        const group = requiredGroup(kernel);
+        if (group === null)
+            return [state, []];
+        const active = kernel.tracks.active.get('audio');
+        const tracks = audioTracks(kernel);
+        const activeInfo = tracks.find((t) => t.id === active);
+        if (activeInfo !== undefined && activeInfo.group === group)
+            return [state, []];
+        const target = pickInGroup(tracks, group, state.preferredLang);
+        if (target === undefined || target === null || target.id === active)
+            return [state, []];
+        return [state, [select(target.id)]];
+    }
+    return [state, []];
+};
+/** The stage factory. */
+export default function altAudio() {
+    return {
+        name: 'alt-audio',
+        provides: ['alt-audio'],
+        // docs/06: audio group switching crosses codec boundaries, so the
+        // changeType machinery must be present; the loader pulls codec-switch in.
+        requires: ['scheduler', 'codec-switch'],
+        install(ctx) {
+            ctx.reduce('alt-audio', reduceAltAudio);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/alt-audio/index.js.map

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

package/dist/stages/cmaf-timing/index.d.ts

@@ -0,0 +1,3 @@
+import type { Stage } from '../../types/stage.js';
+export default function cmafTiming(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/cmaf-timing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/cmaf-timing/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAKlD,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,KAAK,CAiC1C"}

package/dist/stages/cmaf-timing/index.js

@@ -0,0 +1,56 @@
+/**
+ * cmaf-timing normalizes the decode timeline of native fMP4 segments so a live
+ * CMAF stream plays. A CMAF live segment's tfdt carries the real broadcast
+ * clock (often a value in the billions of seconds); appended with the zero
+ * timestampOffset the kernel derives for fMP4, its frames land far past the
+ * playhead and nothing ever renders. This stage rewrites each segment's tfdt to
+ * the presentation start the manifest assigns it, which is the same alignment a
+ * TS transmux produces for free, so VOD (already near zero) is untouched and
+ * live is corrected.
+ *
+ * It contributes a transform step and the `media-transform` capability, so the
+ * append path routes through the transform pipeline for a CMAF composition too.
+ * Timescales come from the init segment's moov; the transform runs after any
+ * transmux, and a decrypt step never touches the moof header, so an encrypted
+ * segment is normalized the same way.
+ */
+import { findBox, normalizeTfdt, trackTimescales } from '../../containers/mp4-box/index.js';
+/** After ts-transmux (100) and any decrypt-class step, before the append. */
+const ORDER = 150;
+export default function cmafTiming() {
+    return {
+        name: 'cmaf-timing',
+        provides: ['cmaf-timing', 'media-transform', 'media-time-normalized'],
+        install(ctx) {
+            // Track-id to timescale, learned from init segments, per content type.
+            const timescales = new Map();
+            ctx.registerTransform({
+                name: 'cmaf-timing',
+                order: ORDER,
+                transform(data, meta) {
+                    if (meta.contentType !== 'video' && meta.contentType !== 'audio')
+                        return data;
+                    // An init segment carries the moov: learn each track's timescale.
+                    if (findBox(data, 'moov') !== null) {
+                        const scales = trackTimescales(data);
+                        if (scales.size > 0)
+                            timescales.set(meta.contentType, scales);
+                    }
+                    // A media segment carries a moof: align its decode clock to the
+                    // presentation start the manifest gave it. Without a known timescale
+                    // (no init seen yet) leave the bytes alone rather than guess.
+                    if (findBox(data, 'moof') !== null) {
+                        const scales = timescales.get(meta.contentType);
+                        if (scales !== undefined && scales.size > 0) {
+                            const fallback = [...scales.values()][0] ?? 0;
+                            normalizeTfdt(data, meta.start, scales, fallback);
+                        }
+                    }
+                    return data;
+                },
+            });
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/cmaf-timing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stages/cmaf-timing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAI5F,6EAA6E;AAC7E,MAAM,KAAK,GAAG,GAAG,CAAC;AAElB,MAAM,CAAC,OAAO,UAAU,UAAU;IAChC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,CAAC,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,CAAC;QACrE,OAAO,CAAC,GAAG;YACT,uEAAuE;YACvE,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;YAC1D,GAAG,CAAC,iBAAiB,CAAC;gBACpB,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,KAAK;gBACZ,SAAS,CAAC,IAAgB,EAAE,IAAiB;oBAC3C,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO;wBAAE,OAAO,IAAI,CAAC;oBAC9E,kEAAkE;oBAClE,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;wBACnC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;wBACrC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC;4BAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;oBAChE,CAAC;oBACD,gEAAgE;oBAChE,qEAAqE;oBACrE,8DAA8D;oBAC9D,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;wBACnC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBAChD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;4BAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;4BAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;wBACpD,CAAC;oBACH,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;aACF,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stages/cmcd/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Common Media Client Data (CTA-5004). The engine already exposes the seam
+ * this needs: a request hook that sees every outgoing segment and manifest
+ * URL. This stage reads playback state through the stage context and appends
+ * the CMCD keys a CDN reads to understand the session, as either a query
+ * argument or request headers.
+ *
+ * It computes nothing the kernel does not already track: the active rendition
+ * bitrate, the measured throughput EWMA, and the buffer ahead of the playhead
+ * from the media element. No new kernel state, no new effect.
+ */
+import type { Stage } from '../../types/stage.js';
+export interface CmcdOptions {
+    /** A stable content id, echoed as `cid`. */
+    readonly contentId?: string;
+    /** 'query' appends a CMCD argument to the URL; 'header' sends CMCD-* headers. */
+    readonly mode?: 'query' | 'header';
+    /** Overrides the generated session id, echoed as `sid`. */
+    readonly sessionId?: string;
+}
+export default function cmcd(options?: CmcdOptions): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/cmcd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/cmcd/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA+BD,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,KAAK,CAmD7D"}

package/dist/stages/cmcd/index.js

@@ -0,0 +1,92 @@
+/** The CMCD object type, inferred from the URL the request is fetching. */
+function objectType(url) {
+    if (/\.(m3u8|mpd)(\?|$)/i.test(url))
+        return 'm';
+    if (/\.(vtt|srt)(\?|$)/i.test(url))
+        return 'c';
+    if (/\.(aac|mp3|ac3|m4a)(\?|$)/i.test(url))
+        return 'a';
+    return 'av';
+}
+/** CMCD keys whose value is an enumerated token, sent unquoted. */
+const TOKEN_KEYS = new Set(['ot', 'sf', 'st']);
+/**
+ * Serializes CMCD keys per CTA-5004: sorted, booleans bare, tokens unquoted,
+ * and true strings (sid, cid) quoted.
+ */
+function serialize(keys) {
+    return Object.keys(keys)
+        .sort()
+        .map((key) => {
+        const value = keys[key];
+        if (value === true)
+            return key;
+        if (typeof value === 'string') {
+            return TOKEN_KEYS.has(key) ? `${key}=${value}` : `${key}=${JSON.stringify(value)}`;
+        }
+        return `${key}=${value}`;
+    })
+        .join(',');
+}
+export default function cmcd(options = {}) {
+    const sessionId = options.sessionId ??
+        globalThis.crypto?.randomUUID?.() ??
+        `mb-${Math.random().toString(36).slice(2)}`;
+    const mode = options.mode ?? 'query';
+    return {
+        name: 'cmcd',
+        provides: ['cmcd'],
+        requires: ['transport'],
+        install(ctx) {
+            ctx.addRequestHook((req) => {
+                const state = ctx.getState();
+                const keys = {
+                    sid: sessionId,
+                    ot: objectType(req.url),
+                };
+                if (options.contentId !== undefined)
+                    keys.cid = options.contentId;
+                // Encoded bitrate of the active rendition, in kbps.
+                const activeId = state.quality.active;
+                if (activeId !== null && state.presentation !== null) {
+                    for (const period of state.presentation.periods) {
+                        for (const track of period.tracks) {
+                            const rendition = track.renditions.find((r) => r.id === activeId);
+                            if (rendition !== undefined)
+                                keys.br = Math.round(rendition.bitrate / 1000);
+                        }
+                    }
+                }
+                // Measured throughput EWMA, in kbps, rounded to the spec's 100 kbps.
+                const mtp = state.stats.throughputEwma;
+                if (mtp > 0)
+                    keys.mtp = Math.round(mtp / 1000 / 100) * 100;
+                // Buffer ahead of the playhead, in ms, from the element.
+                const el = ctx.element;
+                const ahead = bufferAhead(el);
+                if (ahead !== null)
+                    keys.bl = Math.round((ahead * 1000) / 100) * 100;
+                if (ahead !== null && ahead < 1)
+                    keys.su = true;
+                const payload = serialize(keys);
+                if (mode === 'header') {
+                    req.headers['CMCD-Request'] = payload;
+                }
+                else {
+                    const separator = req.url.includes('?') ? '&' : '?';
+                    req.url = `${req.url}${separator}CMCD=${encodeURIComponent(payload)}`;
+                }
+            });
+        },
+    };
+}
+function bufferAhead(el) {
+    const { buffered, currentTime } = el;
+    for (let i = 0; i < buffered.length; i += 1) {
+        if (buffered.start(i) <= currentTime && currentTime <= buffered.end(i)) {
+            return buffered.end(i) - currentTime;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/cmcd/index.js.map

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

package/dist/stages/codec-probe/index.d.ts

@@ -0,0 +1,9 @@
+import type { Stage } from '../../types/stage.js';
+export interface CodecProbeApi {
+    /** The codec strings derived from the most recent init segment. */
+    readonly detected: readonly string[];
+    /** The MSE mime type the probe reconstructed, ready for isTypeSupported. */
+    readonly mimeType: string | null;
+}
+export default function codecProbe(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/codec-probe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/codec-probe/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAYD,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,KAAK,CAuC1C"}

package/dist/stages/codec-probe/index.js

@@ -0,0 +1,68 @@
+/**
+ * codec-probe as a loadable stage. The derivation itself lives in the
+ * container layer (probeInitSegment reads the stsd sample entries and rebuilds
+ * the RFC 6381 string from avcC/hvcC/esds/vpcC/dOps). This stage is the
+ * runtime call site the container never had: a transform that watches init
+ * segments, publishes what it derived on `engine.codecProbe`, and emits a
+ * `codecprobe:detected` event.
+ *
+ * It also registers the composition's type probe: a rendition the manifest
+ * left codec-less (a bare media playlist) gets its SourceBuffer typed from
+ * its first segment instead of the bare `video/mp4` Chrome refuses. A
+ * manifest that does declare codecs still creates the buffer as declared;
+ * a mismatch with the probe surfaces on the event for a follow-up stage.
+ */
+import { probeInitSegment } from '../../containers/codec-probe/index.js';
+/** A media segment carries a moof; only an init segment carries a moov. */
+function isInitSegment(data) {
+    for (let i = 4; i + 4 <= data.byteLength && i < 64; i += 1) {
+        if (data[i] === 0x6d && data[i + 1] === 0x6f && data[i + 2] === 0x6f && data[i + 3] === 0x76) {
+            return true; // 'moov'
+        }
+    }
+    return false;
+}
+export default function codecProbe() {
+    return {
+        name: 'codec-probe',
+        provides: ['codec-probe'],
+        requires: ['mp4-box'],
+        install(ctx) {
+            let detected = [];
+            let mimeType = null;
+            ctx.registerNamespace('codecProbe', {
+                get detected() {
+                    return detected;
+                },
+                get mimeType() {
+                    return mimeType;
+                },
+            });
+            ctx.registerTypeProbe((bytes) => {
+                if (!isInitSegment(bytes))
+                    return null;
+                const result = probeInitSegment(bytes);
+                return result.codecs.length > 0 ? result.mimeType : null;
+            });
+            ctx.registerTransform({
+                name: 'codec-probe',
+                // Early, so it reads the init before any transmux rewraps it.
+                order: 5,
+                transform(data, meta) {
+                    if (meta.contentType !== 'video' && meta.contentType !== 'audio')
+                        return data;
+                    if (!isInitSegment(data))
+                        return data;
+                    const result = probeInitSegment(data);
+                    if (result.codecs.length > 0) {
+                        detected = result.codecs;
+                        mimeType = result.mimeType;
+                        ctx.emit('codecprobe:detected', { codecs: result.codecs, mimeType: result.mimeType });
+                    }
+                    return data;
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/codec-probe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stages/codec-probe/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAWzE,2EAA2E;AAC3E,SAAS,aAAa,CAAC,IAAgB;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC7F,OAAO,IAAI,CAAC,CAAC,SAAS;QACxB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,UAAU;IAChC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,CAAC,GAAG;YACT,IAAI,QAAQ,GAAsB,EAAE,CAAC;YACrC,IAAI,QAAQ,GAAkB,IAAI,CAAC;YACnC,GAAG,CAAC,iBAAiB,CAAC,YAAY,EAAE;gBAClC,IAAI,QAAQ;oBACV,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,IAAI,QAAQ;oBACV,OAAO,QAAQ,CAAC;gBAClB,CAAC;aACsB,CAAC,CAAC;YAC3B,GAAG,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACvC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACvC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3D,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,iBAAiB,CAAC;gBACpB,IAAI,EAAE,aAAa;gBACnB,8DAA8D;gBAC9D,KAAK,EAAE,CAAC;gBACR,SAAS,CAAC,IAAgB,EAAE,IAAiB;oBAC3C,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO;wBAAE,OAAO,IAAI,CAAC;oBAC9E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;wBAAE,OAAO,IAAI,CAAC;oBACtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBACtC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC7B,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;wBACzB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;wBAC3B,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACxF,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stages/codec-switch/index.d.ts

@@ -0,0 +1,6 @@
+import type { Rendition } from '../../types/ir.js';
+import type { SwitchVerdict } from '../../types/quality.js';
+import type { Stage } from '../../types/stage.js';
+export declare function createPolicy(): (current: Rendition | null, target: Rendition) => SwitchVerdict;
+export default function codecSwitch(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/codec-switch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/codec-switch/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAyBlD,wBAAgB,YAAY,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,KAAK,aAAa,CAO9F;AAED,MAAM,CAAC,OAAO,UAAU,WAAW,IAAI,KAAK,CAa3C"}

package/dist/stages/codec-switch/index.js

@@ -0,0 +1,59 @@
+/**
+ * codec-switch: the real answer to entanglement #2's query. It registers a
+ * switch policy the kernel injects into abr's telemetry; abr consumes it
+ * without importing this stage. The refinement over the kernel default: a
+ * changeType verdict is only returned when the browser can actually bridge
+ * the two codecs, which needs both a supported target type and
+ * SourceBuffer.changeType itself. Where the browser cannot, an in-family
+ * change downgrades to reload rather than proposing a switch that would
+ * throw at append time.
+ *
+ * codec-probe (declared in `requires`, resolved by the loader, never
+ * imported) is the future source of exact codec strings when a manifest
+ * lies; until a runtime call site exists this policy reasons over the IR's
+ * declared strings, which is already a real improvement.
+ */
+import { canSwitchTo } from '../../kernel/rendition-select.js';
+/** A full MSE type string for a rendition, mime plus codecs. */
+function typeString(rendition) {
+    return rendition.codecs === null
+        ? rendition.mimeType
+        : `${rendition.mimeType}; codecs="${rendition.codecs}"`;
+}
+/** Whether the runtime can bridge two types without tearing the buffer down. */
+function changeTypeSupported(target) {
+    const MediaSourceCtor = typeof MediaSource !== 'undefined'
+        ? MediaSource
+        : globalThis.ManagedMediaSource;
+    if (MediaSourceCtor === undefined)
+        return false;
+    if (typeof globalThis.SourceBuffer?.prototype?.changeType !==
+        'function') {
+        return false;
+    }
+    return MediaSourceCtor.isTypeSupported(typeString(target));
+}
+export function createPolicy() {
+    return (current, target) => {
+        const base = canSwitchTo(current, target);
+        if (base !== 'changeType')
+            return base;
+        // The kernel says a changeType would do; confirm the browser agrees.
+        return changeTypeSupported(target) ? 'changeType' : 'reload';
+    };
+}
+export default function codecSwitch() {
+    return {
+        name: 'codec-switch',
+        provides: ['codec-switch'],
+        // docs/05 also lists codec-probe; that becomes a real `requires` once
+        // the probe has a runtime call site (tracked in the register). Until
+        // then this policy reasons over declared strings and needs only mse's
+        // changeType.
+        requires: ['mse'],
+        install(ctx) {
+            ctx.registerSwitchPolicy(createPolicy());
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/codec-switch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stages/codec-switch/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAK/D,gEAAgE;AAChE,SAAS,UAAU,CAAC,SAAoB;IACtC,OAAO,SAAS,CAAC,MAAM,KAAK,IAAI;QAC9B,CAAC,CAAC,SAAS,CAAC,QAAQ;QACpB,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,aAAa,SAAS,CAAC,MAAM,GAAG,CAAC;AAC5D,CAAC;AAED,gFAAgF;AAChF,SAAS,mBAAmB,CAAC,MAAiB;IAC5C,MAAM,eAAe,GACnB,OAAO,WAAW,KAAK,WAAW;QAChC,CAAC,CAAC,WAAW;QACb,CAAC,CAAE,UAA0D,CAAC,kBAAkB,CAAC;IACrF,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAChD,IACE,OAAQ,UAAU,CAAC,YAAY,EAAE,SAAsC,EAAE,UAAU;QACnF,UAAU,EACV,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,eAAe,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,YAAY;YAAE,OAAO,IAAI,CAAC;QACvC,qEAAqE;QACrE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,WAAW;IACjC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,sEAAsE;QACtE,qEAAqE;QACrE,sEAAsE;QACtE,cAAc;QACd,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,OAAO,CAAC,GAAG;YACT,GAAG,CAAC,oBAAoB,CAAC,YAAY,EAAE,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stages/content-steering/index.d.ts

@@ -0,0 +1,4 @@
+import type { Stage } from '../../types/stage.js';
+/** The stage factory. */
+export default function contentSteering(): Stage;
+//# sourceMappingURL=index.d.ts.map