mattebox 0.1.0

package/dist/containers/fmp4/writer.js

@@ -0,0 +1,201 @@
+/**
+ * A minimal fragmented-ISOBMFF writer, the counterpart to mp4-box's reader.
+ * It emits exactly the boxes MSE needs to accept a fragment: an init segment
+ * (ftyp + a moov with one trak per elementary stream and an mvex) and a
+ * media segment (moof + mdat). A muxed TS segment becomes one init with a
+ * video trak and an audio trak, so a single SourceBuffer decodes both.
+ * Nothing here reads the clock or a random source: identical samples in
+ * produce identical bytes out, which is what the golden fixtures pin.
+ *
+ * ts-transmux and packed-audio both import this module. It is a shared
+ * container utility, not a stage, so neither imports the other.
+ */
+// ---- box primitives -------------------------------------------------------
+function fourcc(type) {
+    return [type.charCodeAt(0), type.charCodeAt(1), type.charCodeAt(2), type.charCodeAt(3)];
+}
+/** Concatenates children under a box header. Sizes are computed, never assumed. */
+function box(type, ...children) {
+    let length = 8;
+    for (const child of children)
+        length += child.byteLength;
+    const out = new Uint8Array(length);
+    new DataView(out.buffer).setUint32(0, length);
+    out.set(fourcc(type), 4);
+    let offset = 8;
+    for (const child of children) {
+        out.set(child, offset);
+        offset += child.byteLength;
+    }
+    return out;
+}
+/** A FullBox: version byte plus 24-bit flags ahead of the payload. */
+function fullBox(type, version, flags, ...children) {
+    const head = u8(version, (flags >> 16) & 0xff, (flags >> 8) & 0xff, flags & 0xff);
+    return box(type, head, ...children);
+}
+function u8(...values) {
+    return Uint8Array.from(values, (v) => v & 0xff);
+}
+function u16(value) {
+    return u8((value >> 8) & 0xff, value & 0xff);
+}
+function u32(value) {
+    return u8((value >>> 24) & 0xff, (value >> 16) & 0xff, (value >> 8) & 0xff, value & 0xff);
+}
+/** A 64-bit unsigned as two 32-bit halves; JS numbers hold this range exactly to 2^53. */
+function u64(value) {
+    return concat(u32(Math.floor(value / 0x1_0000_0000)), u32(value >>> 0));
+}
+function concat(...parts) {
+    let length = 0;
+    for (const part of parts)
+        length += part.byteLength;
+    const out = new Uint8Array(length);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.byteLength;
+    }
+    return out;
+}
+const UNITY_MATRIX = concat(u32(0x0001_0000), u32(0), u32(0), u32(0), u32(0x0001_0000), u32(0), u32(0), u32(0), u32(0x4000_0000));
+// ---- init segment ---------------------------------------------------------
+function ftyp() {
+    return box('ftyp', u8(...fourcc('isom')), u32(0x200), u8(...fourcc('isom')), u8(...fourcc('iso6')), u8(...fourcc('mp41')));
+}
+function avcC(config) {
+    const { sps, pps } = config;
+    return box('avcC', u8(1, sps[1] ?? 0, sps[2] ?? 0, sps[3] ?? 0), 
+    // lengthSizeMinusOne: 0xFF -> reserved bits set, 4-byte NAL length.
+    u8(0xff), 
+    // numOfSequenceParameterSets: reserved bits set, count 1.
+    u8(0xe1), u16(sps.byteLength), sps, u8(1), u16(pps.byteLength), pps);
+}
+function avc1(config) {
+    return box('avc1', u8(0, 0, 0, 0, 0, 0), u16(1), u16(0), u16(0), u32(0), u32(0), u32(0), u16(config.width), u16(config.height), u32(0x0048_0000), u32(0x0048_0000), u32(0), u16(1), new Uint8Array(32), u16(0x18), u16(0xffff), avcC(config));
+}
+function esds(config) {
+    const asc = u8((config.audioObjectType << 3) | (config.samplingFrequencyIndex >> 1), ((config.samplingFrequencyIndex & 1) << 7) | (config.channelConfig << 3));
+    const dsi = concat(u8(0x05, asc.byteLength), asc);
+    const dcd = concat(u8(0x04, 13 + dsi.byteLength, 0x40, 0x15), u8(0, 0, 0), u32(0), u32(0), dsi);
+    const sl = u8(0x06, 0x01, 0x02);
+    const es = concat(u8(0x03, 3 + dcd.byteLength + sl.byteLength, 0, 0, 0), dcd, sl);
+    return fullBox('esds', 0, 0, es);
+}
+function mp4a(config) {
+    return box('mp4a', u8(0, 0, 0, 0, 0, 0), u16(1), u32(0), u32(0), u16(config.channelConfig), u16(16), u16(0), u16(0), u32((config.timescale << 16) >>> 0), esds(config));
+}
+function stbl(config) {
+    const entry = config.kind === 'video' ? avc1(config) : mp4a(config);
+    return box('stbl', fullBox('stsd', 0, 0, u32(1), entry), fullBox('stts', 0, 0, u32(0)), fullBox('stsc', 0, 0, u32(0)), fullBox('stsz', 0, 0, u32(0), u32(0)), fullBox('stco', 0, 0, u32(0)));
+}
+function minf(config) {
+    const header = config.kind === 'video'
+        ? fullBox('vmhd', 0, 1, u16(0), u16(0), u16(0), u16(0))
+        : fullBox('smhd', 0, 0, u16(0), u16(0));
+    const dref = fullBox('dref', 0, 0, u32(1), fullBox('url ', 0, 1));
+    return box('minf', header, box('dinf', dref), stbl(config));
+}
+function hdlr(config) {
+    const handler = config.kind === 'video' ? 'vide' : 'soun';
+    const name = config.kind === 'video' ? 'VideoHandler' : 'SoundHandler';
+    return fullBox('hdlr', 0, 0, u32(0), u8(...fourcc(handler)), u32(0), u32(0), u32(0), concat(u8(...[...name].map((c) => c.charCodeAt(0))), u8(0)));
+}
+function mdia(config) {
+    const mdhd = fullBox('mdhd', 0, 0, u32(0), u32(0), u32(config.timescale), u32(0), u16(0x55c4), u16(0));
+    return box('mdia', mdhd, hdlr(config), minf(config));
+}
+function tkhd(config) {
+    const w = config.kind === 'video' ? config.width : 0;
+    const h = config.kind === 'video' ? config.height : 0;
+    return fullBox('tkhd', 0, 0x7, u32(0), u32(0), u32(config.id), u32(0), u32(0), u32(0), u32(0), u16(0), u16(0), u16(config.kind === 'audio' ? 0x0100 : 0), u16(0), UNITY_MATRIX, u32((w << 16) >>> 0), u32((h << 16) >>> 0));
+}
+function trak(config) {
+    return box('trak', tkhd(config), mdia(config));
+}
+function mvhd(nextTrackId) {
+    return fullBox('mvhd', 0, 0, u32(0), u32(0), u32(90000), u32(0), u32(0x0001_0000), u16(0x0100), u16(0), u32(0), u32(0), UNITY_MATRIX, concat(u32(0), u32(0), u32(0), u32(0), u32(0), u32(0)), u32(nextTrackId));
+}
+function mvex(configs) {
+    const trexes = configs.map((config) => fullBox('trex', 0, 0, u32(config.id), u32(1), u32(0), u32(0), u32(0)));
+    return box('mvex', ...trexes);
+}
+/** The init segment: ftyp then a moov describing every track. */
+export function writeInitSegment(configs) {
+    let maxId = 0;
+    for (const config of configs)
+        maxId = Math.max(maxId, config.id);
+    const moov = box('moov', mvhd(maxId + 1), ...configs.map(trak), mvex(configs));
+    return concat(ftyp(), moov);
+}
+// ---- media segment --------------------------------------------------------
+const TRUN_FLAGS = 0x0001 | 0x0100 | 0x0200 | 0x0400 | 0x0800;
+const TFHD_FLAGS = 0x020000; // default-base-is-moof
+function sampleFlags(sample) {
+    return sample.isKeyframe ? 0x0200_0000 : (0x0001_0000 | 0x0100_0000) >>> 0;
+}
+function traf(fragment, trunHead) {
+    const tfhd = fullBox('tfhd', 0, TFHD_FLAGS, u32(fragment.trackId));
+    const tfdt = fullBox('tfdt', 1, 0, u64(fragment.baseMediaDecodeTime));
+    const entries = new Uint8Array(fragment.samples.length * 16);
+    const view = new DataView(entries.buffer);
+    for (let i = 0; i < fragment.samples.length; i += 1) {
+        const sample = fragment.samples[i];
+        const base = i * 16;
+        view.setUint32(base, sample.duration);
+        view.setUint32(base + 4, sample.data.byteLength);
+        view.setUint32(base + 8, sampleFlags(sample));
+        view.setUint32(base + 12, sample.cts);
+    }
+    const trun = fullBox('trun', 1, TRUN_FLAGS, trunHead, entries);
+    return box('traf', tfhd, tfdt, trun);
+}
+/**
+ * The moof/mdat pair for one or more track fragments. Each trun's data offset
+ * is back-patched once the moof size is known, so the offsets are exact
+ * regardless of how many tracks the fragment carries or how large the trafs
+ * grew. The mdat interleaves tracks in the order given.
+ */
+export function writeMediaSegment(sequenceNumber, fragments) {
+    const mfhd = fullBox('mfhd', 0, 0, u32(sequenceNumber));
+    // Build each traf with a placeholder data offset, then back-patch below.
+    const trafs = fragments.map((fragment) => traf(fragment, concat(u32(fragment.samples.length), u32(0))));
+    const moof = box('moof', mfhd, ...trafs);
+    const moofView = new DataView(moof.buffer);
+    // The mdat payload begins right after the moof. Each track's samples follow
+    // the previous track's in the mdat, so its data offset is the moof size plus
+    // the mdat header plus the running byte total ahead of it.
+    let trafOffsetInMoof = 8 + mfhd.byteLength;
+    let mdatCursor = moof.byteLength + 8;
+    for (const [i, fragment] of fragments.entries()) {
+        const thisTraf = trafs[i];
+        // trun payload begins at: traf header(8) + tfhd + tfdt + trun header(8) + fullbox(4) + sample_count(4).
+        const tfhdLen = 8 + 4 + 4;
+        const tfdtLen = 8 + 4 + 8;
+        const trunDataOffsetPos = trafOffsetInMoof + 8 + tfhdLen + tfdtLen + 8 + 4 + 4;
+        moofView.setUint32(trunDataOffsetPos, mdatCursor);
+        let fragmentBytes = 0;
+        for (const sample of fragment.samples)
+            fragmentBytes += sample.data.byteLength;
+        mdatCursor += fragmentBytes;
+        trafOffsetInMoof += thisTraf.byteLength;
+    }
+    let mdatLength = 0;
+    for (const fragment of fragments) {
+        for (const sample of fragment.samples)
+            mdatLength += sample.data.byteLength;
+    }
+    const mdat = new Uint8Array(8 + mdatLength);
+    new DataView(mdat.buffer).setUint32(0, mdat.byteLength);
+    mdat.set(fourcc('mdat'), 4);
+    let offset = 8;
+    for (const fragment of fragments) {
+        for (const sample of fragment.samples) {
+            mdat.set(sample.data, offset);
+            offset += sample.data.byteLength;
+        }
+    }
+    return concat(moof, mdat);
+}
+//# sourceMappingURL=writer.js.map

