@norskvideo/moq-net 0.1.0

package/connection/connect.js

@@ -0,0 +1,348 @@
+/* @ts-self-types="./connect.d.ts" */
+import Session from "@moq/qmux";
+import * as Ietf from "../ietf/index.js";
+import * as Lite from "../lite/index.js";
+import { Stream } from "../stream.js";
+import * as Hex from "../util/hex.js";
+import { exchangeSetup } from "./handshake.js";
+// Default head start for WebTransport before attempting the WebSocket fallback.
+const DEFAULT_WEBSOCKET_DELAY_MS = 500;
+// Save if WebSocket won the last race, so we won't give QUIC a head start next time.
+const websocketWon = new Set();
+// Firefox's WebTransport implementation drops server-initiated bidi streams,
+// breaking publish (the relay opens a subscribe bidi back to us). Force WebSocket.
+// TODO: remove once Firefox fixes incoming bidi delivery.
+const isFirefox = typeof navigator !== "undefined" && navigator.userAgent.toLowerCase().includes("firefox");
+/**
+ * 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 async function connect(url, props) {
+    if (props?.transport) {
+        return connectTransport(url, props.transport);
+    }
+    // Create a cancel promise to kill whichever is still connecting.
+    const { promise: cancel, resolve: done } = Promise.withResolvers();
+    const webtransport = globalThis.WebTransport && !isFirefox ? connectWebTransport(url, cancel, props?.webtransport) : undefined;
+    // Give QUIC a head start to connect before trying WebSocket, unless WebSocket has won in the past.
+    // NOTE that QUIC should be faster because it involves 1/2 fewer RTTs.
+    const headstart = !webtransport || websocketWon.has(url.toString()) ? 0 : (props?.websocket?.delay ?? DEFAULT_WEBSOCKET_DELAY_MS);
+    const websocket = props?.websocket?.enabled !== false
+        ? connectWebSocket(props?.websocket?.url ?? url, headstart, cancel)
+        : undefined;
+    if (!websocket && !webtransport) {
+        throw new Error("no transport available; WebTransport not supported and WebSocket is disabled");
+    }
+    // Race the available transports, using `.any` to ignore if one participant has an error.
+    // `webtransport`/`websocket` are `Promise | undefined`, so test existence explicitly: a
+    // promise is always truthy, so bare truthiness here would be a misused-promise.
+    const session = await Promise.any(webtransport !== undefined
+        ? websocket !== undefined
+            ? [websocket, webtransport]
+            : [webtransport]
+        : [websocket]);
+    done();
+    if (!session)
+        throw new Error("no transport available");
+    // Save if WebSocket won the last race, so we won't give QUIC a head start next time.
+    if (session instanceof Session) {
+        console.warn(url.toString(), "connected via WebSocket");
+        websocketWon.add(url.toString());
+    }
+    else {
+        console.log(url.toString(), "connected via WebTransport");
+    }
+    // Get the negotiated protocol. qmux Session exposes it directly;
+    // native WebTransport doesn't have a standard .protocol property yet.
+    const protocol = session instanceof Session
+        ? session.protocol || undefined
+        : // @ts-expect-error - TODO: add protocol to WebTransport
+            session.protocol;
+    console.debug(url.toString(), "negotiated ALPN:", protocol ?? "(none)");
+    // Choose setup encoding based on negotiated WebTransport protocol (if any).
+    let setupVersion;
+    const modernVersion = protocol === Ietf.ALPN.DRAFT_19
+        ? Ietf.Version.DRAFT_19
+        : protocol === Ietf.ALPN.DRAFT_18
+            ? Ietf.Version.DRAFT_18
+            : protocol === Ietf.ALPN.DRAFT_17
+                ? Ietf.Version.DRAFT_17
+                : undefined;
+    if (modernVersion !== undefined) {
+        return await handshakeAlpn(url, session, modernVersion);
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_16) {
+        setupVersion = Ietf.Version.DRAFT_16;
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_15) {
+        setupVersion = Ietf.Version.DRAFT_15;
+    }
+    else if (protocol === Lite.ALPN_05_WIP) {
+        // moq-lite draft-05 exchanges SETUP on a dedicated unidirectional stream
+        // (handled inside Connection), not the session compat stream.
+        return new Lite.Connection(url, session, Lite.Version.DRAFT_05_WIP, undefined);
+    }
+    else if (protocol === Lite.ALPN_04) {
+        // moq-lite draft-04 doesn't use a session stream, so we return immediately.
+        return new Lite.Connection(url, session, Lite.Version.DRAFT_04, undefined);
+    }
+    else if (protocol === Lite.ALPN_03) {
+        // moq-lite draft-03 doesn't use a session stream, so we return immediately.
+        return new Lite.Connection(url, session, Lite.Version.DRAFT_03, undefined);
+    }
+    else if (protocol === Lite.ALPN || protocol === "" || protocol === undefined) {
+        // moq-lite ALPN (or no protocol) uses Draft14 encoding for SETUP,
+        // then negotiates the actual version via the SETUP message.
+        setupVersion = Ietf.Version.DRAFT_14;
+    }
+    else {
+        throw new Error(`unsupported WebTransport protocol: ${protocol}`);
+    }
+    // We're encoding 0x20 so it's backwards compatible with moq-transport-10+
+    const stream = await Stream.open(session);
+    await stream.writer.u53(Lite.StreamId.ClientCompat);
+    const encoder = new TextEncoder();
+    const params = new Ietf.SetupOptions();
+    params.setVarint(Ietf.SetupOption.MaxRequestId, 42069n); // Allow a ton of request IDs.
+    params.setBytes(Ietf.SetupOption.Implementation, encoder.encode("moq-lite-js")); // Put the implementation name in the parameters.
+    const client = new Ietf.ClientSetup({
+        // NOTE: draft 15 onwards does not use CLIENT_SETUP to negotiate the version.
+        // We still echo it just to make sure we're not accidentally trying to negotiate the version.
+        versions: setupVersion === Ietf.Version.DRAFT_16
+            ? [Ietf.Version.DRAFT_16]
+            : setupVersion === Ietf.Version.DRAFT_15
+                ? [Ietf.Version.DRAFT_15]
+                : [Lite.Version.DRAFT_02, Lite.Version.DRAFT_01, Ietf.Version.DRAFT_14],
+        parameters: params,
+    });
+    console.debug(url.toString(), "sending client setup", client);
+    await client.encode(stream.writer, setupVersion);
+    // And we expect 0x21 as the response.
+    const serverCompat = await stream.reader.u53();
+    if (serverCompat !== Lite.StreamId.ServerCompat) {
+        throw new Error(`unsupported server message type: ${serverCompat.toString()}`);
+    }
+    // Decode ServerSetup in Draft14 format (version + params)
+    const server = await Ietf.ServerSetup.decode(stream.reader, setupVersion);
+    console.debug(url.toString(), "received server setup", server);
+    if (Object.values(Lite.Version).includes(server.version)) {
+        return new Lite.Connection(url, session, server.version, stream);
+    }
+    else if (Object.values(Ietf.Version).includes(server.version)) {
+        const maxRequestId = server.parameters.getVarint(Ietf.SetupOption.MaxRequestId) ?? 0n;
+        return new Ietf.Connection({
+            url,
+            quic: session,
+            control: stream,
+            maxRequestId,
+            version: server.version,
+        });
+    }
+    else {
+        throw new Error(`unsupported server version: ${server.version.toString()}`);
+    }
+}
+async function connectTransport(url, session) {
+    // @ts-expect-error - TODO: add protocol to WebTransport
+    const protocol = session.protocol;
+    // Choose setup encoding based on negotiated WebTransport protocol (if any).
+    let setupVersion;
+    const modernVersion = protocol === Ietf.ALPN.DRAFT_19
+        ? Ietf.Version.DRAFT_19
+        : protocol === Ietf.ALPN.DRAFT_18
+            ? Ietf.Version.DRAFT_18
+            : protocol === Ietf.ALPN.DRAFT_17
+                ? Ietf.Version.DRAFT_17
+                : undefined;
+    if (modernVersion !== undefined) {
+        return await handshakeAlpn(url, session, modernVersion);
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_16) {
+        setupVersion = Ietf.Version.DRAFT_16;
+    }
+    else if (protocol === Ietf.ALPN.DRAFT_15) {
+        setupVersion = Ietf.Version.DRAFT_15;
+    }
+    else if (protocol === Lite.ALPN_05_WIP) {
+        return new Lite.Connection(url, session, Lite.Version.DRAFT_05_WIP, undefined);
+    }
+    else if (protocol === Lite.ALPN_04) {
+        return new Lite.Connection(url, session, Lite.Version.DRAFT_04, undefined);
+    }
+    else if (protocol === Lite.ALPN_03) {
+        return new Lite.Connection(url, session, Lite.Version.DRAFT_03, undefined);
+    }
+    else if (protocol === Lite.ALPN || protocol === "" || protocol === undefined) {
+        setupVersion = Ietf.Version.DRAFT_14;
+    }
+    else {
+        throw new Error(`unsupported WebTransport protocol: ${protocol}`);
+    }
+    const stream = await Stream.open(session);
+    await stream.writer.u53(Lite.StreamId.ClientCompat);
+    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 client = new Ietf.ClientSetup({
+        versions: setupVersion === Ietf.Version.DRAFT_16
+            ? [Ietf.Version.DRAFT_16]
+            : setupVersion === Ietf.Version.DRAFT_15
+                ? [Ietf.Version.DRAFT_15]
+                : [Lite.Version.DRAFT_02, Lite.Version.DRAFT_01, Ietf.Version.DRAFT_14],
+        parameters: params,
+    });
+    await client.encode(stream.writer, setupVersion);
+    const serverCompat = await stream.reader.u53();
+    if (serverCompat !== Lite.StreamId.ServerCompat) {
+        throw new Error(`unsupported server message type: ${serverCompat.toString()}`);
+    }
+    const server = await Ietf.ServerSetup.decode(stream.reader, setupVersion);
+    if (Object.values(Lite.Version).includes(server.version)) {
+        return new Lite.Connection(url, session, server.version, stream);
+    }
+    else if (Object.values(Ietf.Version).includes(server.version)) {
+        const maxRequestId = server.parameters.getVarint(Ietf.SetupOption.MaxRequestId) ?? 0n;
+        return new Ietf.Connection({
+            url,
+            quic: session,
+            control: stream,
+            maxRequestId,
+            version: server.version,
+        });
+    }
+    else {
+        throw new Error(`unsupported server version: ${server.version.toString()}`);
+    }
+}
+/**
+ * Draft-17+ client handshake. ALPN already pinned the version; SETUP is
+ * exchanged over a pair of uni streams using stream type 0x2F00.
+ */
+async function handshakeAlpn(url, session, version) {
+    const controlStream = await exchangeSetup(session, version, "moq-lite-js");
+    return new Ietf.Connection({
+        url,
+        quic: session,
+        control: controlStream,
+        // v17+ uses NativeSession which manages its own request IDs; maxRequestId is unused.
+        maxRequestId: 0n,
+        version,
+    });
+}
+// Strip PEM armor and base64-decode to the raw DER bytes.
+function pemToDer(pem) {
+    const match = pem.match(/-----BEGIN CERTIFICATE-----([\s\S]+?)-----END CERTIFICATE-----/);
+    if (!match) {
+        throw new Error("invalid PEM certificate: missing -----BEGIN/END CERTIFICATE----- armor");
+    }
+    const binary = atob(match[1].replace(/\s+/g, ""));
+    const der = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        der[i] = binary.charCodeAt(i);
+    }
+    return der;
+}
+/**
+ * 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 async function certificateHash(cert) {
+    const der = typeof cert === "string" ? pemToDer(cert) : cert;
+    const digest = await crypto.subtle.digest("SHA-256", der);
+    return new Uint8Array(digest);
+}
+// Normalize our friendlier pinning options into the DOM `serverCertificateHashes`.
+async function resolveCertificateHashes(options) {
+    const hashes = [];
+    for (const hash of options?.serverCertificateHashes ?? []) {
+        const value = typeof hash.value === "string" ? Hex.toBytes(hash.value) : hash.value;
+        hashes.push({ algorithm: hash.algorithm ?? "sha-256", value });
+    }
+    if (options?.serverCertificate !== undefined) {
+        hashes.push({ algorithm: "sha-256", value: await certificateHash(options.serverCertificate) });
+    }
+    return hashes.length > 0 ? hashes : undefined;
+}
+async function connectWebTransport(url, cancel, options) {
+    let finalUrl = url;
+    // Our custom pinning fields are normalized separately; the rest are DOM options.
+    const { serverCertificate: _cert, serverCertificateHashes: _hashes, ...webtransport } = options ?? {};
+    const finalOptions = {
+        allowPooling: false,
+        congestionControl: "low-latency",
+        protocols: [
+            Lite.ALPN_04,
+            Lite.ALPN_03,
+            Lite.ALPN,
+            // NOTE(norsk): the IETF draft ALPNs (moqt-15..19) are intentionally NOT
+            // offered. norsk advertises moqt-16, and net's draft-16 data-plane
+            // reader can't yet consume norsk's (correct) draft-16 subgroup objects,
+            // so negotiating moqt-16 breaks media playback. Offering only the
+            // moq-lite ALPNs makes the WebTransport handshake settle on no IETF
+            // protocol → net's draft-14 fallback (connect.ts §"Lite.ALPN | ''"),
+            // which norsk serves fine. Restore these once net draft-16 works.
+        ],
+        ...webtransport,
+    };
+    // Accumulate caller-provided pins first, then append anything we fetch below,
+    // so a fetched fingerprint never clobbers hashes passed in via options.
+    const hashes = (await resolveCertificateHashes(options)) ?? [];
+    // Only perform certificate fetch and URL rewrite when polyfill is not needed
+    // This is needed because WebTransport is a butt to work with in local development.
+    if (url.protocol === "http:") {
+        const fingerprintUrl = new URL(url);
+        fingerprintUrl.pathname = "/certificate.sha256";
+        fingerprintUrl.search = "";
+        // Dev-only path: http:// can't be a real WebTransport origin, so we fetch the
+        // self-signed cert's hash over plain HTTP and pin it. Production uses https://
+        // and never reaches here. Keep this at debug so it doesn't read as a problem.
+        console.debug(fingerprintUrl.toString(), "performing an insecure fingerprint fetch; use https:// in production");
+        // Fetch the fingerprint from the server.
+        // TODO cancel the request if the effect is cancelled.
+        const fingerprint = await Promise.race([fetch(fingerprintUrl), cancel]);
+        if (!fingerprint)
+            return undefined;
+        const fingerprintText = await Promise.race([fingerprint.text(), cancel]);
+        if (fingerprintText === undefined)
+            return undefined;
+        hashes.push({ algorithm: "sha-256", value: Hex.toBytes(fingerprintText) });
+        finalUrl = new URL(url);
+        finalUrl.protocol = "https:";
+    }
+    if (hashes.length > 0) {
+        finalOptions.serverCertificateHashes = hashes;
+    }
+    const quic = new WebTransport(finalUrl, finalOptions);
+    // Both .ready and .closed reject on failure; catch .closed to avoid an unhandled rejection.
+    quic.closed.catch(() => { });
+    // Wait for the WebTransport to connect, or for the cancel promise to resolve.
+    // Close the connection if we lost the race.
+    const loaded = await Promise.race([quic.ready.then(() => true), cancel]);
+    if (!loaded) {
+        quic.close();
+        return undefined;
+    }
+    return quic;
+}
+// TODO accept arguments to control the port/path used.
+async function connectWebSocket(url, delay, cancel) {
+    const timer = new Promise((resolve) => setTimeout(resolve, delay));
+    const active = await Promise.race([cancel, timer.then(() => true)]);
+    if (!active)
+        return undefined;
+    const quic = new Session(url);
+    // Wait for the WebSocket to connect, or for the cancel promise to resolve.
+    // `ready` rejects on a refused/failed connection, so a throw here is the caller's
+    // cue to retry; a lost cancel race instead resolves and we close the loser.
+    const loaded = await Promise.race([quic.ready.then(() => true), cancel]);
+    if (!loaded) {
+        quic.close();
+        return undefined;
+    }
+    return quic;
+}
+//# sourceMappingURL=connect.js.map

package/connection/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/connection/connect.ts"],"names":[],"mappings":"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","sourcesContent":["import Session from \"@moq/qmux\";\nimport * as Ietf from \"../ietf/index.ts\";\nimport * as Lite from \"../lite/index.ts\";\nimport { Stream } from \"../stream.ts\";\nimport * as Hex from \"../util/hex.ts\";\nimport type { Established } from \"./established.ts\";\nimport { exchangeSetup } from \"./handshake.ts\";\n\n// Default head start for WebTransport before attempting the WebSocket fallback.\nconst DEFAULT_WEBSOCKET_DELAY_MS = 500;\n\n/** Tuning for the WebSocket fallback used when WebTransport is unavailable or loses the connect race. */\nexport interface WebSocketOptions {\n\t// If true (default), enable the WebSocket fallback.\n\tenabled?: boolean;\n\n\t// Optional: Use a different URL than WebTransport.\n\t// By default, `https` => `wss` and `http` => `ws`.\n\turl?: URL;\n\n\t// The delay in milliseconds before attempting the WebSocket fallback. (default: 500)\n\t// If WebSocket won the previous race for a given URL, this will be 0.\n\tdelay?: DOMHighResTimeStamp;\n}\n\n// One entry of `serverCertificateHashes`, used to pin a self-signed server.\n// Unlike the DOM type, `value` also accepts a hex string (the format moq\n// servers report via their certificate fingerprints), decoded automatically.\n/** A server certificate hash used to pin a self-signed server. `value` accepts raw bytes or a hex string. */\nexport interface CertificateHash {\n\talgorithm?: \"sha-256\";\n\tvalue: BufferSource | string;\n}\n\n// WebTransport options, extended with friendlier certificate pinning.\n/** WebTransport options extended with friendlier certificate pinning (hex hashes or a raw certificate). */\nexport interface WebTransportProps extends Omit<WebTransportOptions, \"serverCertificateHashes\"> {\n\t// Pin the server to one or more certificate hashes. Each `value` may be raw\n\t// bytes or a hex string; the algorithm defaults to `sha-256`.\n\tserverCertificateHashes?: CertificateHash[];\n\n\t// Pin the server by supplying its certificate directly; the SHA-256 hash is\n\t// computed for you. Accepts a PEM string or raw DER bytes. Use this when you\n\t// have the certificate but not its precomputed fingerprint.\n\tserverCertificate?: string | BufferSource;\n}\n\n/** Options for {@link connect}. */\nexport interface ConnectProps {\n\t// WebTransport options.\n\twebtransport?: WebTransportProps;\n\n\t// WebSocket (fallback) options.\n\twebsocket?: WebSocketOptions;\n\n\t// Use a pre-existing WebTransport session instead of connecting.\n\t// When provided, skips WebTransport/WebSocket race and uses this directly.\n\ttransport?: WebTransport;\n}\n\n// Save if WebSocket won the last race, so we won't give QUIC a head start next time.\nconst websocketWon = new Set<string>();\n\n// Firefox's WebTransport implementation drops server-initiated bidi streams,\n// breaking publish (the relay opens a subscribe bidi back to us). Force WebSocket.\n// TODO: remove once Firefox fixes incoming bidi delivery.\nconst isFirefox = typeof navigator !== \"undefined\" && navigator.userAgent.toLowerCase().includes(\"firefox\");\n\n/**\n * Establishes a connection to a MOQ server.\n *\n * @param url - The URL of the server to connect to\n * @returns A promise that resolves to a Connection instance\n */\nexport async function connect(url: URL, props?: ConnectProps): Promise<Established> {\n\tif (props?.transport) {\n\t\treturn connectTransport(url, props.transport);\n\t}\n\n\t// Create a cancel promise to kill whichever is still connecting.\n\tconst { promise: cancel, resolve: done } = Promise.withResolvers<void>();\n\n\tconst webtransport =\n\t\tglobalThis.WebTransport && !isFirefox ? connectWebTransport(url, cancel, props?.webtransport) : undefined;\n\n\t// Give QUIC a head start to connect before trying WebSocket, unless WebSocket has won in the past.\n\t// NOTE that QUIC should be faster because it involves 1/2 fewer RTTs.\n\tconst headstart =\n\t\t!webtransport || websocketWon.has(url.toString()) ? 0 : (props?.websocket?.delay ?? DEFAULT_WEBSOCKET_DELAY_MS);\n\tconst websocket =\n\t\tprops?.websocket?.enabled !== false\n\t\t\t? connectWebSocket(props?.websocket?.url ?? url, headstart, cancel)\n\t\t\t: undefined;\n\n\tif (!websocket && !webtransport) {\n\t\tthrow new Error(\"no transport available; WebTransport not supported and WebSocket is disabled\");\n\t}\n\n\t// Race the available transports, using `.any` to ignore if one participant has an error.\n\t// `webtransport`/`websocket` are `Promise | undefined`, so test existence explicitly: a\n\t// promise is always truthy, so bare truthiness here would be a misused-promise.\n\tconst session = await Promise.any(\n\t\twebtransport !== undefined\n\t\t\t? websocket !== undefined\n\t\t\t\t? [websocket, webtransport]\n\t\t\t\t: [webtransport]\n\t\t\t: [websocket],\n\t);\n\tdone();\n\n\tif (!session) throw new Error(\"no transport available\");\n\n\t// Save if WebSocket won the last race, so we won't give QUIC a head start next time.\n\tif (session instanceof Session) {\n\t\tconsole.warn(url.toString(), \"connected via WebSocket\");\n\t\twebsocketWon.add(url.toString());\n\t} else {\n\t\tconsole.log(url.toString(), \"connected via WebTransport\");\n\t}\n\n\t// Get the negotiated protocol. qmux Session exposes it directly;\n\t// native WebTransport doesn't have a standard .protocol property yet.\n\tconst protocol: string | undefined =\n\t\tsession instanceof Session\n\t\t\t? session.protocol || undefined\n\t\t\t: // @ts-expect-error - TODO: add protocol to WebTransport\n\t\t\t\tsession.protocol;\n\tconsole.debug(url.toString(), \"negotiated ALPN:\", protocol ?? \"(none)\");\n\n\t// Choose setup encoding based on negotiated WebTransport protocol (if any).\n\tlet setupVersion: Ietf.Version;\n\tconst modernVersion =\n\t\tprotocol === Ietf.ALPN.DRAFT_19\n\t\t\t? Ietf.Version.DRAFT_19\n\t\t\t: protocol === Ietf.ALPN.DRAFT_18\n\t\t\t\t? Ietf.Version.DRAFT_18\n\t\t\t\t: protocol === Ietf.ALPN.DRAFT_17\n\t\t\t\t\t? Ietf.Version.DRAFT_17\n\t\t\t\t\t: undefined;\n\tif (modernVersion !== undefined) {\n\t\treturn await handshakeAlpn(url, session as WebTransport, modernVersion);\n\t} else if (protocol === Ietf.ALPN.DRAFT_16) {\n\t\tsetupVersion = Ietf.Version.DRAFT_16;\n\t} else if (protocol === Ietf.ALPN.DRAFT_15) {\n\t\tsetupVersion = Ietf.Version.DRAFT_15;\n\t} else if (protocol === Lite.ALPN_05_WIP) {\n\t\t// moq-lite draft-05 exchanges SETUP on a dedicated unidirectional stream\n\t\t// (handled inside Connection), not the session compat stream.\n\t\treturn new Lite.Connection(url, session, Lite.Version.DRAFT_05_WIP, undefined);\n\t} else if (protocol === Lite.ALPN_04) {\n\t\t// moq-lite draft-04 doesn't use a session stream, so we return immediately.\n\t\treturn new Lite.Connection(url, session, Lite.Version.DRAFT_04, undefined);\n\t} else if (protocol === Lite.ALPN_03) {\n\t\t// moq-lite draft-03 doesn't use a session stream, so we return immediately.\n\t\treturn new Lite.Connection(url, session, Lite.Version.DRAFT_03, undefined);\n\t} else if (protocol === Lite.ALPN || protocol === \"\" || protocol === undefined) {\n\t\t// moq-lite ALPN (or no protocol) uses Draft14 encoding for SETUP,\n\t\t// then negotiates the actual version via the SETUP message.\n\t\tsetupVersion = Ietf.Version.DRAFT_14;\n\t} else {\n\t\tthrow new Error(`unsupported WebTransport protocol: ${protocol}`);\n\t}\n\n\t// We're encoding 0x20 so it's backwards compatible with moq-transport-10+\n\tconst stream = await Stream.open(session);\n\tawait stream.writer.u53(Lite.StreamId.ClientCompat);\n\n\tconst encoder = new TextEncoder();\n\n\tconst params = new Ietf.SetupOptions();\n\tparams.setVarint(Ietf.SetupOption.MaxRequestId, 42069n); // Allow a ton of request IDs.\n\tparams.setBytes(Ietf.SetupOption.Implementation, encoder.encode(\"moq-lite-js\")); // Put the implementation name in the parameters.\n\n\tconst client = new Ietf.ClientSetup({\n\t\t// NOTE: draft 15 onwards does not use CLIENT_SETUP to negotiate the version.\n\t\t// We still echo it just to make sure we're not accidentally trying to negotiate the version.\n\t\tversions:\n\t\t\tsetupVersion === Ietf.Version.DRAFT_16\n\t\t\t\t? [Ietf.Version.DRAFT_16]\n\t\t\t\t: setupVersion === Ietf.Version.DRAFT_15\n\t\t\t\t\t? [Ietf.Version.DRAFT_15]\n\t\t\t\t\t: [Lite.Version.DRAFT_02, Lite.Version.DRAFT_01, Ietf.Version.DRAFT_14],\n\t\tparameters: params,\n\t});\n\tconsole.debug(url.toString(), \"sending client setup\", client);\n\tawait client.encode(stream.writer, setupVersion);\n\n\t// And we expect 0x21 as the response.\n\tconst serverCompat = await stream.reader.u53();\n\tif (serverCompat !== Lite.StreamId.ServerCompat) {\n\t\tthrow new Error(`unsupported server message type: ${serverCompat.toString()}`);\n\t}\n\n\t// Decode ServerSetup in Draft14 format (version + params)\n\tconst server = await Ietf.ServerSetup.decode(stream.reader, setupVersion);\n\tconsole.debug(url.toString(), \"received server setup\", server);\n\n\tif (Object.values(Lite.Version).includes(server.version as Lite.Version)) {\n\t\treturn new Lite.Connection(url, session, server.version as Lite.Version, stream);\n\t} else if (Object.values(Ietf.Version).includes(server.version as Ietf.Version)) {\n\t\tconst maxRequestId = server.parameters.getVarint(Ietf.SetupOption.MaxRequestId) ?? 0n;\n\t\treturn new Ietf.Connection({\n\t\t\turl,\n\t\t\tquic: session,\n\t\t\tcontrol: stream,\n\t\t\tmaxRequestId,\n\t\t\tversion: server.version as Ietf.IetfVersion,\n\t\t});\n\t} else {\n\t\tthrow new Error(`unsupported server version: ${server.version.toString()}`);\n\t}\n}\n\nasync function connectTransport(url: URL, session: WebTransport): Promise<Established> {\n\t// @ts-expect-error - TODO: add protocol to WebTransport\n\tconst protocol: string | undefined = session.protocol;\n\n\t// Choose setup encoding based on negotiated WebTransport protocol (if any).\n\tlet setupVersion: Ietf.Version;\n\tconst modernVersion =\n\t\tprotocol === Ietf.ALPN.DRAFT_19\n\t\t\t? Ietf.Version.DRAFT_19\n\t\t\t: protocol === Ietf.ALPN.DRAFT_18\n\t\t\t\t? Ietf.Version.DRAFT_18\n\t\t\t\t: protocol === Ietf.ALPN.DRAFT_17\n\t\t\t\t\t? Ietf.Version.DRAFT_17\n\t\t\t\t\t: undefined;\n\tif (modernVersion !== undefined) {\n\t\treturn await handshakeAlpn(url, session, modernVersion);\n\t} else if (protocol === Ietf.ALPN.DRAFT_16) {\n\t\tsetupVersion = Ietf.Version.DRAFT_16;\n\t} else if (protocol === Ietf.ALPN.DRAFT_15) {\n\t\tsetupVersion = Ietf.Version.DRAFT_15;\n\t} else if (protocol === Lite.ALPN_05_WIP) {\n\t\treturn new Lite.Connection(url, session, Lite.Version.DRAFT_05_WIP, undefined);\n\t} else if (protocol === Lite.ALPN_04) {\n\t\treturn new Lite.Connection(url, session, Lite.Version.DRAFT_04, undefined);\n\t} else if (protocol === Lite.ALPN_03) {\n\t\treturn new Lite.Connection(url, session, Lite.Version.DRAFT_03, undefined);\n\t} else if (protocol === Lite.ALPN || protocol === \"\" || protocol === undefined) {\n\t\tsetupVersion = Ietf.Version.DRAFT_14;\n\t} else {\n\t\tthrow new Error(`unsupported WebTransport protocol: ${protocol}`);\n\t}\n\n\tconst stream = await Stream.open(session);\n\tawait stream.writer.u53(Lite.StreamId.ClientCompat);\n\n\tconst encoder = new TextEncoder();\n\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 client = new Ietf.ClientSetup({\n\t\tversions:\n\t\t\tsetupVersion === Ietf.Version.DRAFT_16\n\t\t\t\t? [Ietf.Version.DRAFT_16]\n\t\t\t\t: setupVersion === Ietf.Version.DRAFT_15\n\t\t\t\t\t? [Ietf.Version.DRAFT_15]\n\t\t\t\t\t: [Lite.Version.DRAFT_02, Lite.Version.DRAFT_01, Ietf.Version.DRAFT_14],\n\t\tparameters: params,\n\t});\n\tawait client.encode(stream.writer, setupVersion);\n\n\tconst serverCompat = await stream.reader.u53();\n\tif (serverCompat !== Lite.StreamId.ServerCompat) {\n\t\tthrow new Error(`unsupported server message type: ${serverCompat.toString()}`);\n\t}\n\n\tconst server = await Ietf.ServerSetup.decode(stream.reader, setupVersion);\n\n\tif (Object.values(Lite.Version).includes(server.version as Lite.Version)) {\n\t\treturn new Lite.Connection(url, session, server.version as Lite.Version, stream);\n\t} else if (Object.values(Ietf.Version).includes(server.version as Ietf.Version)) {\n\t\tconst maxRequestId = server.parameters.getVarint(Ietf.SetupOption.MaxRequestId) ?? 0n;\n\t\treturn new Ietf.Connection({\n\t\t\turl,\n\t\t\tquic: session,\n\t\t\tcontrol: stream,\n\t\t\tmaxRequestId,\n\t\t\tversion: server.version as Ietf.IetfVersion,\n\t\t});\n\t} else {\n\t\tthrow new Error(`unsupported server version: ${server.version.toString()}`);\n\t}\n}\n\n/**\n * Draft-17+ client handshake. ALPN already pinned the version; SETUP is\n * exchanged over a pair of uni streams using stream type 0x2F00.\n */\nasync function handshakeAlpn(url: URL, session: WebTransport, version: Ietf.IetfVersion): Promise<Established> {\n\tconst controlStream = await exchangeSetup(session, version, \"moq-lite-js\");\n\n\treturn new Ietf.Connection({\n\t\turl,\n\t\tquic: session,\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// One entry of the DOM `serverCertificateHashes`, derived without naming the lib type.\ntype WebTransportHash = NonNullable<WebTransportOptions[\"serverCertificateHashes\"]>[number];\n\n// Strip PEM armor and base64-decode to the raw DER bytes.\nfunction pemToDer(pem: string): Uint8Array<ArrayBuffer> {\n\tconst match = pem.match(/-----BEGIN CERTIFICATE-----([\\s\\S]+?)-----END CERTIFICATE-----/);\n\tif (!match) {\n\t\tthrow new Error(\"invalid PEM certificate: missing -----BEGIN/END CERTIFICATE----- armor\");\n\t}\n\n\tconst binary = atob(match[1].replace(/\\s+/g, \"\"));\n\tconst der = new Uint8Array(binary.length);\n\tfor (let i = 0; i < binary.length; i++) {\n\t\tder[i] = binary.charCodeAt(i);\n\t}\n\treturn der;\n}\n\n/**\n * Compute the SHA-256 hash of a certificate, the value `serverCertificateHashes`\n * pins. Accepts a PEM string or raw DER bytes. Matches the hex fingerprints a moq\n * server reports, so `Hex.fromBytes(await certificateHash(pem))` round-trips.\n */\nexport async function certificateHash(cert: string | BufferSource): Promise<Uint8Array<ArrayBuffer>> {\n\tconst der = typeof cert === \"string\" ? pemToDer(cert) : cert;\n\tconst digest = await crypto.subtle.digest(\"SHA-256\", der);\n\treturn new Uint8Array(digest);\n}\n\n// Normalize our friendlier pinning options into the DOM `serverCertificateHashes`.\nasync function resolveCertificateHashes(options?: WebTransportProps): Promise<WebTransportHash[] | undefined> {\n\tconst hashes: WebTransportHash[] = [];\n\n\tfor (const hash of options?.serverCertificateHashes ?? []) {\n\t\tconst value = typeof hash.value === \"string\" ? Hex.toBytes(hash.value) : hash.value;\n\t\thashes.push({ algorithm: hash.algorithm ?? \"sha-256\", value });\n\t}\n\n\tif (options?.serverCertificate !== undefined) {\n\t\thashes.push({ algorithm: \"sha-256\", value: await certificateHash(options.serverCertificate) });\n\t}\n\n\treturn hashes.length > 0 ? hashes : undefined;\n}\n\nasync function connectWebTransport(\n\turl: URL,\n\tcancel: Promise<void>,\n\toptions?: WebTransportProps,\n): Promise<WebTransport | undefined> {\n\tlet finalUrl = url;\n\n\t// Our custom pinning fields are normalized separately; the rest are DOM options.\n\tconst { serverCertificate: _cert, serverCertificateHashes: _hashes, ...webtransport } = options ?? {};\n\n\tconst finalOptions: WebTransportOptions = {\n\t\tallowPooling: false,\n\t\tcongestionControl: \"low-latency\",\n\t\tprotocols: [\n\t\t\tLite.ALPN_04,\n\t\t\tLite.ALPN_03,\n\t\t\tLite.ALPN,\n\t\t\t// NOTE(norsk): the IETF draft ALPNs (moqt-15..19) are intentionally NOT\n\t\t\t// offered. norsk advertises moqt-16, and net's draft-16 data-plane\n\t\t\t// reader can't yet consume norsk's (correct) draft-16 subgroup objects,\n\t\t\t// so negotiating moqt-16 breaks media playback. Offering only the\n\t\t\t// moq-lite ALPNs makes the WebTransport handshake settle on no IETF\n\t\t\t// protocol → net's draft-14 fallback (connect.ts §\"Lite.ALPN | ''\"),\n\t\t\t// which norsk serves fine. Restore these once net draft-16 works.\n\t\t],\n\t\t...webtransport,\n\t};\n\n\t// Accumulate caller-provided pins first, then append anything we fetch below,\n\t// so a fetched fingerprint never clobbers hashes passed in via options.\n\tconst hashes = (await resolveCertificateHashes(options)) ?? [];\n\n\t// Only perform certificate fetch and URL rewrite when polyfill is not needed\n\t// This is needed because WebTransport is a butt to work with in local development.\n\tif (url.protocol === \"http:\") {\n\t\tconst fingerprintUrl = new URL(url);\n\t\tfingerprintUrl.pathname = \"/certificate.sha256\";\n\t\tfingerprintUrl.search = \"\";\n\t\t// Dev-only path: http:// can't be a real WebTransport origin, so we fetch the\n\t\t// self-signed cert's hash over plain HTTP and pin it. Production uses https://\n\t\t// and never reaches here. Keep this at debug so it doesn't read as a problem.\n\t\tconsole.debug(\n\t\t\tfingerprintUrl.toString(),\n\t\t\t\"performing an insecure fingerprint fetch; use https:// in production\",\n\t\t);\n\n\t\t// Fetch the fingerprint from the server.\n\t\t// TODO cancel the request if the effect is cancelled.\n\t\tconst fingerprint = await Promise.race([fetch(fingerprintUrl), cancel]);\n\t\tif (!fingerprint) return undefined;\n\n\t\tconst fingerprintText = await Promise.race([fingerprint.text(), cancel]);\n\t\tif (fingerprintText === undefined) return undefined;\n\n\t\thashes.push({ algorithm: \"sha-256\", value: Hex.toBytes(fingerprintText) });\n\n\t\tfinalUrl = new URL(url);\n\t\tfinalUrl.protocol = \"https:\";\n\t}\n\n\tif (hashes.length > 0) {\n\t\tfinalOptions.serverCertificateHashes = hashes;\n\t}\n\n\tconst quic = new WebTransport(finalUrl, finalOptions);\n\n\t// Both .ready and .closed reject on failure; catch .closed to avoid an unhandled rejection.\n\tquic.closed.catch(() => {});\n\n\t// Wait for the WebTransport to connect, or for the cancel promise to resolve.\n\t// Close the connection if we lost the race.\n\tconst loaded = await Promise.race([quic.ready.then(() => true), cancel]);\n\tif (!loaded) {\n\t\tquic.close();\n\t\treturn undefined;\n\t}\n\n\treturn quic;\n}\n\n// TODO accept arguments to control the port/path used.\nasync function connectWebSocket(url: URL, delay: number, cancel: Promise<void>): Promise<Session | undefined> {\n\tconst timer = new Promise<void>((resolve) => setTimeout(resolve, delay));\n\n\tconst active = await Promise.race([cancel, timer.then(() => true)]);\n\tif (!active) return undefined;\n\n\tconst quic = new Session(url);\n\n\t// Wait for the WebSocket to connect, or for the cancel promise to resolve.\n\t// `ready` rejects on a refused/failed connection, so a throw here is the caller's\n\t// cue to retry; a lost cancel race instead resolves and we close the loser.\n\tconst loaded = await Promise.race([quic.ready.then(() => true), cancel]);\n\tif (!loaded) {\n\t\tquic.close();\n\t\treturn undefined;\n\t}\n\n\treturn quic;\n}\n"]}

package/connection/established.d.ts

@@ -0,0 +1,30 @@
+import type { Signal } from "@norskvideo/moq-signals";
+import type { Announced } from "../announced";
+import type { Bandwidth } from "../bandwidth";
+import type { Broadcast } from "../broadcast";
+import type * as Path from "../path";
+import type * as Time from "../time";
+/** An established MoQ session, implemented by both the moq-lite and moq-ietf protocols. */
+export interface Established {
+    /** URL of the connected server. */
+    readonly url: URL;
+    /** Negotiated wire protocol version. */
+    readonly version: string;
+    /** Estimated send bitrate from the congestion controller (if supported). */
+    readonly sendBandwidth?: Bandwidth;
+    /** Estimated receive bitrate from PROBE (moq-lite-03+ only). */
+    readonly recvBandwidth?: Bandwidth;
+    /** RTT in milliseconds from PROBE (moq-lite-04+ only). */
+    readonly rtt?: Signal<Time.Milli | undefined>;
+    /** Subscribe to broadcast announcements under an optional path prefix. */
+    announced(prefix?: Path.Valid): Announced;
+    /** Publish a broadcast at the given path. */
+    publish(path: Path.Valid, broadcast: Broadcast): void;
+    /** Consume the broadcast at the given path. */
+    consume(broadcast: Path.Valid): Broadcast;
+    /** Close the session. */
+    close(): void;
+    /** Resolves when the session closes. */
+    closed: Promise<void>;
+}
+//# sourceMappingURL=established.d.ts.map

package/connection/established.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"established.d.ts","sourceRoot":"","sources":["../../src/connection/established.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AAExC,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAElB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAEnC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAEnC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAE9C,0EAA0E;IAC1E,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAE1C,6CAA6C;IAC7C,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAEtD,+CAA+C;IAC/C,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAE1C,yBAAyB;IACzB,KAAK,IAAI,IAAI,CAAC;IAEd,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB"}

package/connection/established.js

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

package/connection/established.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"established.js","sourceRoot":"","sources":["../../src/connection/established.ts"],"names":[],"mappings":"","sourcesContent":["import type { Signal } from \"@moq/signals\";\nimport type { Announced } from \"../announced.ts\";\nimport type { Bandwidth } from \"../bandwidth.ts\";\nimport type { Broadcast } from \"../broadcast.ts\";\nimport type * as Path from \"../path.ts\";\nimport type * as Time from \"../time.ts\";\n\n/** An established MoQ session, implemented by both the moq-lite and moq-ietf protocols. */\nexport interface Established {\n\t/** URL of the connected server. */\n\treadonly url: URL;\n\n\t/** Negotiated wire protocol version. */\n\treadonly version: string;\n\n\t/** Estimated send bitrate from the congestion controller (if supported). */\n\treadonly sendBandwidth?: Bandwidth;\n\n\t/** Estimated receive bitrate from PROBE (moq-lite-03+ only). */\n\treadonly recvBandwidth?: Bandwidth;\n\n\t/** RTT in milliseconds from PROBE (moq-lite-04+ only). */\n\treadonly rtt?: Signal<Time.Milli | undefined>;\n\n\t/** Subscribe to broadcast announcements under an optional path prefix. */\n\tannounced(prefix?: Path.Valid): Announced;\n\n\t/** Publish a broadcast at the given path. */\n\tpublish(path: Path.Valid, broadcast: Broadcast): void;\n\n\t/** Consume the broadcast at the given path. */\n\tconsume(broadcast: Path.Valid): Broadcast;\n\n\t/** Close the session. */\n\tclose(): void;\n\n\t/** Resolves when the session closes. */\n\tclosed: Promise<void>;\n}\n"]}

