@norskvideo/moq-json 0.1.2 → 0.1.4

package/snapshot/compression.test.js

@@ -1,132 +0,0 @@
-/* @ts-self-types="./compression.test.d.ts" */
-import { expect, test } from "bun:test";
-import { Decoder } from "@norskvideo/moq-flate";
-import { Track } from "@norskvideo/moq-net";
-import { Consumer } from "./consumer.js";
-import { Producer } from "./producer.js";
-const enc = new TextEncoder();
-const dec = new TextDecoder();
-// Reconstruct every value a compressed consumer yields, in order.
-async function drainCompressed(track) {
-    const out = [];
-    for await (const value of new Consumer(track, { compression: true }))
-        out.push(value);
-    return out;
-}
-// The raw (stored) bytes of a track's first frame, without reconstructing JSON.
-async function firstFrame(track) {
-    const group = await track.nextGroupOrdered();
-    if (!group)
-        throw new Error("expected a group");
-    const frame = await group.readFrame();
-    if (!frame)
-        throw new Error("expected a frame");
-    return frame;
-}
-// Count the groups a (finished) track published, draining each so the reads terminate.
-async function groupCount(track) {
-    let groups = 0;
-    for (;;) {
-        const group = await track.nextGroupOrdered();
-        if (!group)
-            return groups;
-        groups++;
-        while ((await group.readFrame()) !== undefined) { }
-    }
-}
-test("compressed snapshot per group round-trips", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 0, compression: true });
-    producer.update({ a: 1 });
-    producer.update({ a: 2 });
-    producer.finish();
-    // Deltas off: one compressed snapshot per group, reconstructed in order.
-    expect(await drainCompressed(track)).toEqual([{ a: 1 }, { a: 2 }]);
-});
-test("compressed live consumer sees each update in order", async () => {
-    // A live consumer reconstructs each update in order from the shared per-group stream.
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100, compression: true });
-    const consumer = new Consumer(track, { compression: true });
-    for (let n = 1; n <= 5; n++) {
-        producer.update({ a: n });
-        expect(await consumer.next()).toEqual({ a: n });
-    }
-});
-test("compressed deltas share one group and reconstruct", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100, compression: true });
-    producer.update({ a: 1, b: 1 });
-    producer.update({ a: 1, b: 2 });
-    producer.update({ a: 5, b: 2 });
-    producer.finish();
-    expect((await drainCompressed(track)).at(-1)).toEqual({ a: 5, b: 2 });
-});
-test("compressed late joiner reconstructs from snapshot + deltas", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100, compression: true });
-    producer.update({ a: 1, b: 1 });
-    producer.update({ a: 1, b: 2 });
-    producer.update({ a: 5, b: 2 });
-    producer.finish();
-    // A consumer created only now still rebuilds the final value from the snapshot + deltas.
-    expect((await drainCompressed(track)).at(-1)).toEqual({ a: 5, b: 2 });
-});
-test("a group's snapshot decodes from a fresh decoder", async () => {
-    // Frame 0 opens a cold window, so a brand-new decoder reconstructs it, which is what lets a late
-    // joiner (or the Rust consumer) start mid-stream at any group boundary.
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 0, compression: true });
-    producer.update({ hello: "world" });
-    producer.finish();
-    const decoder = new Decoder();
-    expect(JSON.parse(dec.decode(decoder.frame(await firstFrame(track))))).toEqual({ hello: "world" });
-});
-test("compressed deltas reuse the window", async () => {
-    // The shared per-group window is the point: a delta restating snapshot content shrinks sharply.
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100, compression: true });
-    const phrase = "Media over QUIC delivers real-time latency at massive scale";
-    producer.update({ note: phrase });
-    producer.update({ note: phrase, echo: phrase });
-    producer.finish();
-    const group = await track.nextGroupOrdered();
-    if (!group)
-        throw new Error("expected a group");
-    await group.readFrame(); // snapshot
-    const delta = await group.readFrame();
-    if (!delta)
-        throw new Error("expected a delta");
-    const rawDelta = enc.encode(JSON.stringify({ echo: phrase }));
-    expect(delta.length).toBeLessThan(rawDelta.length / 2);
-});
-test("compression shrinks a repetitive frame", async () => {
-    const value = { renditions: Array(3).fill("video".repeat(50)) };
-    const plain = new Track("plain");
-    new Producer(plain, { deltaRatio: 0 }).update(value);
-    const compressed = new Track("compressed");
-    new Producer(compressed, { deltaRatio: 0, compression: true }).update(value);
-    const plainLen = (await firstFrame(plain)).length;
-    const compressedLen = (await firstFrame(compressed)).length;
-    expect(compressedLen).toBeLessThan(plainLen);
-});
-test("compressed deltas roll on the compressed budget", async () => {
-    // With compression the budget is measured on compressed frame sizes: #snapshotLen and #deltaBytes
-    // are the written slice lengths, not the raw JSON. A tight ratio over many distinct updates must
-    // roll more than one group, and a late joiner must still rebuild the final value across the
-    // compressed group boundary. Guards against the budget regressing to raw lengths. Two identical
-    // producers (deterministic output) keep the group-count and reconstruction reads independent.
-    const fill = (track) => {
-        const producer = new Producer(track, { deltaRatio: 2, compression: true });
-        for (let n = 0; n <= 40; n++)
-            producer.update({ n });
-        producer.finish();
-    };
-    const layout = new Track("layout");
-    fill(layout);
-    expect(await groupCount(layout)).toBeGreaterThan(1);
-    const reconstruct = new Track("reconstruct");
-    fill(reconstruct);
-    expect((await drainCompressed(reconstruct)).at(-1)).toEqual({ n: 40 });
-});
-//# sourceMappingURL=compression.test.js.map

