@norskvideo/moq-hang 0.1.0

package/container/consumer.test.js

@@ -0,0 +1,396 @@
+/* @ts-self-types="./consumer.test.d.ts" */
+import { expect, test } from "bun:test";
+import { Group, Track, Varint } from "@norskvideo/moq-net";
+import { encodeDataSegment } from "./cmaf/encode.js";
+import { Format as CmafFormat } from "./cmaf/format.js";
+import { Consumer } from "./consumer.js";
+import { Format as LegacyFormat } from "./legacy.js";
+const TIMESCALE = 90_000;
+const TEST_INIT = {
+    timescale: TIMESCALE,
+    trackId: 1,
+    defaultSampleDuration: 0,
+    defaultSampleSize: 0,
+    defaultSampleFlags: 0,
+};
+function encodeLegacyFrame(timestamp, payload) {
+    const tsBytes = Varint.encode(timestamp);
+    const data = new Uint8Array(tsBytes.byteLength + payload.byteLength);
+    data.set(tsBytes, 0);
+    data.set(payload, tsBytes.byteLength);
+    return data;
+}
+// --- LegacyFormat ---
+test("LegacyFormat decodes a valid frame", () => {
+    const format = new LegacyFormat();
+    const payload = new Uint8Array([0xde, 0xad]);
+    const timestamp = 1000;
+    const frame = encodeLegacyFrame(timestamp, payload);
+    const result = format.decode(frame);
+    expect(result).toHaveLength(1);
+    expect(result[0].timestamp).toBe(timestamp);
+    expect(result[0].data).toEqual(payload);
+    expect(result[0].keyframe).toBe(false);
+});
+test("LegacyFormat always returns keyframe: false", () => {
+    const format = new LegacyFormat();
+    const frame = encodeLegacyFrame(0, new Uint8Array([0x01]));
+    const [decoded] = format.decode(frame);
+    expect(decoded.keyframe).toBe(false);
+});
+test("LegacyFormat always returns exactly one frame", () => {
+    const format = new LegacyFormat();
+    const frame = encodeLegacyFrame(5000, new Uint8Array([0x01, 0x02, 0x03]));
+    const result = format.decode(frame);
+    expect(result).toHaveLength(1);
+});
+test("LegacyFormat throws on empty input", () => {
+    const format = new LegacyFormat();
+    expect(() => format.decode(new Uint8Array(0))).toThrow();
+});
+test("LegacyFormat throws on truncated input", () => {
+    const format = new LegacyFormat();
+    // A varint that indicates more bytes follow but is truncated
+    expect(() => format.decode(new Uint8Array([0x80]))).toThrow();
+});
+// --- CmafFormat ---
+test("CmafFormat decodes a valid keyframe segment", () => {
+    const format = new CmafFormat(TEST_INIT);
+    const segment = encodeDataSegment({
+        data: new Uint8Array([0xca, 0xfe]),
+        timestamp: 0,
+        duration: 3000,
+        keyframe: true,
+        sequence: 0,
+    });
+    const result = format.decode(segment);
+    expect(result).toHaveLength(1);
+    expect(result[0].data).toEqual(new Uint8Array([0xca, 0xfe]));
+    expect(result[0].timestamp).toBe(0);
+    expect(result[0].keyframe).toBe(true);
+});
+test("CmafFormat decodes a delta frame segment", () => {
+    const format = new CmafFormat(TEST_INIT);
+    const segment = encodeDataSegment({
+        data: new Uint8Array([0xbe, 0xef]),
+        timestamp: 3000,
+        duration: 3000,
+        keyframe: false,
+        sequence: 1,
+    });
+    const result = format.decode(segment);
+    expect(result).toHaveLength(1);
+    expect(result[0].keyframe).toBe(false);
+});
+test("CmafFormat converts timescale units to microseconds", () => {
+    const format = new CmafFormat(TEST_INIT);
+    // 90000 timescale units = 1 second = 1_000_000 microseconds
+    const segment = encodeDataSegment({
+        data: new Uint8Array([0x01]),
+        timestamp: TIMESCALE,
+        duration: 3000,
+        keyframe: true,
+        sequence: 0,
+    });
+    const result = format.decode(segment);
+    expect(result[0].timestamp).toBe(1_000_000);
+});
+test("CmafFormat throws on corrupt segment", () => {
+    const format = new CmafFormat(TEST_INIT);
+    expect(() => format.decode(new Uint8Array([0x00, 0x01, 0x02]))).toThrow();
+});
+// --- Consumer ---
+function encodeLegacy(timestamp) {
+    const tsBytes = Varint.encode(timestamp);
+    const payload = new Uint8Array([0xde, 0xad]);
+    const data = new Uint8Array(tsBytes.byteLength + payload.byteLength);
+    data.set(tsBytes, 0);
+    data.set(payload, tsBytes.byteLength);
+    return data;
+}
+function writeGroupWithLegacyFrames(track, sequence, timestamps) {
+    const group = new Group(sequence);
+    for (const ts of timestamps) {
+        group.writeFrame(encodeLegacy(ts));
+    }
+    group.close();
+    track.writeGroup(group);
+}
+async function drainFrames(consumer, timeout) {
+    const frames = [];
+    for (;;) {
+        const result = await Promise.race([
+            consumer.next(),
+            new Promise((resolve) => setTimeout(() => resolve(null), timeout)),
+        ]);
+        if (result === null || result === undefined)
+            break;
+        if (result.frame) {
+            frames.push({ timestamp: result.frame.timestamp, group: result.group, keyframe: result.frame.keyframe });
+        }
+    }
+    return frames;
+}
+test("Consumer delivers frames from a single group", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    writeGroupWithLegacyFrames(track, 0, [0, 33_000]);
+    track.close();
+    const frames = await drainFrames(consumer, 200);
+    expect(frames).toHaveLength(2);
+    expect(frames[0].timestamp).toBe(0);
+    expect(frames[1].timestamp).toBe(33_000);
+    consumer.close();
+});
+test("Consumer forces keyframe true at index 0", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    writeGroupWithLegacyFrames(track, 0, [0, 33_000]);
+    track.close();
+    const frames = await drainFrames(consumer, 200);
+    expect(frames[0].keyframe).toBe(true);
+    expect(frames[1].keyframe).toBe(false);
+    consumer.close();
+});
+test("Consumer index spans MoQ frames for keyframe detection", async () => {
+    // Custom format that returns 3 samples per MoQ frame, all keyframe: false
+    const multiFormat = {
+        decode(_frame) {
+            return [
+                { data: new Uint8Array([1]), timestamp: 0, keyframe: false },
+                { data: new Uint8Array([2]), timestamp: 33_000, keyframe: false },
+                { data: new Uint8Array([3]), timestamp: 66_000, keyframe: false },
+            ];
+        },
+    };
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: multiFormat, latency: 500 });
+    const group = new Group(0);
+    group.writeFrame(new Uint8Array([0x01])); // first MoQ frame → 3 samples
+    group.writeFrame(new Uint8Array([0x02])); // second MoQ frame → 3 samples
+    group.close();
+    track.writeGroup(group);
+    track.close();
+    const frames = await drainFrames(consumer, 200);
+    expect(frames).toHaveLength(6);
+    // Only index 0 is keyframe, rest are false
+    expect(frames.map((f) => f.keyframe)).toEqual([true, false, false, false, false, false]);
+    consumer.close();
+});
+test("Consumer keeps frames decoded before an error (truncated GoP)", async () => {
+    // 0xFF in the first byte signals the format to throw, simulating a stream
+    // RESET or corrupt frame mid-group. Encoding the trigger in the frame bytes
+    // keeps this deterministic when groups decode in parallel.
+    const truncatingFormat = {
+        decode(frame) {
+            if (frame[0] === 0xff)
+                throw new Error("truncated");
+            return [{ data: frame, timestamp: frame[0], keyframe: false }];
+        },
+    };
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: truncatingFormat, latency: 500 });
+    // Group 0: 2 valid frames then a tail-truncating error.
+    const g0 = new Group(0);
+    g0.writeFrame(new Uint8Array([0x01]));
+    g0.writeFrame(new Uint8Array([0x02]));
+    g0.writeFrame(new Uint8Array([0xff]));
+    g0.close();
+    track.writeGroup(g0);
+    // Group 1 decodes cleanly.
+    const g1 = new Group(1);
+    g1.writeFrame(new Uint8Array([0x04]));
+    g1.close();
+    track.writeGroup(g1);
+    track.close();
+    const frames = await drainFrames(consumer, 200);
+    // First 2 frames of group 0 survive; group 1 follows.
+    expect(frames.map((f) => f.group)).toEqual([0, 0, 1]);
+    expect(frames.map((f) => f.timestamp)).toEqual([1, 2, 4]);
+    consumer.close();
+});
+test("Consumer close returns undefined from next()", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    const promise = consumer.next();
+    consumer.close();
+    const result = await promise;
+    expect(result).toBeUndefined();
+});
+test("Consumer throws on concurrent next() calls", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    // First call blocks waiting for data
+    void consumer.next();
+    // Second call should throw
+    expect(() => consumer.next()).toThrow("multiple calls to next not supported");
+    consumer.close();
+});
+test("Consumer skips groups via PTS-span when over latency", async () => {
+    const track = new Track("test");
+    // Zero latency = skip everything that's not the latest
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 0 });
+    // Write groups with increasing timestamps. With 0 latency, any PTS span > 0 triggers skip.
+    writeGroupWithLegacyFrames(track, 0, [0]);
+    writeGroupWithLegacyFrames(track, 1, [100_000]);
+    writeGroupWithLegacyFrames(track, 2, [200_000]);
+    track.close();
+    const frames = await drainFrames(consumer, 300);
+    // With zero latency, the consumer should skip to the latest group
+    const groups = [...new Set(frames.map((f) => f.group))];
+    expect(groups.at(-1)).toBe(2);
+    consumer.close();
+});
+// --- Ordering ---
+test("Consumer delivers groups in sequence order regardless of arrival order", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    writeGroupWithLegacyFrames(track, 2, [60_000]);
+    writeGroupWithLegacyFrames(track, 0, [0]);
+    writeGroupWithLegacyFrames(track, 1, [30_000]);
+    track.close();
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    const frames = await drainFrames(consumer, 500);
+    expect(frames).toHaveLength(3);
+    expect(frames[0].group).toBe(0);
+    expect(frames[1].group).toBe(1);
+    expect(frames[2].group).toBe(2);
+    consumer.close();
+});
+test("Consumer rejects stale groups", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    // Group 5 arrives first (sets active = 5)
+    writeGroupWithLegacyFrames(track, 5, [0]);
+    await new Promise((resolve) => setTimeout(resolve, 50));
+    // Group 3 is stale
+    writeGroupWithLegacyFrames(track, 3, [100_000]);
+    // Group 6 is valid
+    writeGroupWithLegacyFrames(track, 6, [30_000]);
+    track.close();
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    const frames = await drainFrames(consumer, 500);
+    expect(frames).toHaveLength(2);
+    expect(frames[0].group).toBe(5);
+    expect(frames[1].group).toBe(6);
+    consumer.close();
+});
+// --- Group boundary signals ---
+test("Consumer next() returns group-done signals", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    writeGroupWithLegacyFrames(track, 0, [0, 33_000]);
+    writeGroupWithLegacyFrames(track, 1, [66_000]);
+    track.close();
+    await new Promise((resolve) => setTimeout(resolve, 50));
+    const allResults = [];
+    for (;;) {
+        const result = await Promise.race([
+            consumer.next(),
+            new Promise((resolve) => setTimeout(() => resolve(null), 500)),
+        ]);
+        if (result === null || result === undefined)
+            break;
+        allResults.push({ frame: result.frame !== undefined, group: result.group });
+    }
+    const frameResults = allResults.filter((r) => r.frame);
+    const boundaries = allResults.filter((r) => !r.frame);
+    expect(frameResults).toHaveLength(3);
+    expect(boundaries).toHaveLength(2);
+    expect(boundaries[0].group).toBe(0);
+    expect(boundaries[1].group).toBe(1);
+    consumer.close();
+});
+// --- Buffered signal ---
+test("Consumer buffered signal updates as frames arrive", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 });
+    expect(consumer.buffered.peek()).toEqual([]);
+    writeGroupWithLegacyFrames(track, 0, [0, 33_000]);
+    writeGroupWithLegacyFrames(track, 1, [66_000, 99_000]);
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    const ranges = consumer.buffered.peek();
+    expect(ranges.length).toBe(1);
+    expect(ranges[0].start).toBe(0);
+    expect(ranges[0].end >= 66).toBeTruthy();
+    track.close();
+    consumer.close();
+});
+// --- Gap recovery ---
+test("Consumer recovers from gap in group sequence numbers", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: new LegacyFormat(), latency: 100 });
+    writeGroupWithLegacyFrames(track, 0, [0, 20_000]);
+    writeGroupWithLegacyFrames(track, 1, [40_000, 60_000]);
+    // Skip group 2
+    writeGroupWithLegacyFrames(track, 3, [120_000, 140_000]);
+    writeGroupWithLegacyFrames(track, 4, [160_000, 180_000]);
+    writeGroupWithLegacyFrames(track, 5, [200_000, 220_000]);
+    track.close();
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    const frames = await drainFrames(consumer, 500);
+    expect(frames.length >= 4).toBeTruthy();
+    consumer.close();
+});
+// --- Edge cases from design review ---
+test("Consumer handles empty decode result without deadlock", async () => {
+    let callCount = 0;
+    const emptyThenValid = {
+        decode(_frame) {
+            callCount++;
+            if (callCount === 1)
+                return []; // empty result
+            return [{ data: new Uint8Array([1]), timestamp: 33_000, keyframe: false }];
+        },
+    };
+    const track = new Track("test");
+    const consumer = new Consumer(track, { format: emptyThenValid, latency: 500 });
+    const group = new Group(0);
+    group.writeFrame(new Uint8Array([0x01])); // empty decode
+    group.writeFrame(new Uint8Array([0x02])); // valid decode
+    group.close();
+    track.writeGroup(group);
+    track.close();
+    const frames = await drainFrames(consumer, 300);
+    // The empty decode produces no frames, but the second MoQ frame does.
+    // Since index 0 was never used (empty result), the first actual frame gets index=1 → keyframe false?
+    // Actually index increments per sample, and empty decode means 0 samples → index stays at 0.
+    // So the next frame's first sample gets index=0 → keyframe=true.
+    expect(frames).toHaveLength(1);
+    expect(frames[0].keyframe).toBe(true);
+    consumer.close();
+});
+// --- CMAF through Consumer ---
+test("Consumer with CmafFormat delivers correct timestamps", async () => {
+    const track = new Track("test");
+    const consumer = new Consumer(track, {
+        format: new CmafFormat(TEST_INIT),
+        latency: 500,
+    });
+    const group = new Group(0);
+    group.writeFrame(encodeDataSegment({
+        data: new Uint8Array([0xca, 0xfe]),
+        timestamp: 0,
+        duration: 3000,
+        keyframe: true,
+        sequence: 0,
+    }));
+    group.writeFrame(encodeDataSegment({
+        data: new Uint8Array([0xbe, 0xef]),
+        timestamp: 3000,
+        duration: 3000,
+        keyframe: false,
+        sequence: 0,
+    }));
+    group.close();
+    track.writeGroup(group);
+    track.close();
+    const frames = await drainFrames(consumer, 200);
+    expect(frames).toHaveLength(2);
+    expect(frames[0].keyframe).toBe(true); // index 0 override
+    expect(frames[1].keyframe).toBe(false); // trusts format
+    expect(frames[0].timestamp).toBe(0);
+    expect(frames[1].timestamp).toBe(33_333); // 3000/90000 * 1_000_000
+    consumer.close();
+});
+//# sourceMappingURL=consumer.test.js.map

