@norskvideo/moq-net 0.1.8 → 0.2.1

package/ietf/version.d.ts.map

@@ -1 +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;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;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,GACvB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAa3B,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE9C"}
+{"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;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;aACH,QAAQ,EAAE,UAAU;IAEpB;;OAEG;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;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,GACvB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,GACvB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAe3B,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE9C"}

package/ietf/version.js

@@ -43,6 +43,15 @@ export const Version = {
      * https://www.ietf.org/archive/id/draft-ietf-moq-transport-20.txt
      */
     DRAFT_20: 0xff000014,
+    /**
+     * draft-ietf-moq-transport-21
+     * https://www.ietf.org/archive/id/draft-ietf-moq-transport-21.txt
+     */
+    DRAFT_21: 0xff000015,
+    /**
+     * draft-ietf-moq-transport-22 (unpublished, wire-identical to draft-21)
+     */
+    DRAFT_22: 0xff000016,
 };
 // ALPN / WebTransport subprotocol identifiers for draft versions.
 export const ALPN = {
@@ -53,6 +62,8 @@ export const ALPN = {
     DRAFT_18: "moqt-18",
     DRAFT_19: "moqt-19",
     DRAFT_20: "moqt-20",
+    DRAFT_21: "moqt-21",
+    DRAFT_22: "moqt-22",
 };
 const VERSION_NAMES = {
     [Version.DRAFT_07]: "moq-transport-07",
@@ -63,6 +74,8 @@ const VERSION_NAMES = {
     [Version.DRAFT_18]: "moq-transport-18",
     [Version.DRAFT_19]: "moq-transport-19",
     [Version.DRAFT_20]: "moq-transport-20",
+    [Version.DRAFT_21]: "moq-transport-21",
+    [Version.DRAFT_22]: "moq-transport-22",
 };
 export function versionName(v) {
     return VERSION_NAMES[v] ?? `unknown(0x${v.toString(16)})`;

package/ietf/version.js.map

@@ -1 +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;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;IACnB,QAAQ,EAAE,SAAS;CACV,CAAC;AAeX,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;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\n\t/**\n\t * draft-ietf-moq-transport-20\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-20.txt\n\t */\n\tDRAFT_20: 0xff000014,\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\tDRAFT_20: \"moqt-20\",\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\t| typeof Version.DRAFT_20;\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\t[Version.DRAFT_20]: \"moq-transport-20\",\n};\n\nexport function versionName(v: Version): string {\n\treturn VERSION_NAMES[v] ?? `unknown(0x${v.toString(16)})`;\n}\n"]}
+{"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;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;OAEG;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;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACV,CAAC;AAiBX,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;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\n\t/**\n\t * draft-ietf-moq-transport-20\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-20.txt\n\t */\n\tDRAFT_20: 0xff000014,\n\n\t/**\n\t * draft-ietf-moq-transport-21\n\t * https://www.ietf.org/archive/id/draft-ietf-moq-transport-21.txt\n\t */\n\tDRAFT_21: 0xff000015,\n\n\t/**\n\t * draft-ietf-moq-transport-22 (unpublished, wire-identical to draft-21)\n\t */\n\tDRAFT_22: 0xff000016,\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\tDRAFT_20: \"moqt-20\",\n\tDRAFT_21: \"moqt-21\",\n\tDRAFT_22: \"moqt-22\",\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\t| typeof Version.DRAFT_20\n\t| typeof Version.DRAFT_21\n\t| typeof Version.DRAFT_22;\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\t[Version.DRAFT_20]: \"moq-transport-20\",\n\t[Version.DRAFT_21]: \"moq-transport-21\",\n\t[Version.DRAFT_22]: \"moq-transport-22\",\n};\n\nexport function versionName(v: Version): string {\n\treturn VERSION_NAMES[v] ?? `unknown(0x${v.toString(16)})`;\n}\n"]}

package/index.d.ts

@@ -7,21 +7,26 @@
 /** 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";
 /** Broadcast announcement streams. */
-export * as Announce from "./announced";
+export * as Announce from "./announce";
+/** Send-side bandwidth estimates split among the tracks sharing a connection. */
+export * as Bandwidth from "./bandwidth_api";
 /** Broadcast role handles. */
 export * as Broadcast from "./broadcast";
-/** Connection helpers: connect to or accept a MoQ session and reconnect on failure. */
-export * as Connection from "./connection/index";
-/** The error a read or write rejects with when the peer resets a stream, carrying its code. */
-export { RemoteError } from "./error";
+/** A reconnecting, shareable handle on a MoQ session. */
+export { Connection } from "./connection/index";
+export { SessionCode, StreamCode } from "./error";
+/** Session and stream errors, each carrying a code from its own registry. */
+export * as Error from "./errors";
 /** Group role handles and frame helpers. */
 export * as Group from "./group";
-/** Broadcast path utilities with delimiter-aware prefix matching. */
+/** Broadcast routing tables, independent of any connection. */
+export * as Origin from "./origin";
+/** Broadcast path utilities with delimiter-aware prefix matching. Path patterns are re-exported from `@norskvideo/moq-pattern`. */
 export * as Path from "./path";
 /** Branded time types (nanoseconds, microseconds, milliseconds, seconds) with conversions. */
 export * as Time from "./time";
 /** Track role handles. */
 export * as Track from "./track";