package/snapshot/compression.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compression.test.js","sourceRoot":"","sources":["../../src/snapshot/compression.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"bun:test\";\nimport { Decoder } from \"@moq/flate\";\nimport { Track } from \"@moq/net\";\nimport { Consumer } from \"./consumer.ts\";\nimport { Producer } from \"./producer.ts\";\n\ntype Value = Record<string, unknown>;\n\nconst enc = new TextEncoder();\nconst dec = new TextDecoder();\n\n// Reconstruct every value a compressed consumer yields, in order.\nasync function drainCompressed(track: Track): Promise<Value[]> {\n\tconst out: Value[] = [];\n\tfor await (const value of new Consumer<Value>(track, { compression: true })) out.push(value);\n\treturn out;\n}\n\n// The raw (stored) bytes of a track's first frame, without reconstructing JSON.\nasync function firstFrame(track: Track): Promise<Uint8Array> {\n\tconst group = await track.nextGroupOrdered();\n\tif (!group) throw new Error(\"expected a group\");\n\tconst frame = await group.readFrame();\n\tif (!frame) throw new Error(\"expected a frame\");\n\treturn frame;\n}\n\n// Count the groups a (finished) track published, draining each so the reads terminate.\nasync function groupCount(track: Track): Promise<number> {\n\tlet groups = 0;\n\tfor (;;) {\n\t\tconst group = await track.nextGroupOrdered();\n\t\tif (!group) return groups;\n\t\tgroups++;\n\t\twhile ((await group.readFrame()) !== undefined) {}\n\t}\n}\n\ntest(\"compressed snapshot per group round-trips\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 0, compression: true });\n\tproducer.update({ a: 1 });\n\tproducer.update({ a: 2 });\n\tproducer.finish();\n\n\t// Deltas off: one compressed snapshot per group, reconstructed in order.\n\texpect(await drainCompressed(track)).toEqual([{ a: 1 }, { a: 2 }]);\n});\n\ntest(\"compressed live consumer sees each update in order\", async () => {\n\t// A live consumer reconstructs each update in order from the shared per-group stream.\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100, compression: true });\n\tconst consumer = new Consumer<Value>(track, { compression: true });\n\n\tfor (let n = 1; n <= 5; n++) {\n\t\tproducer.update({ a: n });\n\t\texpect(await consumer.next()).toEqual({ a: n });\n\t}\n});\n\ntest(\"compressed deltas share one group and reconstruct\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100, compression: true });\n\tproducer.update({ a: 1, b: 1 });\n\tproducer.update({ a: 1, b: 2 });\n\tproducer.update({ a: 5, b: 2 });\n\tproducer.finish();\n\n\texpect((await drainCompressed(track)).at(-1)).toEqual({ a: 5, b: 2 });\n});\n\ntest(\"compressed late joiner reconstructs from snapshot + deltas\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100, compression: true });\n\tproducer.update({ a: 1, b: 1 });\n\tproducer.update({ a: 1, b: 2 });\n\tproducer.update({ a: 5, b: 2 });\n\tproducer.finish();\n\n\t// A consumer created only now still rebuilds the final value from the snapshot + deltas.\n\texpect((await drainCompressed(track)).at(-1)).toEqual({ a: 5, b: 2 });\n});\n\ntest(\"a group's snapshot decodes from a fresh decoder\", async () => {\n\t// Frame 0 opens a cold window, so a brand-new decoder reconstructs it, which is what lets a late\n\t// joiner (or the Rust consumer) start mid-stream at any group boundary.\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 0, compression: true });\n\tproducer.update({ hello: \"world\" });\n\tproducer.finish();\n\n\tconst decoder = new Decoder();\n\texpect(JSON.parse(dec.decode(decoder.frame(await firstFrame(track))))).toEqual({ hello: \"world\" });\n});\n\ntest(\"compressed deltas reuse the window\", async () => {\n\t// The shared per-group window is the point: a delta restating snapshot content shrinks sharply.\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100, compression: true });\n\tconst phrase = \"Media over QUIC delivers real-time latency at massive scale\";\n\tproducer.update({ note: phrase });\n\tproducer.update({ note: phrase, echo: phrase });\n\tproducer.finish();\n\n\tconst group = await track.nextGroupOrdered();\n\tif (!group) throw new Error(\"expected a group\");\n\tawait group.readFrame(); // snapshot\n\tconst delta = await group.readFrame();\n\tif (!delta) throw new Error(\"expected a delta\");\n\n\tconst rawDelta = enc.encode(JSON.stringify({ echo: phrase }));\n\texpect(delta.length).toBeLessThan(rawDelta.length / 2);\n});\n\ntest(\"compression shrinks a repetitive frame\", async () => {\n\tconst value = { renditions: Array(3).fill(\"video\".repeat(50)) };\n\n\tconst plain = new Track(\"plain\");\n\tnew Producer<Value>(plain, { deltaRatio: 0 }).update(value);\n\tconst compressed = new Track(\"compressed\");\n\tnew Producer<Value>(compressed, { deltaRatio: 0, compression: true }).update(value);\n\n\tconst plainLen = (await firstFrame(plain)).length;\n\tconst compressedLen = (await firstFrame(compressed)).length;\n\texpect(compressedLen).toBeLessThan(plainLen);\n});\n\ntest(\"compressed deltas roll on the compressed budget\", async () => {\n\t// With compression the budget is measured on compressed frame sizes: #snapshotLen and #deltaBytes\n\t// are the written slice lengths, not the raw JSON. A tight ratio over many distinct updates must\n\t// roll more than one group, and a late joiner must still rebuild the final value across the\n\t// compressed group boundary. Guards against the budget regressing to raw lengths. Two identical\n\t// producers (deterministic output) keep the group-count and reconstruction reads independent.\n\tconst fill = (track: Track) => {\n\t\tconst producer = new Producer<Value>(track, { deltaRatio: 2, compression: true });\n\t\tfor (let n = 0; n <= 40; n++) producer.update({ n });\n\t\tproducer.finish();\n\t};\n\n\tconst layout = new Track(\"layout\");\n\tfill(layout);\n\texpect(await groupCount(layout)).toBeGreaterThan(1);\n\n\tconst reconstruct = new Track(\"reconstruct\");\n\tfill(reconstruct);\n\texpect((await drainCompressed(reconstruct)).at(-1)).toEqual({ n: 40 });\n});\n"]}

