@norskvideo/moq-net 0.1.0

package/ietf/version.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Supported MoQ Transport protocol versions
+ */
+export declare const Version: {
+    /**
+     * draft-ietf-moq-transport-07
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-07.txt
+     */
+    readonly DRAFT_07: 4278190087;
+    /**
+     * draft-ietf-moq-transport-14
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-14.txt
+     */
+    readonly DRAFT_14: 4278190094;
+    /**
+     * draft-ietf-moq-transport-15
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-15.txt
+     */
+    readonly DRAFT_15: 4278190095;
+    /**
+     * draft-ietf-moq-transport-16
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-16.txt
+     */
+    readonly DRAFT_16: 4278190096;
+    /**
+     * draft-ietf-moq-transport-17
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-17.txt
+     */
+    readonly DRAFT_17: 4278190097;
+    /**
+     * draft-ietf-moq-transport-18
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-18.txt
+     */
+    readonly DRAFT_18: 4278190098;
+    /**
+     * draft-ietf-moq-transport-19
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-19.txt
+     */
+    readonly DRAFT_19: 4278190099;
+};
+export type Version = (typeof Version)[keyof typeof Version];
+export declare const ALPN: {
+    readonly DRAFT_14: "moq-00";
+    readonly DRAFT_15: "moqt-15";
+    readonly DRAFT_16: "moqt-16";
+    readonly DRAFT_17: "moqt-17";
+    readonly DRAFT_18: "moqt-18";
+    readonly DRAFT_19: "moqt-19";
+};
+/**
+ * IETF protocol versions used by the ietf/ module.
+ * Use this narrower type for version-branched encode/decode to get exhaustive matching.
+ */
+export type IetfVersion = typeof Version.DRAFT_14 | typeof Version.DRAFT_15 | typeof Version.DRAFT_16 | typeof Version.DRAFT_17 | typeof Version.DRAFT_18 | typeof Version.DRAFT_19;
+export declare function versionName(v: Version): string;
+//# sourceMappingURL=version.d.ts.map

package/ietf/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/ietf/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,OAAO;IACnB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;CACX,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAG7D,eAAO,MAAM,IAAI;aAChB,QAAQ,EAAE,QAAQ;aAClB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;CACV,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,WAAW,GACpB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAY3B,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE9C"}

package/ietf/version.js

@@ -0,0 +1,63 @@
+/* @ts-self-types="./version.d.ts" */
+/**
+ * Supported MoQ Transport protocol versions
+ */
+export const Version = {
+    /**
+     * draft-ietf-moq-transport-07
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-07.txt
+     */
+    DRAFT_07: 0xff000007,
+    /**
+     * draft-ietf-moq-transport-14
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-14.txt
+     */
+    DRAFT_14: 0xff00000e,
+    /**
+     * draft-ietf-moq-transport-15
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-15.txt
+     */
+    DRAFT_15: 0xff00000f,
+    /**
+     * draft-ietf-moq-transport-16
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-16.txt
+     */
+    DRAFT_16: 0xff000010,
+    /**
+     * draft-ietf-moq-transport-17
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-17.txt
+     */
+    DRAFT_17: 0xff000011,
+    /**
+     * draft-ietf-moq-transport-18
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-18.txt
+     */
+    DRAFT_18: 0xff000012,
+    /**
+     * draft-ietf-moq-transport-19
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-19.txt
+     */
+    DRAFT_19: 0xff000013,
+};
+// ALPN / WebTransport subprotocol identifiers for draft versions.
+export const ALPN = {
+    DRAFT_14: "moq-00",
+    DRAFT_15: "moqt-15",
+    DRAFT_16: "moqt-16",
+    DRAFT_17: "moqt-17",
+    DRAFT_18: "moqt-18",
+    DRAFT_19: "moqt-19",
+};
+const VERSION_NAMES = {
+    [Version.DRAFT_07]: "moq-transport-07",
+    [Version.DRAFT_14]: "moq-transport-14",
+    [Version.DRAFT_15]: "moq-transport-15",
+    [Version.DRAFT_16]: "moq-transport-16",
+    [Version.DRAFT_17]: "moq-transport-17",
+    [Version.DRAFT_18]: "moq-transport-18",
+    [Version.DRAFT_19]: "moq-transport-19",
+};
+export function versionName(v) {
+    return VERSION_NAMES[v] ?? `unknown(0x${v.toString(16)})`;
+}
+//# sourceMappingURL=version.js.map