package/dist/containers/fmp4/writer.js.map

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

package/dist/containers/id3.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ID3v2 framing, shared by packed-audio (which skips the leading tag before
+ * the ADTS frames) and meta-id3 (which turns the frames into metadata cues).
+ * Living in the container layer keeps the stage from importing a sibling
+ * stage. Every size read is synchsafe-aware and bounded by the buffer, so a
+ * malformed tag reports the length it could trust rather than overrunning.
+ */
+import type { CueDescriptor } from '../types/messages.js';
+/** The full byte length of the ID3v2 tag at `offset`, or zero if none is there. */
+export declare function id3TagLength(data: Uint8Array, offset?: number): number;
+/** One decoded ID3 frame: its four-character id and its raw payload bytes. */
+export interface Id3Frame {
+    readonly id: string;
+    readonly data: Uint8Array;
+}
+/** Parses the frames of one ID3v2 tag. Stops at padding or a bad frame. */
+export declare function parseId3Frames(data: Uint8Array, offset?: number): Id3Frame[];
+/**
+ * Turns an ID3 tag's frames into metadata cues at `presentationTime`. Text
+ * frames carry their decoded string; every frame keeps its raw bytes on the
+ * payload so a consumer can read a format this decoder does not special-case.
+ * The cues are zero-length, which is how timed metadata is represented.
+ */
+export declare function id3Cues(data: Uint8Array, presentationTime: number, offset?: number): CueDescriptor[];
+//# sourceMappingURL=id3.d.ts.map