package/snapshot/producer.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=producer.test.d.ts.map

package/snapshot/producer.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"producer.test.d.ts","sourceRoot":"","sources":["../../src/snapshot/producer.test.ts"],"names":[],"mappings":""}

package/snapshot/producer.test.js

@@ -1,75 +0,0 @@
-/* @ts-self-types="./producer.test.d.ts" */
-import { expect, test } from "bun:test";
-import { Track } from "@norskvideo/moq-net";
-import { Effect } from "@norskvideo/moq-signals";
-import { Consumer } from "./consumer.js";
-import { Producer } from "./producer.js";
-test("a track-less producer seeds subscribers and fans out edits", async () => {
-    const source = new Producer({ initial: {} });
-    // Edit before anyone subscribes: the value is retained, not lost.
-    source.mutate((v) => {
-        v.video = { renditions: {} };
-    });
-    const effect = new Effect();
-    const track = new Track("catalog.json");
-    source.serve(track, effect);
-    const consumer = new Consumer(track);
-    // A new subscriber is seeded with the current value.
-    expect((await consumer.next())?.video).toEqual({ renditions: {} });
-    // An independent owner edits its own key; the subscriber sees it, the other key untouched.
-    source.mutate((v) => {
-        v.scte35 = { splices: [] };
-    });
-    const update = await consumer.next();
-    expect(update?.video).toEqual({ renditions: {} });
-    expect(update?.scte35).toEqual({ splices: [] });
-    effect.close();
-});
-test("a reconnecting subscriber is seeded with the full current value", async () => {
-    const source = new Producer({ initial: {} });
-    source.mutate((v) => {
-        v.video = { renditions: {} };
-        v.scte35 = { splices: [] };
-    });
-    // The first subscription drains and ends...
-    const first = new Effect();
-    source.serve(new Track("catalog.json"), first);
-    first.close();
-    // ...and a fresh subscription still gets the current value, not nothing.
-    const effect = new Effect();
-    const track = new Track("catalog.json");
-    source.serve(track, effect);
-    const seeded = await new Consumer(track).next();
-    expect(seeded?.video).toEqual({ renditions: {} });
-    expect(seeded?.scte35).toEqual({ splices: [] });
-    effect.close();
-});
-test("mutate without a value or initial throws", () => {
-    const source = new Producer();
-    expect(() => source.mutate(() => { })).toThrow();
-});
-test("serve() can override compression per subscriber", async () => {
-    // One fan-out producer serves the same value both plaintext and compressed.
-    const source = new Producer({ initial: {} });
-    source.mutate((v) => {
-        v.video = { renditions: { hd: { codec: "avc1.640028" } } };
-    });
-    const effect = new Effect();
-    const plainTrack = new Track("catalog.json");
-    source.serve(plainTrack, effect);
-    const plain = await new Consumer(plainTrack).next();
-    const zTrack = new Track("catalog.json.z");
-    source.serve(zTrack, effect, { compression: true });
-    const compressed = await new Consumer(zTrack, { compression: true }).next();
-    // Both tracks reconstruct the identical value despite different wire encodings.
-    expect(compressed).toEqual(plain);
-    expect(compressed?.video).toEqual({ renditions: { hd: { codec: "avc1.640028" } } });
-    effect.close();
-});
-test("serve() throws on a track-bound producer", () => {
-    const producer = new Producer(new Track("meta.json"));
-    const effect = new Effect();
-    expect(() => producer.serve(new Track("other"), effect)).toThrow();
-    effect.close();
-});
-//# sourceMappingURL=producer.test.js.map