package/container/consumer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.test.js","sourceRoot":"","sources":["../../src/container/consumer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,KAAK,EAAa,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,SAAS,GAAgB;IAC9B,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,CAAC;IACV,qBAAqB,EAAE,CAAC;IACxB,iBAAiB,EAAE,CAAC;IACpB,kBAAkB,EAAE,CAAC;CACrB,CAAC;AAEF,SAAS,iBAAiB,CAAC,SAAqB,EAAE,OAAmB;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACb,CAAC;AAED,uBAAuB;AAEvB,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAkB,CAAC;IACrC,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACxD,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAe,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC1D,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAkB,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAExF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACnD,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,6DAA6D;IAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,qBAAqB;AAErB,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACxD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,iBAAiB,CAAC;QACjC,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAe,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACrD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,iBAAiB,CAAC;QACjC,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAChE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACzC,4DAA4D;IAC5D,MAAM,OAAO,GAAG,iBAAiB,CAAC;QACjC,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAuB,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACjD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,mBAAmB;AAEnB,SAAS,YAAY,CAAC,SAAqB;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAY,EAAE,QAAgB,EAAE,UAAwB;IAC3F,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,WAAW,CACzB,QAAkB,EAClB,OAAe;IAEf,MAAM,MAAM,GAAkE,EAAE,CAAC;IACjF,SAAS,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YACjC,QAAQ,CAAC,IAAI,EAAE;YACf,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;SACxE,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QACnD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1G,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;IAC/D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,EAAE,MAAoB,CAAC,CAAC,CAAC;IAC9E,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAe,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAoB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;IAC3D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,EAAE,MAAoB,CAAC,CAAC,CAAC;IAC9E,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;IACzE,0EAA0E;IAC1E,MAAM,WAAW,GAAoB;QACpC,MAAM,CAAC,MAAkB;YACxB,OAAO;gBACN,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;gBAC1E,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE;gBAC/E,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE;aAC/E,CAAC;QACH,CAAC;KACD,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAE1F,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;IACxE,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,+BAA+B;IACzE,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,2CAA2C;IAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACzF,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;IAChF,0EAA0E;IAC1E,4EAA4E;IAC5E,2DAA2D;IAC3D,MAAM,gBAAgB,GAAoB;QACzC,MAAM,CAAC,KAAiB;YACvB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;YACpD,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;KACD,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAE/F,wDAAwD;IACxD,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,EAAE,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,EAAE,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,EAAE,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAErB,2BAA2B;IAC3B,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,EAAE,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAErB,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,sDAAsD;IACtD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;IAC/D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEjB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;AAChC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC7D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,qCAAqC;IACrC,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;IAErB,2BAA2B;IAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IAC9E,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,uDAAuD;IACvD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,CAAe,EAAE,CAAC,CAAC;IAE/F,2FAA2F;IAC3F,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,CAAC,CAAC,CAAC;IACxD,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,OAAqB,CAAC,CAAC,CAAC;IAC9D,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,OAAqB,CAAC,CAAC,CAAC;IAC9D,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,kEAAkE;IAClE,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,mBAAmB;AAEnB,IAAI,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;IACzF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAoB,CAAC,CAAC,CAAC;IAC7D,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,CAAC,CAAC,CAAC;IACxD,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAoB,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,0CAA0C;IAC1C,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAExD,mBAAmB;IACnB,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,OAAqB,CAAC,CAAC,CAAC;IAC9D,mBAAmB;IACnB,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAoB,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,iCAAiC;AAEjC,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC7D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,EAAE,MAAoB,CAAC,CAAC,CAAC;IAC9E,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAoB,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAExD,MAAM,UAAU,GAAwC,EAAE,CAAC;IAC3D,SAAS,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YACjC,QAAQ,CAAC,IAAI,EAAE;YACf,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;SACpE,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QACnD,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,0BAA0B;AAE1B,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;IACpE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE7C,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,EAAE,MAAoB,CAAC,CAAC,CAAC;IAC9E,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAoB,EAAE,MAAoB,CAAC,CAAC,CAAC;IAEnF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAe,CAAC,CAAC;IAC9C,MAAM,CAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAc,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;IAErD,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,uBAAuB;AAEvB,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAEjG,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAe,EAAE,MAAoB,CAAC,CAAC,CAAC;IAC9E,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAoB,EAAE,MAAoB,CAAC,CAAC,CAAC;IACnF,eAAe;IACf,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,OAAqB,EAAE,OAAqB,CAAC,CAAC,CAAC;IACrF,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,OAAqB,EAAE,OAAqB,CAAC,CAAC,CAAC;IACrF,0BAA0B,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,OAAqB,EAAE,OAAqB,CAAC,CAAC,CAAC;IACrF,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,wCAAwC;AAExC,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;IACxE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,cAAc,GAAoB;QACvC,MAAM,CAAC,MAAkB;YACxB,SAAS,EAAE,CAAC;YACZ,IAAI,SAAS,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC,CAAC,eAAe;YAC/C,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1F,CAAC;KACD,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;IAE7F,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IACzD,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IACzD,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,sEAAsE;IACtE,qGAAqG;IACrG,6FAA6F;IAC7F,iEAAiE;IACjE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,gCAAgC;AAEhC,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE;QACpC,MAAM,EAAE,IAAI,UAAU,CAAC,SAAS,CAAC;QACjC,OAAO,EAAE,GAAiB;KAC1B,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,UAAU,CACf,iBAAiB,CAAC;QACjB,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,CAAC;KACX,CAAC,CACF,CAAC;IACF,KAAK,CAAC,UAAU,CACf,iBAAiB,CAAC;QACjB,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,CAAC;KACX,CAAC,CACF,CAAC;IACF,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB;IAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB;IACxD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAe,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAoB,CAAC,CAAC,CAAC,yBAAyB;IACjF,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["import { expect, test } from \"bun:test\";\nimport { Group, type Time, Track, Varint } from \"@moq/net\";\nimport type { InitSegment } from \"./cmaf/decode.ts\";\nimport { encodeDataSegment } from \"./cmaf/encode.ts\";\nimport { Format as CmafFormat } from \"./cmaf/format.ts\";\nimport { Consumer } from \"./consumer.ts\";\nimport type { Format as ContainerFormat } from \"./format.ts\";\nimport { Format as LegacyFormat } from \"./legacy.ts\";\nimport type { Frame } from \"./types.ts\";\n\nconst TIMESCALE = 90_000;\nconst TEST_INIT: InitSegment = {\n\ttimescale: TIMESCALE,\n\ttrackId: 1,\n\tdefaultSampleDuration: 0,\n\tdefaultSampleSize: 0,\n\tdefaultSampleFlags: 0,\n};\n\nfunction encodeLegacyFrame(timestamp: Time.Micro, payload: Uint8Array): Uint8Array {\n\tconst tsBytes = Varint.encode(timestamp);\n\tconst data = new Uint8Array(tsBytes.byteLength + payload.byteLength);\n\tdata.set(tsBytes, 0);\n\tdata.set(payload, tsBytes.byteLength);\n\treturn data;\n}\n\n// --- LegacyFormat ---\n\ntest(\"LegacyFormat decodes a valid frame\", () => {\n\tconst format = new LegacyFormat();\n\tconst payload = new Uint8Array([0xde, 0xad]);\n\tconst timestamp = 1000 as Time.Micro;\n\tconst frame = encodeLegacyFrame(timestamp, payload);\n\n\tconst result = format.decode(frame);\n\n\texpect(result).toHaveLength(1);\n\texpect(result[0].timestamp).toBe(timestamp);\n\texpect(result[0].data).toEqual(payload);\n\texpect(result[0].keyframe).toBe(false);\n});\n\ntest(\"LegacyFormat always returns keyframe: false\", () => {\n\tconst format = new LegacyFormat();\n\tconst frame = encodeLegacyFrame(0 as Time.Micro, new Uint8Array([0x01]));\n\n\tconst [decoded] = format.decode(frame);\n\texpect(decoded.keyframe).toBe(false);\n});\n\ntest(\"LegacyFormat always returns exactly one frame\", () => {\n\tconst format = new LegacyFormat();\n\tconst frame = encodeLegacyFrame(5000 as Time.Micro, new Uint8Array([0x01, 0x02, 0x03]));\n\n\tconst result = format.decode(frame);\n\texpect(result).toHaveLength(1);\n});\n\ntest(\"LegacyFormat throws on empty input\", () => {\n\tconst format = new LegacyFormat();\n\texpect(() => format.decode(new Uint8Array(0))).toThrow();\n});\n\ntest(\"LegacyFormat throws on truncated input\", () => {\n\tconst format = new LegacyFormat();\n\t// A varint that indicates more bytes follow but is truncated\n\texpect(() => format.decode(new Uint8Array([0x80]))).toThrow();\n});\n\n// --- CmafFormat ---\n\ntest(\"CmafFormat decodes a valid keyframe segment\", () => {\n\tconst format = new CmafFormat(TEST_INIT);\n\tconst segment = encodeDataSegment({\n\t\tdata: new Uint8Array([0xca, 0xfe]),\n\t\ttimestamp: 0,\n\t\tduration: 3000,\n\t\tkeyframe: true,\n\t\tsequence: 0,\n\t});\n\n\tconst result = format.decode(segment);\n\n\texpect(result).toHaveLength(1);\n\texpect(result[0].data).toEqual(new Uint8Array([0xca, 0xfe]));\n\texpect(result[0].timestamp).toBe(0 as Time.Micro);\n\texpect(result[0].keyframe).toBe(true);\n});\n\ntest(\"CmafFormat decodes a delta frame segment\", () => {\n\tconst format = new CmafFormat(TEST_INIT);\n\tconst segment = encodeDataSegment({\n\t\tdata: new Uint8Array([0xbe, 0xef]),\n\t\ttimestamp: 3000,\n\t\tduration: 3000,\n\t\tkeyframe: false,\n\t\tsequence: 1,\n\t});\n\n\tconst result = format.decode(segment);\n\n\texpect(result).toHaveLength(1);\n\texpect(result[0].keyframe).toBe(false);\n});\n\ntest(\"CmafFormat converts timescale units to microseconds\", () => {\n\tconst format = new CmafFormat(TEST_INIT);\n\t// 90000 timescale units = 1 second = 1_000_000 microseconds\n\tconst segment = encodeDataSegment({\n\t\tdata: new Uint8Array([0x01]),\n\t\ttimestamp: TIMESCALE,\n\t\tduration: 3000,\n\t\tkeyframe: true,\n\t\tsequence: 0,\n\t});\n\n\tconst result = format.decode(segment);\n\texpect(result[0].timestamp).toBe(1_000_000 as Time.Micro);\n});\n\ntest(\"CmafFormat throws on corrupt segment\", () => {\n\tconst format = new CmafFormat(TEST_INIT);\n\texpect(() => format.decode(new Uint8Array([0x00, 0x01, 0x02]))).toThrow();\n});\n\n// --- Consumer ---\n\nfunction encodeLegacy(timestamp: Time.Micro): Uint8Array {\n\tconst tsBytes = Varint.encode(timestamp);\n\tconst payload = new Uint8Array([0xde, 0xad]);\n\tconst data = new Uint8Array(tsBytes.byteLength + payload.byteLength);\n\tdata.set(tsBytes, 0);\n\tdata.set(payload, tsBytes.byteLength);\n\treturn data;\n}\n\nfunction writeGroupWithLegacyFrames(track: Track, sequence: number, timestamps: Time.Micro[]) {\n\tconst group = new Group(sequence);\n\tfor (const ts of timestamps) {\n\t\tgroup.writeFrame(encodeLegacy(ts));\n\t}\n\tgroup.close();\n\ttrack.writeGroup(group);\n}\n\nasync function drainFrames(\n\tconsumer: Consumer,\n\ttimeout: number,\n): Promise<{ timestamp: Time.Micro; group: number; keyframe: boolean }[]> {\n\tconst frames: { timestamp: Time.Micro; group: number; keyframe: boolean }[] = [];\n\tfor (;;) {\n\t\tconst result = await Promise.race([\n\t\t\tconsumer.next(),\n\t\t\tnew Promise<null>((resolve) => setTimeout(() => resolve(null), timeout)),\n\t\t]);\n\t\tif (result === null || result === undefined) break;\n\t\tif (result.frame) {\n\t\t\tframes.push({ timestamp: result.frame.timestamp, group: result.group, keyframe: result.frame.keyframe });\n\t\t}\n\t}\n\treturn frames;\n}\n\ntest(\"Consumer delivers frames from a single group\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro, 33_000 as Time.Micro]);\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 200);\n\texpect(frames).toHaveLength(2);\n\texpect(frames[0].timestamp).toBe(0 as Time.Micro);\n\texpect(frames[1].timestamp).toBe(33_000 as Time.Micro);\n\tconsumer.close();\n});\n\ntest(\"Consumer forces keyframe true at index 0\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro, 33_000 as Time.Micro]);\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 200);\n\texpect(frames[0].keyframe).toBe(true);\n\texpect(frames[1].keyframe).toBe(false);\n\tconsumer.close();\n});\n\ntest(\"Consumer index spans MoQ frames for keyframe detection\", async () => {\n\t// Custom format that returns 3 samples per MoQ frame, all keyframe: false\n\tconst multiFormat: ContainerFormat = {\n\t\tdecode(_frame: Uint8Array): Frame[] {\n\t\t\treturn [\n\t\t\t\t{ data: new Uint8Array([1]), timestamp: 0 as Time.Micro, keyframe: false },\n\t\t\t\t{ data: new Uint8Array([2]), timestamp: 33_000 as Time.Micro, keyframe: false },\n\t\t\t\t{ data: new Uint8Array([3]), timestamp: 66_000 as Time.Micro, keyframe: false },\n\t\t\t];\n\t\t},\n\t};\n\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: multiFormat, latency: 500 as Time.Milli });\n\n\tconst group = new Group(0);\n\tgroup.writeFrame(new Uint8Array([0x01])); // first MoQ frame → 3 samples\n\tgroup.writeFrame(new Uint8Array([0x02])); // second MoQ frame → 3 samples\n\tgroup.close();\n\ttrack.writeGroup(group);\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 200);\n\texpect(frames).toHaveLength(6);\n\t// Only index 0 is keyframe, rest are false\n\texpect(frames.map((f) => f.keyframe)).toEqual([true, false, false, false, false, false]);\n\tconsumer.close();\n});\n\ntest(\"Consumer keeps frames decoded before an error (truncated GoP)\", async () => {\n\t// 0xFF in the first byte signals the format to throw, simulating a stream\n\t// RESET or corrupt frame mid-group. Encoding the trigger in the frame bytes\n\t// keeps this deterministic when groups decode in parallel.\n\tconst truncatingFormat: ContainerFormat = {\n\t\tdecode(frame: Uint8Array): Frame[] {\n\t\t\tif (frame[0] === 0xff) throw new Error(\"truncated\");\n\t\t\treturn [{ data: frame, timestamp: frame[0] as Time.Micro, keyframe: false }];\n\t\t},\n\t};\n\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: truncatingFormat, latency: 500 as Time.Milli });\n\n\t// Group 0: 2 valid frames then a tail-truncating error.\n\tconst g0 = new Group(0);\n\tg0.writeFrame(new Uint8Array([0x01]));\n\tg0.writeFrame(new Uint8Array([0x02]));\n\tg0.writeFrame(new Uint8Array([0xff]));\n\tg0.close();\n\ttrack.writeGroup(g0);\n\n\t// Group 1 decodes cleanly.\n\tconst g1 = new Group(1);\n\tg1.writeFrame(new Uint8Array([0x04]));\n\tg1.close();\n\ttrack.writeGroup(g1);\n\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 200);\n\t// First 2 frames of group 0 survive; group 1 follows.\n\texpect(frames.map((f) => f.group)).toEqual([0, 0, 1]);\n\texpect(frames.map((f) => f.timestamp as number)).toEqual([1, 2, 4]);\n\tconsumer.close();\n});\n\ntest(\"Consumer close returns undefined from next()\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\tconst promise = consumer.next();\n\tconsumer.close();\n\n\tconst result = await promise;\n\texpect(result).toBeUndefined();\n});\n\ntest(\"Consumer throws on concurrent next() calls\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\t// First call blocks waiting for data\n\tvoid consumer.next();\n\n\t// Second call should throw\n\texpect(() => consumer.next()).toThrow(\"multiple calls to next not supported\");\n\tconsumer.close();\n});\n\ntest(\"Consumer skips groups via PTS-span when over latency\", async () => {\n\tconst track = new Track(\"test\");\n\t// Zero latency = skip everything that's not the latest\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 0 as Time.Milli });\n\n\t// Write groups with increasing timestamps. With 0 latency, any PTS span > 0 triggers skip.\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 1, [100_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 2, [200_000 as Time.Micro]);\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 300);\n\t// With zero latency, the consumer should skip to the latest group\n\tconst groups = [...new Set(frames.map((f) => f.group))];\n\texpect(groups.at(-1)).toBe(2);\n\tconsumer.close();\n});\n\n// --- Ordering ---\n\ntest(\"Consumer delivers groups in sequence order regardless of arrival order\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\twriteGroupWithLegacyFrames(track, 2, [60_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 1, [30_000 as Time.Micro]);\n\ttrack.close();\n\n\tawait new Promise((resolve) => setTimeout(resolve, 100));\n\n\tconst frames = await drainFrames(consumer, 500);\n\texpect(frames).toHaveLength(3);\n\texpect(frames[0].group).toBe(0);\n\texpect(frames[1].group).toBe(1);\n\texpect(frames[2].group).toBe(2);\n\tconsumer.close();\n});\n\ntest(\"Consumer rejects stale groups\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\t// Group 5 arrives first (sets active = 5)\n\twriteGroupWithLegacyFrames(track, 5, [0 as Time.Micro]);\n\tawait new Promise((resolve) => setTimeout(resolve, 50));\n\n\t// Group 3 is stale\n\twriteGroupWithLegacyFrames(track, 3, [100_000 as Time.Micro]);\n\t// Group 6 is valid\n\twriteGroupWithLegacyFrames(track, 6, [30_000 as Time.Micro]);\n\ttrack.close();\n\n\tawait new Promise((resolve) => setTimeout(resolve, 100));\n\n\tconst frames = await drainFrames(consumer, 500);\n\texpect(frames).toHaveLength(2);\n\texpect(frames[0].group).toBe(5);\n\texpect(frames[1].group).toBe(6);\n\tconsumer.close();\n});\n\n// --- Group boundary signals ---\n\ntest(\"Consumer next() returns group-done signals\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro, 33_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 1, [66_000 as Time.Micro]);\n\ttrack.close();\n\n\tawait new Promise((resolve) => setTimeout(resolve, 50));\n\n\tconst allResults: { frame: boolean; group: number }[] = [];\n\tfor (;;) {\n\t\tconst result = await Promise.race([\n\t\t\tconsumer.next(),\n\t\t\tnew Promise<null>((resolve) => setTimeout(() => resolve(null), 500)),\n\t\t]);\n\t\tif (result === null || result === undefined) break;\n\t\tallResults.push({ frame: result.frame !== undefined, group: result.group });\n\t}\n\n\tconst frameResults = allResults.filter((r) => r.frame);\n\tconst boundaries = allResults.filter((r) => !r.frame);\n\texpect(frameResults).toHaveLength(3);\n\texpect(boundaries).toHaveLength(2);\n\texpect(boundaries[0].group).toBe(0);\n\texpect(boundaries[1].group).toBe(1);\n\tconsumer.close();\n});\n\n// --- Buffered signal ---\n\ntest(\"Consumer buffered signal updates as frames arrive\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 500 as Time.Milli });\n\n\texpect(consumer.buffered.peek()).toEqual([]);\n\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro, 33_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 1, [66_000 as Time.Micro, 99_000 as Time.Micro]);\n\n\tawait new Promise((resolve) => setTimeout(resolve, 100));\n\n\tconst ranges = consumer.buffered.peek();\n\texpect(ranges.length).toBe(1);\n\texpect(ranges[0].start).toBe(0 as Time.Milli);\n\texpect((ranges[0].end as number) >= 66).toBeTruthy();\n\n\ttrack.close();\n\tconsumer.close();\n});\n\n// --- Gap recovery ---\n\ntest(\"Consumer recovers from gap in group sequence numbers\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: new LegacyFormat(), latency: 100 as Time.Milli });\n\n\twriteGroupWithLegacyFrames(track, 0, [0 as Time.Micro, 20_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 1, [40_000 as Time.Micro, 60_000 as Time.Micro]);\n\t// Skip group 2\n\twriteGroupWithLegacyFrames(track, 3, [120_000 as Time.Micro, 140_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 4, [160_000 as Time.Micro, 180_000 as Time.Micro]);\n\twriteGroupWithLegacyFrames(track, 5, [200_000 as Time.Micro, 220_000 as Time.Micro]);\n\ttrack.close();\n\n\tawait new Promise((resolve) => setTimeout(resolve, 100));\n\n\tconst frames = await drainFrames(consumer, 500);\n\texpect(frames.length >= 4).toBeTruthy();\n\tconsumer.close();\n});\n\n// --- Edge cases from design review ---\n\ntest(\"Consumer handles empty decode result without deadlock\", async () => {\n\tlet callCount = 0;\n\tconst emptyThenValid: ContainerFormat = {\n\t\tdecode(_frame: Uint8Array): Frame[] {\n\t\t\tcallCount++;\n\t\t\tif (callCount === 1) return []; // empty result\n\t\t\treturn [{ data: new Uint8Array([1]), timestamp: 33_000 as Time.Micro, keyframe: false }];\n\t\t},\n\t};\n\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, { format: emptyThenValid, latency: 500 as Time.Milli });\n\n\tconst group = new Group(0);\n\tgroup.writeFrame(new Uint8Array([0x01])); // empty decode\n\tgroup.writeFrame(new Uint8Array([0x02])); // valid decode\n\tgroup.close();\n\ttrack.writeGroup(group);\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 300);\n\t// The empty decode produces no frames, but the second MoQ frame does.\n\t// Since index 0 was never used (empty result), the first actual frame gets index=1 → keyframe false?\n\t// Actually index increments per sample, and empty decode means 0 samples → index stays at 0.\n\t// So the next frame's first sample gets index=0 → keyframe=true.\n\texpect(frames).toHaveLength(1);\n\texpect(frames[0].keyframe).toBe(true);\n\tconsumer.close();\n});\n\n// --- CMAF through Consumer ---\n\ntest(\"Consumer with CmafFormat delivers correct timestamps\", async () => {\n\tconst track = new Track(\"test\");\n\tconst consumer = new Consumer(track, {\n\t\tformat: new CmafFormat(TEST_INIT),\n\t\tlatency: 500 as Time.Milli,\n\t});\n\n\tconst group = new Group(0);\n\tgroup.writeFrame(\n\t\tencodeDataSegment({\n\t\t\tdata: new Uint8Array([0xca, 0xfe]),\n\t\t\ttimestamp: 0,\n\t\t\tduration: 3000,\n\t\t\tkeyframe: true,\n\t\t\tsequence: 0,\n\t\t}),\n\t);\n\tgroup.writeFrame(\n\t\tencodeDataSegment({\n\t\t\tdata: new Uint8Array([0xbe, 0xef]),\n\t\t\ttimestamp: 3000,\n\t\t\tduration: 3000,\n\t\t\tkeyframe: false,\n\t\t\tsequence: 0,\n\t\t}),\n\t);\n\tgroup.close();\n\ttrack.writeGroup(group);\n\ttrack.close();\n\n\tconst frames = await drainFrames(consumer, 200);\n\texpect(frames).toHaveLength(2);\n\texpect(frames[0].keyframe).toBe(true); // index 0 override\n\texpect(frames[1].keyframe).toBe(false); // trusts format\n\texpect(frames[0].timestamp).toBe(0 as Time.Micro);\n\texpect(frames[1].timestamp).toBe(33_333 as Time.Micro); // 3000/90000 * 1_000_000\n\tconsumer.close();\n});\n"]}

