@norskvideo/moq-net 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+<p align="center">
+	<img height="128px" src="https://github.com/moq-dev/moq/blob/main/.github/logo.svg" alt="Media over QUIC">
+</p>
+
+# @moq/net
+
+[![npm version](https://img.shields.io/npm/v/@moq/net)](https://www.npmjs.com/package/@moq/net)
+[![TypeScript](https://img.shields.io/badge/TypeScript-ready-blue.svg)](https://www.typescriptlang.org/)
+
+A TypeScript [Media over QUIC](https://moq.dev/) (MoQ) client for both browsers and server JS/TS environments.
+`@moq/net` is the **networking layer**: real-time pub/sub with built-in caching, fan-out, and prioritization, on top of QUIC. At session setup it negotiates one of two wire protocols, either the simplified [moq-lite](https://doc.moq.dev/concept/layer/moq-lite) protocol or the full IETF [moq-transport](https://datatracker.ietf.org/doc/draft-ietf-moq-transport/) draft.
+
+Check out [hang](../hang) for a higher-level media library that uses this package.
+
+> **Note:** moq-lite is a subset of moq-transport and is forwards compatible with it, so this client works with any moq-transport CDN (ex. [Cloudflare](https://moq.dev/blog/first-cdn/)). See the [compatibility docs](https://doc.moq.dev/concept/layer/moq-lite#compatibility) for details.
+
+## Quick Start
+
+```bash
+npm add @moq/net
+# or
+pnpm add @moq/net
+bun add @moq/net
+yarn add @moq/net
+# etc
+```
+
+## Server-side usage
+
+`@moq/net` works on both browsers and servers, however in JS/TS server environments (Node, Bun) WebTransport is not yet available, so `@moq/net` will default to WebSockets communication with the relay.
+
+Bun and Node v21+ have `WebSockets` built in, but older versions of Node do not, so for older versions of Node you will need the WebSockets polyfill to use `@moq/net`
+
+```javascript
+import WebSocket from 'ws';
+import * as Moq from '@moq/net';
+// Polyfill WebSocket for MoQ
+globalThis.WebSocket = WebSocket;
+```
+
+You can optionally enable `WebTransport` and full HTTP3/Quic on server environments with the following (experimental) [polyfill](https://github.com/fails-components/webtransport)
+
+```bash
+npm install @fails-components/webtransport
+npm install @fails-components/webtransport-transport-http3-quiche
+```
+
+Which you would load as follows
+
+```javascript
+import { WebTransport, quicheLoaded } from '@fails-components/webtransport';
+global.WebTransport = WebTransport;
+import * as Moq from '@moq/net'
+await quicheLoaded; //This is a promise, connect after it resolves
+```
+
+## Examples
+
+- **[Connection](examples/connection.ts)** - Connect to a MoQ relay server
+- **[Publishing](examples/publish.ts)** - Publish data to a broadcast
+- **[Subscribing](examples/subscribe.ts)** - Subscribe to and receive broadcast data
+- **[Discovery](examples/discovery.ts)** - Discover broadcasts announced by the server
+- **[Server side usage](https://github.com/sb2702/webcodecs-examples/tree/main/src/moq-server)** - Publish from browser to a server
+
+## License
+
+Licensed under either:
+
+- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
+- MIT license ([LICENSE-MIT](../../LICENSE-MIT) or http://opensource.org/licenses/MIT)

package/announced.d.ts

@@ -0,0 +1,45 @@
+import { Signal } from "@norskvideo/moq-signals";
+import * as Path from "./path.js";
+/**
+ * The availability of a broadcast.
+ *
+ * @public
+ */
+export interface AnnouncedEntry {
+    path: Path.Valid;
+    active: boolean;
+}
+/** Reactive backing state for an {@link Announced}: the pending queue plus a closed flag. */
+export declare class AnnouncedState {
+    queue: Signal<AnnouncedEntry[]>;
+    closed: Signal<boolean | Error>;
+}
+/**
+ * Handles writing announcements to the announcement queue.
+ *
+ * @public
+ */
+export declare class Announced {
+    /** Reactive backing state. */
+    state: AnnouncedState;
+    /** Path prefix this stream is scoped to. */
+    prefix: Path.Valid;
+    /** Resolves with the abort error (or undefined) once closed. */
+    readonly closed: Promise<Error | undefined>;
+    constructor(prefix?: Path.Valid);
+    /**
+     * Writes an announcement to the queue.
+     * @param announcement - The announcement to write
+     */
+    append(announcement: AnnouncedEntry): void;
+    /**
+     * Closes the writer.
+     * @param abort - If provided, throw this exception instead of returning undefined.
+     */
+    close(abort?: Error): void;
+    /**
+     * Returns the next announcement.
+     */
+    next(): Promise<AnnouncedEntry | undefined>;
+}
+//# sourceMappingURL=announced.d.ts.map

package/announced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announced.d.ts","sourceRoot":"","sources":["../src/announced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,6FAA6F;AAC7F,qBAAa,cAAc;IAC1B,KAAK,2BAAoC;IACzC,MAAM,0BAAsC;CAC5C;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACrB,8BAA8B;IAC9B,KAAK,iBAAwB;IAE7B,4CAA4C;IAC5C,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;IAEnB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAE5C,YAAY,MAAM,aAAe,EAShC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,EAAE,cAAc,QAKlC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,QAKlB;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAWhD;CACD"}

package/announced.js

@@ -0,0 +1,70 @@
+/* @ts-self-types="./announced.d.ts" */
+import { Signal } from "@norskvideo/moq-signals";
+import * as Path from "./path.js";
+/** Reactive backing state for an {@link Announced}: the pending queue plus a closed flag. */
+export class AnnouncedState {
+    queue = new Signal([]);
+    closed = new Signal(false);
+}
+/**
+ * Handles writing announcements to the announcement queue.
+ *
+ * @public
+ */
+export class Announced {
+    /** Reactive backing state. */
+    state = new AnnouncedState();
+    /** Path prefix this stream is scoped to. */
+    prefix;
+    /** Resolves with the abort error (or undefined) once closed. */
+    closed;
+    constructor(prefix = Path.empty()) {
+        this.prefix = prefix;
+        this.closed = new Promise((resolve) => {
+            const dispose = this.state.closed.subscribe((closed) => {
+                if (!closed)
+                    return;
+                resolve(closed instanceof Error ? closed : undefined);
+                dispose();
+            });
+        });
+    }
+    /**
+     * Writes an announcement to the queue.
+     * @param announcement - The announcement to write
+     */
+    append(announcement) {
+        if (this.state.closed.peek())
+            throw new Error("announced is closed");
+        this.state.queue.mutate((queue) => {
+            queue.push(announcement);
+        });
+    }
+    /**
+     * Closes the writer.
+     * @param abort - If provided, throw this exception instead of returning undefined.
+     */
+    close(abort) {
+        this.state.closed.set(abort ?? true);
+        this.state.queue.mutate((queue) => {
+            queue.length = 0;
+        });
+    }
+    /**
+     * Returns the next announcement.
+     */
+    async next() {
+        for (;;) {
+            const announce = this.state.queue.peek().shift();
+            if (announce)
+                return announce;
+            const closed = this.state.closed.peek();
+            if (closed instanceof Error)
+                throw closed;
+            if (closed)
+                return undefined;
+            await Signal.race(this.state.queue, this.state.closed);
+        }
+    }
+}
+//# sourceMappingURL=announced.js.map

package/announced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announced.js","sourceRoot":"","sources":["../src/announced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAYlC,6FAA6F;AAC7F,MAAM,OAAO,cAAc;IAC1B,KAAK,GAAG,IAAI,MAAM,CAAmB,EAAE,CAAC,CAAC;IACzC,MAAM,GAAG,IAAI,MAAM,CAAkB,KAAK,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACrB,8BAA8B;IAC9B,KAAK,GAAG,IAAI,cAAc,EAAE,CAAC;IAE7B,4CAA4C;IAC5C,MAAM,CAAa;IAEnB,gEAAgE;IACvD,MAAM,CAA6B;IAE5C,YAAY,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;gBACtD,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,OAAO,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACtD,OAAO,EAAE,CAAC;YACX,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAA4B;QAClC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAa;QAClB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACT,SAAS,CAAC;YACT,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACjD,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAE9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,MAAM,YAAY,KAAK;gBAAE,MAAM,MAAM,CAAC;YAC1C,IAAI,MAAM;gBAAE,OAAO,SAAS,CAAC;YAE7B,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;IACF,CAAC;CACD","sourcesContent":["import { Signal } from \"@moq/signals\";\nimport * as Path from \"./path.js\";\n\n/**\n * The availability of a broadcast.\n *\n * @public\n */\nexport interface AnnouncedEntry {\n\tpath: Path.Valid;\n\tactive: boolean;\n}\n\n/** Reactive backing state for an {@link Announced}: the pending queue plus a closed flag. */\nexport class AnnouncedState {\n\tqueue = new Signal<AnnouncedEntry[]>([]);\n\tclosed = new Signal<boolean | Error>(false);\n}\n\n/**\n * Handles writing announcements to the announcement queue.\n *\n * @public\n */\nexport class Announced {\n\t/** Reactive backing state. */\n\tstate = new AnnouncedState();\n\n\t/** Path prefix this stream is scoped to. */\n\tprefix: Path.Valid;\n\n\t/** Resolves with the abort error (or undefined) once closed. */\n\treadonly closed: Promise<Error | undefined>;\n\n\tconstructor(prefix = Path.empty()) {\n\t\tthis.prefix = prefix;\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 * Writes an announcement to the queue.\n\t * @param announcement - The announcement to write\n\t */\n\tappend(announcement: AnnouncedEntry) {\n\t\tif (this.state.closed.peek()) throw new Error(\"announced is closed\");\n\t\tthis.state.queue.mutate((queue) => {\n\t\t\tqueue.push(announcement);\n\t\t});\n\t}\n\n\t/**\n\t * Closes the writer.\n\t * @param abort - If provided, throw this exception instead of returning undefined.\n\t */\n\tclose(abort?: Error) {\n\t\tthis.state.closed.set(abort ?? true);\n\t\tthis.state.queue.mutate((queue) => {\n\t\t\tqueue.length = 0;\n\t\t});\n\t}\n\n\t/**\n\t * Returns the next announcement.\n\t */\n\tasync next(): Promise<AnnouncedEntry | undefined> {\n\t\tfor (;;) {\n\t\t\tconst announce = this.state.queue.peek().shift();\n\t\t\tif (announce) return announce;\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.queue, this.state.closed);\n\t\t}\n\t}\n}\n"]}

package/bandwidth.d.ts

@@ -0,0 +1,11 @@
+import { Signal } from "@norskvideo/moq-signals";
+/**
+ * A bandwidth estimate in bits per second, or undefined if unknown.
+ *
+ * This is a Signal that can be read synchronously via `peek()`,
+ * observed reactively via `effect.get()`, or updated via `set()`.
+ */
+export type Bandwidth = Signal<number | undefined>;
+/** Create a new bandwidth signal. */
+export declare function createBandwidth(): Bandwidth;
+//# sourceMappingURL=bandwidth.d.ts.map

package/bandwidth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bandwidth.d.ts","sourceRoot":"","sources":["../src/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEnD,qCAAqC;AACrC,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

package/bandwidth.js

@@ -0,0 +1,7 @@
+/* @ts-self-types="./bandwidth.d.ts" */
+import { Signal } from "@norskvideo/moq-signals";
+/** Create a new bandwidth signal. */
+export function createBandwidth() {
+    return new Signal(undefined);
+}
+//# sourceMappingURL=bandwidth.js.map

package/bandwidth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bandwidth.js","sourceRoot":"","sources":["../src/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAUtC,qCAAqC;AACrC,MAAM,UAAU,eAAe;IAC9B,OAAO,IAAI,MAAM,CAAqB,SAAS,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { Signal } from \"@moq/signals\";\n\n/**\n * A bandwidth estimate in bits per second, or undefined if unknown.\n *\n * This is a Signal that can be read synchronously via `peek()`,\n * observed reactively via `effect.get()`, or updated via `set()`.\n */\nexport type Bandwidth = Signal<number | undefined>;\n\n/** Create a new bandwidth signal. */\nexport function createBandwidth(): Bandwidth {\n\treturn new Signal<number | undefined>(undefined);\n}\n"]}

package/broadcast.d.ts

@@ -0,0 +1,39 @@
+import { Signal } from "@norskvideo/moq-signals";
+import { Track } from "./track";
+/** A track a subscriber asked for, along with its requested delivery priority. */
+export interface TrackRequest {
+    track: Track;
+    priority: number;
+}
+/** Reactive backing state for a {@link Broadcast}: requested tracks plus a closed flag. */
+export declare class BroadcastState {
+    requested: Signal<TrackRequest[]>;
+    closed: Signal<boolean | Error>;
+}
+/**
+ * Handles writing and managing tracks in a broadcast.
+ *
+ * @public
+ */
+export declare class Broadcast {
+    /** Reactive backing state. */
+    state: BroadcastState;
+    /** Resolves with the abort error (or undefined) once closed. */
+    readonly closed: Promise<Error | undefined>;
+    constructor();
+    /**
+     * A track requested over the network.
+     */
+    requested(): Promise<TrackRequest | undefined>;
+    /**
+     * Populates the provided track over the network.
+     */
+    subscribe(name: string, priority: number): Track;
+    /**
+     * Closes the writer and all associated tracks.
+     *
+     * @param abort - If provided, throw this exception instead of returning undefined.
+     */
+    close(abort?: Error): void;
+}
+//# sourceMappingURL=broadcast.d.ts.map

package/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,2FAA2F;AAC3F,qBAAa,cAAc;IAC1B,SAAS,yBAAkC;IAC3C,MAAM,0BAAsC;CAC5C;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACrB,8BAA8B;IAC9B,KAAK,iBAAwB;IAE7B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAE5C,cAQC;IAED;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAYnD;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAa/C;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,QAQlB;CACD"}

package/broadcast.js

@@ -0,0 +1,76 @@
+/* @ts-self-types="./broadcast.d.ts" */
+import { Signal } from "@norskvideo/moq-signals";
+import { Track } from "./track.js";
+/** Reactive backing state for a {@link Broadcast}: requested tracks plus a closed flag. */
+export class BroadcastState {
+    requested = new Signal([]);
+    closed = new Signal(false);
+}
+/**
+ * Handles writing and managing tracks in a broadcast.
+ *
+ * @public
+ */
+export class Broadcast {
+    /** Reactive backing state. */
+    state = new BroadcastState();
+    /** Resolves with the abort error (or undefined) once closed. */
+    closed;
+    constructor() {
+        this.closed = new Promise((resolve) => {
+            const dispose = this.state.closed.subscribe((closed) => {
+                if (!closed)
+                    return;
+                resolve(closed instanceof Error ? closed : undefined);
+                dispose();
+            });
+        });
+    }
+    /**
+     * A track requested over the network.
+     */
+    async requested() {
+        for (;;) {
+            // We use pop instead of shift because it's slightly more efficient.
+            const track = this.state.requested.peek().pop();
+            if (track)
+                return track;
+            const closed = this.state.closed.peek();
+            if (closed instanceof Error)
+                throw closed;
+            if (closed)
+                return undefined;
+            await Signal.race(this.state.requested, this.state.closed);
+        }
+    }
+    /**
+     * Populates the provided track over the network.
+     */
+    subscribe(name, priority) {
+        const track = new Track(name);
+        if (this.state.closed.peek()) {
+            throw new Error(`broadcast is closed: ${this.state.closed.peek()}`);
+        }
+        this.state.requested.mutate((requested) => {
+            requested.push({ track, priority });
+            // Sort the tracks by priority in ascending order (we will pop)
+            requested.sort((a, b) => a.priority - b.priority);
+        });
+        return track;
+    }
+    /**
+     * Closes the writer and all associated tracks.
+     *
+     * @param abort - If provided, throw this exception instead of returning undefined.
+     */
+    close(abort) {
+        this.state.closed.set(abort ?? true);
+        for (const { track } of this.state.requested.peek()) {
+            track.close(abort);
+        }
+        this.state.requested.mutate((requested) => {
+            requested.length = 0;
+        });
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":"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","sourcesContent":["import { Signal } from \"@moq/signals\";\nimport { Track } from \"./track.ts\";\n\n/** A track a subscriber asked for, along with its requested delivery priority. */\nexport interface TrackRequest {\n\ttrack: Track;\n\tpriority: number;\n}\n\n/** Reactive backing state for a {@link Broadcast}: requested tracks plus a closed flag. */\nexport class BroadcastState {\n\trequested = new Signal<TrackRequest[]>([]);\n\tclosed = new Signal<boolean | Error>(false);\n}\n\n/**\n * Handles writing and managing tracks in a broadcast.\n *\n * @public\n */\nexport class Broadcast {\n\t/** Reactive backing state. */\n\tstate = new BroadcastState();\n\n\t/** Resolves with the abort error (or undefined) once closed. */\n\treadonly closed: Promise<Error | undefined>;\n\n\tconstructor() {\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 * A track requested over the network.\n\t */\n\tasync requested(): Promise<TrackRequest | undefined> {\n\t\tfor (;;) {\n\t\t\t// We use pop instead of shift because it's slightly more efficient.\n\t\t\tconst track = this.state.requested.peek().pop();\n\t\t\tif (track) return track;\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.requested, this.state.closed);\n\t\t}\n\t}\n\n\t/**\n\t * Populates the provided track over the network.\n\t */\n\tsubscribe(name: string, priority: number): Track {\n\t\tconst track = new Track(name);\n\n\t\tif (this.state.closed.peek()) {\n\t\t\tthrow new Error(`broadcast is closed: ${this.state.closed.peek()}`);\n\t\t}\n\t\tthis.state.requested.mutate((requested) => {\n\t\t\trequested.push({ track, priority });\n\t\t\t// Sort the tracks by priority in ascending order (we will pop)\n\t\t\trequested.sort((a, b) => a.priority - b.priority);\n\t\t});\n\n\t\treturn track;\n\t}\n\n\t/**\n\t * Closes the writer and all associated tracks.\n\t *\n\t * @param abort - If provided, throw this exception instead of returning undefined.\n\t */\n\tclose(abort?: Error) {\n\t\tthis.state.closed.set(abort ?? true);\n\t\tfor (const { track } of this.state.requested.peek()) {\n\t\t\ttrack.close(abort);\n\t\t}\n\t\tthis.state.requested.mutate((requested) => {\n\t\t\trequested.length = 0;\n\t\t});\n\t}\n}\n"]}

package/connection/accept.d.ts

@@ -0,0 +1,15 @@
+import type { Established } from "./established";
+/** Options for {@link accept}. */
+export interface AcceptProps {
+    version?: number;
+}
+/**
+ * Server-side handshake: accepts a transport and performs the server half of the SETUP exchange.
+ *
+ * @param transport - The WebTransport session to accept
+ * @param url - The URL of the connection
+ * @param props - Optional configuration
+ * @returns A promise that resolves to a Connection instance
+ */
+export declare function accept(transport: WebTransport, url: URL, props?: AcceptProps): Promise<Established>;
+//# sourceMappingURL=accept.d.ts.map

package/connection/accept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.d.ts","sourceRoot":"","sources":["../../src/connection/accept.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAE3B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAuBzG"}

package/connection/accept.js

@@ -0,0 +1,137 @@
+/* @ts-self-types="./accept.d.ts" */
+import * as Ietf from "../ietf/index.js";
+import * as Lite from "../lite/index.js";
+import { Stream } from "../stream.js";
+import { exchangeSetup } from "./handshake.js";
+/**
+ * Server-side handshake: accepts a transport and performs the server half of the SETUP exchange.
+ *
+ * @param transport - The WebTransport session to accept
+ * @param url - The URL of the connection
+ * @param props - Optional configuration
+ * @returns A promise that resolves to a Connection instance
+ */
+export async function accept(transport, url, props) {
+    // @ts-expect-error - TODO: add protocol to WebTransport
+    const protocol = transport.protocol;
+    if (protocol === Ietf.ALPN.DRAFT_19) {
+        return acceptAlpn(transport, url, Ietf.Version.DRAFT_19);
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_18) {
+        return acceptAlpn(transport, url, Ietf.Version.DRAFT_18);
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_17) {
+        return acceptAlpn(transport, url, Ietf.Version.DRAFT_17);
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_16) {
+        return acceptSetup(transport, url, Ietf.Version.DRAFT_16);
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_15) {
+        return acceptSetup(transport, url, Ietf.Version.DRAFT_15);
+    }
+    else if (protocol === Lite.ALPN_04) {
+        return new Lite.Connection(url, transport, Lite.Version.DRAFT_04, undefined);
+    }
+    else if (protocol === Lite.ALPN_03) {
+        return new Lite.Connection(url, transport, Lite.Version.DRAFT_03, undefined);
+    }
+    else if (protocol === Lite.ALPN || protocol === "" || protocol === undefined) {
+        return acceptNegotiated(transport, url, props);
+    }
+    else {
+        throw new Error(`unsupported WebTransport protocol: ${protocol}`);
+    }
+}
+/**
+ * Draft-17+ accept: ALPN already pinned the version. SETUP is exchanged over
+ * a pair of uni streams using stream type 0x2F00.
+ */
+async function acceptAlpn(transport, url, version) {
+    const controlStream = await exchangeSetup(transport, version, "moq-lite-js");
+    return new Ietf.Connection({
+        url,
+        quic: transport,
+        control: controlStream,
+        // v17+ uses NativeSession which manages its own request IDs; maxRequestId is unused.
+        maxRequestId: 0n,
+        version,
+    });
+}
+/**
+ * Legacy accept (draft-15/16): ALPN pinned the version, but the SETUP message
+ * is still exchanged over a bidi stream wrapped in the moq-lite compat envelope.
+ */
+async function acceptSetup(transport, url, version) {
+    // Accept bidi, read ClientSetup, write ServerSetup
+    const stream = await Stream.accept(transport);
+    if (!stream)
+        throw new Error("no incoming bidi stream for SETUP");
+    const clientCompat = await stream.reader.u53();
+    if (clientCompat !== Lite.StreamId.ClientCompat) {
+        throw new Error(`unexpected client message type: 0x${clientCompat.toString(16)}`);
+    }
+    await Ietf.ClientSetup.decode(stream.reader, version);
+    await stream.writer.u53(Lite.StreamId.ServerCompat);
+    const encoder = new TextEncoder();
+    const params = new Ietf.SetupOptions();
+    params.setVarint(Ietf.SetupOption.MaxRequestId, 42069n);
+    params.setBytes(Ietf.SetupOption.Implementation, encoder.encode("moq-lite-js"));
+    const server = new Ietf.ServerSetup({ version, parameters: params });
+    await server.encode(stream.writer, version);
+    const maxRequestId = 42069n;
+    return new Ietf.Connection({
+        url,
+        quic: transport,
+        control: stream,
+        maxRequestId,
+        version,
+    });
+}
+async function acceptNegotiated(transport, url, props) {
+    const setupVersion = Ietf.Version.DRAFT_14;
+    const stream = await Stream.accept(transport);
+    if (!stream)
+        throw new Error("no incoming bidi stream for SETUP");
+    const clientCompat = await stream.reader.u53();
+    if (clientCompat !== Lite.StreamId.ClientCompat) {
+        throw new Error(`unexpected client message type: 0x${clientCompat.toString(16)}`);
+    }
+    const client = await Ietf.ClientSetup.decode(stream.reader, setupVersion);
+    // Pick the requested version, or first matching version from client's list
+    const allVersions = [...Object.values(Lite.Version), ...Object.values(Ietf.Version)];
+    let selectedVersion;
+    if (props?.version !== undefined) {
+        selectedVersion = props.version;
+    }
+    else {
+        const match = client.versions.find((v) => allVersions.includes(v));
+        if (match === undefined) {
+            throw new Error(`no common version found; client offered: ${client.versions.map((v) => v.toString(16)).join(", ")}`);
+        }
+        selectedVersion = match;
+    }
+    await stream.writer.u53(Lite.StreamId.ServerCompat);
+    const encoder = new TextEncoder();
+    const params = new Ietf.SetupOptions();
+    params.setVarint(Ietf.SetupOption.MaxRequestId, 42069n);
+    params.setBytes(Ietf.SetupOption.Implementation, encoder.encode("moq-lite-js"));
+    const server = new Ietf.ServerSetup({ version: selectedVersion, parameters: params });
+    await server.encode(stream.writer, setupVersion);
+    if (Object.values(Lite.Version).includes(selectedVersion)) {
+        return new Lite.Connection(url, transport, selectedVersion, stream);
+    }
+    else if (Object.values(Ietf.Version).includes(selectedVersion)) {
+        const maxRequestId = client.parameters.getVarint(Ietf.SetupOption.MaxRequestId) ?? 0n;
+        return new Ietf.Connection({
+            url,
+            quic: transport,
+            control: stream,
+            maxRequestId,
+            version: selectedVersion,
+        });
+    }
+    else {
+        throw new Error(`unsupported version: ${selectedVersion.toString(16)}`);
+    }
+}
+//# sourceMappingURL=accept.js.map

package/connection/accept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../src/connection/accept.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Ietf from \"../ietf/index.ts\";\nimport * as Lite from \"../lite/index.ts\";\nimport { Stream } from \"../stream.ts\";\nimport type { Established } from \"./established.ts\";\nimport { exchangeSetup } from \"./handshake.ts\";\n\n/** Options for {@link accept}. */\nexport interface AcceptProps {\n\t// Version to select during SETUP negotiation (for non-ALPN paths).\n\tversion?: number;\n}\n\n/**\n * Server-side handshake: accepts a transport and performs the server half of the SETUP exchange.\n *\n * @param transport - The WebTransport session to accept\n * @param url - The URL of the connection\n * @param props - Optional configuration\n * @returns A promise that resolves to a Connection instance\n */\nexport async function accept(transport: WebTransport, url: URL, props?: AcceptProps): Promise<Established> {\n\t// @ts-expect-error - TODO: add protocol to WebTransport\n\tconst protocol: string | undefined = transport.protocol;\n\n\tif (protocol === Ietf.ALPN.DRAFT_19) {\n\t\treturn acceptAlpn(transport, url, Ietf.Version.DRAFT_19);\n\t} else if (protocol === Ietf.ALPN.DRAFT_18) {\n\t\treturn acceptAlpn(transport, url, Ietf.Version.DRAFT_18);\n\t} else if (protocol === Ietf.ALPN.DRAFT_17) {\n\t\treturn acceptAlpn(transport, url, Ietf.Version.DRAFT_17);\n\t} else if (protocol === Ietf.ALPN.DRAFT_16) {\n\t\treturn acceptSetup(transport, url, Ietf.Version.DRAFT_16);\n\t} else if (protocol === Ietf.ALPN.DRAFT_15) {\n\t\treturn acceptSetup(transport, url, Ietf.Version.DRAFT_15);\n\t} else if (protocol === Lite.ALPN_04) {\n\t\treturn new Lite.Connection(url, transport, Lite.Version.DRAFT_04, undefined);\n\t} else if (protocol === Lite.ALPN_03) {\n\t\treturn new Lite.Connection(url, transport, Lite.Version.DRAFT_03, undefined);\n\t} else if (protocol === Lite.ALPN || protocol === \"\" || protocol === undefined) {\n\t\treturn acceptNegotiated(transport, url, props);\n\t} else {\n\t\tthrow new Error(`unsupported WebTransport protocol: ${protocol}`);\n\t}\n}\n\n/**\n * Draft-17+ accept: ALPN already pinned the version. SETUP is exchanged over\n * a pair of uni streams using stream type 0x2F00.\n */\nasync function acceptAlpn(transport: WebTransport, url: URL, version: Ietf.IetfVersion): Promise<Established> {\n\tconst controlStream = await exchangeSetup(transport, version, \"moq-lite-js\");\n\n\treturn new Ietf.Connection({\n\t\turl,\n\t\tquic: transport,\n\t\tcontrol: controlStream,\n\t\t// v17+ uses NativeSession which manages its own request IDs; maxRequestId is unused.\n\t\tmaxRequestId: 0n,\n\t\tversion,\n\t});\n}\n\n/**\n * Legacy accept (draft-15/16): ALPN pinned the version, but the SETUP message\n * is still exchanged over a bidi stream wrapped in the moq-lite compat envelope.\n */\nasync function acceptSetup(transport: WebTransport, url: URL, version: Ietf.IetfVersion): Promise<Established> {\n\t// Accept bidi, read ClientSetup, write ServerSetup\n\tconst stream = await Stream.accept(transport);\n\tif (!stream) throw new Error(\"no incoming bidi stream for SETUP\");\n\n\tconst clientCompat = await stream.reader.u53();\n\tif (clientCompat !== Lite.StreamId.ClientCompat) {\n\t\tthrow new Error(`unexpected client message type: 0x${clientCompat.toString(16)}`);\n\t}\n\n\tawait Ietf.ClientSetup.decode(stream.reader, version);\n\n\tawait stream.writer.u53(Lite.StreamId.ServerCompat);\n\n\tconst encoder = new TextEncoder();\n\tconst params = new Ietf.SetupOptions();\n\tparams.setVarint(Ietf.SetupOption.MaxRequestId, 42069n);\n\tparams.setBytes(Ietf.SetupOption.Implementation, encoder.encode(\"moq-lite-js\"));\n\n\tconst server = new Ietf.ServerSetup({ version, parameters: params });\n\tawait server.encode(stream.writer, version);\n\n\tconst maxRequestId = 42069n;\n\n\treturn new Ietf.Connection({\n\t\turl,\n\t\tquic: transport,\n\t\tcontrol: stream,\n\t\tmaxRequestId,\n\t\tversion,\n\t});\n}\n\nasync function acceptNegotiated(transport: WebTransport, url: URL, props?: AcceptProps): Promise<Established> {\n\tconst setupVersion = Ietf.Version.DRAFT_14;\n\n\tconst stream = await Stream.accept(transport);\n\tif (!stream) throw new Error(\"no incoming bidi stream for SETUP\");\n\n\tconst clientCompat = await stream.reader.u53();\n\tif (clientCompat !== Lite.StreamId.ClientCompat) {\n\t\tthrow new Error(`unexpected client message type: 0x${clientCompat.toString(16)}`);\n\t}\n\n\tconst client = await Ietf.ClientSetup.decode(stream.reader, setupVersion);\n\n\t// Pick the requested version, or first matching version from client's list\n\tconst allVersions = [...Object.values(Lite.Version), ...Object.values(Ietf.Version)] as number[];\n\tlet selectedVersion: number;\n\tif (props?.version !== undefined) {\n\t\tselectedVersion = props.version;\n\t} else {\n\t\tconst match = client.versions.find((v) => allVersions.includes(v));\n\t\tif (match === undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t`no common version found; client offered: ${client.versions.map((v) => v.toString(16)).join(\", \")}`,\n\t\t\t);\n\t\t}\n\t\tselectedVersion = match;\n\t}\n\n\tawait stream.writer.u53(Lite.StreamId.ServerCompat);\n\n\tconst encoder = new TextEncoder();\n\tconst params = new Ietf.SetupOptions();\n\tparams.setVarint(Ietf.SetupOption.MaxRequestId, 42069n);\n\tparams.setBytes(Ietf.SetupOption.Implementation, encoder.encode(\"moq-lite-js\"));\n\n\tconst server = new Ietf.ServerSetup({ version: selectedVersion, parameters: params });\n\tawait server.encode(stream.writer, setupVersion);\n\n\tif (Object.values(Lite.Version).includes(selectedVersion as Lite.Version)) {\n\t\treturn new Lite.Connection(url, transport, selectedVersion as Lite.Version, stream);\n\t} else if (Object.values(Ietf.Version).includes(selectedVersion as Ietf.Version)) {\n\t\tconst maxRequestId = client.parameters.getVarint(Ietf.SetupOption.MaxRequestId) ?? 0n;\n\t\treturn new Ietf.Connection({\n\t\t\turl,\n\t\t\tquic: transport,\n\t\t\tcontrol: stream,\n\t\t\tmaxRequestId,\n\t\t\tversion: selectedVersion as Ietf.IetfVersion,\n\t\t});\n\t} else {\n\t\tthrow new Error(`unsupported version: ${selectedVersion.toString(16)}`);\n\t}\n}\n"]}

package/connection/cert.test.d.ts

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

package/connection/cert.test.d.ts.map

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

package/connection/cert.test.js

@@ -0,0 +1,26 @@
+/* @ts-self-types="./cert.test.d.ts" */
+import { expect, test } from "bun:test";
+import * as Hex from "../util/hex.js";
+import { certificateHash } from "./connect.js";
+// SHA-256("abc"), a well-known test vector. We feed "abc" as the cert bytes so
+// the expected digest is independent of our own implementation.
+const ABC = new TextEncoder().encode("abc");
+const ABC_SHA256 = "ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad";
+test("certificateHash hashes raw DER bytes", async () => {
+    const hash = await certificateHash(ABC);
+    expect(Hex.fromBytes(hash)).toBe(ABC_SHA256);
+});
+test("certificateHash decodes PEM armor before hashing", async () => {
+    // base64("abc") === "YWJj"
+    const pem = "-----BEGIN CERTIFICATE-----\nYWJj\n-----END CERTIFICATE-----\n";
+    const hash = await certificateHash(pem);
+    expect(Hex.fromBytes(hash)).toBe(ABC_SHA256);
+});
+test("certificateHash rejects a PEM string without armor", async () => {
+    // Valid base64, but no -----BEGIN CERTIFICATE----- wrapper.
+    await expect(certificateHash("YWJj")).rejects.toThrow(/armor/);
+});
+test("hex round-trips through fromBytes/toBytes", () => {
+    expect(Hex.fromBytes(Hex.toBytes(ABC_SHA256))).toBe(ABC_SHA256);
+});
+//# sourceMappingURL=cert.test.js.map

package/connection/cert.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cert.test.js","sourceRoot":"","sources":["../../src/connection/cert.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,+EAA+E;AAC/E,gEAAgE;AAChE,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5C,MAAM,UAAU,GAAG,kEAAkE,CAAC;AAEtF,IAAI,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;IACvD,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;IACnE,2BAA2B;IAC3B,MAAM,GAAG,GAAG,gEAAgE,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACrE,4DAA4D;IAC5D,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACtD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC","sourcesContent":["import { expect, test } from \"bun:test\";\nimport * as Hex from \"../util/hex.ts\";\nimport { certificateHash } from \"./connect.ts\";\n\n// SHA-256(\"abc\"), a well-known test vector. We feed \"abc\" as the cert bytes so\n// the expected digest is independent of our own implementation.\nconst ABC = new TextEncoder().encode(\"abc\");\nconst ABC_SHA256 = \"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad\";\n\ntest(\"certificateHash hashes raw DER bytes\", async () => {\n\tconst hash = await certificateHash(ABC);\n\texpect(Hex.fromBytes(hash)).toBe(ABC_SHA256);\n});\n\ntest(\"certificateHash decodes PEM armor before hashing\", async () => {\n\t// base64(\"abc\") === \"YWJj\"\n\tconst pem = \"-----BEGIN CERTIFICATE-----\\nYWJj\\n-----END CERTIFICATE-----\\n\";\n\tconst hash = await certificateHash(pem);\n\texpect(Hex.fromBytes(hash)).toBe(ABC_SHA256);\n});\n\ntest(\"certificateHash rejects a PEM string without armor\", async () => {\n\t// Valid base64, but no -----BEGIN CERTIFICATE----- wrapper.\n\tawait expect(certificateHash(\"YWJj\")).rejects.toThrow(/armor/);\n});\n\ntest(\"hex round-trips through fromBytes/toBytes\", () => {\n\texpect(Hex.fromBytes(Hex.toBytes(ABC_SHA256))).toBe(ABC_SHA256);\n});\n"]}

package/connection/connect.d.ts

@@ -0,0 +1,37 @@
+import type { Established } from "./established";
+/** Tuning for the WebSocket fallback used when WebTransport is unavailable or loses the connect race. */
+export interface WebSocketOptions {
+    enabled?: boolean;
+    url?: URL;
+    delay?: DOMHighResTimeStamp;
+}
+/** A server certificate hash used to pin a self-signed server. `value` accepts raw bytes or a hex string. */
+export interface CertificateHash {
+    algorithm?: "sha-256";
+    value: BufferSource | string;
+}
+/** WebTransport options extended with friendlier certificate pinning (hex hashes or a raw certificate). */
+export interface WebTransportProps extends Omit<WebTransportOptions, "serverCertificateHashes"> {
+    serverCertificateHashes?: CertificateHash[];
+    serverCertificate?: string | BufferSource;
+}
+/** Options for {@link connect}. */
+export interface ConnectProps {
+    webtransport?: WebTransportProps;
+    websocket?: WebSocketOptions;
+    transport?: WebTransport;
+}
+/**
+ * Establishes a connection to a MOQ server.
+ *
+ * @param url - The URL of the server to connect to
+ * @returns A promise that resolves to a Connection instance
+ */
+export declare function connect(url: URL, props?: ConnectProps): Promise<Established>;
+/**
+ * Compute the SHA-256 hash of a certificate, the value `serverCertificateHashes`
+ * pins. Accepts a PEM string or raw DER bytes. Matches the hex fingerprints a moq
+ * server reports, so `Hex.fromBytes(await certificateHash(pem))` round-trips.
+ */
+export declare function certificateHash(cert: string | BufferSource): Promise<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=connect.d.ts.map

package/connection/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/connection/connect.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,yGAAyG;AACzG,MAAM,WAAW,gBAAgB;IAEhC,OAAO,CAAC,EAAE,OAAO,CAAC;IAIlB,GAAG,CAAC,EAAE,GAAG,CAAC;IAIV,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAKD,6GAA6G;AAC7G,MAAM,WAAW,eAAe;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC;CAC7B;AAGD,2GAA2G;AAC3G,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;IAG9F,uBAAuB,CAAC,EAAE,eAAe,EAAE,CAAC;IAK5C,iBAAiB,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC1C;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAE5B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAGjC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAI7B,SAAS,CAAC,EAAE,YAAY,CAAC;CACzB;AAUD;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAyIlF;AAgHD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAInG"}