package/ietf/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/ietf/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;CACX,CAAC;AAIX,kEAAkE;AAClE,MAAM,CAAC,MAAM,IAAI,GAAG;IACnB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACV,CAAC;AAcX,MAAM,aAAa,GAA2B;IAC7C,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB;CACtC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,CAAU;IACrC,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC;AAC3D,CAAC","sourcesContent":["/**\n * Supported MoQ Transport protocol versions\n */\nexport const Version = {\n\t/**\n\t * draft-ietf-moq-transport-07\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-07.txt\n\t */\n\tDRAFT_07: 0xff000007,\n\n\t/**\n\t * draft-ietf-moq-transport-14\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-14.txt\n\t */\n\tDRAFT_14: 0xff00000e,\n\n\t/**\n\t * draft-ietf-moq-transport-15\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-15.txt\n\t */\n\tDRAFT_15: 0xff00000f,\n\n\t/**\n\t * draft-ietf-moq-transport-16\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-16.txt\n\t */\n\tDRAFT_16: 0xff000010,\n\n\t/**\n\t * draft-ietf-moq-transport-17\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-17.txt\n\t */\n\tDRAFT_17: 0xff000011,\n\n\t/**\n\t * draft-ietf-moq-transport-18\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-18.txt\n\t */\n\tDRAFT_18: 0xff000012,\n\n\t/**\n\t * draft-ietf-moq-transport-19\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-19.txt\n\t */\n\tDRAFT_19: 0xff000013,\n} as const;\n\nexport type Version = (typeof Version)[keyof typeof Version];\n\n// ALPN / WebTransport subprotocol identifiers for draft versions.\nexport const ALPN = {\n\tDRAFT_14: \"moq-00\",\n\tDRAFT_15: \"moqt-15\",\n\tDRAFT_16: \"moqt-16\",\n\tDRAFT_17: \"moqt-17\",\n\tDRAFT_18: \"moqt-18\",\n\tDRAFT_19: \"moqt-19\",\n} as const;\n\n/**\n * IETF protocol versions used by the ietf/ module.\n * Use this narrower type for version-branched encode/decode to get exhaustive matching.\n */\nexport type IetfVersion =\n\t| typeof Version.DRAFT_14\n\t| typeof Version.DRAFT_15\n\t| typeof Version.DRAFT_16\n\t| typeof Version.DRAFT_17\n\t| typeof Version.DRAFT_18\n\t| typeof Version.DRAFT_19;\n\nconst VERSION_NAMES: Record<number, string> = {\n\t[Version.DRAFT_07]: \"moq-transport-07\",\n\t[Version.DRAFT_14]: \"moq-transport-14\",\n\t[Version.DRAFT_15]: \"moq-transport-15\",\n\t[Version.DRAFT_16]: \"moq-transport-16\",\n\t[Version.DRAFT_17]: \"moq-transport-17\",\n\t[Version.DRAFT_18]: \"moq-transport-18\",\n\t[Version.DRAFT_19]: \"moq-transport-19\",\n};\n\nexport function versionName(v: Version): string {\n\treturn VERSION_NAMES[v] ?? `unknown(0x${v.toString(16)})`;\n}\n"]}

package/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MoQ networking layer for browsers: connect to a relay, then publish and consume
+ * broadcasts, tracks, groups, and frames over WebTransport (or a WebSocket fallback).
+ *
+ * @module
+ */
+/** Re-export of {@link https://jsr.io/@moq/signals | @moq/signals}, the reactive primitives used throughout this package. */
+export * as Signals from "@norskvideo/moq-signals";
+export * from "./announced";
+export * from "./bandwidth";
+export * from "./broadcast";
+/** Connection helpers: connect to or accept a MoQ session and reconnect on failure. */
+export * as Connection from "./connection/index";
+export * from "./group";
+/** Broadcast path utilities with delimiter-aware prefix matching. */
+export * as Path from "./path";
+/** Branded time types (nanoseconds, microseconds, milliseconds, seconds) with conversions. */
+export * as Time from "./time";
+export * from "./track";
+/** QUIC variable-length integer encoding and decoding. */
+export * as Varint from "./varint";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6HAA6H;AAC7H,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,uFAAuF;AACvF,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,cAAc,YAAY,CAAC;AAC3B,qEAAqE;AACrE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,8FAA8F;AAC9F,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,0DAA0D;AAC1D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/index.js

