@norskvideo/moq-net 0.1.0

package/track.js

@@ -0,0 +1,227 @@
+/* @ts-self-types="./track.d.ts" */
+import { Signal } from "@norskvideo/moq-signals";
+import { Group } from "./group.js";
+/** Reactive backing state for a {@link Track}: buffered groups, a closed flag, and the subscription priority. */
+export class TrackState {
+    groups = new Signal([]);
+    closed = new Signal(false);
+    priority = new Signal(undefined);
+}
+/** A live stream of groups within a broadcast, identified by name. */
+export class Track {
+    /** Name of this track within its broadcast. */
+    name;
+    /** Reactive backing state. */
+    state = new TrackState();
+    #next;
+    #nextSequence = 0;
+    /** Resolves with the abort error (or undefined) once closed. */
+    closed;
+    constructor(name) {
+        this.name = name;
+        this.closed = new Promise((resolve) => {
+            const dispose = this.state.closed.subscribe((closed) => {
+                if (!closed)
+                    return;
+                resolve(closed instanceof Error ? closed : undefined);
+                dispose();
+            });
+        });
+    }
+    /**
+     * Appends a new group to the track.
+     * @returns A GroupProducer for the new group
+     */
+    appendGroup() {
+        if (this.state.closed.peek())
+            throw new Error("track is closed");
+        const group = new Group(this.#next ?? 0);
+        this.#next = group.sequence + 1;
+        this.state.groups.mutate((groups) => {
+            groups.push(group);
+            groups.sort((a, b) => a.sequence - b.sequence);
+        });
+        return group;
+    }
+    /**
+     * Inserts an existing group into the track.
+     * @param group - The group to insert
+     */
+    writeGroup(group) {
+        if (this.state.closed.peek())
+            throw new Error("track is closed");
+        // Only advance #next upward (for appendGroup auto-increment).
+        if (group.sequence >= (this.#next ?? 0)) {
+            this.#next = group.sequence + 1;
+        }
+        this.state.groups.mutate((groups) => {
+            groups.push(group);
+            groups.sort((a, b) => a.sequence - b.sequence);
+        });
+    }
+    /**
+     * Appends a frame to the track in its own group.
+     *
+     * @param frame - The frame to append
+     */
+    writeFrame(frame) {
+        const group = this.appendGroup();
+        group.writeFrame(frame);
+        group.close();
+    }
+    /** Appends a string to the track as its own single-frame group. */
+    writeString(str) {
+        const group = this.appendGroup();
+        group.writeString(str);
+        group.close();
+    }
+    /** Appends a JSON value to the track as its own single-frame group. */
+    writeJson(json) {
+        const group = this.appendGroup();
+        group.writeJson(json);
+        group.close();
+    }
+    /** Appends a boolean to the track as its own single-frame group. */
+    writeBool(bool) {
+        const group = this.appendGroup();
+        group.writeBool(bool);
+        group.close();
+    }
+    /**
+     * Receive the next group available on this track, in arrival order.
+     *
+     * Groups may arrive out of order or with gaps due to network conditions.
+     * Use {@link nextGroupOrdered} if you need groups in sequence order,
+     * skipping those that arrive too late.
+     */
+    async recvGroup() {
+        for (;;) {
+            const groups = this.state.groups.peek();
+            if (groups.length > 0) {
+                return groups.shift();
+            }
+            const closed = this.state.closed.peek();
+            if (closed instanceof Error)
+                throw closed;
+            if (closed)
+                return undefined;
+            await Signal.race(this.state.groups, this.state.closed);
+        }
+    }
+    /**
+     * @deprecated Use {@link recvGroup} for arrival order, or {@link nextGroupOrdered} for sequence order.
+     */
+    async nextGroup() {
+        return this.recvGroup();
+    }
+    /**
+     * Return the next group with a strictly-greater sequence number than the last returned.
+     *
+     * Late arrivals (with a sequence number at or below the last one returned) are silently skipped.
+     *
+     * NOTE: This will be renamed to `nextGroup` in the next major version.
+     */
+    async nextGroupOrdered() {
+        for (;;) {
+            const group = await this.recvGroup();
+            if (!group)
+                return undefined;
+            if (group.sequence < this.#nextSequence) {
+                group.close();
+                continue;
+            }
+            this.#nextSequence = group.sequence + 1;
+            return group;
+        }
+    }
+    /** Reads the next frame across all groups, discarding older groups. */
+    async readFrame() {
+        return (await this.readFrameSequence())?.data;
+    }
+    /** Reads the next frame along with its group and frame sequence numbers. */
+    async readFrameSequence() {
+        for (;;) {
+            const groups = this.state.groups.peek();
+            // Discard old groups.
+            while (groups.length > 1) {
+                const next = groups[0].tryReadFrameSequence();
+                if (next) {
+                    return { group: groups[0].sequence, frame: next.sequence, data: next.data };
+                }
+                // Skip this old group
+                groups.shift()?.close();
+            }
+            // If there's no groups, wait for a new one.
+            if (groups.length === 0) {
+                const closed = this.state.closed.peek();
+                if (closed instanceof Error)
+                    throw closed;
+                if (closed)
+                    return undefined;
+                await Signal.race(this.state.groups, this.state.closed);
+                continue;
+            }
+            // If there's a group, wait for a frame.
+            const group = groups[0];
+            const next = group.tryReadFrameSequence();
+            if (next) {
+                return { group: group.sequence, frame: next.sequence, data: next.data };
+            }
+            // If the track is closed, return undefined.
+            const closed = this.state.closed.peek();
+            if (closed instanceof Error)
+                throw closed;
+            if (closed)
+                return undefined;
+            // Wake on a new group or the track closing. Only fold in the current group's readability
+            // while it can still deliver frames: a finished group's readable() resolves immediately, so
+            // racing it would busy-loop until a newer group arrives instead of waiting.
+            if (group.done) {
+                await Signal.race(this.state.groups, this.state.closed);
+            }
+            else {
+                await Promise.race([Signal.race(this.state.groups, this.state.closed), group.readable()]);
+            }
+        }
+    }
+    /** Reads the next frame and decodes it as a UTF-8 string. */
+    async readString() {
+        const next = await this.readFrame();
+        if (!next)
+            return undefined;
+        return new TextDecoder().decode(next);
+    }
+    /** Reads the next frame and parses it as JSON. */
+    async readJson() {
+        const next = await this.readString();
+        if (!next)
+            return undefined;
+        return JSON.parse(next);
+    }
+    /** Reads the next frame and decodes it as a one-byte boolean, throwing on a malformed frame. */
+    async readBool() {
+        const next = await this.readFrame();
+        if (!next)
+            return undefined;
+        if (next.byteLength !== 1 || !(next[0] === 0 || next[0] === 1))
+            throw new Error("invalid bool frame");
+        return next[0] === 1;
+    }
+    /**
+     * Update the subscription priority. Triggers a SUBSCRIBE_UPDATE
+     * to the publisher when used on a subscribed track.
+     */
+    updatePriority(priority) {
+        this.state.priority.set(priority, true);
+    }
+    /**
+     * Closes the publisher and all associated groups.
+     */
+    close(abort) {
+        this.state.closed.set(abort ?? true);
+        for (const group of this.state.groups.peek()) {
+            group.close(abort);
+        }
+    }
+}
+//# sourceMappingURL=track.js.map

package/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"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","sourcesContent":["import { Signal } from \"@moq/signals\";\nimport { Group } from \"./group.ts\";\n\n/** Reactive backing state for a {@link Track}: buffered groups, a closed flag, and the subscription priority. */\nexport class TrackState {\n\tgroups = new Signal<Group[]>([]);\n\tclosed = new Signal<boolean | Error>(false);\n\tpriority = new Signal<number | undefined>(undefined);\n}\n\n/** A live stream of groups within a broadcast, identified by name. */\nexport class Track {\n\t/** Name of this track within its broadcast. */\n\treadonly name: string;\n\n\t/** Reactive backing state. */\n\tstate = new TrackState();\n\t#next?: number;\n\t#nextSequence = 0;\n\n\t/** Resolves with the abort error (or undefined) once closed. */\n\treadonly closed: Promise<Error | undefined>;\n\n\tconstructor(name: string) {\n\t\tthis.name = name;\n\n\t\tthis.closed = new Promise((resolve) => {\n\t\t\tconst dispose = this.state.closed.subscribe((closed) => {\n\t\t\t\tif (!closed) return;\n\t\t\t\tresolve(closed instanceof Error ? closed : undefined);\n\t\t\t\tdispose();\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Appends a new group to the track.\n\t * @returns A GroupProducer for the new group\n\t */\n\tappendGroup(): Group {\n\t\tif (this.state.closed.peek()) throw new Error(\"track is closed\");\n\n\t\tconst group = new Group(this.#next ?? 0);\n\n\t\tthis.#next = group.sequence + 1;\n\t\tthis.state.groups.mutate((groups) => {\n\t\t\tgroups.push(group);\n\t\t\tgroups.sort((a, b) => a.sequence - b.sequence);\n\t\t});\n\n\t\treturn group;\n\t}\n\n\t/**\n\t * Inserts an existing group into the track.\n\t * @param group - The group to insert\n\t */\n\twriteGroup(group: Group) {\n\t\tif (this.state.closed.peek()) throw new Error(\"track is closed\");\n\n\t\t// Only advance #next upward (for appendGroup auto-increment).\n\t\tif (group.sequence >= (this.#next ?? 0)) {\n\t\t\tthis.#next = group.sequence + 1;\n\t\t}\n\n\t\tthis.state.groups.mutate((groups) => {\n\t\t\tgroups.push(group);\n\t\t\tgroups.sort((a, b) => a.sequence - b.sequence);\n\t\t});\n\t}\n\n\t/**\n\t * Appends a frame to the track in its own group.\n\t *\n\t * @param frame - The frame to append\n\t */\n\twriteFrame(frame: Uint8Array) {\n\t\tconst group = this.appendGroup();\n\t\tgroup.writeFrame(frame);\n\t\tgroup.close();\n\t}\n\n\t/** Appends a string to the track as its own single-frame group. */\n\twriteString(str: string) {\n\t\tconst group = this.appendGroup();\n\t\tgroup.writeString(str);\n\t\tgroup.close();\n\t}\n\n\t/** Appends a JSON value to the track as its own single-frame group. */\n\twriteJson(json: unknown) {\n\t\tconst group = this.appendGroup();\n\t\tgroup.writeJson(json);\n\t\tgroup.close();\n\t}\n\n\t/** Appends a boolean to the track as its own single-frame group. */\n\twriteBool(bool: boolean) {\n\t\tconst group = this.appendGroup();\n\t\tgroup.writeBool(bool);\n\t\tgroup.close();\n\t}\n\n\t/**\n\t * Receive the next group available on this track, in arrival order.\n\t *\n\t * Groups may arrive out of order or with gaps due to network conditions.\n\t * Use {@link nextGroupOrdered} if you need groups in sequence order,\n\t * skipping those that arrive too late.\n\t */\n\tasync recvGroup(): Promise<Group | undefined> {\n\t\tfor (;;) {\n\t\t\tconst groups = this.state.groups.peek();\n\t\t\tif (groups.length > 0) {\n\t\t\t\treturn groups.shift();\n\t\t\t}\n\n\t\t\tconst closed = this.state.closed.peek();\n\t\t\tif (closed instanceof Error) throw closed;\n\t\t\tif (closed) return undefined;\n\n\t\t\tawait Signal.race(this.state.groups, this.state.closed);\n\t\t}\n\t}\n\n\t/**\n\t * @deprecated Use {@link recvGroup} for arrival order, or {@link nextGroupOrdered} for sequence order.\n\t */\n\tasync nextGroup(): Promise<Group | undefined> {\n\t\treturn this.recvGroup();\n\t}\n\n\t/**\n\t * Return the next group with a strictly-greater sequence number than the last returned.\n\t *\n\t * Late arrivals (with a sequence number at or below the last one returned) are silently skipped.\n\t *\n\t * NOTE: This will be renamed to `nextGroup` in the next major version.\n\t */\n\tasync nextGroupOrdered(): Promise<Group | undefined> {\n\t\tfor (;;) {\n\t\t\tconst group = await this.recvGroup();\n\t\t\tif (!group) return undefined;\n\t\t\tif (group.sequence < this.#nextSequence) {\n\t\t\t\tgroup.close();\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tthis.#nextSequence = group.sequence + 1;\n\t\t\treturn group;\n\t\t}\n\t}\n\n\t/** Reads the next frame across all groups, discarding older groups. */\n\tasync readFrame(): Promise<Uint8Array | undefined> {\n\t\treturn (await this.readFrameSequence())?.data;\n\t}\n\n\t/** Reads the next frame along with its group and frame sequence numbers. */\n\tasync readFrameSequence(): Promise<{ group: number; frame: number; data: Uint8Array } | undefined> {\n\t\tfor (;;) {\n\t\t\tconst groups = this.state.groups.peek();\n\n\t\t\t// Discard old groups.\n\t\t\twhile (groups.length > 1) {\n\t\t\t\tconst next = groups[0].tryReadFrameSequence();\n\t\t\t\tif (next) {\n\t\t\t\t\treturn { group: groups[0].sequence, frame: next.sequence, data: next.data };\n\t\t\t\t}\n\n\t\t\t\t// Skip this old group\n\t\t\t\tgroups.shift()?.close();\n\t\t\t}\n\n\t\t\t// If there's no groups, wait for a new one.\n\t\t\tif (groups.length === 0) {\n\t\t\t\tconst closed = this.state.closed.peek();\n\t\t\t\tif (closed instanceof Error) throw closed;\n\t\t\t\tif (closed) return undefined;\n\n\t\t\t\tawait Signal.race(this.state.groups, this.state.closed);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// If there's a group, wait for a frame.\n\t\t\tconst group = groups[0];\n\t\t\tconst next = group.tryReadFrameSequence();\n\t\t\tif (next) {\n\t\t\t\treturn { group: group.sequence, frame: next.sequence, data: next.data };\n\t\t\t}\n\n\t\t\t// If the track is closed, return undefined.\n\t\t\tconst closed = this.state.closed.peek();\n\t\t\tif (closed instanceof Error) throw closed;\n\t\t\tif (closed) return undefined;\n\n\t\t\t// Wake on a new group or the track closing. Only fold in the current group's readability\n\t\t\t// while it can still deliver frames: a finished group's readable() resolves immediately, so\n\t\t\t// racing it would busy-loop until a newer group arrives instead of waiting.\n\t\t\tif (group.done) {\n\t\t\t\tawait Signal.race(this.state.groups, this.state.closed);\n\t\t\t} else {\n\t\t\t\tawait Promise.race([Signal.race(this.state.groups, this.state.closed), group.readable()]);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Reads the next frame and decodes it as a UTF-8 string. */\n\tasync readString(): Promise<string | undefined> {\n\t\tconst next = await this.readFrame();\n\t\tif (!next) return undefined;\n\t\treturn new TextDecoder().decode(next);\n\t}\n\n\t/** Reads the next frame and parses it as JSON. */\n\tasync readJson(): Promise<unknown | undefined> {\n\t\tconst next = await this.readString();\n\t\tif (!next) return undefined;\n\t\treturn JSON.parse(next);\n\t}\n\n\t/** Reads the next frame and decodes it as a one-byte boolean, throwing on a malformed frame. */\n\tasync readBool(): Promise<boolean | undefined> {\n\t\tconst next = await this.readFrame();\n\t\tif (!next) return undefined;\n\t\tif (next.byteLength !== 1 || !(next[0] === 0 || next[0] === 1)) throw new Error(\"invalid bool frame\");\n\t\treturn next[0] === 1;\n\t}\n\n\t/**\n\t * Update the subscription priority. Triggers a SUBSCRIBE_UPDATE\n\t * to the publisher when used on a subscribed track.\n\t */\n\tupdatePriority(priority: number) {\n\t\tthis.state.priority.set(priority, true);\n\t}\n\n\t/**\n\t * Closes the publisher and all associated groups.\n\t */\n\tclose(abort?: Error) {\n\t\tthis.state.closed.set(abort ?? true);\n\n\t\tfor (const group of this.state.groups.peek()) {\n\t\t\tgroup.close(abort);\n\t\t}\n\t}\n}\n"]}

package/track.test.d.ts

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

package/track.test.d.ts.map

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

package/track.test.js

@@ -0,0 +1,56 @@
+/* @ts-self-types="./track.test.d.ts" */
+import { expect, test } from "bun:test";
+import { Group } from "./group.js";
+import { Track } from "./track.js";
+test("nextGroupOrdered skips late arrivals", async () => {
+    const track = new Track("test");
+    track.writeGroup(new Group(5));
+    const first = await track.nextGroupOrdered();
+    expect(first?.sequence).toBe(5);
+    // Late arrivals with sequence <= last returned are skipped.
+    track.writeGroup(new Group(3));
+    track.writeGroup(new Group(4));
+    track.writeGroup(new Group(7));
+    const next = await track.nextGroupOrdered();
+    expect(next?.sequence).toBe(7);
+});
+test("nextGroupOrdered returns buffered groups in sequence", async () => {
+    const track = new Track("test");
+    track.writeGroup(new Group(3));
+    track.writeGroup(new Group(5));
+    expect((await track.nextGroupOrdered())?.sequence).toBe(3);
+    expect((await track.nextGroupOrdered())?.sequence).toBe(5);
+});
+test("recvGroup after nextGroupOrdered still returns late arrivals", async () => {
+    const track = new Track("test");
+    track.writeGroup(new Group(5));
+    // Ordered returns seq 5, advancing its cursor.
+    const ordered = await track.nextGroupOrdered();
+    expect(ordered?.sequence).toBe(5);
+    // recvGroup is independent of the ordered cursor: a late seq 3 still surfaces.
+    track.writeGroup(new Group(3));
+    const recv = await track.recvGroup();
+    expect(recv?.sequence).toBe(3);
+});
+test("nextGroupOrdered returns undefined when track closes", async () => {
+    const track = new Track("test");
+    track.close();
+    expect(await track.nextGroupOrdered()).toBeUndefined();
+});
+test("readFrame does not livelock when a sole group finishes before the next arrives", async () => {
+    const track = new Track("test");
+    // A group is appended then finished empty while the track stays open. A finished group's
+    // readable() resolves immediately, so the reader must not busy-wait on it (which would starve the
+    // macrotask queue and never observe the next group).
+    const g0 = track.appendGroup();
+    g0.close();
+    // The next group arrives via a macrotask; if the reader livelocks on microtasks it never runs.
+    setTimeout(() => {
+        const g1 = track.appendGroup();
+        g1.writeString("hello");
+        g1.close();
+        track.close();
+    }, 10);
+    expect(await track.readString()).toBe("hello");
+}, 2000);
+//# sourceMappingURL=track.test.js.map

package/track.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.test.js","sourceRoot":"","sources":["../src/track.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"bun:test\";\nimport { Group } from \"./group.ts\";\nimport { Track } from \"./track.ts\";\n\ntest(\"nextGroupOrdered skips late arrivals\", async () => {\n\tconst track = new Track(\"test\");\n\n\ttrack.writeGroup(new Group(5));\n\n\tconst first = await track.nextGroupOrdered();\n\texpect(first?.sequence).toBe(5);\n\n\t// Late arrivals with sequence <= last returned are skipped.\n\ttrack.writeGroup(new Group(3));\n\ttrack.writeGroup(new Group(4));\n\ttrack.writeGroup(new Group(7));\n\n\tconst next = await track.nextGroupOrdered();\n\texpect(next?.sequence).toBe(7);\n});\n\ntest(\"nextGroupOrdered returns buffered groups in sequence\", async () => {\n\tconst track = new Track(\"test\");\n\n\ttrack.writeGroup(new Group(3));\n\ttrack.writeGroup(new Group(5));\n\n\texpect((await track.nextGroupOrdered())?.sequence).toBe(3);\n\texpect((await track.nextGroupOrdered())?.sequence).toBe(5);\n});\n\ntest(\"recvGroup after nextGroupOrdered still returns late arrivals\", async () => {\n\tconst track = new Track(\"test\");\n\n\ttrack.writeGroup(new Group(5));\n\n\t// Ordered returns seq 5, advancing its cursor.\n\tconst ordered = await track.nextGroupOrdered();\n\texpect(ordered?.sequence).toBe(5);\n\n\t// recvGroup is independent of the ordered cursor: a late seq 3 still surfaces.\n\ttrack.writeGroup(new Group(3));\n\tconst recv = await track.recvGroup();\n\texpect(recv?.sequence).toBe(3);\n});\n\ntest(\"nextGroupOrdered returns undefined when track closes\", async () => {\n\tconst track = new Track(\"test\");\n\ttrack.close();\n\texpect(await track.nextGroupOrdered()).toBeUndefined();\n});\n\ntest(\"readFrame does not livelock when a sole group finishes before the next arrives\", async () => {\n\tconst track = new Track(\"test\");\n\n\t// A group is appended then finished empty while the track stays open. A finished group's\n\t// readable() resolves immediately, so the reader must not busy-wait on it (which would starve the\n\t// macrotask queue and never observe the next group).\n\tconst g0 = track.appendGroup();\n\tg0.close();\n\n\t// The next group arrives via a macrotask; if the reader livelocks on microtasks it never runs.\n\tsetTimeout(() => {\n\t\tconst g1 = track.appendGroup();\n\t\tg1.writeString(\"hello\");\n\t\tg1.close();\n\t\ttrack.close();\n\t}, 10);\n\n\texpect(await track.readString()).toBe(\"hello\");\n}, 2000);\n"]}