-/** QUIC variable-length integer encoding and decoding. */
+/** Varint encoding and decoding, in QUIC's format and moq-transport's leading-ones format. */
 export * as Varint from "./varint";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +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,sCAAsC;AACtC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,8BAA8B;AAC9B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,uFAAuF;AACvF,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,+FAA+F;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,4CAA4C;AAC5C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,qEAAqE;AACrE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,8FAA8F;AAC9F,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,0BAA0B;AAC1B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,0DAA0D;AAC1D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}
+{"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,sCAAsC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,iFAAiF;AACjF,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAChD,8BAA8B;AAC9B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,6EAA6E;AAC7E,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,4CAA4C;AAC5C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,+DAA+D;AAC/D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,wHAAwH;AACxH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,8FAA8F;AAC9F,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,0BAA0B;AAC1B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,8FAA8F;AAC9F,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/index.js

@@ -7,16 +7,21 @@
  */
 import * as Signals_1 from "@norskvideo/moq-signals";
 export { Signals_1 as Signals };
-import * as Announce_1 from "./announced.js";
+import * as Announce_1 from "./announce.js";
 export { Announce_1 as Announce };
+import * as Bandwidth_1 from "./bandwidth_api.js";
+export { Bandwidth_1 as Bandwidth };
 import * as Broadcast_1 from "./broadcast.js";
 export { Broadcast_1 as Broadcast };
-import * as Connection_1 from "./connection/index.js";
-export { Connection_1 as Connection };
-/** The error a read or write rejects with when the peer resets a stream, carrying its code. */
-export { RemoteError } from "./error.js";
+/** A reconnecting, shareable handle on a MoQ session. */
+export { Connection } from "./connection/index.js";
+export { SessionCode, StreamCode } from "./error.js";
+import * as Error_1 from "./errors.js";
+export { Error_1 as Error };
 import * as Group_1 from "./group.js";
 export { Group_1 as Group };
+import * as Origin_1 from "./origin.js";
+export { Origin_1 as Origin };
 import * as Path_1 from "./path.js";
 export { Path_1 as Path };
 import * as Time_1 from "./time.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;2BAGsB,cAAc;sBAA3B,OAAO;4BAEO,gBAAgB;uBAA9B,QAAQ;6BAEO,gBAAgB;wBAA/B,SAAS;8BAEO,uBAAuB;yBAAvC,UAAU;AACtB,+FAA+F;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;yBAElB,YAAY;oBAAvB,KAAK;wBAEK,WAAW;mBAArB,IAAI;wBAEM,WAAW;mBAArB,IAAI;yBAEO,YAAY;oBAAvB,KAAK;0BAEO,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\";\n/** Broadcast announcement streams. */\nexport * as Announce from \"./announced.ts\";\n/** Broadcast role handles. */\nexport * as Broadcast from \"./broadcast.ts\";\n/** Connection helpers: connect to or accept a MoQ session and reconnect on failure. */\nexport * as Connection from \"./connection/index.ts\";\n/** The error a read or write rejects with when the peer resets a stream, carrying its code. */\nexport { RemoteError } from \"./error.ts\";\n/** Group role handles and frame helpers. */\nexport * as Group 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\";\n/** Track role handles. */\nexport * as Track from \"./track.ts\";\n/** QUIC variable-length integer encoding and decoding. */\nexport * as Varint from \"./varint.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;2BAGsB,cAAc;sBAA3B,OAAO;4BAEO,eAAe;uBAA7B,QAAQ;6BAEO,oBAAoB;wBAAnC,SAAS;6BAEM,gBAAgB;wBAA/B,SAAS;AACrB,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;yBAE9B,aAAa;oBAAxB,KAAK;yBAEM,YAAY;oBAAvB,KAAK;0BAEO,aAAa;qBAAzB,MAAM;wBAEI,WAAW;mBAArB,IAAI;wBAEM,WAAW;mBAArB,IAAI;yBAEO,YAAY;oBAAvB,KAAK;0BAEO,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\";\n/** Broadcast announcement streams. */\nexport * as Announce from \"./announce.ts\";\n/** Send-side bandwidth estimates split among the tracks sharing a connection. */\nexport * as Bandwidth from \"./bandwidth_api.ts\";\n/** Broadcast role handles. */\nexport * as Broadcast from \"./broadcast.ts\";\n/** A reconnecting, shareable handle on a MoQ session. */\nexport { Connection } from \"./connection/index.ts\";\nexport { SessionCode, StreamCode } from \"./error.ts\";\n/** Session and stream errors, each carrying a code from its own registry. */\nexport * as Error from \"./errors.ts\";\n/** Group role handles and frame helpers. */\nexport * as Group from \"./group.ts\";\n/** Broadcast routing tables, independent of any connection. */\nexport * as Origin from \"./origin.ts\";\n/** Broadcast path utilities with delimiter-aware prefix matching. Path patterns are re-exported from `@moq/pattern`. */\nexport * as Path from \"./path.ts\";\n/** Branded time types (nanoseconds, microseconds, milliseconds, seconds) with conversions. */\nexport * as Time from \"./time.ts\";\n/** Track role handles. */\nexport * as Track from \"./track.ts\";\n/** Varint encoding and decoding, in QUIC's format and moq-transport's leading-ones format. */\nexport * as Varint from \"./varint.ts\";\n"]}