package/dist/containers/id3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id3.d.ts","sourceRoot":"","sources":["../../src/containers/id3.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AAkBxE,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,SAAI,GAAG,MAAM,CAKjE;AAED,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAaD,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,SAAI,GAAG,QAAQ,EAAE,CAsBvE;AAUD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,aAAa,EAAE,CAU/F"}

package/dist/containers/id3.js

@@ -0,0 +1,75 @@
+const HEADER_SIZE = 10;
+function isId3(data, offset) {
+    return data[offset] === 0x49 && data[offset + 1] === 0x44 && data[offset + 2] === 0x33;
+}
+/** A 28-bit synchsafe integer: four bytes, seven bits each. */
+function synchsafe(data, offset) {
+    return (((data[offset] ?? 0) << 21) |
+        ((data[offset + 1] ?? 0) << 14) |
+        ((data[offset + 2] ?? 0) << 7) |
+        (data[offset + 3] ?? 0));
+}
+/** The full byte length of the ID3v2 tag at `offset`, or zero if none is there. */
+export function id3TagLength(data, offset = 0) {
+    if (offset + HEADER_SIZE > data.byteLength || !isId3(data, offset))
+        return 0;
+    const size = synchsafe(data, offset + 6);
+    const total = HEADER_SIZE + size;
+    return offset + total <= data.byteLength ? total : 0;
+}
+function frameSize(data, offset, major) {
+    // 2.4 uses synchsafe frame sizes; 2.3 uses a plain 32-bit big-endian size.
+    if (major >= 4)
+        return synchsafe(data, offset);
+    return (((data[offset] ?? 0) << 24) |
+        ((data[offset + 1] ?? 0) << 16) |
+        ((data[offset + 2] ?? 0) << 8) |
+        (data[offset + 3] ?? 0));
+}
+/** Parses the frames of one ID3v2 tag. Stops at padding or a bad frame. */
+export function parseId3Frames(data, offset = 0) {
+    const total = id3TagLength(data, offset);
+    if (total === 0)
+        return [];
+    const major = data[offset + 3] ?? 0;
+    const frames = [];
+    let cursor = offset + HEADER_SIZE;
+    const end = offset + total;
+    while (cursor + 10 <= end) {
+        const id = String.fromCharCode(data[cursor] ?? 0, data[cursor + 1] ?? 0, data[cursor + 2] ?? 0, data[cursor + 3] ?? 0);
+        // A zero id is padding: the frames are done.
+        if (data[cursor] === 0)
+            break;
+        const size = frameSize(data, cursor + 4, major);
+        if (size <= 0 || cursor + 10 + size > end)
+            break;
+        frames.push({ id, data: data.subarray(cursor + 10, cursor + 10 + size) });
+        cursor += 10 + size;
+    }
+    return frames;
+}
+function decodeTextFrame(frame) {
+    // Text frames lead with an encoding byte; 0 is ISO-8859-1, 3 is UTF-8.
+    const encoding = frame.data[0] ?? 0;
+    const body = frame.data.subarray(1);
+    const label = encoding === 1 || encoding === 2 ? 'utf-16' : 'utf-8';
+    return new TextDecoder(label).decode(body).replace(/\0+$/, '');
+}
+/**
+ * Turns an ID3 tag's frames into metadata cues at `presentationTime`. Text
+ * frames carry their decoded string; every frame keeps its raw bytes on the
+ * payload so a consumer can read a format this decoder does not special-case.
+ * The cues are zero-length, which is how timed metadata is represented.
+ */
+export function id3Cues(data, presentationTime, offset = 0) {
+    const frames = parseId3Frames(data, offset);
+    return frames.map((frame) => {
+        const payload = {
+            key: frame.id,
+            data: [...frame.data],
+            ...(frame.id.startsWith('T') || frame.id === 'WXXX' ? { value: decodeTextFrame(frame) } : {}),
+        };
+        return { start: presentationTime, end: presentationTime, payload };
+    });
+}
+//# sourceMappingURL=id3.js.map