package/container/format.d.ts

@@ -0,0 +1,12 @@
+import type { Frame } from "./types";
+/** A container format that decodes raw MoQ frames into media frames. */
+export interface Format {
+    /**
+     * Parse one MoQ frame into decoded media frames. `extensions` carries the raw
+     * MOQ Object Properties bytes (undefined when the object had none) — LOC reads
+     * its per-frame Timestamp from there (draft-ietf-moq-loc-03 §2.3); other
+     * formats ignore it.
+     */
+    decode(frame: Uint8Array, extensions?: Uint8Array): Frame[];
+}
+//# sourceMappingURL=format.d.ts.map

package/container/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/container/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,wEAAwE;AACxE,MAAM,WAAW,MAAM;IACtB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,KAAK,EAAE,CAAC;CAC5D"}

package/container/format.js

@@ -0,0 +1,3 @@
+/* @ts-self-types="./format.d.ts" */
+export {};
+//# sourceMappingURL=format.js.map

package/container/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/container/format.ts"],"names":[],"mappings":"","sourcesContent":["import type { Frame } from \"./types\";\n\n/** A container format that decodes raw MoQ frames into media frames. */\nexport interface Format {\n\t/**\n\t * Parse one MoQ frame into decoded media frames. `extensions` carries the raw\n\t * MOQ Object Properties bytes (undefined when the object had none) — LOC reads\n\t * its per-frame Timestamp from there (draft-ietf-moq-loc-03 §2.3); other\n\t * formats ignore it.\n\t */\n\tdecode(frame: Uint8Array, extensions?: Uint8Array): Frame[];\n}\n"]}