package/snapshot/producer.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"producer.test.js","sourceRoot":"","sources":["../../src/snapshot/producer.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"bun:test\";\nimport { Track } from \"@moq/net\";\nimport { Effect } from \"@moq/signals\";\nimport { Consumer } from \"./consumer.ts\";\nimport { Producer } from \"./producer.ts\";\n\ntest(\"a track-less producer seeds subscribers and fans out edits\", async () => {\n\tconst source = new Producer<Record<string, unknown>>({ initial: {} });\n\n\t// Edit before anyone subscribes: the value is retained, not lost.\n\tsource.mutate((v) => {\n\t\tv.video = { renditions: {} };\n\t});\n\n\tconst effect = new Effect();\n\tconst track = new Track(\"catalog.json\");\n\tsource.serve(track, effect);\n\tconst consumer = new Consumer<Record<string, unknown>>(track);\n\n\t// A new subscriber is seeded with the current value.\n\texpect((await consumer.next())?.video).toEqual({ renditions: {} });\n\n\t// An independent owner edits its own key; the subscriber sees it, the other key untouched.\n\tsource.mutate((v) => {\n\t\tv.scte35 = { splices: [] };\n\t});\n\tconst update = await consumer.next();\n\texpect(update?.video).toEqual({ renditions: {} });\n\texpect(update?.scte35).toEqual({ splices: [] });\n\n\teffect.close();\n});\n\ntest(\"a reconnecting subscriber is seeded with the full current value\", async () => {\n\tconst source = new Producer<Record<string, unknown>>({ initial: {} });\n\tsource.mutate((v) => {\n\t\tv.video = { renditions: {} };\n\t\tv.scte35 = { splices: [] };\n\t});\n\n\t// The first subscription drains and ends...\n\tconst first = new Effect();\n\tsource.serve(new Track(\"catalog.json\"), first);\n\tfirst.close();\n\n\t// ...and a fresh subscription still gets the current value, not nothing.\n\tconst effect = new Effect();\n\tconst track = new Track(\"catalog.json\");\n\tsource.serve(track, effect);\n\tconst seeded = await new Consumer<Record<string, unknown>>(track).next();\n\texpect(seeded?.video).toEqual({ renditions: {} });\n\texpect(seeded?.scte35).toEqual({ splices: [] });\n\n\teffect.close();\n});\n\ntest(\"mutate without a value or initial throws\", () => {\n\tconst source = new Producer<Record<string, unknown>>();\n\texpect(() => source.mutate(() => {})).toThrow();\n});\n\ntest(\"serve() can override compression per subscriber\", async () => {\n\t// One fan-out producer serves the same value both plaintext and compressed.\n\tconst source = new Producer<Record<string, unknown>>({ initial: {} });\n\tsource.mutate((v) => {\n\t\tv.video = { renditions: { hd: { codec: \"avc1.640028\" } } };\n\t});\n\n\tconst effect = new Effect();\n\n\tconst plainTrack = new Track(\"catalog.json\");\n\tsource.serve(plainTrack, effect);\n\tconst plain = await new Consumer<Record<string, unknown>>(plainTrack).next();\n\n\tconst zTrack = new Track(\"catalog.json.z\");\n\tsource.serve(zTrack, effect, { compression: true });\n\tconst compressed = await new Consumer<Record<string, unknown>>(zTrack, { compression: true }).next();\n\n\t// Both tracks reconstruct the identical value despite different wire encodings.\n\texpect(compressed).toEqual(plain);\n\texpect(compressed?.video).toEqual({ renditions: { hd: { codec: \"avc1.640028\" } } });\n\n\teffect.close();\n});\n\ntest(\"serve() throws on a track-bound producer\", () => {\n\tconst producer = new Producer<Record<string, unknown>>(new Track(\"meta.json\"));\n\tconst effect = new Effect();\n\texpect(() => producer.serve(new Track(\"other\"), effect)).toThrow();\n\teffect.close();\n});\n"]}

package/snapshot/snapshot.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=snapshot.test.d.ts.map

package/snapshot/snapshot.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.test.d.ts","sourceRoot":"","sources":["../../src/snapshot/snapshot.test.ts"],"names":[],"mappings":""}

package/snapshot/snapshot.test.js