package/connection/handshake.d.ts

@@ -0,0 +1,10 @@
+import * as Ietf from "../ietf/index";
+import { Stream } from "../stream";
+/**
+ * Draft-17+ SETUP exchange. Each side opens a uni stream, writes its Setup
+ * message, and reads the peer's Setup off an incoming uni stream. The two
+ * halves run in parallel and the protocol is symmetric, so both `connect`
+ * (client) and `accept` (server) use this same function.
+ */
+export declare function exchangeSetup(transport: WebTransport, version: Ietf.IetfVersion, implementation: string): Promise<Stream>;
+//# sourceMappingURL=handshake.d.ts.map

package/connection/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/connection/handshake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAU,MAAM,EAAU,MAAM,cAAc,CAAC;AAEtD;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,IAAI,CAAC,WAAW,EACzB,cAAc,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/connection/handshake.js

@@ -0,0 +1,48 @@
+/* @ts-self-types="./handshake.d.ts" */
+import * as Ietf from "../ietf/index.js";
+import { Reader, Stream, Writer } from "../stream.js";
+/**
+ * Draft-17+ SETUP exchange. Each side opens a uni stream, writes its Setup
+ * message, and reads the peer's Setup off an incoming uni stream. The two
+ * halves run in parallel and the protocol is symmetric, so both `connect`
+ * (client) and `accept` (server) use this same function.
+ */
+export async function exchangeSetup(transport, version, implementation) {
+    const encoder = new TextEncoder();
+    const params = new Ietf.SetupOptions();
+    params.setBytes(Ietf.SetupOption.Implementation, encoder.encode(implementation));
+    const setupMsg = new Ietf.Setup({ parameters: params });
+    const [sent, received] = await Promise.all([
+        sendSetup(transport, version, setupMsg),
+        receiveSetup(transport, version),
+    ]);
+    return new Stream({
+        writable: sent.writable,
+        readable: received.readable,
+        writer: sent.writer,
+        reader: received.reader,
+    });
+}
+async function sendSetup(transport, version, setupMsg) {
+    const writable = (await transport.createUnidirectionalStream());
+    const writer = new Writer(writable, version);
+    await writer.u53(Ietf.Setup.id); // 0x2F00 stream type
+    await setupMsg.encode(writer, version);
+    return { writable, writer };
+}
+async function receiveSetup(transport, version) {
+    const uniReader = transport.incomingUnidirectionalStreams.getReader();
+    const next = await uniReader.read();
+    uniReader.releaseLock();
+    if (next.done)
+        throw new Error("no incoming uni stream for SETUP");
+    const readable = next.value;
+    const reader = new Reader(readable, undefined, version);
+    const streamType = await reader.u53();
+    if (streamType !== Ietf.Setup.id) {
+        throw new Error(`unexpected stream type on setup uni: 0x${streamType.toString(16)}`);
+    }
+    await Ietf.Setup.decode(reader, version);
+    return { readable, reader };
+}
+//# sourceMappingURL=handshake.js.map