@@ -0,0 +1,23 @@
+/* @ts-self-types="./index.d.ts" */
+/**
+ * MoQ networking layer for browsers: connect to a relay, then publish and consume
+ * broadcasts, tracks, groups, and frames over WebTransport (or a WebSocket fallback).
+ *
+ * @module
+ */
+import * as Signals_1 from "@norskvideo/moq-signals";
+export { Signals_1 as Signals };
+export * from "./announced.js";
+export * from "./bandwidth.js";
+export * from "./broadcast.js";
+import * as Connection_1 from "./connection/index.js";
+export { Connection_1 as Connection };
+export * from "./group.js";
+import * as Path_1 from "./path.js";
+export { Path_1 as Path };
+import * as Time_1 from "./time.js";
+export { Time_1 as Time };
+export * from "./track.js";
+import * as Varint_1 from "./varint.js";
+export { Varint_1 as Varint };
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;2BAGsB,cAAc;sBAA3B,OAAO;AACnB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;8BAEH,uBAAuB;yBAAvC,UAAU;AACtB,cAAc,YAAY,CAAC;wBAEL,WAAW;mBAArB,IAAI;wBAEM,WAAW;mBAArB,IAAI;AAChB,cAAc,YAAY,CAAC;0BAEH,aAAa;qBAAzB,MAAM","sourcesContent":["/**\n * MoQ networking layer for browsers: connect to a relay, then publish and consume\n * broadcasts, tracks, groups, and frames over WebTransport (or a WebSocket fallback).\n *\n * @module\n */\n\n/** Re-export of {@link https://jsr.io/@moq/signals | @moq/signals}, the reactive primitives used throughout this package. */\nexport * as Signals from \"@moq/signals\";\nexport * from \"./announced.ts\";\nexport * from \"./bandwidth.ts\";\nexport * from \"./broadcast.ts\";\n/** Connection helpers: connect to or accept a MoQ session and reconnect on failure. */\nexport * as Connection from \"./connection/index.ts\";\nexport * from \"./group.ts\";\n/** Broadcast path utilities with delimiter-aware prefix matching. */\nexport * as Path from \"./path.ts\";\n/** Branded time types (nanoseconds, microseconds, milliseconds, seconds) with conversions. */\nexport * as Time from \"./time.ts\";\nexport * from \"./track.ts\";\n/** QUIC variable-length integer encoding and decoding. */\nexport * as Varint from \"./varint.ts\";\n"]}

package/integration.test.d.ts

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

package/integration.test.d.ts.map

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

package/integration.test.js

@@ -0,0 +1,90 @@
+/* @ts-self-types="./integration.test.d.ts" */
+import { expect, test } from "bun:test";
+import { Broadcast } from "./broadcast.js";
+import { accept, connect } from "./connection/index.js";
+import * as Ietf from "./ietf/index.js";
+import * as Lite from "./lite/index.js";
+import { createMockTransportPair } from "./mock.js";
+import * as Path from "./path.js";
+const url = new URL("https://localhost:4443/test");
+async function runPublishSubscribeFlow(protocol, version) {
+    const pair = createMockTransportPair(protocol);
+    const [client, server] = await Promise.all([
+        connect(url, { transport: pair.client }),
+        accept(pair.server, url, version !== undefined ? { version } : undefined),
+    ]);
+    // Server publishes a broadcast
+    const broadcast = new Broadcast();
+    server.publish(Path.from("test"), broadcast);
+    // Client discovers announced broadcast
+    const announced = client.announced();
+    const entry = await announced.next();
+    if (!entry)
+        throw new Error("expected entry");
+    expect(entry.path).toBe("test");
+    expect(entry.active).toBe(true);
+    // Client consumes the broadcast and subscribes to a track
+    const remote = client.consume(Path.from("test"));
+    const track = remote.subscribe("video", 0);
+    // Server handles the subscription request
+    const req = await broadcast.requested();
+    if (!req)
+        throw new Error("expected req");
+    expect(req.track.name).toBe("video");
+    // Server writes data
+    req.track.writeString("hello");
+    // Client reads data
+    const data = await track.readString();
+    expect(data).toBe("hello");
+    // Cleanup
+    req.track.close();
+    broadcast.close();
+    announced.close();
+    remote.close();
+    client.close();
+    server.close();
+}
+test("integration: lite draft-01", async () => {
+    await runPublishSubscribeFlow("", Lite.Version.DRAFT_01);
+});
+test("integration: lite draft-02", async () => {
+    await runPublishSubscribeFlow("", Lite.Version.DRAFT_02);
+});
+test("integration: lite draft-03", async () => {
+    await runPublishSubscribeFlow(Lite.ALPN_03);
+});
+test("integration: ietf draft-14", async () => {
+    await runPublishSubscribeFlow("", Ietf.Version.DRAFT_14);
+});
+test("integration: ietf draft-15", async () => {
+    await runPublishSubscribeFlow(Ietf.ALPN.DRAFT_15);
+});
+test("integration: ietf draft-16", async () => {
+    await runPublishSubscribeFlow(Ietf.ALPN.DRAFT_16);
+});
+test("integration: ietf draft-17", async () => {
+    await runPublishSubscribeFlow(Ietf.ALPN.DRAFT_17);
+});
+test("integration: ietf draft-18", async () => {
+    await runPublishSubscribeFlow(Ietf.ALPN.DRAFT_18);
+});
+test("integration: ietf draft-19", async () => {
+    await runPublishSubscribeFlow(Ietf.ALPN.DRAFT_19);
+});
+test("integration: subscribe to non-existent broadcast", async () => {
+    const pair = createMockTransportPair("");
+    const [client, server] = await Promise.all([
+        connect(url, { transport: pair.client }),
+        accept(pair.server, url, { version: Ietf.Version.DRAFT_14 }),
+    ]);
+    // Client tries to consume a broadcast that nobody is publishing
+    const remote = client.consume(Path.from("nonexistent"));
+    const track = remote.subscribe("video", 0);
+    // Reading should eventually error since the broadcast doesn't exist
+    await expect((async () => {
+        await track.readString();
+    })()).rejects.toThrow();
+    client.close();
+    server.close();
+});
+//# sourceMappingURL=integration.test.js.map