@@ -1,185 +0,0 @@
-/* @ts-self-types="./snapshot.test.d.ts" */
-import { expect, test } from "bun:test";
-import { Track } from "@norskvideo/moq-net";
-import { Consumer } from "./consumer.js";
-import { Producer } from "./producer.js";
-// Reconstruct every value a consumer yields, in order.
-async function drain(track) {
-    const out = [];
-    for await (const value of new Consumer(track))
-        out.push(value);
-    return out;
-}
-// Inspect the published layout via the public API: the frame count of each group, in order.
-// The track must be finished first so group/frame reads terminate.
-async function structure(track) {
-    const counts = [];
-    for (;;) {
-        const group = await track.nextGroupOrdered();
-        if (!group)
-            break;
-        let frames = 0;
-        while ((await group.readFrame()) !== undefined)
-            frames++;
-        counts.push(frames);
-    }
-    return counts;
-}
-test("deltas off: a snapshot group per change", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 0 });
-    producer.update({ a: 1 });
-    producer.update({ a: 2 });
-    producer.finish();
-    // Two changes => two single-frame snapshot groups, reconstructed in order.
-    expect(await drain(track)).toEqual([{ a: 1 }, { a: 2 }]);
-});
-test("deltaRatio 0 disables deltas, like off", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 0 });
-    producer.update({ a: 1 });
-    producer.update({ a: 2 });
-    producer.finish();
-    // `0` is treated as off, not a degenerate "enabled" value that keeps the group open: each change
-    // is its own single-frame snapshot group.
-    expect(await structure(track)).toEqual([1, 1]);
-});
-test("live consumer sees each update", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track);
-    const consumer = new Consumer(track);
-    for (let n = 1; n <= 3; n++) {
-        producer.update({ a: n });
-        expect(await consumer.next()).toEqual({ a: n });
-    }
-});
-test("unchanged value writes nothing", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track);
-    producer.update({ a: 1 });
-    producer.update({ a: 1 });
-    producer.finish();
-    expect(await structure(track)).toEqual([1]);
-});
-test("deltas share one group", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100 });
-    producer.update({ a: 1, b: 1 });
-    producer.update({ a: 1, b: 2 });
-    producer.update({ a: 1, b: 3 });
-    producer.finish();
-    // All updates fit in a single group as snapshot + two deltas.
-    expect(await structure(track)).toEqual([3]);
-});
-test("deltas reconstruct to the final value", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100 });
-    producer.update({ a: 1, b: 1 });
-    producer.update({ a: 1, b: 2 });
-    producer.update({ a: 5, b: 2 });
-    producer.finish();
-    expect((await drain(track)).at(-1)).toEqual({ a: 5, b: 2 });
-});
-// `mutate()` edits the shared document: multiple owners edit one producer, each touching its own
-// keys, and each call publishes. This is how the catalog producer is extended (e.g. an scte35
-// section) without a single owner having to rebuild the whole document.
-test("mutate composes independent owners", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { initial: {} });
-    const consumer = new Consumer(track);
-    producer.mutate((v) => {
-        v.video = "v1";
-    });
-    expect(await consumer.next()).toEqual({ video: "v1" });
-    // A second owner starts from the latest value and adds its own key without clobbering the first.
-    producer.mutate((v) => {
-        v.scte35 = { id: 1 };
-    });
-    expect(await consumer.next()).toEqual({ video: "v1", scte35: { id: 1 } });
-});
-test("mutate starts from the configured initial value", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { initial: {} });
-    const consumer = new Consumer(track);
-    producer.mutate((v) => {
-        v.a = 1;
-    });
-    expect(await consumer.next()).toEqual({ a: 1 });
-});
-test("mutate without a prior value or initial throws", () => {
-    const producer = new Producer(new Track("test"));
-    expect(() => producer.mutate(() => { })).toThrow();
-});
-// Removing a section drops it from the reconstructed value, so a consumer detects the removal.
-// Exercised with deltas on to cover the merge-patch null-deletion path.
-test("mutate removes a section", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100, initial: {} });
-    const consumer = new Consumer(track);
-    producer.mutate((v) => {
-        v.a = 1;
-        v.scte35 = { id: 1 };
-    });
-    expect(await consumer.next()).toEqual({ a: 1, scte35: { id: 1 } });
-    producer.mutate((v) => {
-        delete v.scte35;
-    });
-    expect(await consumer.next()).toEqual({ a: 1 });
-});
-test("tight ratio rolls snapshots", async () => {
-    const track = new Track("test");
-    // A ratio of 1 budgets deltas up to one snapshot (equal 7-byte frames => 7 bytes). The gate checks
-    // the deltas already written, so the delta that tips the group over budget still lands (a one-frame
-    // overshoot): group 0 takes two deltas (14 bytes) before the fourth update rolls group 1.
-    const producer = new Producer(track, { deltaRatio: 1 });
-    producer.update({ a: 1 }); // snapshot, group 0
-    producer.update({ a: 2 }); // delta, group 0 (deltas = 7)
-    producer.update({ a: 3 }); // delta, group 0 (deltas = 14, now over budget)
-    producer.update({ a: 4 }); // budget already exceeded, rolls group 1
-    producer.finish();
-    expect(await structure(track)).toEqual([3, 1]);
-});
-test("deltas stay within ratio times snapshot", async () => {
-    const track = new Track("test");
-    // The budget covers only the deltas, not the snapshot frame, measured against the group's snapshot
-    // size. Single-digit values keep every frame at a constant 7 bytes (`{"n":N}`), so a ratio of 8
-    // budgets 56 bytes of deltas. The gate checks the deltas already written, so the group keeps filling
-    // until they first exceed 56 (nine deltas = 63 bytes) and the next update rolls (a one-frame
-    // overshoot past the 56-byte budget).
-    const producer = new Producer(track, { deltaRatio: 8 });
-    for (let n = 0; n <= 10; n++)
-        producer.update({ n });
-    producer.finish();
-    expect(await structure(track)).toEqual([10, 1]);
-});
-test("array change is a wholesale delta", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100 });
-    producer.update({ list: [1, 2] });
-    producer.update({ list: [1, 2, 3] });
-    producer.finish();
-    // The array is replaced wholesale in a delta, so it stays in the same group.
-    expect(await structure(track)).toEqual([2]);
-});
-test("late joiner collapses a buffered backlog to the latest value", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 100 });
-    for (let n = 0; n <= 20; n++) {
-        producer.update({ n });
-    }
-    producer.finish();
-    // A whole group's worth of snapshot + deltas is buffered before the consumer reads, so it applies
-    // them all but yields only the latest value once, not every superseded state.
-    expect(await drain(track)).toEqual([{ n: 20 }]);
-});
-test("frame cap rolls snapshot", async () => {
-    const track = new Track("test");
-    const producer = new Producer(track, { deltaRatio: 1_000_000 });
-    // First update is the snapshot; deltas fill the group until the frame cap forces a roll.
-    for (let i = 0; i <= 256; i++) {
-        producer.update({ n: i });
-    }
-    producer.finish();
-    expect(await structure(track)).toEqual([256, 1]);
-});
-//# sourceMappingURL=snapshot.test.js.map

