moqtail 0.13.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,6 +7,8 @@
7
7
  * - If `typeValue` is **odd**, the value is a binary blob (`Uint8Array`) with a maximum length of 65535 bytes.
8
8
  *
9
9
  * Use {@link KeyValuePair.tryNewVarInt} for varint pairs and {@link KeyValuePair.tryNewBytes} for blob pairs.
10
+ * A Type whose own namespace fixes the value encoding overrides the parity rule; see
11
+ * {@link KeyValuePair.newBytes}.
10
12
  */
11
13
  declare class KeyValuePair {
12
14
  /**
@@ -36,6 +38,13 @@ declare class KeyValuePair {
36
38
  * @throws KeyValueFormattingError if typeValue is not even.
37
39
  */
38
40
  static tryNewVarInt(typeValue: bigint | number, value: bigint | number): KeyValuePair;
41
+ /**
42
+ * Creates a varint KeyValuePair for a Type whose namespace defines a numeric value
43
+ * regardless of parity. Prefer {@link KeyValuePair.tryNewVarInt}.
44
+ * @param typeValue - The key/type identifier; parity is not checked.
45
+ * @param value - The varint value.
46
+ */
47
+ static newVarInt(typeValue: bigint | number, value: bigint | number): KeyValuePair;
39
48
  /**
40
49
  * Creates a new blob KeyValuePair.
41
50
  * @param typeValue - Must be odd.
@@ -45,6 +54,14 @@ declare class KeyValuePair {
45
54
  * @throws LengthExceedsMaxError if value length exceeds 65535 bytes.
46
55
  */
47
56
  static tryNewBytes(typeValue: bigint | number, value: Uint8Array): KeyValuePair;
57
+ /**
58
+ * Creates a blob KeyValuePair for a Type whose namespace defines a byte-string
59
+ * value regardless of parity. Prefer {@link KeyValuePair.tryNewBytes}.
60
+ * @param typeValue - The key/type identifier; parity is not checked.
61
+ * @param value - The binary blob value.
62
+ * @throws LengthExceedsMaxError if value length exceeds 65535 bytes.
63
+ */
64
+ static newBytes(typeValue: bigint | number, value: Uint8Array): KeyValuePair;
48
65
  /**
49
66
  * Serializes this key-value pair to a frozen byte buffer.
50
67
  * Equivalent to {@link KeyValuePair.serializeDelta} with `prevType = 0n`.
@@ -86,6 +103,13 @@ declare class KeyValuePair {
86
103
  * @param typeValue - The already-decoded Type.
87
104
  */
88
105
  static deserializeValue(buf: BaseByteBuffer, typeValue: bigint): KeyValuePair;
106
+ /**
107
+ * Reads a length-prefixed byte-string Value, independent of Type parity.
108
+ * @param buf - The buffer to read from.
109
+ * @param typeValue - The already-decoded Type.
110
+ * @throws LengthExceedsMaxError if the length exceeds 65535 bytes.
111
+ */
112
+ static deserializeBytesValue(buf: BaseByteBuffer, typeValue: bigint): KeyValuePair;
89
113
  /**
90
114
  * Checks if this pair is equal to another.
91
115
  * @param other - The other KeyValuePair.
@@ -108,7 +132,7 @@ declare function deserializeKvpList(buf: BaseByteBuffer, count: number | bigint)
108
132
  */
109
133
  declare function deserializeKvpListUntilEmpty(buf: BaseByteBuffer): KeyValuePair[];
110
134
  /**
111
- * Checks if the KeyValuePair is a varint pair (even typeValue).
135
+ * Checks if the KeyValuePair carries a varint value.
112
136
  * @param pair - The KeyValuePair to check.
113
137
  * @returns True if value is a varint.
114
138
  */
@@ -116,7 +140,7 @@ declare function isVarInt(pair: KeyValuePair): pair is KeyValuePair & {
116
140
  value: bigint;
117
141
  };
118
142
  /**
119
- * Checks if the KeyValuePair is a blob pair (odd typeValue).
143
+ * Checks if the KeyValuePair carries a blob value.
120
144
  * @param pair - The KeyValuePair to check.
121
145
  * @returns True if value is a Uint8Array.
122
146
  */
@@ -347,7 +371,7 @@ declare class ReasonPhrase {
347
371
  */
348
372
  /**
349
373
  * @public
350
- * Object datagram types for MOQT objects (Draft-16).
374
+ * Object datagram types for MOQT objects.
351
375
  *
352
376
  * Type bit layout (form 0b00X0XXXX):
353
377
  * - Bit 0 (0x01): PROPERTIES - Properties field present
@@ -635,7 +659,7 @@ declare namespace ObjectStatus {
635
659
  //#endregion
636
660
  //#region src/model/data/datagram.d.ts
637
661
  /**
638
- * Represents a unified OBJECT_DATAGRAM message (Draft-16).
662
+ * Represents a unified OBJECT_DATAGRAM message.
639
663
  *
640
664
  * Type bit layout (form 0b00X0XXXX):
641
665
  * - Bit 0 (0x01): PROPERTIES
@@ -701,18 +725,7 @@ declare class FetchHeader {
701
725
  declare const SUPPORTED_VERSIONS: string[];
702
726
  /**
703
727
  * @public
704
- * Control message types, per draft-18 Table 5.
705
- *
706
- * The comment on each member is the Stream column: `Control` is the control stream
707
- * (§3.3), `Request` a bidirectional request stream, and `First` means the message MUST
708
- * be the first on a new request stream.
709
- *
710
- * Table 5 reserves `0x01` (SETUP for version 00), `0x40`/`0x41` (CLIENT_SETUP /
711
- * SERVER_SETUP for versions 10 and below) and `0x20`/`0x21` (CLIENT_SETUP /
712
- * SERVER_SETUP for versions 16 and below — folded into Setup by #256). All five stay
713
- * in the enum as documentation, but `tryFrom` rejects every RESERVED codepoint, which
714
- * is what §10 requires — an endpoint receiving an unknown message type MUST close the
715
- * session.
728
+ * Control message types.
716
729
  */
717
730
  declare enum ControlMessageType {
718
731
  ReservedSetupV00 = 1,
@@ -761,9 +774,7 @@ declare enum ControlMessageType {
761
774
  // Request, First
762
775
  PublishOk = 30,
763
776
  // Request; an alias of RequestOk (§10.5), not its own body
764
- PublishBlocked = 15,
765
- // Request
766
- Switch = 34
777
+ PublishSkipped = 15
767
778
  }
768
779
  /**
769
780
  * Converts a bigint value to a ControlMessageType enum.
@@ -790,40 +801,37 @@ declare namespace ControlMessageType {
790
801
  }
791
802
  /**
792
803
  * @public
793
- * Filter types for subscription requests.
794
- */
795
- declare enum FilterType {
796
- NextGroupStart = 1,
797
- LatestObject = 2,
798
- AbsoluteStart = 3,
799
- AbsoluteRange = 4
800
- }
801
- /**
802
- * Converts a bigint value to a FilterType enum.
804
+ * Which fields of a LOCATION_FILTER follow its type, and how they are read.
805
+ */
806
+ declare enum LocationFilterType {
807
+ /** No filter: every Object passes. */
808
+ None = 0,
809
+ /** Starts StartGroup groups before the Next Group. */
810
+ RelativeStart = 1,
811
+ AbsoluteStart = 2,
812
+ /** Ends with the last Object of the End Group. */
813
+ AbsoluteStartGroupEnd = 3,
814
+ /** Ends with End Object of the End Group. */
815
+ AbsoluteRange = 4,
816
+ /** Starts at the Object after the Largest Object. */
817
+ NextObject = 5
818
+ }
819
+ /**
820
+ * Converts a bigint value to a LocationFilterType enum.
803
821
  * @param v - The bigint value.
804
- * @returns The corresponding FilterType.
805
- * @throws InvalidEnumValue if the value is not a valid filter type.
822
+ * @returns The corresponding LocationFilterType.
823
+ * @throws InvalidEnumValue if the value is not a valid Location Filter Type.
806
824
  */
807
- declare namespace FilterType {
808
- function tryFrom(v: bigint): FilterType;
825
+ declare namespace LocationFilterType {
826
+ function tryFrom(v: bigint): LocationFilterType;
809
827
  }
810
828
  /**
811
829
  * @public
812
- * Fetch request types for MOQT protocol.
813
- */
814
- declare enum FetchType {
815
- Standalone = 1,
816
- Relative = 2,
817
- Absolute = 3
818
- }
819
- /**
820
- * Converts a bigint value to a FetchType enum.
821
- * @param v - The bigint value.
822
- * @returns The corresponding FetchType.
823
- * @throws InvalidEnumValue if the value is not a valid fetch type.
830
+ * Switch modes for subscription switching requests.
824
831
  */
825
- declare namespace FetchType {
826
- function tryFrom(v: bigint): FetchType;
832
+ declare enum SwitchMode {
833
+ Hard = 0,
834
+ Soft = 1
827
835
  }
828
836
  /**
829
837
  * @public
@@ -871,7 +879,6 @@ declare enum PublishDoneStatusCode {
871
879
  InternalError = 0,
872
880
  Unauthorized = 1,
873
881
  TrackEnded = 2,
874
- SubscriptionEnded = 3,
875
882
  GoingAway = 4,
876
883
  TooFarBehind = 5,
877
884
  Expired = 6,
@@ -912,13 +919,14 @@ declare enum RequestErrorCode {
912
919
  DoesNotExist = 16,
913
920
  InvalidRange = 17,
914
921
  MalformedTrack = 18,
915
- DuplicateSubscription = 25,
916
922
  Uninterested = 32,
917
923
  PrefixOverlap = 48,
918
924
  NamespaceTooLarge = 49,
919
- InvalidJoiningRequestId = 50,
925
+ InvalidSwitch = 50,
920
926
  UnsupportedExtension = 51,
921
- Redirect = 52
927
+ Redirect = 52,
928
+ ConflictingFilters = 53,
929
+ InvalidFilter = 54
922
930
  }
923
931
  /**
924
932
  * Converts a bigint value to a RequestErrorCode enum.
@@ -938,20 +946,36 @@ declare namespace RequestErrorCode {
938
946
  //#endregion
939
947
  //#region src/model/data/fetch_object.d.ts
940
948
  /**
941
- * Prior-object state threaded across successive Fetch Objects on the same stream.
949
+ * The prior Object a Fetch Object is encoded against: each one is written as
950
+ * differences from it.
942
951
  */
943
952
  type FetchObjectContext = {
944
953
  groupId: bigint;
945
- subgroupId: bigint;
954
+ /**
955
+ * Null while the stream has carried only End of Range markers and no Object yet:
956
+ * a marker sets the prior Group and Object IDs, but has no Subgroup ID.
957
+ */
958
+ subgroupId: bigint | null;
946
959
  objectId: bigint;
947
- publisherPriority: number;
960
+ /**
961
+ * Null while the stream has carried only End of Range markers and no Object yet:
962
+ * a marker has no priority.
963
+ */
964
+ publisherPriority: number | null;
948
965
  };
949
966
  /**
950
- * Kind discriminator for End-of-Range markers (§11.5).
967
+ * Kind discriminator for End-of-Range markers.
951
968
  */
952
969
  declare enum EndOfRangeKind {
970
+ /** Serialization Flags = 0x8C: all objects in the range are known not to exist. */
953
971
  NonExistent = 140,
954
- Unknown = 268
972
+ /** Serialization Flags = 0x10C: the range is cache-unknown. */
973
+ Unknown = 268,
974
+ /**
975
+ * Serialization Flags = 0x20C: the range timed out, e.g. a relay ran out of its
976
+ * fill budget before it could retrieve it.
977
+ */
978
+ TimedOut = 524
955
979
  }
956
980
  /**
957
981
  * Payload-bearing fetch object (§11.5, non-End-of-Range form).
@@ -972,10 +996,14 @@ declare class FetchObject {
972
996
  get groupId(): bigint;
973
997
  get objectId(): bigint;
974
998
  /**
975
- * Context to thread into the next call on this stream.
976
- * Returns null for EndOfRange markers — they MUST NOT update prior state.
999
+ * What the entry after this one is encoded against, given what this one was
1000
+ * encoded against (`prev`).
1001
+ *
1002
+ * After an Object, that is the Object itself. After an End of Range marker, it is
1003
+ * the marker's Group and Object IDs, with the Subgroup ID and priority still those
1004
+ * of the last Object before the marker, or none if no Object came before it.
977
1005
  */
978
- toContext(): FetchObjectContext | null;
1006
+ nextContext(prev?: FetchObjectContext): FetchObjectContext;
979
1007
  static newObject(groupId: bigint | number, subgroupId: bigint | number, objectId: bigint | number, publisherPriority: number, forwardingPreference: ObjectForwardingPreference, properties: KeyValuePair[] | null, payload: Uint8Array): FetchObject;
980
1008
  static newEndOfRange(kind: EndOfRangeKind, groupId: bigint | number, objectId: bigint | number): FetchObject;
981
1009
  serialize(prev?: FetchObjectContext, groupOrder?: GroupOrder): FrozenByteBuffer;
@@ -989,7 +1017,7 @@ declare const MAX_FULL_TRACK_NAME_LENGTH = 4096;
989
1017
  * Fully-qualified track identifier = hierarchical namespace (tuple) + leaf name bytes.
990
1018
  *
991
1019
  * Constraints enforced (throws {@link TrackNameError}):
992
- * - Namespace tuple field count: 0 .. {@link MAX_NAMESPACE_TUPLE_COUNT} (draft-18 §2.4.1; an empty namespace is legal).
1020
+ * - Namespace tuple field count: 0 .. {@link MAX_NAMESPACE_TUPLE_COUNT} (an empty namespace is legal).
993
1021
  * - Total serialized length (namespace tuple + raw name bytes) less than or equals {@link MAX_FULL_TRACK_NAME_LENGTH} bytes.
994
1022
  *
995
1023
  * Namespace input may be:
@@ -1083,7 +1111,7 @@ declare class MoqtObject {
1083
1111
  static newWithPayload(fullTrackName: FullTrackName, location: Location, publisherPriority: number, objectForwardingPreference: ObjectForwardingPreference, subgroupId: bigint | number | null, properties: KeyValuePair[] | null, payload: Uint8Array): MoqtObject;
1084
1112
  static newWithStatus(fullTrackName: FullTrackName, location: Location, publisherPriority: number, objectForwardingPreference: ObjectForwardingPreference, subgroupId: bigint | number | null, properties: KeyValuePair[] | null, objectStatus: ObjectStatus): MoqtObject;
1085
1113
  /**
1086
- * Create a MoqtObject from a Datagram (Draft-16).
1114
+ * Create a MoqtObject from a Datagram.
1087
1115
  * @param datagram - The received Datagram.
1088
1116
  * @param fullTrackName - The resolved full track name.
1089
1117
  * @param defaultPriority - The default publisher priority from the control message (used when DEFAULT_PRIORITY bit is set).
@@ -1098,7 +1126,7 @@ declare class MoqtObject {
1098
1126
  static fromFetchObject(fetchObject: FetchObject, fullTrackName: FullTrackName): MoqtObject;
1099
1127
  static fromSubgroupObject(subgroupObject: SubgroupObject, groupId: bigint | number, publisherPriority: number | undefined, subgroupId: bigint | number | null, fullTrackName: FullTrackName): MoqtObject;
1100
1128
  /**
1101
- * Convert to Datagram for wire transmission (Draft-16).
1129
+ * Convert to Datagram for wire transmission.
1102
1130
  * Automatically creates a payload or status Datagram based on the object's state.
1103
1131
  * @param trackAlias - The track alias to use.
1104
1132
  * @param endOfGroup - Whether this is the last object in the group (only for payload datagrams).
@@ -1266,8 +1294,7 @@ declare class ByteBuffer extends BaseByteBuffer {
1266
1294
  putU16(v: number): void;
1267
1295
  /**
1268
1296
  /**
1269
- * Encode a MOQT draft-18 varint using the minimal length.
1270
- * See section 1.4.1 https://datatracker.ietf.org/doc/draft-ietf-moq-transport/
1297
+ * Encode a MOQT varint using the minimal length.
1271
1298
  */
1272
1299
  putVI(v: bigint | number): void;
1273
1300
  putBytes(src: Uint8Array): void;
@@ -1285,24 +1312,22 @@ declare class FrozenByteBuffer extends BaseByteBuffer {
1285
1312
  get length(): number;
1286
1313
  }
1287
1314
  //#endregion
1288
- //#region src/model/control/publish_blocked.d.ts
1315
+ //#region src/model/control/publish_skipped.d.ts
1289
1316
  /**
1290
1317
  * @public
1291
- * PUBLISH_BLOCKED (0xF): a publisher tells the peer it cannot send the PUBLISH that
1292
- * would start a subscription to a track under a SUBSCRIBE_TRACKS namespace, because it
1293
- * is blocked by the peer's bidirectional stream limit. It MUST NOT send PUBLISH for
1294
- * that track until the limit lifts (§10.20).
1318
+ * PUBLISH_SKIPPED (0xF): a publisher tells the peer it cannot send the PUBLISH that
1319
+ * would start a subscription to a track under a SUBSCRIBE_TRACKS namespace.
1295
1320
  *
1296
1321
  * Sent on the SUBSCRIBE_TRACKS response stream, so only the namespace suffix after that
1297
1322
  * subscription's prefix is carried.
1298
1323
  */
1299
- declare class PublishBlocked {
1324
+ declare class PublishSkipped {
1300
1325
  readonly trackNamespaceSuffix: Tuple;
1301
1326
  readonly trackName: Uint8Array;
1302
1327
  constructor(trackNamespaceSuffix: Tuple, trackName: Uint8Array);
1303
1328
  getType(): ControlMessageType;
1304
1329
  serialize(): FrozenByteBuffer;
1305
- static parsePayload(buf: BaseByteBuffer): PublishBlocked;
1330
+ static parsePayload(buf: BaseByteBuffer): PublishSkipped;
1306
1331
  }
1307
1332
  //#endregion
1308
1333
  //#region src/model/parameter/constant.d.ts
@@ -1325,9 +1350,11 @@ declare enum SetupOptionType {
1325
1350
  Path = 1,
1326
1351
  AuthorizationToken = 3,
1327
1352
  MaxAuthTokenCacheSize = 4,
1328
- /** Raw-QUIC only. Client-only; MUST NOT be sent over WebTransport (draft-18 §10.3.1.1). */
1353
+ /** Raw-QUIC only. Client-only; MUST NOT be sent over WebTransport. */
1329
1354
  Authority = 5,
1355
+ MaxFilterRanges = 6,
1330
1356
  MoqtImplementation = 7,
1357
+ MaxRequestUpdates = 8,
1331
1358
  /**
1332
1359
  * PROVISIONAL: sender-side track switching is not an adopted extension, so this
1333
1360
  * codepoint is absent from the registry the conformance fixture tracks. It sits in the
@@ -1346,8 +1373,15 @@ declare enum MessageParameterType {
1346
1373
  FillTimeout = 10,
1347
1374
  Forward = 16,
1348
1375
  SubscriberPriority = 32,
1349
- SubscriptionFilter = 33,
1376
+ LocationFilter = 33,
1350
1377
  GroupOrder = 34,
1378
+ FillParameters = 35,
1379
+ SwitchFrom = 36,
1380
+ SubgroupFilter = 37,
1381
+ ObjectIdFilter = 38,
1382
+ PriorityFilter = 39,
1383
+ ObjectPropertyFilter = 40,
1384
+ TrackPropertyFilter = 41,
1351
1385
  NewGroupRequest = 50,
1352
1386
  /**
1353
1387
  * Registered codepoint with no typed parameter yet: its consumer is REQUEST_UPDATE for
@@ -1355,6 +1389,7 @@ declare enum MessageParameterType {
1355
1389
  * varint its even Type implies.
1356
1390
  */
1357
1391
  TrackNamespacePrefix = 52,
1392
+ IncludeProperties = 53,
1358
1393
  /**
1359
1394
  * PROVISIONAL: sender-side track switching is not an adopted extension, so this
1360
1395
  * codepoint is absent from the registry the conformance fixture tracks; see its
@@ -1488,6 +1523,22 @@ declare class Forward implements Parameter {
1488
1523
  static fromKeyValuePair(pair: KeyValuePair): Forward | undefined;
1489
1524
  }
1490
1525
  //#endregion
1526
+ //#region src/model/parameter/message/include_properties.d.ts
1527
+ /**
1528
+ * Whether the response carries Track Properties: the OK answering a SUBSCRIBE,
1529
+ * TRACK_STATUS or FETCH, or each PUBLISH a SUBSCRIBE_TRACKS brings. With 0 the
1530
+ * Track Properties field is still there, but empty.
1531
+ * Allowed wire values: 0 or 1; any other value is a PROTOCOL_VIOLATION.
1532
+ * Default (when omitted) is 1 (include them).
1533
+ */
1534
+ declare class IncludeProperties implements Parameter {
1535
+ readonly include: boolean;
1536
+ static readonly TYPE = MessageParameterType.IncludeProperties;
1537
+ constructor(include: boolean);
1538
+ toKeyValuePair(): KeyValuePair;
1539
+ static fromKeyValuePair(pair: KeyValuePair): IncludeProperties | undefined;
1540
+ }
1541
+ //#endregion
1491
1542
  //#region src/model/parameter/message/group_order_param.d.ts
1492
1543
  /**
1493
1544
  * How to prioritize Objects from different groups (Ascending=0x1 or Descending=0x2).
@@ -1569,7 +1620,7 @@ interface MoqtFragment {
1569
1620
  }
1570
1621
  /**
1571
1622
  * @public
1572
- * A parsed `moqt://authority/path[?query][#fragment]` URI (draft-18 §3.1).
1623
+ * A parsed `moqt://authority/path[?query][#fragment]` URI.
1573
1624
  *
1574
1625
  * `moqt-URI = "moqt" "://" authority path-abempty [ "?" query ]`, with an optional
1575
1626
  * local-only fragment. `authority` is `host[:port]`; `path` keeps its leading `/`
@@ -1665,7 +1716,7 @@ declare class NewGroupRequest implements Parameter {
1665
1716
  *
1666
1717
  * PROVISIONAL: sender-side track switching is not an adopted extension, so
1667
1718
  * this parameter has no codepoint in the registry the conformance fixture
1668
- * tracks (`dev/conformance/draft18`) and is never asserted against it. Id 0 is
1719
+ * tracks (`dev/conformance/draft22`) and is never asserted against it. Id 0 is
1669
1720
  * the default allocation every implementation runs; other ids select an
1670
1721
  * algorithm specific to one implementation.
1671
1722
  */
@@ -1706,24 +1757,330 @@ declare class SubscriberPriority implements Parameter {
1706
1757
  static fromKeyValuePair(pair: KeyValuePair): SubscriberPriority | undefined;
1707
1758
  }
1708
1759
  //#endregion
1709
- //#region src/model/parameter/message/subscription_filter.d.ts
1760
+ //#region src/model/parameter/message/location_filter.d.ts
1710
1761
  /**
1711
- * Length-prefixed Subscription Filter specifying what objects the subscriber wants.
1712
- * If omitted from SUBSCRIBE or PUBLISH_OK, the subscription is unfiltered (LatestObject).
1762
+ * The range of Locations a subscription or fetch selects. The Location Filter
1763
+ * Type decides which fields are set, and the value is not length-prefixed.
1764
+ *
1765
+ * Every Group here is absolute, except `startGroup` of a
1766
+ * {@link (LocationFilterType:enum).RelativeStart}, which counts back from the Next
1767
+ * Group: 0 is the Next Group, 1 the current one. The wire carries the End Group
1768
+ * as a delta from the Start Group; that is undone on the way in and redone on
1769
+ * the way out.
1770
+ *
1771
+ * If omitted from SUBSCRIBE or FETCH, the subscription or fetch is unfiltered.
1713
1772
  * If omitted from REQUEST_UPDATE, the value is unchanged.
1714
1773
  */
1715
- declare class SubscriptionFilter implements Parameter {
1716
- readonly filterType: FilterType;
1717
- readonly startLocation?: Location | undefined;
1774
+ declare class LocationFilter implements Parameter {
1775
+ readonly filterType: LocationFilterType;
1776
+ readonly startGroup?: bigint | undefined;
1777
+ readonly startObject?: bigint | undefined;
1718
1778
  readonly endGroup?: bigint | undefined;
1719
- static readonly TYPE = MessageParameterType.SubscriptionFilter;
1720
- constructor(filterType: FilterType, startLocation?: Location | undefined, endGroup?: bigint | undefined);
1779
+ readonly endObject?: bigint | undefined;
1780
+ static readonly TYPE = MessageParameterType.LocationFilter;
1781
+ /**
1782
+ * @throws :{@link ProtocolViolationError} When a field the type calls for is
1783
+ * missing, or the End Group is before the Start Group.
1784
+ */
1785
+ constructor(filterType: LocationFilterType, startGroup?: bigint | undefined, startObject?: bigint | undefined, endGroup?: bigint | undefined, endObject?: bigint | undefined);
1786
+ /**
1787
+ * The first Location the filter passes, given the track's Largest Object, or
1788
+ * `undefined` when there is no filter. A relative start that would fall before
1789
+ * group 0 is group 0; a track with nothing published yet starts a relative
1790
+ * filter at `{0,0}`.
1791
+ */
1792
+ startLocation(largest?: Location): Location | undefined;
1793
+ /** The Start Location an absolute filter carries; `undefined` for the others. */
1794
+ get absoluteStart(): Location | undefined;
1795
+ /**
1796
+ * The last Location the filter passes, inclusive, or `undefined` when it is
1797
+ * open-ended. A Group End is the whole of that group, so its Object is 2^64-1.
1798
+ */
1799
+ endLocation(): Location | undefined;
1800
+ /**
1801
+ * The inclusive range the filter selects under the rules for a Fetch, which
1802
+ * never reach past the Largest Object: an open end is the Largest Object, and
1803
+ * no filter at all is the whole track up to it.
1804
+ *
1805
+ * `undefined` when that range is empty, which includes a track with nothing
1806
+ * published yet and a Next Object filter, whose start is always past the
1807
+ * Largest Object.
1808
+ */
1809
+ fetchRange(largest?: Location): {
1810
+ start: Location;
1811
+ end: Location;
1812
+ } | undefined;
1813
+ /** The Location Filter Type and its fields, without the Parameter Type. */
1814
+ serializeValue(): Uint8Array;
1815
+ /**
1816
+ * Reads a Location Filter Type and exactly the fields it calls for.
1817
+ * @throws :{@link ProtocolViolationError} For an unknown Location Filter Type,
1818
+ * or an End Group past 2^64-1.
1819
+ */
1820
+ static deserializeValue(buf: BaseByteBuffer): LocationFilter;
1821
+ toKeyValuePair(): KeyValuePair;
1822
+ static fromKeyValuePair(pair: KeyValuePair): LocationFilter | undefined;
1823
+ }
1824
+ //#endregion
1825
+ //#region src/model/parameter/message/switch_from.d.ts
1826
+ /**
1827
+ * Identifies the subscription being replaced by a switch request.
1828
+ * The value is two varints followed by a flags byte: bit 7 (MSB) is Publish Done;
1829
+ * bits 0 through 6 are reserved and must be zero.
1830
+ */
1831
+ declare class SwitchFrom implements Parameter {
1832
+ readonly requestId: bigint;
1833
+ readonly mode: SwitchMode;
1834
+ readonly publishDone: boolean;
1835
+ static readonly TYPE = MessageParameterType.SwitchFrom;
1836
+ constructor(requestId: bigint, mode: SwitchMode, publishDone: boolean);
1837
+ toKeyValuePair(): KeyValuePair;
1838
+ static fromKeyValuePair(pair: KeyValuePair): SwitchFrom | undefined;
1839
+ }
1840
+ //#endregion
1841
+ //#region src/model/parameter/message/fill_parameters.d.ts
1842
+ /**
1843
+ * Requests a fill fetch stream, and overrides for it. An omitted parameter keeps
1844
+ * the value it has for the live subscription; an omitted LOCATION_FILTER fills
1845
+ * over the subscription's own.
1846
+ */
1847
+ declare class FillParameters implements Parameter {
1848
+ readonly parameters: MessageParameter[];
1849
+ static readonly TYPE = MessageParameterType.FillParameters;
1850
+ constructor(parameters: MessageParameter[]);
1721
1851
  toKeyValuePair(): KeyValuePair;
1722
- static fromKeyValuePair(pair: KeyValuePair): SubscriptionFilter | undefined;
1852
+ static fromKeyValuePair(pair: KeyValuePair): FillParameters | undefined;
1853
+ }
1854
+ //#endregion
1855
+ //#region src/model/error/error.d.ts
1856
+ /**
1857
+ * Copyright 2025 The MOQtail Authors
1858
+ *
1859
+ * Licensed under the Apache License, Version 2.0 (the "License");
1860
+ * you may not use this file except in compliance with the License.
1861
+ * You may obtain a copy of the License at
1862
+ *
1863
+ * http://www.apache.org/licenses/LICENSE-2.0
1864
+ *
1865
+ * Unless required by applicable law or agreed to in writing, software
1866
+ * distributed under the License is distributed on an "AS IS" BASIS,
1867
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1868
+ * See the License for the specific language governing permissions and
1869
+ * limitations under the License.
1870
+ */
1871
+ /**
1872
+ * Base class for all MOQtail errors.
1873
+ */
1874
+ declare class MOQtailError extends Error {
1875
+ constructor(cause?: string);
1876
+ }
1877
+ /**
1878
+ * Not enough bytes in buffer to satisfy a read.
1879
+ */
1880
+ declare class NotEnoughBytesError extends MOQtailError {
1881
+ context: string;
1882
+ needed: number;
1883
+ available: number;
1884
+ constructor(context: string, needed: number, available: number);
1885
+ }
1886
+ /**
1887
+ * Cannot cast between two incompatible types.
1888
+ */
1889
+ declare class CastingError extends MOQtailError {
1890
+ context: string;
1891
+ fromType: string;
1892
+ toType: string;
1893
+ details: string;
1894
+ constructor(context: string, fromType: string, toType: string, details: string);
1895
+ }
1896
+ /**
1897
+ * Value too large to encode as varint.
1898
+ */
1899
+ declare class VarIntOverflowError extends MOQtailError {
1900
+ context: string;
1901
+ value: number;
1902
+ constructor(context: string, value: number);
1903
+ }
1904
+ /**
1905
+ * Length exceeds maximum allowed by protocol.
1906
+ */
1907
+ declare class LengthExceedsMaxError extends MOQtailError {
1908
+ context: string;
1909
+ max: number;
1910
+ len: number;
1911
+ constructor(context: string, max: number, len: number);
1912
+ }
1913
+ /**
1914
+ * Key/value formatting error.
1915
+ */
1916
+ declare class KeyValueFormattingError extends MOQtailError {
1917
+ context: string;
1918
+ constructor(context: string);
1919
+ }
1920
+ /**
1921
+ * Invalid discriminant or type tag.
1922
+ */
1923
+ declare class InvalidTypeError extends MOQtailError {
1924
+ context: string;
1925
+ details: string;
1926
+ constructor(context: string, details: string);
1927
+ }
1928
+ /**
1929
+ * Invalid enum discriminant / value encountered when mapping to a protocol enum.
1930
+ */
1931
+ declare class InvalidEnumValue extends MOQtailError {
1932
+ context: string;
1933
+ value: bigint | number;
1934
+ constructor(context: string, value: bigint | number);
1935
+ }
1936
+ /**
1937
+ * Invalid UTF-8 encountered in a string or bytes field.
1938
+ */
1939
+ declare class InvalidUTF8Error extends MOQtailError {
1940
+ context: string;
1941
+ details: string;
1942
+ constructor(context: string, details: string);
1943
+ }
1944
+ /**
1945
+ * Generic protocol violation.
1946
+ */
1947
+ declare class ProtocolViolationError extends MOQtailError {
1948
+ context: string;
1949
+ details: string;
1950
+ constructor(context: string, details: string);
1951
+ }
1952
+ /**
1953
+ * Track naming error.
1954
+ */
1955
+ declare class TrackNameError extends MOQtailError {
1956
+ context: string;
1957
+ details: string;
1958
+ constructor(context: string, details: string);
1959
+ }
1960
+ /**
1961
+ * Request ID error.
1962
+ */
1963
+ declare class RequestIdError extends MOQtailError {
1964
+ context: string;
1965
+ details: string;
1966
+ constructor(context: string, details: string);
1967
+ }
1968
+ /**
1969
+ * Operation timed out.
1970
+ */
1971
+ declare class TimeoutError extends MOQtailError {
1972
+ context: string;
1973
+ constructor(context: string);
1974
+ }
1975
+ /**
1976
+ * Internal error.
1977
+ */
1978
+ declare class InternalError extends MOQtailError {
1979
+ context: string;
1980
+ details: string;
1981
+ constructor(context: string, details: string);
1982
+ }
1983
+ /**
1984
+ * Connection terminated.
1985
+ */
1986
+ declare class TerminationError extends MOQtailError {
1987
+ context: string;
1988
+ terminationCode: number;
1989
+ constructor(context: string, terminationCode: number);
1990
+ }
1991
+ //#endregion
1992
+ //#region src/model/parameter/message/range_filter.d.ts
1993
+ /**
1994
+ * What a Range Filter selects on. Each kind is its own parameter type, and the two
1995
+ * property kinds also name the Property they read.
1996
+ */
1997
+ declare enum RangeFilterKind {
1998
+ Subgroup = 37,
1999
+ ObjectId = 38,
2000
+ /** Publisher Priority, which is a single byte. */
2001
+ Priority = 39,
2002
+ ObjectProperty = 40,
2003
+ /** Selects tracks rather than Objects, so it only rides SUBSCRIBE_TRACKS. */
2004
+ TrackProperty = 41
2005
+ }
2006
+ declare namespace RangeFilterKind {
2007
+ /** Whether the filter carries a Property Type after its SetID. */
2008
+ function hasPropertyType(kind: RangeFilterKind): boolean;
2009
+ function isRangeFilterType(typeValue: bigint | number): boolean;
2010
+ }
2011
+ /** An inclusive range of values. An open-ended range has no `end`. */
2012
+ interface Range {
2013
+ readonly start: bigint;
2014
+ readonly end?: bigint;
2015
+ }
2016
+ /**
2017
+ * A Range as the wire carries it: the Start as a delta from the End before it, the
2018
+ * End as a delta from its own Start.
2019
+ */
2020
+ type RangeDelta = readonly [start: bigint, end?: bigint];
2021
+ /**
2022
+ * A Range Filter that cannot be honoured. A peer that sends one is answered with
2023
+ * REQUEST_ERROR INVALID_FILTER rather than a closed session: the request is
2024
+ * well-formed, it just asks for something that cannot be applied.
2025
+ */
2026
+ declare class InvalidFilterError extends MOQtailError {
2027
+ readonly context: string;
2028
+ readonly details: string;
2029
+ constructor(context: string, details: string);
2030
+ }
2031
+ /**
2032
+ * Delta-encodes ascending `ranges`. Only the last may be open-ended.
2033
+ * @throws :{@link InvalidFilterError} When the ranges do not ascend.
2034
+ */
2035
+ declare function encodeRanges(ranges: readonly Range[]): RangeDelta[];
2036
+ /**
2037
+ * One Range Filter parameter. Unlike other parameters it may repeat in a message,
2038
+ * once per SetID (and Property Type).
2039
+ *
2040
+ * Without a `setId` it is the zero-length form, which in REQUEST_UPDATE removes the
2041
+ * filters of its kind.
2042
+ *
2043
+ * The Ranges are held as the wire's deltas and only added back by {@link
2044
+ * RangeFilter.ranges}: a sum past 2^64-1 is answered with a REQUEST_ERROR for the
2045
+ * request that carried it, which a parser that rejected it could not do.
2046
+ */
2047
+ declare class RangeFilter implements Parameter {
2048
+ readonly kind: RangeFilterKind;
2049
+ readonly setId?: number | undefined;
2050
+ readonly propertyType?: bigint | undefined;
2051
+ readonly deltas: readonly RangeDelta[];
2052
+ /**
2053
+ * @throws :{@link ProtocolViolationError} When the Property Type's presence does not
2054
+ * match the kind, or a removal carries anything but its kind.
2055
+ */
2056
+ constructor(kind: RangeFilterKind, setId?: number | undefined, propertyType?: bigint | undefined, deltas?: readonly RangeDelta[]);
2057
+ /** The zero-length form, which removes the filters of its kind. */
2058
+ get isRemoval(): boolean;
2059
+ /** How many Ranges the filter holds, which is what a peer's range limit counts. */
2060
+ get rangeCount(): number;
2061
+ /**
2062
+ * The Ranges with their deltas added back.
2063
+ * @throws :{@link InvalidFilterError} When a bound exceeds 2^64-1.
2064
+ */
2065
+ ranges(): Range[];
2066
+ /**
2067
+ * The Ranges, once everything a filter of this kind has to satisfy holds.
2068
+ * @throws :{@link InvalidFilterError} For an odd Property Type, a priority above
2069
+ * 255, or a bound past 2^64-1.
2070
+ */
2071
+ validate(): Range[];
2072
+ /** The SetID, Property Type if any, and the Ranges, without the Type or Length. */
2073
+ serializeValue(): Uint8Array;
2074
+ toKeyValuePair(): KeyValuePair;
2075
+ /**
2076
+ * Decodes a Range Filter value. The Value ends with the last Range, so a Start
2077
+ * with nothing after it is an open-ended last Range.
2078
+ */
2079
+ static fromKeyValuePair(pair: KeyValuePair): RangeFilter | undefined;
1723
2080
  }
1724
2081
  //#endregion
1725
2082
  //#region src/model/parameter/message_parameter.d.ts
1726
- type MessageParameter = ObjectDeliveryTimeout | SubgroupDeliveryTimeout | RendezvousTimeout | FillTimeout | AuthorizationToken | Expires | LargestObject | Forward | SubscriberPriority | GroupOrderParam | SubscriptionFilter | NewGroupRequest | SwitchingSetAssignment;
2083
+ type MessageParameter = ObjectDeliveryTimeout | SubgroupDeliveryTimeout | RendezvousTimeout | FillTimeout | AuthorizationToken | Expires | LargestObject | Forward | SubscriberPriority | GroupOrderParam | LocationFilter | NewGroupRequest | SwitchFrom | FillParameters | RangeFilter | IncludeProperties | SwitchingSetAssignment;
1727
2084
  declare namespace MessageParameter {
1728
2085
  /**
1729
2086
  * Parses a single KeyValuePair into a MessageParameter.
@@ -1745,8 +2102,30 @@ declare namespace MessageParameter {
1745
2102
  function isSwitchingSetAssignment(param: MessageParameter): param is SwitchingSetAssignment;
1746
2103
  /** The negotiated Group Order, or {@link (GroupOrder:enum).Original} when unparameterized. */
1747
2104
  function groupOrderOf(params: readonly MessageParameter[]): GroupOrder;
1748
- function isSubscriptionFilter(param: MessageParameter): param is SubscriptionFilter;
2105
+ function isLocationFilter(param: MessageParameter): param is LocationFilter;
1749
2106
  function isNewGroupRequest(param: MessageParameter): param is NewGroupRequest;
2107
+ function isSwitchFrom(param: MessageParameter): param is SwitchFrom;
2108
+ function isFillParameters(param: MessageParameter): param is FillParameters;
2109
+ function isRangeFilter(param: MessageParameter): param is RangeFilter;
2110
+ /**
2111
+ * Whether `params` carry a Range Filter, either directly or inside FILL_PARAMETERS,
2112
+ * removals included. An endpoint that allows no filter ranges rejects any of them.
2113
+ */
2114
+ function carriesRangeFilter(params: readonly MessageParameter[]): boolean;
2115
+ function isIncludeProperties(param: MessageParameter): param is IncludeProperties;
2116
+ /**
2117
+ * The parameters a PUBLISH answering a SUBSCRIBE_TRACKS states: the request's
2118
+ * settings that a PUBLISH can carry (FORWARD, GROUP_ORDER, LOCATION_FILTER), which
2119
+ * are the new subscription's initial settings. AUTHORIZATION_TOKEN is never copied.
2120
+ * The Range Filters, FILL_PARAMETERS and INCLUDE_PROPERTIES cannot go in a PUBLISH;
2121
+ * they are the publisher's to apply.
2122
+ */
2123
+ function publishParametersFor(subscribeTracks: readonly MessageParameter[]): MessageParameter[];
2124
+ /**
2125
+ * Whether a request's response should carry Track Properties: false only when it
2126
+ * has INCLUDE_PROPERTIES set to 0.
2127
+ */
2128
+ function includesProperties(params: readonly MessageParameter[]): boolean;
1750
2129
  }
1751
2130
  /**
1752
2131
  * Builder for constructing a list of MessageParameters.
@@ -1762,10 +2141,14 @@ declare class MessageParameters {
1762
2141
  addAuthorizationToken(token: AuthorizationToken): this;
1763
2142
  addExpires(expires: bigint | number): this;
1764
2143
  addForward(forward: boolean): this;
2144
+ addIncludeProperties(include: boolean): this;
1765
2145
  addSubscriberPriority(priority: number): this;
1766
2146
  addGroupOrder(order: GroupOrderParam['order']): this;
1767
- addSubscriptionFilter(filter: SubscriptionFilter): this;
2147
+ addLocationFilter(filter: LocationFilter): this;
1768
2148
  addNewGroupRequest(group: bigint | number): this;
2149
+ addSwitchFrom(requestId: bigint | number, mode: SwitchMode, publishDone: boolean): this;
2150
+ addFillParameters(parameters: MessageParameter[]): this;
2151
+ addRangeFilter(filter: RangeFilter): this;
1769
2152
  build(): MessageParameter[];
1770
2153
  /**
1771
2154
  * Parses an array of KeyValuePairs into a list of MessageParameters.
@@ -1786,8 +2169,12 @@ declare function serializeMessageParameterKvps(items: KeyValuePair[]): FrozenByt
1786
2169
  declare function deserializeMessageParameterKvps(buf: BaseByteBuffer, count: number | bigint): KeyValuePair[];
1787
2170
  /**
1788
2171
  * Applies a set of parameter updates to an existing parameter list.
1789
- * For each update, replaces the matching parameter (by wire type value) or appends it.
1790
- * Per spec: "If omitted from REQUEST_UPDATE/SUBSCRIBE_UPDATE, the value is unchanged."
2172
+ *
2173
+ * A Type the update leaves out keeps its value. A Type it carries is replaced
2174
+ * outright, every instance of it: a Range Filter can repeat, and an update that
2175
+ * names a filter kind states the whole of that kind, so one left over from before
2176
+ * would quietly widen or narrow what the subscriber asked for. A zero-length Range
2177
+ * Filter replaces its kind with nothing.
1791
2178
  */
1792
2179
  declare function applyMessageParameterUpdate(current: MessageParameter[], updates: MessageParameter[]): void;
1793
2180
  //#endregion
@@ -1866,11 +2253,10 @@ declare class NamespaceDone {
1866
2253
  //#endregion
1867
2254
  //#region src/model/control/setup.d.ts
1868
2255
  /**
1869
- * The first message each endpoint sends on its control stream (draft-18 §10.3).
2256
+ * The first message each endpoint sends on its control stream.
1870
2257
  *
1871
2258
  * Both peers send the same message; there are no separate client and server forms and
1872
- * no version fields, since version negotiation happens over ALPN (§3.1). Replaces
1873
- * CLIENT_SETUP / SERVER_SETUP.
2259
+ * no version fields, since version negotiation happens over ALPN.
1874
2260
  *
1875
2261
  * Some options are client-only (see {@link SetupOptionType}); whether a peer is
1876
2262
  * allowed to send a given option depends on which side it is and on the transport,
@@ -1888,47 +2274,14 @@ declare class Setup {
1888
2274
  //#region src/model/control/fetch.d.ts
1889
2275
  declare class Fetch {
1890
2276
  readonly requestId: bigint;
1891
- readonly typeAndProps: {
1892
- readonly type: FetchType.Standalone;
1893
- readonly props: {
1894
- fullTrackName: FullTrackName;
1895
- startLocation: Location;
1896
- endLocation: Location;
1897
- };
1898
- } | {
1899
- readonly type: FetchType.Relative;
1900
- readonly props: {
1901
- joiningRequestId: bigint;
1902
- joiningStart: bigint;
1903
- };
1904
- } | {
1905
- readonly type: FetchType.Absolute;
1906
- readonly props: {
1907
- joiningRequestId: bigint;
1908
- joiningStart: bigint;
1909
- };
1910
- };
2277
+ readonly fullTrackName: FullTrackName;
1911
2278
  readonly parameters: MessageParameter[];
1912
- constructor(requestId: bigint, typeAndProps: {
1913
- readonly type: FetchType.Standalone;
1914
- readonly props: {
1915
- fullTrackName: FullTrackName;
1916
- startLocation: Location;
1917
- endLocation: Location;
1918
- };
1919
- } | {
1920
- readonly type: FetchType.Relative;
1921
- readonly props: {
1922
- joiningRequestId: bigint;
1923
- joiningStart: bigint;
1924
- };
1925
- } | {
1926
- readonly type: FetchType.Absolute;
1927
- readonly props: {
1928
- joiningRequestId: bigint;
1929
- joiningStart: bigint;
1930
- };
1931
- }, parameters: MessageParameter[]);
2279
+ constructor(requestId: bigint, fullTrackName: FullTrackName, parameters: MessageParameter[]);
2280
+ /**
2281
+ * The requested range. A FETCH without a LOCATION_FILTER parameter asks for the
2282
+ * whole track up to the Largest Object, the same as a {@link (LocationFilterType:enum).None} filter.
2283
+ */
2284
+ get locationFilter(): LocationFilter;
1932
2285
  getType(): ControlMessageType;
1933
2286
  serialize(): FrozenByteBuffer;
1934
2287
  static parsePayload(buf: BaseByteBuffer): Fetch;
@@ -1951,11 +2304,12 @@ declare class Fetch {
1951
2304
  * limitations under the License.
1952
2305
  */
1953
2306
  declare enum LOCPropertyId {
1954
- Timestamp = 6,
1955
2307
  Timescale = 8,
1956
- VideoFrameMarking = 10,
2308
+ VideoFrameMarking = 9,
1957
2309
  AudioLevel = 12,
1958
- VideoConfig = 13
2310
+ VideoConfig = 13,
2311
+ AudioConfig = 15,
2312
+ Timestamp = 16
1959
2313
  }
1960
2314
  declare enum TrackPropertyType {
1961
2315
  ObjectDeliveryTimeout = 2,
@@ -1980,11 +2334,8 @@ interface PropertyRange {
1980
2334
  }
1981
2335
  /**
1982
2336
  * @public
1983
- * Registration-policy ranges for the Property Type space (§15.8).
2337
+ * Registration-policy ranges for the Property Type space.
1984
2338
  *
1985
- * §2.5 gives the 1-byte application-specific range as `0x38-0x3F`; that is stale text
1986
- * from before draft-18's varint change, which made the 1-byte space `0x00-0x7F`.
1987
- * §15.8 is the correct table and is what these constants follow.
1988
2339
  */
1989
2340
  declare const PropertyRanges: {
1990
2341
  /** Standards Action or IESG Approval (1-byte encoding). */readonly StandardsAction: {
@@ -2098,10 +2449,13 @@ declare namespace TrackProperty {
2098
2449
  */
2099
2450
  declare class FetchOk {
2100
2451
  readonly endOfTrack: boolean;
2452
+ /** The last Location the response covers, inclusive. Object 2^64-1 is all of that group. */
2101
2453
  readonly endLocation: Location;
2102
2454
  readonly parameters: MessageParameter[];
2103
2455
  readonly trackProperties: TrackProperty[];
2104
- constructor(endOfTrack: boolean, endLocation: Location, parameters: MessageParameter[], trackProperties?: TrackProperty[]);
2456
+ constructor(endOfTrack: boolean, /** The last Location the response covers, inclusive. Object 2^64-1 is all of that group. */
2457
+
2458
+ endLocation: Location, parameters: MessageParameter[], trackProperties?: TrackProperty[]);
2105
2459
  getType(): ControlMessageType;
2106
2460
  serialize(): FrozenByteBuffer;
2107
2461
  static parsePayload(buf: BaseByteBuffer): FetchOk;
@@ -2112,7 +2466,7 @@ declare class FetchOk {
2112
2466
  declare const MAX_NEW_SESSION_URI_LENGTH = 8192;
2113
2467
  /**
2114
2468
  * GOAWAY (0x10) winds down a session, or — on a request stream — migrates that one
2115
- * request (§10.4).
2469
+ * request.
2116
2470
  */
2117
2471
  declare class GoAway {
2118
2472
  newSessionUri?: string | undefined;
@@ -2122,12 +2476,7 @@ declare class GoAway {
2122
2476
  * on a request stream it resets the stream with `GOING_AWAY`.
2123
2477
  */
2124
2478
  readonly timeout: bigint;
2125
- /**
2126
- * The smallest peer Request ID that was not or might not have been processed. Present
2127
- * only on the control stream, so a GOAWAY migrating a single request omits it.
2128
- */
2129
- readonly requestId?: bigint | undefined;
2130
- constructor(newSessionUri?: string, timeout?: bigint, requestId?: bigint);
2479
+ constructor(newSessionUri?: string, timeout?: bigint);
2131
2480
  getType(): ControlMessageType;
2132
2481
  serialize(): FrozenByteBuffer;
2133
2482
  static parsePayload(buf: BaseByteBuffer): GoAway;
@@ -2138,11 +2487,7 @@ declare class Subscribe {
2138
2487
  requestId: bigint;
2139
2488
  fullTrackName: FullTrackName;
2140
2489
  parameters: MessageParameter[];
2141
- private constructor();
2142
- static newNextGroupStart(requestId: bigint, fullTrackName: FullTrackName, parameters: MessageParameter[]): Subscribe;
2143
- static newLatestObject(requestId: bigint, fullTrackName: FullTrackName, parameters: MessageParameter[]): Subscribe;
2144
- static newAbsoluteStart(requestId: bigint, fullTrackName: FullTrackName, startLocation: Location, parameters: MessageParameter[]): Subscribe;
2145
- static newAbsoluteRange(requestId: bigint, fullTrackName: FullTrackName, startLocation: Location, endGroup: bigint, parameters: MessageParameter[]): Subscribe;
2490
+ constructor(requestId: bigint, fullTrackName: FullTrackName, parameters: MessageParameter[]);
2146
2491
  getType(): ControlMessageType;
2147
2492
  serialize(): FrozenByteBuffer;
2148
2493
  static parsePayload(buf: BaseByteBuffer): Subscribe;
@@ -2153,6 +2498,11 @@ declare class PublishDone {
2153
2498
  readonly statusCode: PublishDoneStatusCode;
2154
2499
  readonly streamCount: bigint;
2155
2500
  readonly errorReason: ReasonPhrase;
2501
+ /**
2502
+ * The Stream Count a publisher sends when it cannot name the exact number of streams
2503
+ * it opened. Receivers fall back on a timeout to end the subscription.
2504
+ */
2505
+ static readonly UNKNOWN_STREAM_COUNT: bigint;
2156
2506
  constructor(statusCode: PublishDoneStatusCode, streamCount: bigint, errorReason: ReasonPhrase);
2157
2507
  static new(statusCode: PublishDoneStatusCode, streamCount: bigint, errorReason: ReasonPhrase): PublishDone;
2158
2508
  getType(): ControlMessageType;
@@ -2209,15 +2559,9 @@ declare class TrackStatus {
2209
2559
  subscriberPriority: number;
2210
2560
  groupOrder: GroupOrder;
2211
2561
  forward: boolean;
2212
- filterType: FilterType;
2213
- startLocation: Location | undefined;
2214
- endGroup: bigint | undefined;
2562
+ locationFilter: LocationFilter;
2215
2563
  subscribeParameters: MessageParameter[];
2216
- private constructor();
2217
- static newNextGroupStart(requestId: bigint, trackAlias: bigint, fullTrackName: FullTrackName, subscriberPriority: number, groupOrder: GroupOrder, forward: boolean, subscribeParameters: MessageParameter[]): TrackStatus;
2218
- static newLatestObject(requestId: bigint, trackAlias: bigint, fullTrackName: FullTrackName, subscriberPriority: number, groupOrder: GroupOrder, forward: boolean, subscribeParameters: MessageParameter[]): TrackStatus;
2219
- static newAbsoluteStart(requestId: bigint, trackAlias: bigint, fullTrackName: FullTrackName, subscriberPriority: number, groupOrder: GroupOrder, forward: boolean, startLocation: Location, subscribeParameters: MessageParameter[]): TrackStatus;
2220
- static newAbsoluteRange(requestId: bigint, trackAlias: bigint, fullTrackName: FullTrackName, subscriberPriority: number, groupOrder: GroupOrder, forward: boolean, startLocation: Location, endGroup: bigint, subscribeParameters: MessageParameter[]): TrackStatus;
2564
+ constructor(requestId: bigint, trackAlias: bigint, fullTrackName: FullTrackName, subscriberPriority: number, groupOrder: GroupOrder, forward: boolean, locationFilter: LocationFilter, subscribeParameters: MessageParameter[]);
2221
2565
  getType(): ControlMessageType;
2222
2566
  serialize(): FrozenByteBuffer;
2223
2567
  static parsePayload(buf: BaseByteBuffer): TrackStatus;
@@ -2252,18 +2596,6 @@ declare class SubscribeTracks {
2252
2596
  static parsePayload(buf: BaseByteBuffer): SubscribeTracks;
2253
2597
  }
2254
2598
  //#endregion
2255
- //#region src/model/control/switch.d.ts
2256
- declare class Switch {
2257
- requestId: bigint;
2258
- fullTrackName: FullTrackName;
2259
- subscriptionRequestId: bigint;
2260
- parameters: KeyValuePair[];
2261
- constructor(requestId: bigint, fullTrackName: FullTrackName, subscriptionRequestId: bigint, parameters: KeyValuePair[]);
2262
- getType(): ControlMessageType;
2263
- serialize(): FrozenByteBuffer;
2264
- static parsePayload(buf: BaseByteBuffer): Switch;
2265
- }
2266
- //#endregion
2267
2599
  //#region src/model/control/request_ok.d.ts
2268
2600
  /**
2269
2601
  * @public
@@ -2272,13 +2604,12 @@ declare class Switch {
2272
2604
  * names (PUBLISH_OK, TRACK_STATUS_OK, ...) are shorthands for logging, not distinct
2273
2605
  * messages. SUBSCRIBE_OK (0x4) and FETCH_OK (0x18) do keep bodies of their own.
2274
2606
  *
2275
- * It carries no Request ID: the request stream it arrives on identifies the request
2276
- * (§10.1).
2607
+ * It carries no Request ID: the request stream it arrives on identifies the request.
2277
2608
  */
2278
2609
  declare class RequestOk {
2279
2610
  readonly parameters: MessageParameter[];
2280
2611
  /**
2281
- * Draft-18 Track Properties, which the trailing bytes of the payload carry with no
2612
+ * Track Properties, which the trailing bytes of the payload carry with no
2282
2613
  * count of their own. Populated only in TRACK_STATUS_OK; empty for every other request
2283
2614
  * type — see {@link RequestOk.validateTrackProperties}.
2284
2615
  */
@@ -2324,12 +2655,58 @@ declare class RequestError {
2324
2655
  }
2325
2656
  //#endregion
2326
2657
  //#region src/model/control/control_message.d.ts
2327
- type ControlMessage = Publish | PublishBlocked | PublishDone | PublishNamespace | Namespace | NamespaceDone | Setup | Fetch | FetchOk | GoAway | Subscribe | RequestError | SubscribeOk | RequestUpdate | TrackStatus | SubscribeNamespace | SubscribeTracks | RequestOk | Switch;
2658
+ type ControlMessage = Publish | PublishSkipped | PublishDone | PublishNamespace | Namespace | NamespaceDone | Setup | Fetch | FetchOk | GoAway | Subscribe | RequestError | SubscribeOk | RequestUpdate | TrackStatus | SubscribeNamespace | SubscribeTracks | RequestOk;
2328
2659
  declare namespace ControlMessage {
2329
2660
  function deserialize(buf: FrozenByteBuffer): ControlMessage;
2330
2661
  function serialize(msg: ControlMessage): FrozenByteBuffer;
2331
2662
  }
2332
2663
  //#endregion
2664
+ //#region src/model/error/stream_reset.d.ts
2665
+ /**
2666
+ * Copyright 2026 The MOQtail Authors
2667
+ *
2668
+ * Licensed under the Apache License, Version 2.0 (the "License");
2669
+ * you may not use this file except in compliance with the License.
2670
+ * You may obtain a copy of the License at
2671
+ *
2672
+ * http://www.apache.org/licenses/LICENSE-2.0
2673
+ *
2674
+ * Unless required by applicable law or agreed to in writing, software
2675
+ * distributed under the License is distributed on an "AS IS" BASIS,
2676
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2677
+ * See the License for the specific language governing permissions and
2678
+ * limitations under the License.
2679
+ */
2680
+ /**
2681
+ * @public
2682
+ * Codes carried when resetting a request stream or sending STOP_SENDING on one.
2683
+ *
2684
+ * A separate registry from {@link (RequestErrorCode:enum)}, which disagrees with it on
2685
+ * the same names: `GOING_AWAY` is `0x4` here but `0x6` there.
2686
+ */
2687
+ declare enum StreamResetCode {
2688
+ InternalError = 0,
2689
+ Cancelled = 1,
2690
+ DeliveryTimeout = 2,
2691
+ SessionClosed = 3,
2692
+ GoingAway = 4,
2693
+ TooFarBehind = 5,
2694
+ UnknownObjectStatus = 6,
2695
+ ExpiredAuthToken = 7,
2696
+ ExcessiveLoad = 9,
2697
+ MalformedTrack = 18
2698
+ }
2699
+ declare namespace StreamResetCode {
2700
+ /**
2701
+ * Converts a numeric application error code to a StreamResetCode. The code is a
2702
+ * `number` because that is what the transport reports it as
2703
+ * (`WebTransportError.streamErrorCode`, an `unsigned long`).
2704
+ *
2705
+ * @throws :{@link InvalidEnumValue} if the code is not a defined stream reset code.
2706
+ */
2707
+ function tryFrom(code: number): StreamResetCode;
2708
+ }
2709
+ //#endregion
2333
2710
  //#region src/model/catalog/cmsf.d.ts
2334
2711
  /**
2335
2712
  * Copyright 2026 The MOQtail Authors
@@ -2381,143 +2758,6 @@ declare class CMSFCatalog {
2381
2758
  private extractTrackName;
2382
2759
  }
2383
2760
  //#endregion
2384
- //#region src/model/error/error.d.ts
2385
- /**
2386
- * Copyright 2025 The MOQtail Authors
2387
- *
2388
- * Licensed under the Apache License, Version 2.0 (the "License");
2389
- * you may not use this file except in compliance with the License.
2390
- * You may obtain a copy of the License at
2391
- *
2392
- * http://www.apache.org/licenses/LICENSE-2.0
2393
- *
2394
- * Unless required by applicable law or agreed to in writing, software
2395
- * distributed under the License is distributed on an "AS IS" BASIS,
2396
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2397
- * See the License for the specific language governing permissions and
2398
- * limitations under the License.
2399
- */
2400
- /**
2401
- * Base class for all MOQtail errors.
2402
- */
2403
- declare class MOQtailError extends Error {
2404
- constructor(cause?: string);
2405
- }
2406
- /**
2407
- * Not enough bytes in buffer to satisfy a read.
2408
- */
2409
- declare class NotEnoughBytesError extends MOQtailError {
2410
- context: string;
2411
- needed: number;
2412
- available: number;
2413
- constructor(context: string, needed: number, available: number);
2414
- }
2415
- /**
2416
- * Cannot cast between two incompatible types.
2417
- */
2418
- declare class CastingError extends MOQtailError {
2419
- context: string;
2420
- fromType: string;
2421
- toType: string;
2422
- details: string;
2423
- constructor(context: string, fromType: string, toType: string, details: string);
2424
- }
2425
- /**
2426
- * Value too large to encode as varint.
2427
- */
2428
- declare class VarIntOverflowError extends MOQtailError {
2429
- context: string;
2430
- value: number;
2431
- constructor(context: string, value: number);
2432
- }
2433
- /**
2434
- * Length exceeds maximum allowed by protocol.
2435
- */
2436
- declare class LengthExceedsMaxError extends MOQtailError {
2437
- context: string;
2438
- max: number;
2439
- len: number;
2440
- constructor(context: string, max: number, len: number);
2441
- }
2442
- /**
2443
- * Key/value formatting error.
2444
- */
2445
- declare class KeyValueFormattingError extends MOQtailError {
2446
- context: string;
2447
- constructor(context: string);
2448
- }
2449
- /**
2450
- * Invalid discriminant or type tag.
2451
- */
2452
- declare class InvalidTypeError extends MOQtailError {
2453
- context: string;
2454
- details: string;
2455
- constructor(context: string, details: string);
2456
- }
2457
- /**
2458
- * Invalid enum discriminant / value encountered when mapping to a protocol enum.
2459
- */
2460
- declare class InvalidEnumValue extends MOQtailError {
2461
- context: string;
2462
- value: bigint | number;
2463
- constructor(context: string, value: bigint | number);
2464
- }
2465
- /**
2466
- * Invalid UTF-8 encountered in a string or bytes field.
2467
- */
2468
- declare class InvalidUTF8Error extends MOQtailError {
2469
- context: string;
2470
- details: string;
2471
- constructor(context: string, details: string);
2472
- }
2473
- /**
2474
- * Generic protocol violation.
2475
- */
2476
- declare class ProtocolViolationError extends MOQtailError {
2477
- context: string;
2478
- details: string;
2479
- constructor(context: string, details: string);
2480
- }
2481
- /**
2482
- * Track naming error.
2483
- */
2484
- declare class TrackNameError extends MOQtailError {
2485
- context: string;
2486
- details: string;
2487
- constructor(context: string, details: string);
2488
- }
2489
- /**
2490
- * Request ID error.
2491
- */
2492
- declare class RequestIdError extends MOQtailError {
2493
- context: string;
2494
- details: string;
2495
- constructor(context: string, details: string);
2496
- }
2497
- /**
2498
- * Operation timed out.
2499
- */
2500
- declare class TimeoutError extends MOQtailError {
2501
- context: string;
2502
- constructor(context: string);
2503
- }
2504
- /**
2505
- * Internal error.
2506
- */
2507
- declare class InternalError extends MOQtailError {
2508
- context: string;
2509
- details: string;
2510
- constructor(context: string, details: string);
2511
- }
2512
- /**
2513
- * Connection terminated.
2514
- */
2515
- declare class TerminationError extends MOQtailError {
2516
- context: string;
2517
- terminationCode: number;
2518
- constructor(context: string, terminationCode: number);
2519
- }
2520
- //#endregion
2521
2761
  //#region src/model/error/constant.d.ts
2522
2762
  /**
2523
2763
  * Copyright 2025 The MOQtail Authors
@@ -2549,12 +2789,12 @@ declare enum TerminationCode {
2549
2789
  DATA_STREAM_TIMEOUT = 18,
2550
2790
  AUTH_TOKEN_CACHE_OVERFLOW = 19,
2551
2791
  DUPLICATE_AUTH_TOKEN_ALIAS = 20,
2552
- VERSION_NEGOTIATION_FAILED = 21,
2553
2792
  MALFORMED_AUTH_TOKEN = 22,
2554
2793
  UNKNOWN_AUTH_TOKEN_ALIAS = 23,
2555
2794
  EXPIRED_AUTH_TOKEN = 24,
2556
2795
  INVALID_AUTHORITY = 25,
2557
- MALFORMED_AUTHORITY = 26
2796
+ MALFORMED_AUTHORITY = 26,
2797
+ TOO_MANY_REQUEST_UPDATES = 27
2558
2798
  }
2559
2799
  declare namespace TerminationCode {
2560
2800
  /**
@@ -2566,53 +2806,6 @@ declare namespace TerminationCode {
2566
2806
  function tryFrom(code: number): TerminationCode;
2567
2807
  }
2568
2808
  //#endregion
2569
- //#region src/model/error/stream_reset.d.ts
2570
- /**
2571
- * Copyright 2026 The MOQtail Authors
2572
- *
2573
- * Licensed under the Apache License, Version 2.0 (the "License");
2574
- * you may not use this file except in compliance with the License.
2575
- * You may obtain a copy of the License at
2576
- *
2577
- * http://www.apache.org/licenses/LICENSE-2.0
2578
- *
2579
- * Unless required by applicable law or agreed to in writing, software
2580
- * distributed under the License is distributed on an "AS IS" BASIS,
2581
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2582
- * See the License for the specific language governing permissions and
2583
- * limitations under the License.
2584
- */
2585
- /**
2586
- * @public
2587
- * Codes carried when resetting a request stream or sending STOP_SENDING on one, per
2588
- * draft-18 §3.3.3.
2589
- *
2590
- * A separate registry from {@link (RequestErrorCode:enum)}, which disagrees with it on
2591
- * the same names: `GOING_AWAY` is `0x4` here but `0x6` there.
2592
- */
2593
- declare enum StreamResetCode {
2594
- InternalError = 0,
2595
- Cancelled = 1,
2596
- DeliveryTimeout = 2,
2597
- SessionClosed = 3,
2598
- GoingAway = 4,
2599
- TooFarBehind = 5,
2600
- UnknownObjectStatus = 6,
2601
- ExpiredAuthToken = 7,
2602
- ExcessiveLoad = 9,
2603
- MalformedTrack = 18
2604
- }
2605
- declare namespace StreamResetCode {
2606
- /**
2607
- * Converts a numeric application error code to a StreamResetCode. The code is a
2608
- * `number` because that is what the transport reports it as
2609
- * (`WebTransportError.streamErrorCode`, an `unsigned long`).
2610
- *
2611
- * @throws :{@link InvalidEnumValue} if the code is not a defined stream reset code.
2612
- */
2613
- function tryFrom(code: number): StreamResetCode;
2614
- }
2615
- //#endregion
2616
2809
  //#region src/model/property/timestamp.d.ts
2617
2810
  declare class Timestamp {
2618
2811
  readonly timestamp: bigint;
@@ -2633,9 +2826,12 @@ declare class Timescale {
2633
2826
  //#endregion
2634
2827
  //#region src/model/property/video_frame_marking.d.ts
2635
2828
  declare class VideoFrameMarking {
2636
- readonly value: bigint;
2829
+ readonly value: Uint8Array;
2637
2830
  static readonly TYPE = LOCPropertyId.VideoFrameMarking;
2638
- constructor(value: bigint);
2831
+ /** The RFC 9626 frame-marking octets (1 to 4), without the length prefix. */
2832
+ constructor(value: Uint8Array);
2833
+ /** True if the frame decodes without temporally prior frames (the I bit). */
2834
+ get independent(): boolean;
2639
2835
  toKeyValuePair(): KeyValuePair;
2640
2836
  static fromKeyValuePair(pair: KeyValuePair): VideoFrameMarking | undefined;
2641
2837
  }
@@ -2658,8 +2854,17 @@ declare class VideoConfig {
2658
2854
  static fromKeyValuePair(pair: KeyValuePair): VideoConfig | undefined;
2659
2855
  }
2660
2856
  //#endregion
2857
+ //#region src/model/property/audio_config.d.ts
2858
+ declare class AudioConfig {
2859
+ readonly config: Uint8Array;
2860
+ static readonly TYPE = LOCPropertyId.AudioConfig;
2861
+ constructor(config: Uint8Array);
2862
+ toKeyValuePair(): KeyValuePair;
2863
+ static fromKeyValuePair(pair: KeyValuePair): AudioConfig | undefined;
2864
+ }
2865
+ //#endregion
2661
2866
  //#region src/model/property/loc.d.ts
2662
- type LOCProperty = Timestamp | Timescale | VideoFrameMarking | AudioLevel | VideoConfig;
2867
+ type LOCProperty = Timestamp | Timescale | VideoFrameMarking | AudioLevel | VideoConfig | AudioConfig;
2663
2868
  declare namespace LOCProperty {
2664
2869
  function fromKeyValuePair(pair: KeyValuePair): LOCProperty | undefined;
2665
2870
  function toKeyValuePair(header: LOCProperty): KeyValuePair;
@@ -2668,14 +2873,17 @@ declare namespace LOCProperty {
2668
2873
  function isVideoFrameMarking(header: LOCProperty): header is VideoFrameMarking;
2669
2874
  function isAudioLevel(header: LOCProperty): header is AudioLevel;
2670
2875
  function isVideoConfig(header: LOCProperty): header is VideoConfig;
2876
+ function isAudioConfig(header: LOCProperty): header is AudioConfig;
2671
2877
  }
2672
2878
  declare class LOCProperties {
2673
2879
  private kvps;
2674
2880
  addTimestamp(timestamp: bigint | number): this;
2675
2881
  addTimescale(timescale: bigint | number): this;
2676
- addVideoFrameMarking(marking: bigint | number): this;
2882
+ /** Marks a whole, non-scalable frame (RFC 9626 short form): S and E set, I set on a keyframe. */
2883
+ addVideoFrameMarking(isKey: boolean): this;
2677
2884
  addAudioLevel(audioLevel: bigint | number): this;
2678
2885
  addVideoConfig(config: Uint8Array): this;
2886
+ addAudioConfig(config: Uint8Array): this;
2679
2887
  addRaw(pair: KeyValuePair): this;
2680
2888
  build(): KeyValuePair[];
2681
2889
  static fromKeyValuePairs(kvps: KeyValuePair[]): LOCProperty[];
@@ -2741,7 +2949,7 @@ declare class MaxAuthTokenCacheSize implements Parameter {
2741
2949
  //#region src/model/parameter/setup/authority.d.ts
2742
2950
  /**
2743
2951
  * Raw-QUIC only: the authority component of the `moqt://` URI, carried in SETUP because
2744
- * there is no HTTP CONNECT to carry it (draft-18 §10.3.1.1).
2952
+ * there is no HTTP CONNECT to carry it.
2745
2953
  *
2746
2954
  * Client-only; MUST NOT be sent by a server or over WebTransport. moqtail-ts always
2747
2955
  * connects over WebTransport, so its own handshake never sends this — see
@@ -2755,10 +2963,24 @@ declare class Authority implements Parameter {
2755
2963
  static fromKeyValuePair(pair: KeyValuePair): Authority | undefined;
2756
2964
  }
2757
2965
  //#endregion
2966
+ //#region src/model/parameter/setup/max_filter_ranges.d.ts
2967
+ /**
2968
+ * Limits the total number of Ranges the peer may have across all Range filter parameters
2969
+ * of a single subscription or fetch. Zero, the default when absent, means the peer may
2970
+ * not send Range filters at all.
2971
+ */
2972
+ declare class MaxFilterRanges implements Parameter {
2973
+ readonly value: bigint;
2974
+ static readonly TYPE = SetupOptionType.MaxFilterRanges;
2975
+ constructor(value: bigint);
2976
+ toKeyValuePair(): KeyValuePair;
2977
+ static fromKeyValuePair(pair: KeyValuePair): MaxFilterRanges | undefined;
2978
+ }
2979
+ //#endregion
2758
2980
  //#region src/model/parameter/setup/moqt_implementation.d.ts
2759
2981
  /**
2760
- * Free-form implementation identification string, e.g. for logging and debugging
2761
- * (draft-18 §10.3.1.5). Either peer may send it.
2982
+ * Free-form implementation identification string, e.g. for logging and debugging.
2983
+ * Either peer may send it.
2762
2984
  */
2763
2985
  declare class MoqtImplementation implements Parameter {
2764
2986
  readonly info: string;
@@ -2768,13 +2990,27 @@ declare class MoqtImplementation implements Parameter {
2768
2990
  static fromKeyValuePair(pair: KeyValuePair): MoqtImplementation | undefined;
2769
2991
  }
2770
2992
  //#endregion
2993
+ //#region src/model/parameter/setup/max_request_updates.d.ts
2994
+ /**
2995
+ * Maximum number of outstanding REQUEST_UPDATEs per request stream: an update counts
2996
+ * until its REQUEST_OK or REQUEST_ERROR arrives. Zero, the default when absent, means
2997
+ * no limit. Receiving one past the limit closes the session with TOO_MANY_REQUEST_UPDATES.
2998
+ */
2999
+ declare class MaxRequestUpdates implements Parameter {
3000
+ readonly value: bigint;
3001
+ static readonly TYPE = SetupOptionType.MaxRequestUpdates;
3002
+ constructor(value: bigint);
3003
+ toKeyValuePair(): KeyValuePair;
3004
+ static fromKeyValuePair(pair: KeyValuePair): MaxRequestUpdates | undefined;
3005
+ }
3006
+ //#endregion
2771
3007
  //#region src/model/parameter/setup/ssts_algorithms.d.ts
2772
3008
  /**
2773
3009
  * The sender-side track switching (SSTS) algorithms this endpoint supports.
2774
3010
  *
2775
3011
  * PROVISIONAL: sender-side track switching is not an adopted extension, so
2776
3012
  * this option has no codepoint in the registry the conformance fixture tracks
2777
- * (`dev/conformance/draft18`) and is never asserted against it. An empty list
3013
+ * (`dev/conformance/draft22`) and is never asserted against it. An empty list
2778
3014
  * — or the absence of the option — prohibits the use of SSTS.
2779
3015
  */
2780
3016
  declare class SstsAlgorithms implements Parameter {
@@ -2786,7 +3022,7 @@ declare class SstsAlgorithms implements Parameter {
2786
3022
  }
2787
3023
  //#endregion
2788
3024
  //#region src/model/parameter/setup_option.d.ts
2789
- type SetupOption = Path | MaxAuthTokenCacheSize | AuthorizationToken | Authority | MoqtImplementation | SstsAlgorithms;
3025
+ type SetupOption = Path | MaxAuthTokenCacheSize | AuthorizationToken | Authority | MaxFilterRanges | MoqtImplementation | MaxRequestUpdates | SstsAlgorithms;
2790
3026
  declare namespace SetupOption {
2791
3027
  function fromKeyValuePair(pair: KeyValuePair): SetupOption | undefined;
2792
3028
  function toKeyValuePair(param: SetupOption): KeyValuePair;
@@ -2794,6 +3030,8 @@ declare namespace SetupOption {
2794
3030
  function isMaxAuthTokenCacheSize(param: SetupOption): param is MaxAuthTokenCacheSize;
2795
3031
  function isAuthorizationToken(param: SetupOption): param is AuthorizationToken;
2796
3032
  function isAuthority(param: SetupOption): param is Authority;
3033
+ function isMaxFilterRanges(param: SetupOption): param is MaxFilterRanges;
3034
+ function isMaxRequestUpdates(param: SetupOption): param is MaxRequestUpdates;
2797
3035
  function isMoqtImplementation(param: SetupOption): param is MoqtImplementation;
2798
3036
  function isSstsAlgorithms(param: SetupOption): param is SstsAlgorithms;
2799
3037
  }
@@ -2804,6 +3042,8 @@ declare class SetupOptions {
2804
3042
  addMaxAuthTokenCacheSize(maxSize: bigint | number): this;
2805
3043
  addPath(moqtPath: string): this;
2806
3044
  addAuthorizationToken(auth: AuthorizationToken): this;
3045
+ addMaxFilterRanges(value: bigint | number): this;
3046
+ addMaxRequestUpdates(value: bigint | number): this;
2807
3047
  addMoqtImplementation(info: string): this;
2808
3048
  addSstsAlgorithms(algorithms: (bigint | number)[]): this;
2809
3049
  addRaw(pair: KeyValuePair): this;
@@ -2811,4 +3051,37 @@ declare class SetupOptions {
2811
3051
  static fromKeyValuePairs(kvps: KeyValuePair[]): SetupOption[];
2812
3052
  }
2813
3053
  //#endregion
2814
- export { GoAway as $, messageParameterTypeFromNumber as $t, MOQtailError as A, ObjectForwardingPreference as An, NewGroupRequest as At, CMSFTrack as B, deserializeKvpListUntilEmpty as Bn, GroupOrderParam as Bt, CastingError as C, SUPPORTED_VERSIONS as Cn, MessageParameters as Ct, InvalidUTF8Error as D, DEFAULT_PUBLISHER_PRIORITY as Dn, SubscriptionFilter as Dt, InvalidTypeError as E, Datagram as En, serializeMessageParameterKvps as Et, TimeoutError as F, Tuple as Fn, resolveTransportUrl as Ft, SubscribeTracks as G, ObjectDeliveryTimeout as Gt, RequestError as H, isVarInt as Hn, Expires as Ht, TrackNameError as I, TupleField as In, GREASE_BASE as It, RequestUpdate as J, AuthorizationToken as Jt, SubscribeNamespace as K, FillTimeout as Kt, VarIntOverflowError as L, Location as Ln, GREASE_STEP as Lt, ProtocolViolationError as M, SubgroupHeaderType as Mn, Redirect as Mt, RequestIdError as N, MAX_REASON_PHRASE_LEN as Nn, MoqtFragment as Nt, KeyValueFormattingError as O, FetchHeaderType as On, SubscriberPriority as Ot, TerminationError as P, ReasonPhrase as Pn, MoqtUrl as Pt, Subscribe as Q, TokenAliasType as Qt, CMSF as R, KeyValuePair as Rn, greaseValue as Rt, TerminationCode as S, RequestErrorCode as Sn, MessageParameter as St, InvalidEnumValue as T, FetchHeader as Tn, deserializeMessageParameterKvps as Tt, RequestOk as U, serializeKvpList as Un, SubgroupDeliveryTimeout as Ut, ControlMessage as V, isBytes as Vn, Forward as Vt, Switch as W, RendezvousTimeout as Wt, Publish as X, MessageParameterType as Xt, SubscribeOk as Y, Parameter as Yt, PublishDone as Z, SetupOptionType as Zt, AudioLevel as _, ControlMessageType as _n, Fetch as _t, MoqtImplementation as a, FrozenByteBuffer as an, ImmutablePropertiesTrackProperty as at, Timestamp as b, GroupOrder as bn, Namespace as bt, Path as c, SubgroupHeader as cn, SubgroupDeliveryTimeoutProperty as ct, PriorGroupIdGapProperty as d, FullTrackName as dn, LOCPropertyId as dt, setupOptionTypeFromNumber as en, MAX_NEW_SESSION_URI_LENGTH as et, PriorObjectIdGapProperty as f, MAX_FULL_TRACK_NAME_LENGTH as fn, PropertyRange as ft, VideoConfig as g, FetchObjectContext as gn, locPropertyIdFromNumber as gt, LOCProperty as h, FetchObject as hn, isApplicationSpecificProperty as ht, SstsAlgorithms as i, ByteBuffer as in, DynamicGroupsProperty as it, NotEnoughBytesError as j, ObjectStatus as jn, LargestObject as jt, LengthExceedsMaxError as k, ObjectDatagramType as kn, SwitchingSetAssignment as kt, ImmutablePropertiesObjectProperty as l, MoqtObject as ln, TrackProperty as lt, LOCProperties as m, EndOfRangeKind as mn, TrackPropertyType as mt, SetupOptions as n, PublishBlocked as nn, DefaultPublisherGroupOrderProperty as nt, Authority as o, Header as on, MaxCacheDurationProperty as ot, UnknownObjectProperty as p, MAX_NAMESPACE_TUPLE_COUNT as pn, PropertyRanges as pt, TrackStatus as q, AuthTokenVariant as qt, assertNoAuthorityOverWebTransport as r, BaseByteBuffer as rn, DefaultPublisherPriorityProperty as rt, MaxAuthTokenCacheSize as s, RequestIdMap as sn, ObjectDeliveryTimeoutProperty as st, SetupOption as t, tokenAliasTypeFromNumber as tn, FetchOk as tt, ObjectProperty as u, SubgroupObject as un, UnknownTrackProperty as ut, VideoFrameMarking as v, FetchType as vn, Setup as vt, InternalError as w, TrackStatusCode as wn, applyMessageParameterUpdate as wt, StreamResetCode as x, PublishDoneStatusCode as xn, PublishNamespace as xt, Timescale as y, FilterType as yn, NamespaceDone as yt, CMSFCatalog as z, deserializeKvpList as zn, isGrease as zt };
3054
+ //#region src/model/parameter/message/combined_filter.d.ts
3055
+ /**
3056
+ * The object filter a request's Range Filters add up to.
3057
+ *
3058
+ * Ranges within one filter are OR'd, filters sharing a SetID are AND'd, and the
3059
+ * SetIDs are OR'd with each other. No filter at all passes every Object.
3060
+ */
3061
+ declare class CombinedFilter {
3062
+ #private;
3063
+ /** How many Ranges the filters hold, which is what a range limit counts. */
3064
+ readonly rangeCount: number;
3065
+ /**
3066
+ * Builds the filter from every Range Filter in `params`; anything else, and a
3067
+ * zero-length removal, is ignored.
3068
+ *
3069
+ * @throws :{@link InvalidFilterError} For a filter that cannot be applied: one
3070
+ * that repeats a Type, SetID and Property Type already given, one with an odd
3071
+ * Property Type, a priority above 255 or a bound past 2^64-1, or a track filter,
3072
+ * which selects tracks rather than Objects.
3073
+ */
3074
+ constructor(params: readonly MessageParameter[]);
3075
+ /** Whether the filter passes everything. */
3076
+ get isEmpty(): boolean;
3077
+ /**
3078
+ * Whether `obj` passes.
3079
+ *
3080
+ * @param subgroupId - The Subgroup ID `obj` travels in. It is passed in because an
3081
+ * Object whose Subgroup ID is its subgroup's first Object ID does not know it
3082
+ * itself. `null` — a datagram — has no subgroup, so no subgroup filter passes it.
3083
+ */
3084
+ matches(obj: MoqtObject, subgroupId?: bigint | null): boolean;
3085
+ }
3086
+ //#endregion
3087
+ export { LOCPropertyId as $, isBytes as $n, Forward as $t, ControlMessage as A, GroupOrder as An, ProtocolViolationError as At, Subscribe as B, FetchHeaderType as Bn, SwitchingSetAssignment as Bt, Timescale as C, FullTrackName as Cn, InvalidEnumValue as Ct, CMSFCatalog as D, FetchObject as Dn, LengthExceedsMaxError as Dt, CMSF as E, EndOfRangeKind as En, KeyValueFormattingError as Et, TrackStatus as F, SwitchMode as Fn, VarIntOverflowError as Ft, DefaultPublisherPriorityProperty as G, MAX_REASON_PHRASE_LEN as Gn, MoqtUrl as Gt, MAX_NEW_SESSION_URI_LENGTH as H, ObjectForwardingPreference as Hn, LargestObject as Ht, RequestUpdate as I, TrackStatusCode as In, FillParameters as It, MaxCacheDurationProperty as J, TupleField as Jn, GREASE_STEP as Jt, DynamicGroupsProperty as K, ReasonPhrase as Kn, resolveTransportUrl as Kt, SubscribeOk as L, FetchHeader as Ln, SwitchFrom as Lt, RequestOk as M, PublishDoneStatusCode as Mn, TerminationError as Mt, SubscribeTracks as N, RequestErrorCode as Nn, TimeoutError as Nt, CMSFTrack as O, FetchObjectContext as On, MOQtailError as Ot, SubscribeNamespace as P, SUPPORTED_VERSIONS as Pn, TrackNameError as Pt, UnknownTrackProperty as Q, deserializeKvpListUntilEmpty as Qn, IncludeProperties as Qt, Publish as R, Datagram as Rn, LocationFilter as Rt, VideoFrameMarking as S, SubgroupObject as Sn, InternalError as St, TerminationCode as T, MAX_NAMESPACE_TUPLE_COUNT as Tn, InvalidUTF8Error as Tt, FetchOk as U, ObjectStatus as Un, Redirect as Ut, GoAway as V, ObjectDatagramType as Vn, NewGroupRequest as Vt, DefaultPublisherGroupOrderProperty as W, SubgroupHeaderType as Wn, MoqtFragment as Wt, SubgroupDeliveryTimeoutProperty as X, KeyValuePair as Xn, isGrease as Xt, ObjectDeliveryTimeoutProperty as Y, Location as Yn, greaseValue as Yt, TrackProperty as Z, deserializeKvpList as Zn, GroupOrderParam as Zt, LOCProperties as _, FrozenByteBuffer as _n, RangeDelta as _t, SstsAlgorithms as a, AuthTokenVariant as an, Fetch as at, VideoConfig as b, SubgroupHeader as bn, encodeRanges as bt, MaxFilterRanges as c, MessageParameterType as cn, Namespace as ct, Path as d, messageParameterTypeFromNumber as dn, MessageParameters as dt, Expires as en, isVarInt as er, PropertyRange as et, ImmutablePropertiesObjectProperty as f, setupOptionTypeFromNumber as fn, applyMessageParameterUpdate as ft, UnknownObjectProperty as g, ByteBuffer as gn, Range as gt, PriorObjectIdGapProperty as h, BaseByteBuffer as hn, InvalidFilterError as ht, assertNoAuthorityOverWebTransport as i, FillTimeout as in, locPropertyIdFromNumber as it, RequestError as j, LocationFilterType as jn, RequestIdError as jt, StreamResetCode as k, ControlMessageType as kn, NotEnoughBytesError as kt, Authority as l, SetupOptionType as ln, PublishNamespace as lt, PriorGroupIdGapProperty as m, PublishSkipped as mn, serializeMessageParameterKvps as mt, SetupOption as n, RendezvousTimeout as nn, TrackPropertyType as nt, MaxRequestUpdates as o, AuthorizationToken as on, Setup as ot, ObjectProperty as p, tokenAliasTypeFromNumber as pn, deserializeMessageParameterKvps as pt, ImmutablePropertiesTrackProperty as q, Tuple as qn, GREASE_BASE as qt, SetupOptions as r, ObjectDeliveryTimeout as rn, isApplicationSpecificProperty as rt, MoqtImplementation as s, Parameter as sn, NamespaceDone as st, CombinedFilter as t, SubgroupDeliveryTimeout as tn, serializeKvpList as tr, PropertyRanges as tt, MaxAuthTokenCacheSize as u, TokenAliasType as un, MessageParameter as ut, LOCProperty as v, Header as vn, RangeFilter as vt, Timestamp as w, MAX_FULL_TRACK_NAME_LENGTH as wn, InvalidTypeError as wt, AudioLevel as x, MoqtObject as xn, CastingError as xt, AudioConfig as y, RequestIdMap as yn, RangeFilterKind as yt, PublishDone as z, DEFAULT_PUBLISHER_PRIORITY as zn, SubscriberPriority as zt };