package/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../src/integration.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"bun:test\";\nimport { Broadcast } from \"./broadcast.ts\";\nimport { accept, connect } from \"./connection/index.ts\";\nimport * as Ietf from \"./ietf/index.ts\";\nimport * as Lite from \"./lite/index.ts\";\nimport { createMockTransportPair } from \"./mock.ts\";\nimport * as Path from \"./path.ts\";\n\nconst url = new URL(\"https://localhost:4443/test\");\n\nasync function runPublishSubscribeFlow(protocol: string, version?: number) {\n\tconst pair = createMockTransportPair(protocol);\n\n\tconst [client, server] = await Promise.all([\n\t\tconnect(url, { transport: pair.client }),\n\t\taccept(pair.server, url, version !== undefined ? { version } : undefined),\n\t]);\n\n\t// Server publishes a broadcast\n\tconst broadcast = new Broadcast();\n\tserver.publish(Path.from(\"test\"), broadcast);\n\n\t// Client discovers announced broadcast\n\tconst announced = client.announced();\n\tconst entry = await announced.next();\n\tif (!entry) throw new Error(\"expected entry\");\n\texpect(entry.path).toBe(\"test\" as Path.Valid);\n\texpect(entry.active).toBe(true);\n\n\t// Client consumes the broadcast and subscribes to a track\n\tconst remote = client.consume(Path.from(\"test\"));\n\tconst track = remote.subscribe(\"video\", 0);\n\n\t// Server handles the subscription request\n\tconst req = await broadcast.requested();\n\tif (!req) throw new Error(\"expected req\");\n\texpect(req.track.name).toBe(\"video\");\n\n\t// Server writes data\n\treq.track.writeString(\"hello\");\n\n\t// Client reads data\n\tconst data = await track.readString();\n\texpect(data).toBe(\"hello\");\n\n\t// Cleanup\n\treq.track.close();\n\tbroadcast.close();\n\tannounced.close();\n\tremote.close();\n\tclient.close();\n\tserver.close();\n}\n\ntest(\"integration: lite draft-01\", async () => {\n\tawait runPublishSubscribeFlow(\"\", Lite.Version.DRAFT_01);\n});\n\ntest(\"integration: lite draft-02\", async () => {\n\tawait runPublishSubscribeFlow(\"\", Lite.Version.DRAFT_02);\n});\n\ntest(\"integration: lite draft-03\", async () => {\n\tawait runPublishSubscribeFlow(Lite.ALPN_03);\n});\n\ntest(\"integration: ietf draft-14\", async () => {\n\tawait runPublishSubscribeFlow(\"\", Ietf.Version.DRAFT_14);\n});\n\ntest(\"integration: ietf draft-15\", async () => {\n\tawait runPublishSubscribeFlow(Ietf.ALPN.DRAFT_15);\n});\n\ntest(\"integration: ietf draft-16\", async () => {\n\tawait runPublishSubscribeFlow(Ietf.ALPN.DRAFT_16);\n});\n\ntest(\"integration: ietf draft-17\", async () => {\n\tawait runPublishSubscribeFlow(Ietf.ALPN.DRAFT_17);\n});\n\ntest(\"integration: ietf draft-18\", async () => {\n\tawait runPublishSubscribeFlow(Ietf.ALPN.DRAFT_18);\n});\n\ntest(\"integration: ietf draft-19\", async () => {\n\tawait runPublishSubscribeFlow(Ietf.ALPN.DRAFT_19);\n});\n\ntest(\"integration: subscribe to non-existent broadcast\", async () => {\n\tconst pair = createMockTransportPair(\"\");\n\n\tconst [client, server] = await Promise.all([\n\t\tconnect(url, { transport: pair.client }),\n\t\taccept(pair.server, url, { version: Ietf.Version.DRAFT_14 }),\n\t]);\n\n\t// Client tries to consume a broadcast that nobody is publishing\n\tconst remote = client.consume(Path.from(\"nonexistent\"));\n\tconst track = remote.subscribe(\"video\", 0);\n\n\t// Reading should eventually error since the broadcast doesn't exist\n\tawait expect(\n\t\t(async () => {\n\t\t\tawait track.readString();\n\t\t})(),\n\t).rejects.toThrow();\n\n\tclient.close();\n\tserver.close();\n});\n"]}

package/lite/announce.d.ts