package/snapshot/snapshot.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.test.js","sourceRoot":"","sources":["../../src/snapshot/snapshot.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"bun:test\";\nimport { Track } from \"@moq/net\";\nimport { Consumer } from \"./consumer.ts\";\nimport { Producer } from \"./producer.ts\";\n\ntype Value = Record<string, unknown>;\n\n// Reconstruct every value a consumer yields, in order.\nasync function drain(track: Track): Promise<Value[]> {\n\tconst out: Value[] = [];\n\tfor await (const value of new Consumer<Value>(track)) out.push(value);\n\treturn out;\n}\n\n// Inspect the published layout via the public API: the frame count of each group, in order.\n// The track must be finished first so group/frame reads terminate.\nasync function structure(track: Track): Promise<number[]> {\n\tconst counts: number[] = [];\n\tfor (;;) {\n\t\tconst group = await track.nextGroupOrdered();\n\t\tif (!group) break;\n\n\t\tlet frames = 0;\n\t\twhile ((await group.readFrame()) !== undefined) frames++;\n\t\tcounts.push(frames);\n\t}\n\treturn counts;\n}\n\ntest(\"deltas off: a snapshot group per change\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 0 });\n\tproducer.update({ a: 1 });\n\tproducer.update({ a: 2 });\n\tproducer.finish();\n\n\t// Two changes => two single-frame snapshot groups, reconstructed in order.\n\texpect(await drain(track)).toEqual([{ a: 1 }, { a: 2 }]);\n});\n\ntest(\"deltaRatio 0 disables deltas, like off\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 0 });\n\tproducer.update({ a: 1 });\n\tproducer.update({ a: 2 });\n\tproducer.finish();\n\n\t// `0` is treated as off, not a degenerate \"enabled\" value that keeps the group open: each change\n\t// is its own single-frame snapshot group.\n\texpect(await structure(track)).toEqual([1, 1]);\n});\n\ntest(\"live consumer sees each update\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track);\n\tconst consumer = new Consumer<Value>(track);\n\n\tfor (let n = 1; n <= 3; n++) {\n\t\tproducer.update({ a: n });\n\t\texpect(await consumer.next()).toEqual({ a: n });\n\t}\n});\n\ntest(\"unchanged value writes nothing\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track);\n\tproducer.update({ a: 1 });\n\tproducer.update({ a: 1 });\n\tproducer.finish();\n\n\texpect(await structure(track)).toEqual([1]);\n});\n\ntest(\"deltas share one group\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100 });\n\tproducer.update({ a: 1, b: 1 });\n\tproducer.update({ a: 1, b: 2 });\n\tproducer.update({ a: 1, b: 3 });\n\tproducer.finish();\n\n\t// All updates fit in a single group as snapshot + two deltas.\n\texpect(await structure(track)).toEqual([3]);\n});\n\ntest(\"deltas reconstruct to the final value\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100 });\n\tproducer.update({ a: 1, b: 1 });\n\tproducer.update({ a: 1, b: 2 });\n\tproducer.update({ a: 5, b: 2 });\n\tproducer.finish();\n\n\texpect((await drain(track)).at(-1)).toEqual({ a: 5, b: 2 });\n});\n\n// `mutate()` edits the shared document: multiple owners edit one producer, each touching its own\n// keys, and each call publishes. This is how the catalog producer is extended (e.g. an scte35\n// section) without a single owner having to rebuild the whole document.\ntest(\"mutate composes independent owners\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { initial: {} });\n\tconst consumer = new Consumer<Value>(track);\n\n\tproducer.mutate((v) => {\n\t\tv.video = \"v1\";\n\t});\n\texpect(await consumer.next()).toEqual({ video: \"v1\" });\n\n\t// A second owner starts from the latest value and adds its own key without clobbering the first.\n\tproducer.mutate((v) => {\n\t\tv.scte35 = { id: 1 };\n\t});\n\texpect(await consumer.next()).toEqual({ video: \"v1\", scte35: { id: 1 } });\n});\n\ntest(\"mutate starts from the configured initial value\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { initial: {} });\n\tconst consumer = new Consumer<Value>(track);\n\n\tproducer.mutate((v) => {\n\t\tv.a = 1;\n\t});\n\texpect(await consumer.next()).toEqual({ a: 1 });\n});\n\ntest(\"mutate without a prior value or initial throws\", () => {\n\tconst producer = new Producer<Value>(new Track(\"test\"));\n\texpect(() => producer.mutate(() => {})).toThrow();\n});\n\n// Removing a section drops it from the reconstructed value, so a consumer detects the removal.\n// Exercised with deltas on to cover the merge-patch null-deletion path.\ntest(\"mutate removes a section\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100, initial: {} });\n\tconst consumer = new Consumer<Value>(track);\n\n\tproducer.mutate((v) => {\n\t\tv.a = 1;\n\t\tv.scte35 = { id: 1 };\n\t});\n\texpect(await consumer.next()).toEqual({ a: 1, scte35: { id: 1 } });\n\n\tproducer.mutate((v) => {\n\t\tdelete v.scte35;\n\t});\n\texpect(await consumer.next()).toEqual({ a: 1 });\n});\n\ntest(\"tight ratio rolls snapshots\", async () => {\n\tconst track = new Track(\"test\");\n\t// A ratio of 1 budgets deltas up to one snapshot (equal 7-byte frames => 7 bytes). The gate checks\n\t// the deltas already written, so the delta that tips the group over budget still lands (a one-frame\n\t// overshoot): group 0 takes two deltas (14 bytes) before the fourth update rolls group 1.\n\tconst producer = new Producer<Value>(track, { deltaRatio: 1 });\n\tproducer.update({ a: 1 }); // snapshot, group 0\n\tproducer.update({ a: 2 }); // delta, group 0 (deltas = 7)\n\tproducer.update({ a: 3 }); // delta, group 0 (deltas = 14, now over budget)\n\tproducer.update({ a: 4 }); // budget already exceeded, rolls group 1\n\tproducer.finish();\n\n\texpect(await structure(track)).toEqual([3, 1]);\n});\n\ntest(\"deltas stay within ratio times snapshot\", async () => {\n\tconst track = new Track(\"test\");\n\t// The budget covers only the deltas, not the snapshot frame, measured against the group's snapshot\n\t// size. Single-digit values keep every frame at a constant 7 bytes (`{\"n\":N}`), so a ratio of 8\n\t// budgets 56 bytes of deltas. The gate checks the deltas already written, so the group keeps filling\n\t// until they first exceed 56 (nine deltas = 63 bytes) and the next update rolls (a one-frame\n\t// overshoot past the 56-byte budget).\n\tconst producer = new Producer<Value>(track, { deltaRatio: 8 });\n\tfor (let n = 0; n <= 10; n++) producer.update({ n });\n\tproducer.finish();\n\n\texpect(await structure(track)).toEqual([10, 1]);\n});\n\ntest(\"array change is a wholesale delta\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100 });\n\tproducer.update({ list: [1, 2] });\n\tproducer.update({ list: [1, 2, 3] });\n\tproducer.finish();\n\n\t// The array is replaced wholesale in a delta, so it stays in the same group.\n\texpect(await structure(track)).toEqual([2]);\n});\n\ntest(\"late joiner collapses a buffered backlog to the latest value\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 100 });\n\tfor (let n = 0; n <= 20; n++) {\n\t\tproducer.update({ n });\n\t}\n\tproducer.finish();\n\n\t// A whole group's worth of snapshot + deltas is buffered before the consumer reads, so it applies\n\t// them all but yields only the latest value once, not every superseded state.\n\texpect(await drain(track)).toEqual([{ n: 20 }]);\n});\n\ntest(\"frame cap rolls snapshot\", async () => {\n\tconst track = new Track(\"test\");\n\tconst producer = new Producer<Value>(track, { deltaRatio: 1_000_000 });\n\t// First update is the snapshot; deltas fill the group until the frame cap forces a roll.\n\tfor (let i = 0; i <= 256; i++) {\n\t\tproducer.update({ n: i });\n\t}\n\tproducer.finish();\n\n\texpect(await structure(track)).toEqual([256, 1]);\n});\n"]}