package/util/error.d.ts

@@ -0,0 +1,3 @@
+export declare function error(err: unknown): Error;
+export declare function unreachable(value: never): never;
+//# sourceMappingURL=error.d.ts.map

package/util/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AACA,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAEzC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/util/error.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./error.d.ts" */
+// I hate javascript.
+export function error(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+export function unreachable(value) {
+    throw new Error(`unreachable: ${value}`);
+}
+//# sourceMappingURL=error.js.map

package/util/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,UAAU,KAAK,CAAC,GAAY;IACjC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY;IACvC,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["// I hate javascript.\nexport function error(err: unknown): Error {\n\treturn err instanceof Error ? err : new Error(String(err));\n}\n\nexport function unreachable(value: never): never {\n\tthrow new Error(`unreachable: ${value}`);\n}\n"]}

package/util/hex.d.ts

@@ -0,0 +1,3 @@
+export declare function toBytes(hex: string): Uint8Array<ArrayBuffer>;
+export declare function fromBytes(bytes: Uint8Array): string;
+//# sourceMappingURL=hex.d.ts.map

package/util/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/util/hex.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAY5D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEnD"}

package/util/hex.js

@@ -0,0 +1,16 @@
+/* @ts-self-types="./hex.d.ts" */
+export function toBytes(hex) {
+    hex = hex.startsWith("0x") ? hex.slice(2) : hex;
+    if (hex.length % 2) {
+        throw new Error("invalid hex string length");
+    }
+    const matches = hex.match(/.{2}/g);
+    if (!matches) {
+        throw new Error("invalid hex string format");
+    }
+    return new Uint8Array(matches.map((byte) => parseInt(byte, 16)));
+}
+export function fromBytes(bytes) {
+    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=hex.js.map

package/util/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/util/hex.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,GAAW;IAClC,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAChD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAiB;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjF,CAAC","sourcesContent":["export function toBytes(hex: string): Uint8Array<ArrayBuffer> {\n\thex = hex.startsWith(\"0x\") ? hex.slice(2) : hex;\n\tif (hex.length % 2) {\n\t\tthrow new Error(\"invalid hex string length\");\n\t}\n\n\tconst matches = hex.match(/.{2}/g);\n\tif (!matches) {\n\t\tthrow new Error(\"invalid hex string format\");\n\t}\n\n\treturn new Uint8Array(matches.map((byte) => parseInt(byte, 16)));\n}\n\nexport function fromBytes(bytes: Uint8Array): string {\n\treturn Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n"]}

package/util/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./error";
+//# sourceMappingURL=index.d.ts.map

package/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/util/index.js

@@ -0,0 +1,3 @@
+/* @ts-self-types="./index.d.ts" */
+export * from "./error.js";
+//# sourceMappingURL=index.js.map

package/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./error.ts\";\n"]}