@@ -0,0 +1,35 @@
+import * as Path from "../path";
+import type { Reader, Writer } from "../stream";
+import { type Origin } from "./origin";
+import { Version } from "./version";
+export declare const MAX_HOPS = 32;
+export declare class Announce {
+    #private;
+    suffix: Path.Valid;
+    active: boolean;
+    hops: Origin[];
+    constructor(props: {
+        suffix: Path.Valid;
+        active: boolean;
+        hops?: Origin[];
+    });
+    encode(w: Writer, version: Version): Promise<void>;
+    static decode(r: Reader, version: Version): Promise<Announce>;
+    static decodeMaybe(r: Reader, version: Version): Promise<Announce | undefined>;
+}
+export declare class AnnounceInterest {
+    #private;
+    prefix: Path.Valid;
+    excludeHop: bigint;
+    constructor(prefix: Path.Valid, excludeHop?: bigint);
+    encode(w: Writer, version: Version): Promise<void>;
+    static decode(r: Reader, version: Version): Promise<AnnounceInterest>;
+}
+export declare class AnnounceInit {
+    #private;
+    suffixes: Path.Valid[];
+    constructor(paths: Path.Valid[]);
+    encode(w: Writer, version: Version): Promise<void>;
+    static decode(r: Reader, version: Version): Promise<AnnounceInit>;
+}
+//# sourceMappingURL=announce.d.ts.map

package/lite/announce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.d.ts","sourceRoot":"","sources":["../../src/lite/announce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAKvC,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B,qBAAa,QAAQ;;IACpB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,YAAY,KAAK,EAAE;QAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EAO1E;IAwDK,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD;IAED,OAAa,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAElE;IAED,OAAa,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAEnF;CACD;AAED,qBAAa,gBAAgB;;IAC5B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;IAGnB,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAE,MAAW,EAGtD;IA+BK,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD;IAED,OAAa,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE1E;CACD;AAKD,qBAAa,YAAY;;IACxB,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAEvB,YAAY,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAE9B;IA4BK,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvD;IAED,OAAa,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAGtE;CACD"}

package/lite/announce.js