package/container/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Per-frame container formats (timestamp plus codec bitstream): the legacy varint
+ * container, CMAF (fMP4), and LOC, with consumers and producers to read/write them.
+ *
+ * @module
+ */
+export * as Loc from "@norskvideo/moq-loc";
+export * as Cmaf from "./cmaf";
+export { Consumer, type ConsumerProps } from "./consumer";
+export type { Format } from "./format";
+export * as Legacy from "./legacy";
+export * as Timeline from "./timeline";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/container/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,cAAc,SAAS,CAAC"}

package/container/index.js

@@ -0,0 +1,18 @@
+/* @ts-self-types="./index.d.ts" */
+/**
+ * Per-frame container formats (timestamp plus codec bitstream): the legacy varint
+ * container, CMAF (fMP4), and LOC, with consumers and producers to read/write them.
+ *
+ * @module
+ */
+import * as Loc_1 from "@norskvideo/moq-loc";
+export { Loc_1 as Loc };
+import * as Cmaf_1 from "./cmaf";
+export { Cmaf_1 as Cmaf };
+export { Consumer } from "./consumer";
+import * as Legacy_1 from "./legacy";
+export { Legacy_1 as Legacy };
+import * as Timeline_1 from "./timeline";
+export { Timeline_1 as Timeline };
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/container/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;uBAEkB,UAAU;kBAAnB,GAAG;wBACO,QAAQ;mBAAlB,IAAI;AAChB,OAAO,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAC;0BAElC,UAAU;qBAAtB,MAAM;4BACQ,YAAY;uBAA1B,QAAQ;AACpB,cAAc,SAAS,CAAC","sourcesContent":["/**\n * Per-frame container formats (timestamp plus codec bitstream): the legacy varint\n * container, CMAF (fMP4), and LOC, with consumers and producers to read/write them.\n *\n * @module\n */\n\nexport * as Loc from \"@moq/loc\";\nexport * as Cmaf from \"./cmaf\";\nexport { Consumer, type ConsumerProps } from \"./consumer\";\nexport type { Format } from \"./format\";\nexport * as Legacy from \"./legacy\";\nexport * as Timeline from \"./timeline\";\nexport * from \"./types\";\n"]}