package/varint.d.ts

@@ -0,0 +1,36 @@
+/** Largest value that fits in a 1-byte varint (6 bits). */
+export declare const MAX_U6: number;
+/** Largest value that fits in a 2-byte varint (14 bits). */
+export declare const MAX_U14: number;
+/** Largest value that fits in a 4-byte varint (30 bits). */
+export declare const MAX_U30: number;
+/** Largest value representable without precision loss (`Number.MAX_SAFE_INTEGER`, 53 bits). */
+export declare const MAX_U53: number;
+/** Number of bytes needed to encode a value in the leading-ones varint format. */
+export declare function sizeLeadingOnes(v: number | bigint): number;
+/** Encode a value in leading-ones varint format into the provided buffer, returning the written subarray. */
+export declare function encodeLeadingOnesTo(dst: ArrayBuffer, v: number | bigint): Uint8Array;
+/** Encode a value in leading-ones varint format into a freshly allocated buffer. */
+export declare function encodeLeadingOnes(v: number | bigint): Uint8Array;
+/** Decode a leading-ones varint, returning the value and the remaining buffer. */
+export declare function decodeLeadingOnes(buf: Uint8Array): [bigint, Uint8Array];
+/**
+ * Returns the number of bytes needed to encode a value as a varint.
+ */
+export declare function size(v: number): number;
+/**
+ * Encodes a number or bigint into a scratch buffer.
+ * Used by stream.ts to avoid allocations.
+ */
+export declare function encodeTo(dst: ArrayBuffer, v: number | bigint): Uint8Array;
+/**
+ * Encodes a number as a QUIC variable-length integer.
+ * Returns a new Uint8Array containing the encoded bytes.
+ */
+export declare function encode(v: number): Uint8Array;
+/**
+ * Decodes a QUIC variable-length integer from a buffer.
+ * Returns a tuple of [value, remaining buffer].
+ */
+export declare function decode(buf: Uint8Array): [number, Uint8Array];
+//# sourceMappingURL=varint.d.ts.map

package/varint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.d.ts","sourceRoot":"","sources":["../src/varint.ts"],"names":[],"mappings":"AAGA,2DAA2D;AAC3D,eAAO,MAAM,MAAM,QAAa,CAAC;AACjC,4DAA4D;AAC5D,eAAO,MAAM,OAAO,QAAc,CAAC;AACnC,4DAA4D;AAC5D,eAAO,MAAM,OAAO,QAAc,CAAC;AACnC,+FAA+F;AAC/F,eAAO,MAAM,OAAO,QAA0B,CAAC;AAgB/C,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAY1D;AAED,6GAA6G;AAC7G,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAkDpF;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAEhE;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAmFvE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtC;AA6BD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAmBzE;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAE5C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CA8B5D"}