package/dist/containers/id3.js.map

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

package/dist/containers/mp4-box/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * A minimal ISOBMFF box walker, not a general library. It traverses the
+ * box tree handing back offsets, sizes, and payload views, with typed
+ * extraction only for the boxes that have a consumer today: tfdt for the
+ * timeline and sidx for dash-segmentbase. Everything else goes through the
+ * generic walker.
+ *
+ * Malformed input never throws and never loops: every walk either
+ * strictly advances or stops with a MatteboxError value.
+ */
+import type { MatteboxError } from '../../types/error.js';
+/** One box as seen by the walker. `payload` is a subarray view, never a copy. */
+export interface BoxRef {
+    readonly type: string;
+    /** Absolute offset of the box start within the walked buffer. */
+    readonly start: number;
+    /** Total box size including the header. */
+    readonly size: number;
+    readonly headerSize: number;
+    readonly payload: Uint8Array;
+    /** Slash-joined ancestor chain, such as 'moov/trak/mdia'. */
+    readonly path: string;
+}
+export interface WalkResult {
+    readonly error: MatteboxError | null;
+}
+/**
+ * Walks one level plus known containers, depth-first. The visitor sees
+ * every box; returning false stops the walk early without error.
+ */
+export declare function walkBoxes(data: Uint8Array, visit: (box: BoxRef) => boolean | undefined): WalkResult;
+/** The first box matching a slash path such as 'moov/trak/mdia/minf/stbl/stsd'. */
+export declare function findBox(data: Uint8Array, path: string): BoxRef | null;
+/** Every box matching the path, in document order. trak repeats, for one. */
+export declare function findBoxes(data: Uint8Array, path: string): readonly BoxRef[];
+export interface FullBoxHeader {
+    readonly version: number;
+    readonly flags: number;
+    readonly body: Uint8Array;
+}
+/** Splits a FullBox payload into version, 24-bit flags, and the body view. */
+export declare function fullBox(payload: Uint8Array): FullBoxHeader | null;
+export interface Tfdt {
+    readonly version: number;
+    readonly baseMediaDecodeTime: number;
+}
+/** tfdt: version 1 widens baseMediaDecodeTime to 64 bits. */
+export declare function parseTfdt(payload: Uint8Array): Tfdt | null;
+export interface SidxReference {
+    readonly referencedSize: number;
+    readonly subsegmentDuration: number;
+    readonly startsWithSap: boolean;
+}
+export interface Sidx {
+    readonly version: number;
+    readonly referenceId: number;
+    readonly timescale: number;
+    readonly earliestPresentationTime: number;
+    readonly firstOffset: number;
+    readonly references: readonly SidxReference[];
+}
+/** sidx: version 1 widens the time and offset fields to 64 bits. */
+export declare function parseSidx(payload: Uint8Array): Sidx | null;
+/**
+ * The media timescale of each track, read from moov/trak (tkhd track id paired
+ * with mdhd timescale). CMAF timing normalization needs it to convert a
+ * baseMediaDecodeTime between timescale units and seconds.
+ */
+export declare function trackTimescales(init: Uint8Array): Map<number, number>;
+/**
+ * Rewrites every traf's tfdt baseMediaDecodeTime in place so the segment's
+ * media clock equals its presentation start. A CMAF live segment carries the
+ * real broadcast clock (a huge value); appended with a zero timestampOffset it
+ * would land far off the playhead. Normalizing it to `presentationStart` makes
+ * the segment land exactly where the manifest places it, the same alignment a
+ * TS transmux gives for free. Returns the number of tfdt boxes rewritten.
+ */
+export declare function normalizeTfdt(segment: Uint8Array, presentationStart: number, timescales: ReadonlyMap<number, number>, fallbackTimescale: number): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/containers/mp4-box/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/containers/mp4-box/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,iFAAiF;AACjF,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAgCD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GAC1C,UAAU,CAiDZ;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYrE;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAS3E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,CAMjE;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAU1D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAuC1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BrE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,iBAAiB,EAAE,MAAM,GACxB,MAAM,CA4BR"}