package/container/legacy.d.ts

@@ -0,0 +1,39 @@
+import type { Time } from "@norskvideo/moq-net";
+import * as Moq from "@norskvideo/moq-net";
+export type { BufferedRange, BufferedRanges, Frame } from "./types";
+import type { Format as ContainerFormat } from "./format";
+import type { Producer as TimelineProducer } from "./timeline";
+import type { Frame } from "./types";
+/** The legacy hang container: a microsecond timestamp varint followed by the raw codec payload. */
+export declare class Format implements ContainerFormat {
+    /** Decode one legacy frame into a single media frame. */
+    decode(frame: Uint8Array): Frame[];
+}
+/** A byte source that can be copied into a buffer, e.g. a WebCodecs EncodedChunk. */
+export interface Source {
+    /** Number of bytes the source will copy. */
+    byteLength: number;
+    /** Copy the source bytes into the given buffer. */
+    copyTo(buffer: Uint8Array): void;
+}
+/** Encode a frame as a timestamp varint followed by the payload bytes. */
+export declare function encodeFrame(source: Uint8Array | Source, timestamp: Time.Micro): Uint8Array;
+/** Options for a legacy-container {@link Producer}. */
+export interface ProducerProps {
+    /**
+     * Record each group open (sequence + start timestamp) into this companion timeline track, so
+     * consumers can index the media without downloading it.
+     */
+    timeline?: TimelineProducer;
+}
+/** Writes legacy-container frames into a MoQ track, starting a new group on each keyframe. */
+export declare class Producer {
+    #private;
+    /** Wrap a track to publish legacy-container frames into it. */
+    constructor(track: Moq.Track, props?: ProducerProps);
+    /** Encode and append a frame; a keyframe starts a new group. Throws if the first frame is not a keyframe. */
+    encode(data: Uint8Array | Source, timestamp: Time.Micro, keyframe: boolean): void;
+    /** Close the track and current group, optionally with an error. */
+    close(err?: Error): void;
+}
+//# sourceMappingURL=legacy.d.ts.map