package/stream.d.ts

@@ -1,54 +0,0 @@
-/**
- * Lossless append-log JSON publishing over MoQ tracks: the counterpart to the lossy `Snapshot`
- * module. Instead of one value updated over time, a stream is an ordered log of self-contained
- * records that preserves everything; every {@link Producer.append} writes one JSON object as one
- * frame, nothing is ever superseded, and a {@link Consumer} yields every record in order.
- *
- * The whole log rides a **single group** that is never rolled: with {@link ProducerConfig.compression}
- * on, that one group is one DEFLATE window, so every record compresses against the earlier ones.
- * There is deliberately no group rolling (and so no catch-up machinery); a caller that wants to
- * bound the record rate throttles at the source. Interoperable on the wire with the Rust
- * `moq_json::stream`.
- *
- * @module
- */
-import type * as Moq from "@norskvideo/moq-net";
-/** Options for a stream {@link Producer}. */
-export interface ProducerConfig {
-    /**
-     * Compress the group as one sync-flushed `deflate-raw` stream, so each record reuses the earlier
-     * ones as context and shrinks sharply. A {@link Consumer} reading the track must set the same
-     * flag. Defaults to `false`.
-     */
-    compression?: boolean;
-}
-/** Options for a stream {@link Consumer}. */
-export interface ConsumerConfig {
-    /** Whether the track's frames are `deflate-raw` compressed. Must match the producer. Defaults to `false`. */
-    compression?: boolean;
-}
-/**
- * Publishes an ordered log of JSON records to a track, one record per frame in a single group.
- */
-export declare class Producer<T> {
-    #private;
-    /** Wrap a track to publish a record log into it. */
-    constructor(track: Moq.Track, config?: ProducerConfig);
-    /** Append one record to the log. */
-    append(value: T): void;
-    /** Finish the track, closing the group. */
-    finish(): void;
-}
-/**
- * Consumes an ordered log of JSON records from a track, yielding every record in order.
- *
- * The log rides a single group, so this reads that group's frames in order; one record per frame.
- */
-export declare class Consumer<T> {
-    #private;
-    constructor(track: Moq.Track, config?: ConsumerConfig);
-    /** Get the next record, or `undefined` once the track ends. */
-    next(): Promise<T | undefined>;
-    [Symbol.asyncIterator](): AsyncIterator<T>;
-}
-//# sourceMappingURL=stream.d.ts.map