package/internal.d.ts

@@ -5,7 +5,75 @@
  *
  * @module
  */
-import type { Producer, Request } from "./track";
+import type { Dispose, Getter } from "@norskvideo/moq-signals";
+import type { Consumer as BroadcastConsumer, Producer as BroadcastProducer } from "./broadcast";
+import type { Frame, Consumer as GroupConsumer } from "./group";
+import type { Route } from "./hop";
+import * as Path from "./path";
+import type { Timestamp } from "./time";
+import type { Groups, Producer, Request, Subscriber } from "./track";
+import type { Advertised, Advertisements } from "./wire";
+/** Normalize public group bounds into an inclusive start and exclusive end. */
+export declare function groupBounds(groups?: Groups): {
+    start: number;
+    end?: number;
+};
+/**
+ * The announce-interest prefix a scope needs on a prefix-shaped wire: its literal head.
+ * The peer echoes every suffix beneath it, and the caller filters what arrives.
+ */
+export declare function scopeHead(scope: Path.Pattern): Path.Valid;
+/**
+ * Whether a segment of `path` below `prefix` starts with `.`, which hides it from announce
+ * discovery unless the request opts in. A path at or above the prefix never hides.
+ */
+export declare function hiddenBelow(prefix: Path.Valid, path: Path.Valid): boolean;
+/**
+ * Where each carried route lands under the requested prefix: its suffix beneath the
+ * prefix, or the empty suffix for a route above it, where the most specific such route
+ * wins the way a request through the prefix would resolve.
+ */
+export declare function presented(prefix: Path.Valid, table: Advertisements, carries: (covered: Path.Valid) => boolean): Map<Path.Valid, Advertised>;
+/** Whether the announced prefix's subtree overlaps `scope`. */
+export declare function scopeOverlaps(scope: Path.Pattern, prefix: Path.Valid): boolean;
+/** What `scope` captures from an exact announced prefix, if it pins every wildcard. */
+export declare function scopeCaptures(scope: Path.Pattern, prefix: Path.Valid): Path.Pattern[] | undefined;
+/**
+ * What a non-blocking group read found, which is everything the caller needs to decide what
+ * to do next: no second look at the track's closed state, and no ordering rule to get wrong.
+ */
+export type Recv = 
+/** A group to serve. It has already left the buffer, so dropping this is dropping the group. */
+{
+    kind: "group";
+    group: GroupConsumer;
+}
+/** Nothing readable, but the track is live and may produce more. */
+ | {
+    kind: "idle";
+}
+/** The producer finished, yet groups above the cap are still held: raising it releases them. */
+ | {
+    kind: "boundary";
+}
+/** The producer finished and the buffer is drained. Nothing can follow. */
+ | {
+    kind: "done";
+}
+/** The track aborted. */
+ | {
+    kind: "error";
+    error: Error;
+};
+/** A package-internal frame read the wire publisher completes once written. */
+export interface ReadGroupFrame {
+    /** Frame sequence within the group. */
+    sequence: number;
+    /** Frame returned to the publisher. */
+    frame: Frame;
+    /** Mark the frame delivered or deliberately skipped by the wire publisher. */
+    complete(): void;
+}
 /** The next group or datagram sequence shared by dynamic producers of one broadcast track. */
 export interface TrackSequence {
     next: number;
@@ -20,10 +88,56 @@ export interface TrackRequestOptions {
     producer: Producer;
     /** Sequence namespaces shared by the broadcast generation. */
     sequences: TrackSequences;
+    /** Requests not yet accepted or rejected by the publisher. */
+    pending: Set<Request>;
 }
 /** Hooks assigned in static blocks by the owning class. */
 export declare const hooks: {
     /** Mint a track {@link Request}; assigned by `track.ts`. */
     makeRequest: (options: TrackRequestOptions) => Request;
+    /** Access the existing producer while a request awaits immutable wire metadata. */
+    pendingTrackProducer: (request: Request) => Producer;
+    /**
+     * Take the next group the subscriber's cursor allows, without waiting; assigned by `track.ts`.
+     *
+     * Synchronous so a caller can pop a group and act on it in the same turn. Park on
+     * {@link groupChanged} when it reports `idle` or `boundary`.
+     */
+    tryRecvGroup: (subscriber: Subscriber) => Recv;
+    /** Wake once a subscriber's group cursor may read differently; assigned by `track.ts`. */
+    groupChanged: (subscriber: Subscriber, fn: () => void) => Dispose;
+    /**
+     * Exempt a subscriber from live-delivery policy for a one-shot FETCH scan: it names one
+     * old group explicitly, so it is neither late against the live edge nor bound by the start
+     * a live subscription resolves to.
+     */
+    exemptFetch: (subscriber: Subscriber) => void;
+    /**
+     * Replace a serving cursor. An omitted start keeps the current floor; a provided start
+     * can lower it. Wire publishers apply SUBSCRIBE_UPDATE here rather than through
+     * `setGroups`, which never rewinds.
+     */
+    replaceGroups: (subscriber: Subscriber, groups: Groups) => void;
+    /** Return a group's first timestamp, retained even after its first frame is read. */
+    groupTimestamp: (group: GroupConsumer) => Timestamp | undefined;
+    groupLatest: (group: GroupConsumer) => Timestamp | undefined;
+    /** Keep applying a subscription's drift policy after it hands a group out. */
+    expireGroup: (group: GroupConsumer, expiry: {
+        expired: () => boolean;
+        changed: readonly Getter<unknown>[];
+    }) => void;
+    /** Start a group operation unless the handed-out group has expired, and stop it if the group expires mid-flight. */
+    guardGroup: <T>(group: GroupConsumer, operation: () => Promise<T>) => Promise<T>;
+    /** Read a frame the wire publisher completes (or skips) once written. */
+    readGroupFrame: (group: GroupConsumer, from?: number) => Promise<ReadGroupFrame | undefined>;
+    /** Make an evicted mirror terminal while its track timeline still contains it. */
+    evictGroup: (group: GroupConsumer) => void;
+    /** Attach the origin advertisement of a created broadcast. */
+    attachAnnouncer: (producer: BroadcastProducer, announcer: {
+        announce(route: Route): void;
+        unannounce(): void;
+    }) => void;
+    /** Name a broadcast handle by the path an origin created or resolved it at. */
+    stampPath: (target: BroadcastProducer | BroadcastConsumer, path: Path.Valid) => void;
 };
 //# sourceMappingURL=internal.d.ts.map

package/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpD,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAExD,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IACnC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,EAAE,QAAQ,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,cAAc,CAAC;CAC1B;AAED,2DAA2D;AAC3D,eAAO,MAAM,KAAK,EAAE;IACnB,4DAA4D;IAC5D,WAAW,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC;CAKvD,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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"}

package/internal.js

@@ -1,8 +1,116 @@
 /* @ts-self-types="./internal.d.ts" */
+import * as Path from "./path.js";
+/** Normalize public group bounds into an inclusive start and exclusive end. */
+export function groupBounds(groups = {}) {
+    const bound = (value, start) => {
+        if (value === undefined)
+            return undefined;
+        if ((value.included === undefined) === (value.excluded === undefined)) {
+            throw new Error("a group bound must be either included or excluded");
+        }
+        const sequence = value.included ?? value.excluded;
+        if (sequence === undefined || !Number.isSafeInteger(sequence) || sequence < 0) {
+            throw new Error("a group bound must be a non-negative safe integer");
+        }
+        return sequence + (start ? Number(value.excluded !== undefined) : Number(value.included !== undefined));
+    };
+    return { start: bound(groups.start, true) ?? 0, end: bound(groups.end, false) };
+}
+/**
+ * The announce-interest prefix a scope needs on a prefix-shaped wire: its literal head.
+ * The peer echoes every suffix beneath it, and the caller filters what arrives.
+ */
+export function scopeHead(scope) {
+    return Path.from(scope.head);
+}
+/**
+ * Whether a segment of `path` below `prefix` starts with `.`, which hides it from announce
+ * discovery unless the request opts in. A path at or above the prefix never hides.
+ */
+export function hiddenBelow(prefix, path) {
+    const below = Path.stripPrefix(prefix, path);
+    return below !== null && Path.parts(below).some((part) => part.startsWith("."));
+}
+/**
+ * Where each carried route lands under the requested prefix: its suffix beneath the
+ * prefix, or the empty suffix for a route above it, where the most specific such route
+ * wins the way a request through the prefix would resolve.
+ */
+export function presented(prefix, table, carries) {
+    const out = new Map();
+    let rootLen = -1;
+    const requested = Path.Pattern.subtree(prefix);
+    for (const [covered, candidates] of table) {
+        if (!carries(covered))
+            continue;
+        if (Path.hasPrefix(covered, prefix)) {
+            if (covered.length < rootLen)
+                continue;
+            // A scoped route covers only what it claims, so the best one that can serve the prefix wins.
+            const snap = candidates.find((candidate) => !candidate.claim || candidate.claim.overlaps(requested));
+            if (!snap)
+                continue;
+            rootLen = covered.length;
+            out.set(Path.empty(), snap);
+            continue;
+        }
+        const suffix = Path.stripPrefix(prefix, covered);
+        if (suffix !== null && candidates.length > 0)
+            out.set(suffix, candidates[0]);
+    }
+    return out;
+}
+/** Whether the announced prefix's subtree overlaps `scope`. */
+export function scopeOverlaps(scope, prefix) {
+    return scope.overlaps(Path.Pattern.subtree(prefix));
+}
+/** What `scope` captures from an exact announced prefix, if it pins every wildcard. */
+export function scopeCaptures(scope, prefix) {
+    return scope.captures(Path.Pattern.literal(prefix));
+}
 /** Hooks assigned in static blocks by the owning class. */
 export const hooks = {
     makeRequest: () => {
         throw new Error("track.ts not loaded");
     },
+    pendingTrackProducer: () => {
+        throw new Error("track.ts not loaded");
+    },
+    tryRecvGroup: () => {
+        throw new Error("track.ts not loaded");
+    },
+    groupChanged: () => {
+        throw new Error("track.ts not loaded");
+    },
+    exemptFetch: () => {
+        throw new Error("track.ts not loaded");
+    },
+    replaceGroups: () => {
+        throw new Error("track.ts not loaded");
+    },
+    groupTimestamp: () => {
+        throw new Error("group.ts not loaded");
+    },
+    groupLatest: () => {
+        throw new Error("group.ts not loaded");
+    },
+    expireGroup: () => {
+        throw new Error("group.ts not loaded");
+    },
+    guardGroup: () => {
+        throw new Error("group.ts not loaded");
+    },
+    readGroupFrame: () => {
+        throw new Error("group.ts not loaded");
+    },
+    evictGroup: () => {
+        throw new Error("group.ts not loaded");
+    },
+    attachAnnouncer: () => {
+        throw new Error("broadcast.ts not loaded");
+    },
+    stampPath: () => {
+        throw new Error("broadcast.ts not loaded");
+    },
 };
 //# sourceMappingURL=internal.js.map

package/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AA2BA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,KAAK,GAGd;IACH,WAAW,EAAE,GAAG,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;CACD,CAAC","sourcesContent":["/**\n * Package-internal constructor hooks. Classes keep their constructors private so consumers\n * can't mint detached handles; sibling modules create instances through these hooks instead.\n * Not exported from the package entrypoint.\n *\n * @module\n */\nimport type { Producer, Request } from \"./track.ts\";\n\n/** The next group or datagram sequence shared by dynamic producers of one broadcast track. */\nexport interface TrackSequence {\n\tnext: number;\n}\n\n/** Per-track sequence namespaces owned by one broadcast generation. */\nexport type TrackSequences = Map<string, TrackSequence>;\n\n/** Inputs for creating a package-internal track request. */\nexport interface TrackRequestOptions {\n\t/** The requested track name. */\n\tname: string;\n\t/** The producer that will serve the request. */\n\tproducer: Producer;\n\t/** Sequence namespaces shared by the broadcast generation. */\n\tsequences: TrackSequences;\n}\n\n/** Hooks assigned in static blocks by the owning class. */\nexport const hooks: {\n\t/** Mint a track {@link Request}; assigned by `track.ts`. */\n\tmakeRequest: (options: TrackRequestOptions) => Request;\n} = {\n\tmakeRequest: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n};\n"]}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,MAAM,GAAW,EAAE;IAC9C,MAAM,KAAK,GAAG,CAAC,KAAkC,EAAE,KAAc,EAAsB,EAAE;QACxF,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC;QAClD,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC;IACzG,CAAC,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAmB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB,EAAE,IAAgB;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACxB,MAAkB,EAClB,KAAqB,EACrB,OAAyC;IAEzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAChC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,MAAM,GAAG,OAAO;gBAAE,SAAS;YACvC,6FAA6F;YAC7F,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YACrG,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;YAC5B,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,MAAkB;IACpE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,MAAkB;IACpE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC;AAgDD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,KAAK,GA+Cd;IACH,WAAW,EAAE,GAAG,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,oBAAoB,EAAE,GAAG,EAAE;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,YAAY,EAAE,GAAG,EAAE;QAClB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,YAAY,EAAE,GAAG,EAAE;QAClB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,WAAW,EAAE,GAAG,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,aAAa,EAAE,GAAG,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,cAAc,EAAE,GAAG,EAAE;QACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,WAAW,EAAE,GAAG,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,WAAW,EAAE,GAAG,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,UAAU,EAAE,GAAG,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,cAAc,EAAE,GAAG,EAAE;QACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,UAAU,EAAE,GAAG,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;IACD,eAAe,EAAE,GAAG,EAAE;QACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,SAAS,EAAE,GAAG,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;CACD,CAAC","sourcesContent":["/**\n * Package-internal constructor hooks. Classes keep their constructors private so consumers\n * can't mint detached handles; sibling modules create instances through these hooks instead.\n * Not exported from the package entrypoint.\n *\n * @module\n */\nimport type { Dispose, Getter } from \"@moq/signals\";\nimport type { Consumer as BroadcastConsumer, Producer as BroadcastProducer } from \"./broadcast.ts\";\nimport type { Frame, Consumer as GroupConsumer } from \"./group.ts\";\nimport type { Route } from \"./hop.ts\";\nimport * as Path from \"./path.ts\";\nimport type { Timestamp } from \"./time.ts\";\nimport type { Groups, Producer, Request, Subscriber } from \"./track.ts\";\nimport type { Advertised, Advertisements } from \"./wire.ts\";\n\n/** Normalize public group bounds into an inclusive start and exclusive end. */\nexport function groupBounds(groups: Groups = {}): { start: number; end?: number } {\n\tconst bound = (value: Groups[\"start\"] | undefined, start: boolean): number | undefined => {\n\t\tif (value === undefined) return undefined;\n\t\tif ((value.included === undefined) === (value.excluded === undefined)) {\n\t\t\tthrow new Error(\"a group bound must be either included or excluded\");\n\t\t}\n\t\tconst sequence = value.included ?? value.excluded;\n\t\tif (sequence === undefined || !Number.isSafeInteger(sequence) || sequence < 0) {\n\t\t\tthrow new Error(\"a group bound must be a non-negative safe integer\");\n\t\t}\n\t\treturn sequence + (start ? Number(value.excluded !== undefined) : Number(value.included !== undefined));\n\t};\n\treturn { start: bound(groups.start, true) ?? 0, end: bound(groups.end, false) };\n}\n\n/**\n * The announce-interest prefix a scope needs on a prefix-shaped wire: its literal head.\n * The peer echoes every suffix beneath it, and the caller filters what arrives.\n */\nexport function scopeHead(scope: Path.Pattern): Path.Valid {\n\treturn Path.from(scope.head);\n}\n\n/**\n * Whether a segment of `path` below `prefix` starts with `.`, which hides it from announce\n * discovery unless the request opts in. A path at or above the prefix never hides.\n */\nexport function hiddenBelow(prefix: Path.Valid, path: Path.Valid): boolean {\n\tconst below = Path.stripPrefix(prefix, path);\n\treturn below !== null && Path.parts(below).some((part) => part.startsWith(\".\"));\n}\n\n/**\n * Where each carried route lands under the requested prefix: its suffix beneath the\n * prefix, or the empty suffix for a route above it, where the most specific such route\n * wins the way a request through the prefix would resolve.\n */\nexport function presented(\n\tprefix: Path.Valid,\n\ttable: Advertisements,\n\tcarries: (covered: Path.Valid) => boolean,\n): Map<Path.Valid, Advertised> {\n\tconst out = new Map<Path.Valid, Advertised>();\n\tlet rootLen = -1;\n\tconst requested = Path.Pattern.subtree(prefix);\n\tfor (const [covered, candidates] of table) {\n\t\tif (!carries(covered)) continue;\n\t\tif (Path.hasPrefix(covered, prefix)) {\n\t\t\tif (covered.length < rootLen) continue;\n\t\t\t// A scoped route covers only what it claims, so the best one that can serve the prefix wins.\n\t\t\tconst snap = candidates.find((candidate) => !candidate.claim || candidate.claim.overlaps(requested));\n\t\t\tif (!snap) continue;\n\t\t\trootLen = covered.length;\n\t\t\tout.set(Path.empty(), snap);\n\t\t\tcontinue;\n\t\t}\n\t\tconst suffix = Path.stripPrefix(prefix, covered);\n\t\tif (suffix !== null && candidates.length > 0) out.set(suffix, candidates[0]);\n\t}\n\treturn out;\n}\n\n/** Whether the announced prefix's subtree overlaps `scope`. */\nexport function scopeOverlaps(scope: Path.Pattern, prefix: Path.Valid): boolean {\n\treturn scope.overlaps(Path.Pattern.subtree(prefix));\n}\n\n/** What `scope` captures from an exact announced prefix, if it pins every wildcard. */\nexport function scopeCaptures(scope: Path.Pattern, prefix: Path.Valid): Path.Pattern[] | undefined {\n\treturn scope.captures(Path.Pattern.literal(prefix));\n}\n\n/**\n * What a non-blocking group read found, which is everything the caller needs to decide what\n * to do next: no second look at the track's closed state, and no ordering rule to get wrong.\n */\nexport type Recv =\n\t/** A group to serve. It has already left the buffer, so dropping this is dropping the group. */\n\t| { kind: \"group\"; group: GroupConsumer }\n\t/** Nothing readable, but the track is live and may produce more. */\n\t| { kind: \"idle\" }\n\t/** The producer finished, yet groups above the cap are still held: raising it releases them. */\n\t| { kind: \"boundary\" }\n\t/** The producer finished and the buffer is drained. Nothing can follow. */\n\t| { kind: \"done\" }\n\t/** The track aborted. */\n\t| { kind: \"error\"; error: Error };\n\n/** A package-internal frame read the wire publisher completes once written. */\nexport interface ReadGroupFrame {\n\t/** Frame sequence within the group. */\n\tsequence: number;\n\t/** Frame returned to the publisher. */\n\tframe: Frame;\n\t/** Mark the frame delivered or deliberately skipped by the wire publisher. */\n\tcomplete(): void;\n}\n\n/** The next group or datagram sequence shared by dynamic producers of one broadcast track. */\nexport interface TrackSequence {\n\tnext: number;\n}\n\n/** Per-track sequence namespaces owned by one broadcast generation. */\nexport type TrackSequences = Map<string, TrackSequence>;\n\n/** Inputs for creating a package-internal track request. */\nexport interface TrackRequestOptions {\n\t/** The requested track name. */\n\tname: string;\n\t/** The producer that will serve the request. */\n\tproducer: Producer;\n\t/** Sequence namespaces shared by the broadcast generation. */\n\tsequences: TrackSequences;\n\t/** Requests not yet accepted or rejected by the publisher. */\n\tpending: Set<Request>;\n}\n\n/** Hooks assigned in static blocks by the owning class. */\nexport const hooks: {\n\t/** Mint a track {@link Request}; assigned by `track.ts`. */\n\tmakeRequest: (options: TrackRequestOptions) => Request;\n\t/** Access the existing producer while a request awaits immutable wire metadata. */\n\tpendingTrackProducer: (request: Request) => Producer;\n\t/**\n\t * Take the next group the subscriber's cursor allows, without waiting; assigned by `track.ts`.\n\t *\n\t * Synchronous so a caller can pop a group and act on it in the same turn. Park on\n\t * {@link groupChanged} when it reports `idle` or `boundary`.\n\t */\n\ttryRecvGroup: (subscriber: Subscriber) => Recv;\n\t/** Wake once a subscriber's group cursor may read differently; assigned by `track.ts`. */\n\tgroupChanged: (subscriber: Subscriber, fn: () => void) => Dispose;\n\t/**\n\t * Exempt a subscriber from live-delivery policy for a one-shot FETCH scan: it names one\n\t * old group explicitly, so it is neither late against the live edge nor bound by the start\n\t * a live subscription resolves to.\n\t */\n\texemptFetch: (subscriber: Subscriber) => void;\n\t/**\n\t * Replace a serving cursor. An omitted start keeps the current floor; a provided start\n\t * can lower it. Wire publishers apply SUBSCRIBE_UPDATE here rather than through\n\t * `setGroups`, which never rewinds.\n\t */\n\treplaceGroups: (subscriber: Subscriber, groups: Groups) => void;\n\t/** Return a group's first timestamp, retained even after its first frame is read. */\n\tgroupTimestamp: (group: GroupConsumer) => Timestamp | undefined;\n\tgroupLatest: (group: GroupConsumer) => Timestamp | undefined;\n\t/** Keep applying a subscription's drift policy after it hands a group out. */\n\texpireGroup: (\n\t\tgroup: GroupConsumer,\n\t\texpiry: { expired: () => boolean; changed: readonly Getter<unknown>[] },\n\t) => void;\n\t/** Start a group operation unless the handed-out group has expired, and stop it if the group expires mid-flight. */\n\tguardGroup: <T>(group: GroupConsumer, operation: () => Promise<T>) => Promise<T>;\n\t/** Read a frame the wire publisher completes (or skips) once written. */\n\treadGroupFrame: (group: GroupConsumer, from?: number) => Promise<ReadGroupFrame | undefined>;\n\t/** Make an evicted mirror terminal while its track timeline still contains it. */\n\tevictGroup: (group: GroupConsumer) => void;\n\t/** Attach the origin advertisement of a created broadcast. */\n\tattachAnnouncer: (\n\t\tproducer: BroadcastProducer,\n\t\tannouncer: { announce(route: Route): void; unannounce(): void },\n\t) => void;\n\t/** Name a broadcast handle by the path an origin created or resolved it at. */\n\tstampPath: (target: BroadcastProducer | BroadcastConsumer, path: Path.Valid) => void;\n} = {\n\tmakeRequest: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n\tpendingTrackProducer: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n\ttryRecvGroup: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n\tgroupChanged: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n\texemptFetch: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n\treplaceGroups: () => {\n\t\tthrow new Error(\"track.ts not loaded\");\n\t},\n\tgroupTimestamp: () => {\n\t\tthrow new Error(\"group.ts not loaded\");\n\t},\n\tgroupLatest: () => {\n\t\tthrow new Error(\"group.ts not loaded\");\n\t},\n\texpireGroup: () => {\n\t\tthrow new Error(\"group.ts not loaded\");\n\t},\n\tguardGroup: () => {\n\t\tthrow new Error(\"group.ts not loaded\");\n\t},\n\treadGroupFrame: () => {\n\t\tthrow new Error(\"group.ts not loaded\");\n\t},\n\tevictGroup: () => {\n\t\tthrow new Error(\"group.ts not loaded\");\n\t},\n\tattachAnnouncer: () => {\n\t\tthrow new Error(\"broadcast.ts not loaded\");\n\t},\n\tstampPath: () => {\n\t\tthrow new Error(\"broadcast.ts not loaded\");\n\t},\n};\n"]}