package/connection/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/connection/handshake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,SAAuB,EACvB,OAAyB,EACzB,cAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;IACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAExD,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC;QACvC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO,IAAI,MAAM,CAAC;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;KACvB,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CACvB,SAAuB,EACvB,OAAyB,EACzB,QAAoB;IAEpB,MAAM,QAAQ,GAAG,CAAC,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAA+B,CAAC;IAC9F,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB;IACtD,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,YAAY,CAC1B,SAAuB,EACvB,OAAyB;IAEzB,MAAM,SAAS,GAAG,SAAS,CAAC,6BAA6B,CAAC,SAAS,EAElE,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;IACpC,SAAS,CAAC,WAAW,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAExD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IACtC,IAAI,UAAU,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,0CAA0C,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import * as Ietf from \"../ietf/index.ts\";\nimport { Reader, Stream, Writer } from \"../stream.ts\";\n\n/**\n * Draft-17+ SETUP exchange. Each side opens a uni stream, writes its Setup\n * message, and reads the peer's Setup off an incoming uni stream. The two\n * halves run in parallel and the protocol is symmetric, so both `connect`\n * (client) and `accept` (server) use this same function.\n */\nexport async function exchangeSetup(\n\ttransport: WebTransport,\n\tversion: Ietf.IetfVersion,\n\timplementation: string,\n): Promise<Stream> {\n\tconst encoder = new TextEncoder();\n\tconst params = new Ietf.SetupOptions();\n\tparams.setBytes(Ietf.SetupOption.Implementation, encoder.encode(implementation));\n\tconst setupMsg = new Ietf.Setup({ parameters: params });\n\n\tconst [sent, received] = await Promise.all([\n\t\tsendSetup(transport, version, setupMsg),\n\t\treceiveSetup(transport, version),\n\t]);\n\n\treturn new Stream({\n\t\twritable: sent.writable,\n\t\treadable: received.readable,\n\t\twriter: sent.writer,\n\t\treader: received.reader,\n\t});\n}\n\nasync function sendSetup(\n\ttransport: WebTransport,\n\tversion: Ietf.IetfVersion,\n\tsetupMsg: Ietf.Setup,\n): Promise<{ writable: WritableStream<Uint8Array>; writer: Writer }> {\n\tconst writable = (await transport.createUnidirectionalStream()) as WritableStream<Uint8Array>;\n\tconst writer = new Writer(writable, version);\n\tawait writer.u53(Ietf.Setup.id); // 0x2F00 stream type\n\tawait setupMsg.encode(writer, version);\n\treturn { writable, writer };\n}\n\nasync function receiveSetup(\n\ttransport: WebTransport,\n\tversion: Ietf.IetfVersion,\n): Promise<{ readable: ReadableStream<Uint8Array>; reader: Reader }> {\n\tconst uniReader = transport.incomingUnidirectionalStreams.getReader() as ReadableStreamDefaultReader<\n\t\tReadableStream<Uint8Array>\n\t>;\n\tconst next = await uniReader.read();\n\tuniReader.releaseLock();\n\tif (next.done) throw new Error(\"no incoming uni stream for SETUP\");\n\n\tconst readable = next.value;\n\tconst reader = new Reader(readable, undefined, version);\n\n\tconst streamType = await reader.u53();\n\tif (streamType !== Ietf.Setup.id) {\n\t\tthrow new Error(`unexpected stream type on setup uni: 0x${streamType.toString(16)}`);\n\t}\n\tawait Ietf.Setup.decode(reader, version);\n\n\treturn { readable, reader };\n}\n"]}