@@ -0,0 +1,166 @@
+/* @ts-self-types="./announce.d.ts" */
+import * as Path from "../path.js";
+import * as Message from "./message.js";
+import { OriginSchema } from "./origin.js";
+import { Version } from "./version.js";
+// Must match the MAX_HOPS in Rust's model/origin.rs. Broadcasts with longer
+// hop chains are rejected; this keeps loop-detection bounded and rejects
+// pathological announcements across clusters with unbounded forwarding.
+export const MAX_HOPS = 32;
+export class Announce {
+    suffix;
+    active;
+    hops;
+    constructor(props) {
+        this.suffix = props.suffix;
+        this.active = props.active;
+        this.hops = props.hops ?? [];
+        if (this.hops.length > MAX_HOPS) {
+            throw new Error(`hop count ${this.hops.length} exceeds maximum ${MAX_HOPS}`);
+        }
+    }
+    async #encode(w, version) {
+        await w.bool(this.active);
+        await w.string(Path.encode(this.suffix));
+        switch (version) {
+            case Version.DRAFT_01:
+            case Version.DRAFT_02:
+                break;
+            case Version.DRAFT_03:
+                await w.u53(this.hops.length);
+                break;
+            default:
+                // Lite04+: hop count + individual Origin varints.
+                await w.u53(this.hops.length);
+                for (const origin of this.hops) {
+                    await w.u62(origin);
+                }
+                break;
+        }
+    }
+    static async #decode(r, version) {
+        const active = await r.bool();
+        const suffix = Path.decode(await r.string());
+        let hops = [];
+        switch (version) {
+            case Version.DRAFT_01:
+            case Version.DRAFT_02:
+                break;
+            case Version.DRAFT_03: {
+                const count = await r.u53();
+                if (count > MAX_HOPS)
+                    throw new Error(`hop count ${count} exceeds maximum ${MAX_HOPS}`);
+                // Lite03 carries only a hop count, not individual ids. Fill with
+                // the zero placeholder (OriginSchema accepts 0 as valid on-wire).
+                const placeholder = OriginSchema.parse(0n);
+                hops = new Array(count).fill(placeholder);
+                break;
+            }
+            default: {
+                // Lite04+: hop count + individual Origin varints.
+                const count = await r.u53();
+                if (count > MAX_HOPS)
+                    throw new Error(`hop count ${count} exceeds maximum ${MAX_HOPS}`);
+                hops = [];
+                for (let i = 0; i < count; i++) {
+                    hops.push(OriginSchema.parse(await r.u62()));
+                }
+                break;
+            }
+        }
+        return new Announce({ suffix, active, hops });
+    }
+    async encode(w, version) {
+        return Message.encode(w, (w) => this.#encode(w, version));
+    }
+    static async decode(r, version) {
+        return Message.decode(r, (r) => Announce.#decode(r, version));
+    }
+    static async decodeMaybe(r, version) {
+        return Message.decodeMaybe(r, (r) => Announce.#decode(r, version));
+    }
+}
+export class AnnounceInterest {
+    prefix;
+    // 62-bit Origin id of the peer asking for announces. Zero means "no exclusion".
+    // Must be a bigint: peer origins are up to 62 bits and overflow u53.
+    excludeHop;
+    constructor(prefix, excludeHop = 0n) {
+        this.prefix = prefix;
+        this.excludeHop = excludeHop;
+    }
+    async #encode(w, version) {
+        await w.string(Path.encode(this.prefix));
+        switch (version) {
+            case Version.DRAFT_01:
+            case Version.DRAFT_02:
+            case Version.DRAFT_03:
+                break;
+            default:
+                // Lite04+: exclude_hop field (u62 varint).
+                await w.u62(this.excludeHop);
+                break;
+        }
+    }
+    static async #decode(r, version) {
+        const prefix = Path.decode(await r.string());
+        let excludeHop = 0n;
+        switch (version) {
+            case Version.DRAFT_01:
+            case Version.DRAFT_02:
+            case Version.DRAFT_03:
+                break;
+            default:
+                excludeHop = await r.u62();
+                break;
+        }
+        return new AnnounceInterest(prefix, excludeHop);
+    }
+    async encode(w, version) {
+        return Message.encode(w, (w) => this.#encode(w, version));
+    }
+    static async decode(r, version) {
+        return Message.decode(r, (r) => AnnounceInterest.#decode(r, version));
+    }
+}
+/// Sent after setup to communicate the initially announced paths.
+///
+/// Used by Draft01/Draft02 only. Draft03+ uses individual Announce messages instead.
+export class AnnounceInit {
+    suffixes;
+    constructor(paths) {
+        this.suffixes = paths;
+    }
+    static #guard(version) {
+        switch (version) {
+            case Version.DRAFT_01:
+            case Version.DRAFT_02:
+                break;
+            default:
+                throw new Error("announce init not supported for this version");
+        }
+    }
+    async #encode(w) {
+        await w.u53(this.suffixes.length);
+        for (const path of this.suffixes) {
+            await w.string(Path.encode(path));
+        }
+    }
+    static async #decode(r) {
+        const count = await r.u53();
+        const suffixes = [];
+        for (let i = 0; i < count; i++) {
+            suffixes.push(Path.decode(await r.string()));
+        }
+        return new AnnounceInit(suffixes);
+    }
+    async encode(w, version) {
+        AnnounceInit.#guard(version);
+        return Message.encode(w, this.#encode.bind(this));
+    }
+    static async decode(r, version) {
+        AnnounceInit.#guard(version);
+        return Message.decode(r, AnnounceInit.#decode);
+    }
+}
+//# sourceMappingURL=announce.js.map

package/lite/announce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.js","sourceRoot":"","sources":["../../src/lite/announce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAe,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B,MAAM,OAAO,QAAQ;IACpB,MAAM,CAAa;IACnB,MAAM,CAAU;IAChB,IAAI,CAAW;IAEf,YAAY,KAA+D;QAC1E,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,oBAAoB,QAAQ,EAAE,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,CAAS,EAAE,OAAgB;QACxC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEzC,QAAQ,OAAO,EAAE,CAAC;YACjB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ;gBACpB,MAAM;YACP,KAAK,OAAO,CAAC,QAAQ;gBACpB,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9B,MAAM;YACP;gBACC,kDAAkD;gBAClD,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAChC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACrB,CAAC;gBACD,MAAM;QACR,CAAC;IACF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAS,EAAE,OAAgB;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7C,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,QAAQ,OAAO,EAAE,CAAC;YACjB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ;gBACpB,MAAM;YACP,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;gBAC5B,IAAI,KAAK,GAAG,QAAQ;oBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,oBAAoB,QAAQ,EAAE,CAAC,CAAC;gBACxF,iEAAiE;gBACjE,kEAAkE;gBAClE,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3C,IAAI,GAAG,IAAI,KAAK,CAAS,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAClD,MAAM;YACP,CAAC;YACD,SAAS,CAAC;gBACT,kDAAkD;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;gBAC5B,IAAI,KAAK,GAAG,QAAQ;oBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,oBAAoB,QAAQ,EAAE,CAAC,CAAC;gBACxF,IAAI,GAAG,EAAE,CAAC;gBACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;oBAChC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM;YACP,CAAC;QACF,CAAC;QAED,OAAO,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,OAAgB;QACvC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,OAAgB;QAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAS,EAAE,OAAgB;QACnD,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;CACD;AAED,MAAM,OAAO,gBAAgB;IAC5B,MAAM,CAAa;IACnB,gFAAgF;IAChF,qEAAqE;IACrE,UAAU,CAAS;IAEnB,YAAY,MAAkB,EAAE,UAAU,GAAW,EAAE;QACtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,CAAS,EAAE,OAAgB;QACxC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,QAAQ,OAAO,EAAE,CAAC;YACjB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ;gBACpB,MAAM;YACP;gBACC,2CAA2C;gBAC3C,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC7B,MAAM;QACR,CAAC;IACF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAS,EAAE,OAAgB;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,QAAQ,OAAO,EAAE,CAAC;YACjB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ;gBACpB,MAAM;YACP;gBACC,UAAU,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;gBAC3B,MAAM;QACR,CAAC;QACD,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,OAAgB;QACvC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,OAAgB;QAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;CACD;AAED,kEAAkE;AAClE,GAAG;AACH,qFAAqF;AACrF,MAAM,OAAO,YAAY;IACxB,QAAQ,CAAe;IAEvB,YAAY,KAAmB;QAC9B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAgB;QAC7B,QAAQ,OAAO,EAAE,CAAC;YACjB,KAAK,OAAO,CAAC,QAAQ,CAAC;YACtB,KAAK,OAAO,CAAC,QAAQ;gBACpB,MAAM;YACP;gBACC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,CAAS;QACtB,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAS;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,OAAgB;QACvC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,OAAgB;QAC9C,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACD","sourcesContent":["import * as Path from \"../path.ts\";\nimport type { Reader, Writer } from \"../stream.ts\";\nimport * as Message from \"./message.ts\";\nimport { type Origin, OriginSchema } from \"./origin.ts\";\nimport { Version } from \"./version.ts\";\n\n// Must match the MAX_HOPS in Rust's model/origin.rs. Broadcasts with longer\n// hop chains are rejected; this keeps loop-detection bounded and rejects\n// pathological announcements across clusters with unbounded forwarding.\nexport const MAX_HOPS = 32;\n\nexport class Announce {\n\tsuffix: Path.Valid;\n\tactive: boolean;\n\thops: Origin[];\n\n\tconstructor(props: { suffix: Path.Valid; active: boolean; hops?: Origin[] }) {\n\t\tthis.suffix = props.suffix;\n\t\tthis.active = props.active;\n\t\tthis.hops = props.hops ?? [];\n\t\tif (this.hops.length > MAX_HOPS) {\n\t\t\tthrow new Error(`hop count ${this.hops.length} exceeds maximum ${MAX_HOPS}`);\n\t\t}\n\t}\n\n\tasync #encode(w: Writer, version: Version) {\n\t\tawait w.bool(this.active);\n\t\tawait w.string(Path.encode(this.suffix));\n\n\t\tswitch (version) {\n\t\t\tcase Version.DRAFT_01:\n\t\t\tcase Version.DRAFT_02:\n\t\t\t\tbreak;\n\t\t\tcase Version.DRAFT_03:\n\t\t\t\tawait w.u53(this.hops.length);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Lite04+: hop count + individual Origin varints.\n\t\t\t\tawait w.u53(this.hops.length);\n\t\t\t\tfor (const origin of this.hops) {\n\t\t\t\t\tawait w.u62(origin);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\tstatic async #decode(r: Reader, version: Version): Promise<Announce> {\n\t\tconst active = await r.bool();\n\t\tconst suffix = Path.decode(await r.string());\n\n\t\tlet hops: Origin[] = [];\n\t\tswitch (version) {\n\t\t\tcase Version.DRAFT_01:\n\t\t\tcase Version.DRAFT_02:\n\t\t\t\tbreak;\n\t\t\tcase Version.DRAFT_03: {\n\t\t\t\tconst count = await r.u53();\n\t\t\t\tif (count > MAX_HOPS) throw new Error(`hop count ${count} exceeds maximum ${MAX_HOPS}`);\n\t\t\t\t// Lite03 carries only a hop count, not individual ids. Fill with\n\t\t\t\t// the zero placeholder (OriginSchema accepts 0 as valid on-wire).\n\t\t\t\tconst placeholder = OriginSchema.parse(0n);\n\t\t\t\thops = new Array<Origin>(count).fill(placeholder);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\t// Lite04+: hop count + individual Origin varints.\n\t\t\t\tconst count = await r.u53();\n\t\t\t\tif (count > MAX_HOPS) throw new Error(`hop count ${count} exceeds maximum ${MAX_HOPS}`);\n\t\t\t\thops = [];\n\t\t\t\tfor (let i = 0; i < count; i++) {\n\t\t\t\t\thops.push(OriginSchema.parse(await r.u62()));\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\treturn new Announce({ suffix, active, hops });\n\t}\n\n\tasync encode(w: Writer, version: Version): Promise<void> {\n\t\treturn Message.encode(w, (w) => this.#encode(w, version));\n\t}\n\n\tstatic async decode(r: Reader, version: Version): Promise<Announce> {\n\t\treturn Message.decode(r, (r) => Announce.#decode(r, version));\n\t}\n\n\tstatic async decodeMaybe(r: Reader, version: Version): Promise<Announce | undefined> {\n\t\treturn Message.decodeMaybe(r, (r) => Announce.#decode(r, version));\n\t}\n}\n\nexport class AnnounceInterest {\n\tprefix: Path.Valid;\n\t// 62-bit Origin id of the peer asking for announces. Zero means \"no exclusion\".\n\t// Must be a bigint: peer origins are up to 62 bits and overflow u53.\n\texcludeHop: bigint;\n\n\tconstructor(prefix: Path.Valid, excludeHop: bigint = 0n) {\n\t\tthis.prefix = prefix;\n\t\tthis.excludeHop = excludeHop;\n\t}\n\n\tasync #encode(w: Writer, version: Version) {\n\t\tawait w.string(Path.encode(this.prefix));\n\t\tswitch (version) {\n\t\t\tcase Version.DRAFT_01:\n\t\t\tcase Version.DRAFT_02:\n\t\t\tcase Version.DRAFT_03:\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Lite04+: exclude_hop field (u62 varint).\n\t\t\t\tawait w.u62(this.excludeHop);\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\tstatic async #decode(r: Reader, version: Version): Promise<AnnounceInterest> {\n\t\tconst prefix = Path.decode(await r.string());\n\t\tlet excludeHop = 0n;\n\t\tswitch (version) {\n\t\t\tcase Version.DRAFT_01:\n\t\t\tcase Version.DRAFT_02:\n\t\t\tcase Version.DRAFT_03:\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\texcludeHop = await r.u62();\n\t\t\t\tbreak;\n\t\t}\n\t\treturn new AnnounceInterest(prefix, excludeHop);\n\t}\n\n\tasync encode(w: Writer, version: Version): Promise<void> {\n\t\treturn Message.encode(w, (w) => this.#encode(w, version));\n\t}\n\n\tstatic async decode(r: Reader, version: Version): Promise<AnnounceInterest> {\n\t\treturn Message.decode(r, (r) => AnnounceInterest.#decode(r, version));\n\t}\n}\n\n/// Sent after setup to communicate the initially announced paths.\n///\n/// Used by Draft01/Draft02 only. Draft03+ uses individual Announce messages instead.\nexport class AnnounceInit {\n\tsuffixes: Path.Valid[];\n\n\tconstructor(paths: Path.Valid[]) {\n\t\tthis.suffixes = paths;\n\t}\n\n\tstatic #guard(version: Version) {\n\t\tswitch (version) {\n\t\t\tcase Version.DRAFT_01:\n\t\t\tcase Version.DRAFT_02:\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new Error(\"announce init not supported for this version\");\n\t\t}\n\t}\n\n\tasync #encode(w: Writer) {\n\t\tawait w.u53(this.suffixes.length);\n\t\tfor (const path of this.suffixes) {\n\t\t\tawait w.string(Path.encode(path));\n\t\t}\n\t}\n\n\tstatic async #decode(r: Reader): Promise<AnnounceInit> {\n\t\tconst count = await r.u53();\n\t\tconst suffixes: Path.Valid[] = [];\n\t\tfor (let i = 0; i < count; i++) {\n\t\t\tsuffixes.push(Path.decode(await r.string()));\n\t\t}\n\t\treturn new AnnounceInit(suffixes);\n\t}\n\n\tasync encode(w: Writer, version: Version): Promise<void> {\n\t\tAnnounceInit.#guard(version);\n\t\treturn Message.encode(w, this.#encode.bind(this));\n\t}\n\n\tstatic async decode(r: Reader, version: Version): Promise<AnnounceInit> {\n\t\tAnnounceInit.#guard(version);\n\t\treturn Message.decode(r, AnnounceInit.#decode);\n\t}\n}\n"]}