package/container/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/container/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,mGAAmG;AACnG,qBAAa,MAAO,YAAW,eAAe;IAC7C,yDAAyD;IACzD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,EAAE,CAGjC;CACD;AAED,qFAAqF;AACrF,MAAM,WAAW,MAAM;IACtB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACjC;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,UAAU,CAY1F;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,8FAA8F;AAC9F,qBAAa,QAAQ;;IAKpB,+DAA+D;IAC/D,YAAY,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,GAAE,aAAkB,EAGtD;IAED,6GAA6G;IAC7G,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,QAWzE;IAED,mEAAmE;IACnE,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,QAGhB;CACD"}

package/container/legacy.js

@@ -0,0 +1,53 @@
+/* @ts-self-types="./legacy.d.ts" */
+import * as Moq from "@norskvideo/moq-net";
+/** The legacy hang container: a microsecond timestamp varint followed by the raw codec payload. */
+export class Format {
+    /** Decode one legacy frame into a single media frame. */
+    decode(frame) {
+        const [timestamp, data] = Moq.Varint.decode(frame);
+        return [{ data, timestamp: timestamp, keyframe: false }];
+    }
+}
+/** Encode a frame as a timestamp varint followed by the payload bytes. */
+export function encodeFrame(source, timestamp) {
+    const timestampBytes = Moq.Varint.encode(timestamp);
+    const data = new Uint8Array(timestampBytes.byteLength + source.byteLength);
+    data.set(timestampBytes, 0);
+    if (source instanceof Uint8Array) {
+        data.set(source, timestampBytes.byteLength);
+    }
+    else {
+        source.copyTo(data.subarray(timestampBytes.byteLength));
+    }
+    return data;
+}
+/** Writes legacy-container frames into a MoQ track, starting a new group on each keyframe. */
+export class Producer {
+    #track;
+    #group;
+    #timeline;
+    /** Wrap a track to publish legacy-container frames into it. */
+    constructor(track, props = {}) {
+        this.#track = track;
+        this.#timeline = props.timeline;
+    }
+    /** Encode and append a frame; a keyframe starts a new group. Throws if the first frame is not a keyframe. */
+    encode(data, timestamp, keyframe) {
+        if (keyframe) {
+            this.#group?.close();
+            this.#group = this.#track.appendGroup();
+            // Index the group the moment it opens: its start is this keyframe's timestamp.
+            this.#timeline?.record(this.#group.sequence, timestamp);
+        }
+        else if (!this.#group) {
+            throw new Error("must start with a keyframe");
+        }
+        this.#group?.writeFrame(encodeFrame(data, timestamp));
+    }
+    /** Close the track and current group, optionally with an error. */
+    close(err) {
+        this.#track.close(err);
+        this.#group?.close();
+    }
+}
+//# sourceMappingURL=legacy.js.map