package/connection/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./accept";
+export * from "./connect";
+export * from "./established";
+export * from "./reload";
+//# sourceMappingURL=index.d.ts.map

package/connection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/connection/index.js

@@ -0,0 +1,6 @@
+/* @ts-self-types="./index.d.ts" */
+export * from "./accept.js";
+export * from "./connect.js";
+export * from "./established.js";
+export * from "./reload.js";
+//# sourceMappingURL=index.js.map

package/connection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./accept.ts\";\nexport * from \"./connect.ts\";\nexport * from \"./established.ts\";\nexport * from \"./reload.ts\";\n"]}

package/connection/reload.d.ts

@@ -0,0 +1,47 @@
+import { Effect, type Getter, Signal } from "@norskvideo/moq-signals";
+import type * as Path from "../path";
+import { type ConnectProps, type WebSocketOptions, type WebTransportProps } from "./connect";
+import type { Established } from "./established";
+/** Exponential backoff settings for {@link Reload}'s reconnect loop. */
+export type ReloadDelay = {
+    initial: DOMHighResTimeStamp;
+    multiplier: number;
+    max: DOMHighResTimeStamp;
+    timeout?: DOMHighResTimeStamp;
+};
+/** Options for {@link Reload}: connect options plus reactive URL/enabled signals and backoff tuning. */
+export type ReloadProps = ConnectProps & {
+    enabled?: boolean | Signal<boolean>;
+    url?: URL | Signal<URL | undefined>;
+    delay?: ReloadDelay;
+};
+/** Current state of a {@link Reload} connection. */
+export type ReloadStatus = "connecting" | "connected" | "disconnected";
+/** Maintains a MoQ connection, reconnecting with exponential backoff when it drops. */
+export declare class Reload {
+    #private;
+    /** Relay URL to connect to; updating it triggers a reconnect. */
+    url: Signal<URL | undefined>;
+    /** Whether reconnecting is active. */
+    enabled: Signal<boolean>;
+    /** Current connection status. */
+    status: Signal<ReloadStatus>;
+    /** The currently established session, or undefined while disconnected. */
+    established: Signal<Established | undefined>;
+    /** The set of broadcast paths currently announced by the server, updated reactively. */
+    readonly announced: Getter<Set<Path.Valid>>;
+    /** WebTransport options applied to each connection attempt (not reactive). */
+    webtransport?: WebTransportProps;
+    /** WebSocket fallback options applied to each connection attempt (not reactive). */
+    websocket: WebSocketOptions | undefined;
+    /** Backoff settings for the reconnect loop. */
+    delay: ReloadDelay;
+    /** The reactive effect scope driving the connect loop; closed by {@link Reload.close}. */
+    signals: Effect;
+    /** Resolves when the reconnect loop stops via {@link Reload.close} or the retry timeout. */
+    closed: Promise<void>;
+    constructor(props?: ReloadProps);
+    /** Stop reconnecting, close the current connection, and resolve {@link Reload.closed}. */
+    close(): void;
+}
+//# sourceMappingURL=reload.d.ts.map

package/connection/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../src/connection/reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,KAAK,YAAY,EAAW,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG;IAGzB,OAAO,EAAE,mBAAmB,CAAC;IAI7B,UAAU,EAAE,MAAM,CAAC;IAInB,GAAG,EAAE,mBAAmB,CAAC;IAKzB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC9B,CAAC;AAEF,wGAAwG;AACxG,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG;IAGxC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAGpC,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAGpC,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAEvE,uFAAuF;AACvF,qBAAa,MAAM;;IAClB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAE7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAEzB,iCAAiC;IACjC,MAAM,uBAA4C;IAElD,0EAA0E;IAC1E,WAAW,kCAAkD;IAK7D,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAmB;IAE9D,8EAA8E;IAC9E,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAEjC,oFAAoF;IACpF,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAExC,+CAA+C;IAC/C,KAAK,EAAE,WAAW,CAAC;IAEnB,0FAA0F;IAC1F,OAAO,SAAgB;IAEvB,4FAA4F;IAC5F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAYtB,YAAY,KAAK,CAAC,EAAE,WAAW,EAiB9B;IAgGD,0FAA0F;IAC1F,KAAK,SAGJ;CACD"}