package/lite/announce.d.ts

@@ -1,7 +1,17 @@
-import { type Origin } from "../origin";
+import { type Cost, type Hop } from "../hop";
 import * as Path from "../path";
 import type { Reader, Writer } from "../stream";
 import { Version } from "./version";
+export type { Cost };
+/**
+ * Lite-07: copy `keep` path segments (from the head) or hops (from the tail) of the
+ * live announcement `distance` back from the stream's next Announce ID, where 1 is the
+ * latest ANNOUNCE_START. Resolved by {@link AnnounceHistory}.
+ */
+export type Base = {
+    distance: bigint;
+    keep: number;
+};
 /**
  * An announcement on the Announce Stream, advertising or retracting a broadcast.
  *
@@ -14,12 +24,16 @@ import { Version } from "./version";
  */
 export type AnnounceBroadcast = 
 /** A broadcast is now available, carrying the path suffix, the hop chain, and
- * (lite-06+) the route cost. An absent cost encodes as zero. */
+ * (lite-06+) the route cost. An absent cost encodes as zero; it decodes as
+ * `undefined` on a wire with no room for one. On lite-07, `suffix` follows the
+ * segments `pathBase` copies and `hops` precede the ones `hopBase` copies. */
 {
     status: "active";
     suffix: Path.Valid;
-    hops: Origin[];
-    cost?: bigint;
+    hops: Hop[];
+    cost?: Cost;
+    pathBase?: Base;
+    hopBase?: Base;
 }
 /** Pre-lite-06: a broadcast is no longer available, retracted by path. */
  | {
@@ -37,8 +51,13 @@ export type AnnounceBroadcast =
  | {
     status: "restart";
     id: bigint;
-    hops: Origin[];
-    cost?: bigint;
+    hops: Hop[];
+    cost?: Cost;
+    hopBase?: Base;
+}
+/** An unknown lite-06+ announce type, skipped by length. Does not assign an id. */
+ | {
+    status: "skipped";
 };
 /** Encode one announcement, including its type discriminator (lite-06+) and length prefix. */
 export declare function encodeAnnounceBroadcast(w: Writer, msg: AnnounceBroadcast, version: Version): Promise<void>;
@@ -46,6 +65,33 @@ export declare function encodeAnnounceBroadcast(w: Writer, msg: AnnounceBroadcas
 export declare function decodeAnnounceBroadcast(r: Reader, version: Version): Promise<AnnounceBroadcast>;
 /** Like {@link decodeAnnounceBroadcast} but resolves `undefined` on a clean FIN. */
 export declare function decodeAnnounceBroadcastMaybe(r: Reader, version: Version): Promise<AnnounceBroadcast | undefined>;
+type Advertised = {
+    suffix: Path.Valid;
+    hops: Hop[];
+};
+/**
+ * The live announcements on one lite-06+ announce stream, by Announce ID: what
+ * ANNOUNCE_END and ANNOUNCE_UPDATE reference, and what a lite-07 base copies from.
+ * Every violation throws {@link ProtocolViolation}.
+ */
+export declare class AnnounceHistory {
+    #private;
+    /** An ANNOUNCE_START: resolve it and assign it the next id. */
+    start(msg: {
+        suffix: Path.Valid;
+        hops: Hop[];
+        pathBase?: Base;
+        hopBase?: Base;
+    }): Advertised;
+    /** An ANNOUNCE_UPDATE: resolve its chain before replacing the old one, which it may be based on. */
+    update(msg: {
+        id: bigint;
+        hops: Hop[];
+        hopBase?: Base;
+    }): Advertised;
+    /** An ANNOUNCE_END: retire the id, returning its suffix. */
+    end(id: bigint): Path.Valid;
+}
 /**
  * ANNOUNCE_REQUEST: sent by the subscriber to request ANNOUNCE_BROADCAST messages
  * for a path prefix. Renamed from `AnnounceInterest` in lite-05.
@@ -53,14 +99,18 @@ export declare function decodeAnnounceBroadcastMaybe(r: Reader, version: Version
 export declare class AnnounceRequest {
     #private;
     prefix: Path.Valid;
-    /** Lite04/05 only: the 62-bit Origin id of the peer asking for announces, which the
+    /** Lite04/05 only: the 62-bit Hop id of the peer asking for announces, which the
      * publisher uses to skip announces that already passed through it. Zero means "no
      * exclusion". Not on the wire elsewhere, so a value set here is ignored when encoding
      * for another version and decodes as zero.
      *
      * Must be a bigint: peer origins are up to 62 bits and overflow u53. */
     excludeHop: bigint;
-    constructor(prefix: Path.Valid, excludeHop?: bigint);
+    /** Lite07+: also announce routes with a `.`-prefixed segment below the prefix. Not on
+     * the wire earlier, so a value set here is ignored when encoding for an older version
+     * and decodes as false. */
+    hidden: boolean;
+    constructor(prefix: Path.Valid, excludeHop?: bigint, hidden?: boolean);
     encode(w: Writer, version: Version): Promise<void>;
     static decode(r: Reader, version: Version): Promise<AnnounceRequest>;
 }
@@ -73,9 +123,9 @@ export declare class AnnounceInit {
 }
 export declare class AnnounceOk {
     #private;
-    origin: Origin;
+    hop: Hop;
     active: number;
-    constructor(origin: Origin, active: number);
+    constructor(hop: Hop, active: number);
     encode(w: Writer, version: Version): Promise<void>;
     static decode(r: Reader, version: Version): Promise<AnnounceOk>;
 }

package/lite/announce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"announce.d.ts","sourceRoot":"","sources":["../../src/lite/announce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,MAAM,EAAgC,MAAM,cAAc,CAAC;AACnF,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAA6D,OAAO,EAAE,MAAM,cAAc,CAAC;AAclG;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB;AAC5B;gEACgE;AAC9D;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACzE,0EAA0E;GACxE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAA;CAAE;AACzC;sEACsE;GACpE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AACnC;oFACoF;GAClF;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAwJpE,8FAA8F;AAC9F,wBAAsB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhH;AAED,8FAA8F;AAC9F,wBAAsB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAMrG;AAED,oFAAoF;AACpF,wBAAsB,4BAA4B,CACjD,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAOxC;AAED;;;GAGG;AACH,qBAAa,eAAe;;IAC3B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;IACnB;;;;;4EAKwE;IACxE,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAE,MAAW,EAGtD;IAeK,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,eAAe,CAAC,CAEzE;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;AASD,qBAAa,UAAU;;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAGzC;IAsBK,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,UAAU,CAAC,CAGpE;CACD"}
+{"version":3,"file":"announce.d.ts","sourceRoot":"","sources":["../../src/lite/announce.ts"],"names":[],"mappings":"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"}