package/lite/connection.d.ts

@@ -0,0 +1,47 @@
+import { Signal } from "@norskvideo/moq-signals";
+import type { Announced } from "../announced";
+import { type Bandwidth } from "../bandwidth";
+import type { Broadcast } from "../broadcast";
+import type { Established } from "../connection/established";
+import * as Path from "../path";
+import { Stream } from "../stream";
+import type * as Time from "../time";
+import { type Origin } from "./origin";
+import { Version } from "./version";
+/**
+ * Represents a connection to a MoQ server.
+ *
+ * @public
+ */
+export declare class Connection implements Established {
+    #private;
+    readonly url: URL;
+    readonly version: string;
+    /** Estimated send bitrate from the congestion controller. */
+    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>;
+    /** Random per-connection origin id. Shared by Publisher (for outbound hop
+     * chains) and Subscriber (available for optional self-filtering on announces). */
+    readonly origin: Origin;
+    /**
+     * Creates a new Connection instance.
+     * @param url - The URL of the connection
+     * @param quic - The WebTransport session
+     * @param session - The session stream
+     *
+     * @internal
+     */
+    constructor(url: URL, quic: WebTransport, version: Version, session?: Stream);
+    /**
+     * Closes the connection.
+     */
+    close(): void;
+    publish(path: Path.Valid, broadcast: Broadcast): void;
+    announced(prefix?: Path.Valid): Announced;
+    consume(broadcast: Path.Valid): Broadcast;
+    get closed(): Promise<void>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/lite/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/lite/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,EAAwB,MAAM,EAAU,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AAIxC,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,aAAa,CAAC;AAQxD,OAAO,EAAkB,OAAO,EAAe,MAAM,cAAc,CAAC;AAIpE;;;;GAIG;AACH,qBAAa,UAAW,YAAW,WAAW;;IAE7C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAGlB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAiBzB,6DAA6D;IAC7D,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;sFACkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;;OAOG;IACH,YAAY,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EA2B3E;IAED;;OAEG;IACH,KAAK,SAUJ;IA2BD,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,QAE7C;IAED,SAAS,CAAC,MAAM,aAAe,GAAG,SAAS,CAE1C;IAED,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,SAAS,CAExC;IA2HD,IAAI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACD"}