package/stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAErC,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC9B,6GAA6G;IAC7G,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC;;IAStB,oDAAoD;IACpD,YAAY,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAE,cAAmB,EAGxD;IAED,oCAAoC;IACpC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CASrB;IAED,2CAA2C;IAC3C,MAAM,IAAI,IAAI,CAIb;CACD;AAED;;;;GAIG;AACH,qBAAa,QAAQ,CAAC,CAAC;;IAQtB,YAAY,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAE,cAAmB,EAGxD;IAED,+DAA+D;IACzD,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAmBnC;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAMhD;CACD"}

package/stream.js

@@ -1,92 +0,0 @@
-/* @ts-self-types="./stream.d.ts" */
-/**
- * Lossless append-log JSON publishing over MoQ tracks: the counterpart to the lossy `Snapshot`
- * module. Instead of one value updated over time, a stream is an ordered log of self-contained
- * records that preserves everything; every {@link Producer.append} writes one JSON object as one
- * frame, nothing is ever superseded, and a {@link Consumer} yields every record in order.
- *
- * The whole log rides a **single group** that is never rolled: with {@link ProducerConfig.compression}
- * on, that one group is one DEFLATE window, so every record compresses against the earlier ones.
- * There is deliberately no group rolling (and so no catch-up machinery); a caller that wants to
- * bound the record rate throttles at the source. Interoperable on the wire with the Rust
- * `moq_json::stream`.
- *
- * @module
- */
-import { Decoder, Encoder } from "@norskvideo/moq-flate";
-/**
- * Publishes an ordered log of JSON records to a track, one record per frame in a single group.
- */
-export class Producer {
-    #track;
-    #compress;
-    // The single group carrying the whole log, opened on the first append.
-    #group;
-    // The group's DEFLATE encoder (one window for the whole log), present while compressing.
-    #encoder;
-    /** Wrap a track to publish a record log into it. */
-    constructor(track, config = {}) {
-        this.#track = track;
-        this.#compress = config.compression ?? false;
-    }
-    /** Append one record to the log. */
-    append(value) {
-        const payload = new TextEncoder().encode(JSON.stringify(value));
-        if (!this.#group) {
-            this.#group = this.#track.appendGroup();
-            this.#encoder = this.#compress ? new Encoder() : undefined;
-        }
-        this.#group.writeFrame(this.#encoder ? this.#encoder.frame(payload) : payload);
-    }
-    /** Finish the track, closing the group. */
-    finish() {
-        this.#group?.close();
-        this.#group = undefined;
-        this.#track.close();
-    }
-}
-/**
- * Consumes an ordered log of JSON records from a track, yielding every record in order.
- *
- * The log rides a single group, so this reads that group's frames in order; one record per frame.
- */
-export class Consumer {
-    #track;
-    #decompress;
-    #group;
-    // The group's DEFLATE decoder (one window for the whole log), built on the first frame.
-    #decoder;
-    constructor(track, config = {}) {
-        this.#track = track;
-        this.#decompress = config.compression ?? false;
-    }
-    /** Get the next record, or `undefined` once the track ends. */
-    async next() {
-        for (;;) {
-            if (!this.#group) {
-                this.#group = await this.#track.nextGroupOrdered();
-                if (!this.#group)
-                    return undefined;
-                this.#decoder = this.#decompress ? new Decoder() : undefined;
-            }
-            const frame = await this.#group.readFrame();
-            if (frame === undefined) {
-                // The group is finished; the log rides just this one, so the stream ends.
-                this.#group = undefined;
-                this.#decoder = undefined;
-                continue;
-            }
-            const plain = this.#decoder ? this.#decoder.frame(frame) : frame;
-            return JSON.parse(new TextDecoder().decode(plain));
-        }
-    }
-    async *[Symbol.asyncIterator]() {
-        for (;;) {
-            const value = await this.next();
-            if (value === undefined)
-                return;
-            yield value;
-        }
-    }
-}
-//# sourceMappingURL=stream.js.map