package/dist/containers/mp4-box/index.js

@@ -0,0 +1,231 @@
+/** Container boxes the walker descends into. Only ancestors of consumed boxes. */
+const CONTAINERS = new Set([
+    'moov',
+    'trak',
+    'mdia',
+    'minf',
+    'stbl',
+    'moof',
+    'traf',
+]);
+function malformed(reason, offset) {
+    return {
+        category: 'media',
+        code: 'MEDIA_CONTAINER_INVALID',
+        fatal: false,
+        recoverable: false,
+        context: { reason, offset },
+    };
+}
+function fourcc(view, offset) {
+    return String.fromCharCode(view.getUint8(offset), view.getUint8(offset + 1), view.getUint8(offset + 2), view.getUint8(offset + 3));
+}
+/**
+ * Walks one level plus known containers, depth-first. The visitor sees
+ * every box; returning false stops the walk early without error.
+ */
+export function walkBoxes(data, visit) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    function level(start, end, path) {
+        let offset = start;
+        while (offset < end) {
+            if (end - offset < 8) {
+                return malformed('truncated box header', offset);
+            }
+            let size = view.getUint32(offset);
+            let headerSize = 8;
+            const type = fourcc(view, offset + 4);
+            if (size === 1) {
+                // 64-bit size follows the type.
+                if (end - offset < 16)
+                    return malformed('truncated 64-bit size', offset);
+                const big = view.getBigUint64(offset + 8);
+                if (big > BigInt(Number.MAX_SAFE_INTEGER))
+                    return malformed('size overflow', offset);
+                size = Number(big);
+                headerSize = 16;
+            }
+            else if (size === 0) {
+                // Extends to the end of the enclosing space.
+                size = end - offset;
+            }
+            if (size < headerSize) {
+                // A size smaller than its own header cannot advance: stop rather
+                // than loop.
+                return malformed('box size smaller than header', offset);
+            }
+            if (offset + size > end) {
+                return malformed('box extends past its container', offset);
+            }
+            const payload = data.subarray(offset + headerSize, offset + size);
+            const box = { type, start: offset, size, headerSize, payload, path };
+            if (visit(box) === false)
+                return 'stop';
+            if (CONTAINERS.has(type)) {
+                const nested = level(offset + headerSize, offset + size, path === '' ? type : `${path}/${type}`);
+                if (nested !== null)
+                    return nested;
+            }
+            offset += size;
+        }
+        return null;
+    }
+    const outcome = level(0, data.byteLength, '');
+    return { error: outcome === 'stop' || outcome === null ? null : outcome };
+}
+/** The first box matching a slash path such as 'moov/trak/mdia/minf/stbl/stsd'. */
+export function findBox(data, path) {
+    let found = null;
+    const parent = path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '';
+    const leaf = path.includes('/') ? path.slice(path.lastIndexOf('/') + 1) : path;
+    walkBoxes(data, (box) => {
+        if (box.path === parent && box.type === leaf) {
+            found = box;
+            return false;
+        }
+        return undefined;
+    });
+    return found;
+}
+/** Every box matching the path, in document order. trak repeats, for one. */
+export function findBoxes(data, path) {
+    const out = [];
+    const parent = path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '';
+    const leaf = path.includes('/') ? path.slice(path.lastIndexOf('/') + 1) : path;
+    walkBoxes(data, (box) => {
+        if (box.path === parent && box.type === leaf)
+            out.push(box);
+        return undefined;
+    });
+    return out;
+}
+/** Splits a FullBox payload into version, 24-bit flags, and the body view. */
+export function fullBox(payload) {
+    if (payload.byteLength < 4)
+        return null;
+    const version = payload[0];
+    const flags = (payload[1] << 16) | (payload[2] << 8) | payload[3];
+    return { version, flags, body: payload.subarray(4) };
+}
+/** tfdt: version 1 widens baseMediaDecodeTime to 64 bits. */
+export function parseTfdt(payload) {
+    const header = fullBox(payload);
+    if (header === null)
+        return null;
+    const view = new DataView(header.body.buffer, header.body.byteOffset, header.body.byteLength);
+    if (header.version === 1) {
+        if (header.body.byteLength < 8)
+            return null;
+        return { version: 1, baseMediaDecodeTime: Number(view.getBigUint64(0)) };
+    }
+    if (header.body.byteLength < 4)
+        return null;
+    return { version: 0, baseMediaDecodeTime: view.getUint32(0) };
+}
+/** sidx: version 1 widens the time and offset fields to 64 bits. */
+export function parseSidx(payload) {
+    const header = fullBox(payload);
+    if (header === null)
+        return null;
+    const body = header.body;
+    const view = new DataView(body.buffer, body.byteOffset, body.byteLength);
+    const wide = header.version === 1;
+    const fixed = 8 + (wide ? 16 : 8) + 4;
+    if (body.byteLength < fixed)
+        return null;
+    const referenceId = view.getUint32(0);
+    const timescale = view.getUint32(4);
+    let at = 8;
+    const earliestPresentationTime = wide ? Number(view.getBigUint64(at)) : view.getUint32(at);
+    at += wide ? 8 : 4;
+    const firstOffset = wide ? Number(view.getBigUint64(at)) : view.getUint32(at);
+    at += wide ? 8 : 4;
+    at += 2; // reserved
+    const count = view.getUint16(at);
+    at += 2;
+    if (body.byteLength < at + count * 12)
+        return null;
+    const references = [];
+    for (let i = 0; i < count; i += 1) {
+        const word = view.getUint32(at);
+        references.push({
+            referencedSize: word & 0x7fffffff,
+            subsegmentDuration: view.getUint32(at + 4),
+            startsWithSap: (view.getUint32(at + 8) & 0x80000000) !== 0,
+        });
+        at += 12;
+    }
+    return {
+        version: header.version,
+        referenceId,
+        timescale,
+        earliestPresentationTime,
+        firstOffset,
+        references,
+    };
+}
+/**
+ * The media timescale of each track, read from moov/trak (tkhd track id paired
+ * with mdhd timescale). CMAF timing normalization needs it to convert a
+ * baseMediaDecodeTime between timescale units and seconds.
+ */
+export function trackTimescales(init) {
+    const map = new Map();
+    for (const trak of findBoxes(init, 'moov/trak')) {
+        const tkhd = findBox(trak.payload, 'tkhd');
+        const mdhd = findBox(trak.payload, 'mdia/mdhd');
+        if (tkhd === null || mdhd === null)
+            continue;
+        const tkView = new DataView(tkhd.payload.buffer, tkhd.payload.byteOffset, tkhd.payload.byteLength);
+        const mdView = new DataView(mdhd.payload.buffer, mdhd.payload.byteOffset, mdhd.payload.byteLength);
+        // FullBox: version(1) flags(3), then creation/modification times (4 or 8
+        // bytes each by version), then the field of interest.
+        const trackAt = tkhd.payload[0] === 1 ? 20 : 12;
+        const scaleAt = mdhd.payload[0] === 1 ? 20 : 12;
+        if (tkhd.payload.byteLength < trackAt + 4 || mdhd.payload.byteLength < scaleAt + 4)
+            continue;
+        const trackId = tkView.getUint32(trackAt);
+        const timescale = mdView.getUint32(scaleAt);
+        if (timescale > 0)
+            map.set(trackId, timescale);
+    }
+    return map;
+}
+/**
+ * Rewrites every traf's tfdt baseMediaDecodeTime in place so the segment's
+ * media clock equals its presentation start. A CMAF live segment carries the
+ * real broadcast clock (a huge value); appended with a zero timestampOffset it
+ * would land far off the playhead. Normalizing it to `presentationStart` makes
+ * the segment land exactly where the manifest places it, the same alignment a
+ * TS transmux gives for free. Returns the number of tfdt boxes rewritten.
+ */
+export function normalizeTfdt(segment, presentationStart, timescales, fallbackTimescale) {
+    let rewritten = 0;
+    for (const traf of findBoxes(segment, 'moof/traf')) {
+        const tfdt = findBox(traf.payload, 'tfdt');
+        if (tfdt === null)
+            continue;
+        const tfhd = findBox(traf.payload, 'tfhd');
+        // tfhd FullBox: version(1) flags(3), then track_ID(4).
+        const trackId = tfhd !== null && tfhd.payload.byteLength >= 8
+            ? new DataView(tfhd.payload.buffer, tfhd.payload.byteOffset, tfhd.payload.byteLength).getUint32(4)
+            : null;
+        const timescale = (trackId !== null ? timescales.get(trackId) : undefined) ?? fallbackTimescale;
+        if (timescale <= 0)
+            continue;
+        const target = Math.round(presentationStart * timescale);
+        const body = tfdt.payload;
+        const view = new DataView(body.buffer, body.byteOffset, body.byteLength);
+        if (body[0] === 1) {
+            if (body.byteLength >= 12)
+                view.setBigUint64(4, BigInt(target));
+        }
+        else {
+            if (body.byteLength >= 8)
+                view.setUint32(4, target);
+        }
+        rewritten += 1;
+    }
+    return rewritten;
+}
+//# sourceMappingURL=index.js.map