moqtail 0.14.0 → 0.16.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.
Files changed (44) hide show
  1. package/README.md +153 -473
  2. package/dist/{client-Z7egUKTO.cjs → client-DQ5aGbLR.cjs} +1100 -1099
  3. package/dist/client-DUzLw_Y8.d.cts +1932 -0
  4. package/dist/{client-BW1agDFV.mjs → client-DVi4Nh1J.mjs} +942 -947
  5. package/dist/client-epHqMdHm.d.mts +1932 -0
  6. package/dist/client.cjs +121 -4
  7. package/dist/client.d.cts +23 -1933
  8. package/dist/client.d.mts +23 -1933
  9. package/dist/client.mjs +117 -2
  10. package/dist/emitter-UbeRcbuf.mjs +109 -0
  11. package/dist/{logger-c2NoQqtx.cjs → emitter-qNJYD3yQ.cjs} +61 -2
  12. package/dist/index-B-BMK-b6.d.mts +2090 -0
  13. package/dist/index-BtemTtwe.d.cts +2090 -0
  14. package/dist/{index-DBbxKcc1.d.cts → index-CNn9BgO6.d.mts} +168 -337
  15. package/dist/index.cjs +39 -34
  16. package/dist/index.d.cts +20 -4
  17. package/dist/index.d.mts +20 -4
  18. package/dist/index.mjs +5 -4
  19. package/dist/logger-B8IYkljn.d.cts +64 -0
  20. package/dist/logger-B8IYkljn.d.mts +64 -0
  21. package/dist/model.cjs +208 -359
  22. package/dist/model.d.cts +2896 -2
  23. package/dist/model.d.mts +17 -2
  24. package/dist/model.mjs +207 -359
  25. package/dist/player/component.cjs +317 -0
  26. package/dist/player/component.d.cts +50 -0
  27. package/dist/player/component.d.mts +50 -0
  28. package/dist/player/component.mjs +315 -0
  29. package/dist/player-CJayEzwt.cjs +6750 -0
  30. package/dist/player-DcctWhyM.mjs +6599 -0
  31. package/dist/player.cjs +27 -0
  32. package/dist/player.d.cts +17 -0
  33. package/dist/player.d.mts +17 -0
  34. package/dist/player.mjs +1 -0
  35. package/dist/rolldown-runtime-CmQyd0Gu.cjs +27 -0
  36. package/dist/util.cjs +9 -10
  37. package/dist/util.d.cts +20 -13
  38. package/dist/util.d.mts +20 -13
  39. package/dist/util.mjs +4 -6
  40. package/package.json +45 -5
  41. package/dist/index-DBbxKcc1.d.mts +0 -3051
  42. package/dist/logger-ByDB8lYF.mjs +0 -56
  43. package/dist/logger-dEoueCj7.d.cts +0 -35
  44. package/dist/logger-dEoueCj7.d.mts +0 -35
@@ -1,4 +1,3 @@
1
- //#region src/model/common/pair.d.ts
2
1
  /**
3
2
  * @public
4
3
  * Represents a key-value pair for MOQT protocol parameters.
@@ -147,8 +146,6 @@ declare function isVarInt(pair: KeyValuePair): pair is KeyValuePair & {
147
146
  declare function isBytes(pair: KeyValuePair): pair is KeyValuePair & {
148
147
  value: Uint8Array;
149
148
  };
150
- //#endregion
151
- //#region src/model/common/location.d.ts
152
149
  /**
153
150
  * @public
154
151
  * Represents a position in a MOQT track, consisting of a group and object index.
@@ -199,8 +196,6 @@ declare class Location {
199
196
  */
200
197
  compare(other: Location): number;
201
198
  }
202
- //#endregion
203
- //#region src/model/common/tuple.d.ts
204
199
  /**
205
200
  * @public
206
201
  * Represents a single field in a Tuple, storing a value as a UTF-8 encoded byte array.
@@ -301,8 +296,6 @@ declare class Tuple {
301
296
  */
302
297
  equals(other: Tuple): boolean;
303
298
  }
304
- //#endregion
305
- //#region src/model/common/reason_phrase.d.ts
306
299
  /**
307
300
  * The maximum allowed length (in bytes) for a ReasonPhrase.
308
301
  * @public
@@ -352,8 +345,6 @@ declare class ReasonPhrase {
352
345
  */
353
346
  static deserialize(buf: BaseByteBuffer): ReasonPhrase;
354
347
  }
355
- //#endregion
356
- //#region src/model/data/constant.d.ts
357
348
  /**
358
349
  * Copyright 2025 The MOQtail Authors
359
350
  *
@@ -656,8 +647,6 @@ declare namespace ObjectStatus {
656
647
  */
657
648
  function tryFrom(value: number | bigint): ObjectStatus;
658
649
  }
659
- //#endregion
660
- //#region src/model/data/datagram.d.ts
661
650
  /**
662
651
  * Represents a unified OBJECT_DATAGRAM message.
663
652
  *
@@ -693,8 +682,6 @@ declare class Datagram {
693
682
  serialize(): FrozenByteBuffer;
694
683
  static deserialize(buf: BaseByteBuffer): Datagram;
695
684
  }
696
- //#endregion
697
- //#region src/model/data/fetch_header.d.ts
698
685
  declare class FetchHeader {
699
686
  readonly type: FetchHeaderType;
700
687
  readonly requestId: bigint;
@@ -702,8 +689,6 @@ declare class FetchHeader {
702
689
  serialize(): FrozenByteBuffer;
703
690
  static deserialize(buf: BaseByteBuffer): FetchHeader;
704
691
  }
705
- //#endregion
706
- //#region src/model/control/constant.d.ts
707
692
  /**
708
693
  * Copyright 2025 The MOQtail Authors
709
694
  *
@@ -728,52 +713,29 @@ declare const SUPPORTED_VERSIONS: string[];
728
713
  * Control message types.
729
714
  */
730
715
  declare enum ControlMessageType {
731
- ReservedSetupV00 = 1,
732
- // RESERVED; rejected by tryFrom
733
- ReservedClientSetupV10 = 64,
734
- // RESERVED; rejected by tryFrom
735
- ReservedServerSetupV10 = 65,
736
- // RESERVED; rejected by tryFrom
737
- ReservedClientSetupV16 = 32,
738
- // RESERVED; rejected by tryFrom
739
- ReservedServerSetupV16 = 33,
740
- // RESERVED; rejected by tryFrom
741
- Setup = 12032,
742
- // Control
743
- GoAway = 16,
744
- // Control, Request
745
- Subscribe = 3,
746
- // Request, First
747
- SubscribeOk = 4,
748
- // Request
749
- RequestError = 5,
750
- // Request
751
- RequestUpdate = 2,
752
- // Request
753
- PublishDone = 11,
754
- // Request
755
- Fetch = 22,
756
- // Request, First
757
- FetchOk = 24,
758
- // Request
759
- TrackStatus = 13,
760
- // Request, First
761
- PublishNamespace = 6,
762
- // Request, First
763
- RequestOk = 7,
764
- // Request
765
- Namespace = 8,
766
- // Request
767
- NamespaceDone = 14,
768
- // Request
769
- SubscribeNamespace = 80,
770
- // Request, First
771
- SubscribeTracks = 81,
772
- // Request, First
773
- Publish = 29,
774
- // Request, First
775
- PublishOk = 30,
776
- // Request; an alias of RequestOk (§10.5), not its own body
716
+ ReservedSetupV00 = 1, // RESERVED; rejected by tryFrom
717
+ ReservedClientSetupV10 = 64, // RESERVED; rejected by tryFrom
718
+ ReservedServerSetupV10 = 65, // RESERVED; rejected by tryFrom
719
+ ReservedClientSetupV16 = 32, // RESERVED; rejected by tryFrom
720
+ ReservedServerSetupV16 = 33, // RESERVED; rejected by tryFrom
721
+ Setup = 12032, // Control
722
+ GoAway = 16, // Control, Request
723
+ Subscribe = 3, // Request, First
724
+ SubscribeOk = 4, // Request
725
+ RequestError = 5, // Request
726
+ RequestUpdate = 2, // Request
727
+ PublishDone = 11, // Request
728
+ Fetch = 22, // Request, First
729
+ FetchOk = 24, // Request
730
+ TrackStatus = 13, // Request, First
731
+ PublishNamespace = 6, // Request, First
732
+ RequestOk = 7, // Request
733
+ Namespace = 8, // Request
734
+ NamespaceDone = 14, // Request
735
+ SubscribeNamespace = 80, // Request, First
736
+ SubscribeTracks = 81, // Request, First
737
+ Publish = 29, // Request, First
738
+ PublishOk = 30, // Request; an alias of RequestOk (§10.5), not its own body
777
739
  PublishSkipped = 15
778
740
  }
779
741
  /**
@@ -943,23 +905,37 @@ declare namespace RequestErrorCode {
943
905
  */
944
906
  function fromWire(v: bigint): RequestErrorCode;
945
907
  }
946
- //#endregion
947
- //#region src/model/data/fetch_object.d.ts
948
908
  /**
949
- * Prior-object state threaded across successive Fetch Objects on the same stream.
909
+ * The prior Object a Fetch Object is encoded against: each one is written as
910
+ * differences from it.
950
911
  */
951
912
  type FetchObjectContext = {
952
913
  groupId: bigint;
953
- subgroupId: bigint;
914
+ /**
915
+ * Null while the stream has carried only End of Range markers and no Object yet:
916
+ * a marker sets the prior Group and Object IDs, but has no Subgroup ID.
917
+ */
918
+ subgroupId: bigint | null;
954
919
  objectId: bigint;
955
- publisherPriority: number;
920
+ /**
921
+ * Null while the stream has carried only End of Range markers and no Object yet:
922
+ * a marker has no priority.
923
+ */
924
+ publisherPriority: number | null;
956
925
  };
957
926
  /**
958
- * Kind discriminator for End-of-Range markers (§11.5).
927
+ * Kind discriminator for End-of-Range markers.
959
928
  */
960
929
  declare enum EndOfRangeKind {
930
+ /** Serialization Flags = 0x8C: all objects in the range are known not to exist. */
961
931
  NonExistent = 140,
962
- Unknown = 268
932
+ /** Serialization Flags = 0x10C: the range is cache-unknown. */
933
+ Unknown = 268,
934
+ /**
935
+ * Serialization Flags = 0x20C: the range timed out, e.g. a relay ran out of its
936
+ * fill budget before it could retrieve it.
937
+ */
938
+ TimedOut = 524
963
939
  }
964
940
  /**
965
941
  * Payload-bearing fetch object (§11.5, non-End-of-Range form).
@@ -980,17 +956,19 @@ declare class FetchObject {
980
956
  get groupId(): bigint;
981
957
  get objectId(): bigint;
982
958
  /**
983
- * Context to thread into the next call on this stream.
984
- * Returns null for EndOfRange markers — they MUST NOT update prior state.
959
+ * What the entry after this one is encoded against, given what this one was
960
+ * encoded against (`prev`).
961
+ *
962
+ * After an Object, that is the Object itself. After an End of Range marker, it is
963
+ * the marker's Group and Object IDs, with the Subgroup ID and priority still those
964
+ * of the last Object before the marker, or none if no Object came before it.
985
965
  */
986
- toContext(): FetchObjectContext | null;
966
+ nextContext(prev?: FetchObjectContext): FetchObjectContext;
987
967
  static newObject(groupId: bigint | number, subgroupId: bigint | number, objectId: bigint | number, publisherPriority: number, forwardingPreference: ObjectForwardingPreference, properties: KeyValuePair[] | null, payload: Uint8Array): FetchObject;
988
968
  static newEndOfRange(kind: EndOfRangeKind, groupId: bigint | number, objectId: bigint | number): FetchObject;
989
969
  serialize(prev?: FetchObjectContext, groupOrder?: GroupOrder): FrozenByteBuffer;
990
970
  static deserialize(buf: BaseByteBuffer, prev?: FetchObjectContext, groupOrder?: GroupOrder): FetchObject;
991
971
  }
992
- //#endregion
993
- //#region src/model/data/full_track_name.d.ts
994
972
  declare const MAX_NAMESPACE_TUPLE_COUNT = 32;
995
973
  declare const MAX_FULL_TRACK_NAME_LENGTH = 4096;
996
974
  /**
@@ -1054,8 +1032,6 @@ declare class FullTrackName {
1054
1032
  */
1055
1033
  static deserialize(buf: BaseByteBuffer): FullTrackName;
1056
1034
  }
1057
- //#endregion
1058
- //#region src/model/data/subgroup_object.d.ts
1059
1035
  declare class SubgroupObject {
1060
1036
  readonly properties: KeyValuePair[] | null;
1061
1037
  readonly objectStatus: ObjectStatus | null;
@@ -1067,8 +1043,6 @@ declare class SubgroupObject {
1067
1043
  serialize(previousObjectId: bigint | undefined): FrozenByteBuffer;
1068
1044
  static deserialize(buf: BaseByteBuffer, hasProperties: boolean, previousObjectId: bigint | undefined): SubgroupObject;
1069
1045
  }
1070
- //#endregion
1071
- //#region src/model/data/object.d.ts
1072
1046
  declare class MoqtObject {
1073
1047
  readonly fullTrackName: FullTrackName;
1074
1048
  readonly publisherPriority: number;
@@ -1116,8 +1090,6 @@ declare class MoqtObject {
1116
1090
  tryIntoFetchObject(): FetchObject;
1117
1091
  tryIntoSubgroupObject(): SubgroupObject;
1118
1092
  }
1119
- //#endregion
1120
- //#region src/model/data/subgroup_header.d.ts
1121
1093
  declare class SubgroupHeader {
1122
1094
  readonly type: SubgroupHeaderType;
1123
1095
  readonly publisherPriority: number | undefined;
@@ -1140,8 +1112,6 @@ declare class SubgroupHeader {
1140
1112
  */
1141
1113
  resolveSubgroupId(firstObjectId: bigint): void;
1142
1114
  }
1143
- //#endregion
1144
- //#region src/model/data/request_id.d.ts
1145
1115
  /**
1146
1116
  * A bidirectional map between requestId (bigint) and full track names.
1147
1117
  * Used to efficiently look up either by requestId or by name, enforcing uniqueness.
@@ -1211,8 +1181,6 @@ declare class RequestIdMap {
1211
1181
  */
1212
1182
  containsName(name: FullTrackName): boolean;
1213
1183
  }
1214
- //#endregion
1215
- //#region src/model/data/header.d.ts
1216
1184
  type Header = FetchHeader | SubgroupHeader;
1217
1185
  declare namespace Header {
1218
1186
  function newFetch(...args: ConstructorParameters<typeof FetchHeader>): Header;
@@ -1222,8 +1190,6 @@ declare namespace Header {
1222
1190
  function serialize(header: Header): FrozenByteBuffer;
1223
1191
  function deserialize(buf: BaseByteBuffer): Header;
1224
1192
  }
1225
- //#endregion
1226
- //#region src/model/common/byte_buffer.d.ts
1227
1193
  declare abstract class BaseByteBuffer {
1228
1194
  protected buf: Uint8Array;
1229
1195
  protected view: DataView;
@@ -1273,9 +1239,9 @@ declare class ByteBuffer extends BaseByteBuffer {
1273
1239
  putU8(v: number): void;
1274
1240
  putU16(v: number): void;
1275
1241
  /**
1276
- /**
1277
- * Encode a MOQT varint using the minimal length.
1278
- */
1242
+ /**
1243
+ * Encode a MOQT varint using the minimal length.
1244
+ */
1279
1245
  putVI(v: bigint | number): void;
1280
1246
  putBytes(src: Uint8Array): void;
1281
1247
  putLengthPrefixedBytes(src: Uint8Array): void;
@@ -1291,8 +1257,6 @@ declare class FrozenByteBuffer extends BaseByteBuffer {
1291
1257
  constructor(buf: Uint8Array);
1292
1258
  get length(): number;
1293
1259
  }
1294
- //#endregion
1295
- //#region src/model/control/publish_skipped.d.ts
1296
1260
  /**
1297
1261
  * @public
1298
1262
  * PUBLISH_SKIPPED (0xF): a publisher tells the peer it cannot send the PUBLISH that
@@ -1309,8 +1273,6 @@ declare class PublishSkipped {
1309
1273
  serialize(): FrozenByteBuffer;
1310
1274
  static parsePayload(buf: BaseByteBuffer): PublishSkipped;
1311
1275
  }
1312
- //#endregion
1313
- //#region src/model/parameter/constant.d.ts
1314
1276
  /**
1315
1277
  * Copyright 2026 The MOQtail Authors
1316
1278
  *
@@ -1385,13 +1347,9 @@ declare enum TokenAliasType {
1385
1347
  UseValue = 3
1386
1348
  }
1387
1349
  declare function tokenAliasTypeFromNumber(value: number): TokenAliasType;
1388
- //#endregion
1389
- //#region src/model/parameter/parameter.d.ts
1390
1350
  interface Parameter {
1391
1351
  toKeyValuePair(): KeyValuePair;
1392
1352
  }
1393
- //#endregion
1394
- //#region src/model/parameter/common/authorization_token.d.ts
1395
1353
  type AuthTokenVariant = {
1396
1354
  aliasType: TokenAliasType.Delete;
1397
1355
  tokenAlias: bigint;
@@ -1419,8 +1377,6 @@ declare class AuthorizationToken implements Parameter {
1419
1377
  toKeyValuePair(): KeyValuePair;
1420
1378
  static fromKeyValuePair(pair: KeyValuePair): AuthorizationToken | undefined;
1421
1379
  }
1422
- //#endregion
1423
- //#region src/model/parameter/message/fill_timeout.d.ts
1424
1380
  /**
1425
1381
  * Duration in milliseconds a relay SHOULD wait for objects it does not yet hold before
1426
1382
  * ending the FETCH. FETCH only (§10.2.5).
@@ -1432,8 +1388,6 @@ declare class FillTimeout implements Parameter {
1432
1388
  toKeyValuePair(): KeyValuePair;
1433
1389
  static fromKeyValuePair(pair: KeyValuePair): FillTimeout | undefined;
1434
1390
  }
1435
- //#endregion
1436
- //#region src/model/parameter/message/object_delivery_timeout.d.ts
1437
1391
  /**
1438
1392
  * Duration in milliseconds the relay SHOULD continue to attempt forwarding an Object.
1439
1393
  * A value of 0 means no timeout is set (§8).
@@ -1447,8 +1401,6 @@ declare class ObjectDeliveryTimeout implements Parameter {
1447
1401
  toKeyValuePair(): KeyValuePair;
1448
1402
  static fromKeyValuePair(pair: KeyValuePair): ObjectDeliveryTimeout | undefined;
1449
1403
  }
1450
- //#endregion
1451
- //#region src/model/parameter/message/rendezvous_timeout.d.ts
1452
1404
  /**
1453
1405
  * Duration in milliseconds a relay SHOULD wait for a publisher of a track that has none
1454
1406
  * before answering the SUBSCRIBE. SUBSCRIBE only (§10.2.6).
@@ -1460,8 +1412,6 @@ declare class RendezvousTimeout implements Parameter {
1460
1412
  toKeyValuePair(): KeyValuePair;
1461
1413
  static fromKeyValuePair(pair: KeyValuePair): RendezvousTimeout | undefined;
1462
1414
  }
1463
- //#endregion
1464
- //#region src/model/parameter/message/subgroup_delivery_timeout.d.ts
1465
1415
  /**
1466
1416
  * Duration in milliseconds the relay SHOULD continue to attempt forwarding a Subgroup.
1467
1417
  * A value of 0 means no timeout is set (§8).
@@ -1473,8 +1423,6 @@ declare class SubgroupDeliveryTimeout implements Parameter {
1473
1423
  toKeyValuePair(): KeyValuePair;
1474
1424
  static fromKeyValuePair(pair: KeyValuePair): SubgroupDeliveryTimeout | undefined;
1475
1425
  }
1476
- //#endregion
1477
- //#region src/model/parameter/message/expires.d.ts
1478
1426
  /**
1479
1427
  * Time in milliseconds after which the sender will terminate the subscription.
1480
1428
  * A value of 0 means the subscription does not expire or expires at an unknown time.
@@ -1487,8 +1435,6 @@ declare class Expires implements Parameter {
1487
1435
  toKeyValuePair(): KeyValuePair;
1488
1436
  static fromKeyValuePair(pair: KeyValuePair): Expires | undefined;
1489
1437
  }
1490
- //#endregion
1491
- //#region src/model/parameter/message/forward.d.ts
1492
1438
  /**
1493
1439
  * Forwarding state for affected subscriptions.
1494
1440
  * Allowed wire values: 0 (don't forward) or 1 (forward).
@@ -1502,8 +1448,6 @@ declare class Forward implements Parameter {
1502
1448
  toKeyValuePair(): KeyValuePair;
1503
1449
  static fromKeyValuePair(pair: KeyValuePair): Forward | undefined;
1504
1450
  }
1505
- //#endregion
1506
- //#region src/model/parameter/message/include_properties.d.ts
1507
1451
  /**
1508
1452
  * Whether the response carries Track Properties: the OK answering a SUBSCRIBE,
1509
1453
  * TRACK_STATUS or FETCH, or each PUBLISH a SUBSCRIBE_TRACKS brings. With 0 the
@@ -1518,8 +1462,6 @@ declare class IncludeProperties implements Parameter {
1518
1462
  toKeyValuePair(): KeyValuePair;
1519
1463
  static fromKeyValuePair(pair: KeyValuePair): IncludeProperties | undefined;
1520
1464
  }
1521
- //#endregion
1522
- //#region src/model/parameter/message/group_order_param.d.ts
1523
1465
  /**
1524
1466
  * How to prioritize Objects from different groups (Ascending=0x1 or Descending=0x2).
1525
1467
  * Values outside this range are a PROTOCOL_VIOLATION (Original/0x0 is not a valid wire value).
@@ -1533,8 +1475,6 @@ declare class GroupOrderParam implements Parameter {
1533
1475
  toKeyValuePair(): KeyValuePair;
1534
1476
  static fromKeyValuePair(pair: KeyValuePair): GroupOrderParam | undefined;
1535
1477
  }
1536
- //#endregion
1537
- //#region src/model/common/grease.d.ts
1538
1478
  /**
1539
1479
  * Copyright 2026 The MOQtail Authors
1540
1480
  *
@@ -1572,8 +1512,6 @@ declare function isGrease(value: bigint | number): boolean;
1572
1512
  * varint can carry (the pattern is capped at `0x3fffffffffffffde`).
1573
1513
  */
1574
1514
  declare function greaseValue(n: bigint | number): bigint | undefined;
1575
- //#endregion
1576
- //#region src/model/common/moqt_url.d.ts
1577
1515
  /**
1578
1516
  * Copyright 2026 The MOQtail Authors
1579
1517
  *
@@ -1636,8 +1574,6 @@ declare function resolveTransportUrl(url: string | URL): {
1636
1574
  transportUrl: string;
1637
1575
  moqtUrl: MoqtUrl | undefined;
1638
1576
  };
1639
- //#endregion
1640
- //#region src/model/common/redirect.d.ts
1641
1577
  /**
1642
1578
  * @public
1643
1579
  * Directs the peer to retry a request at a different URI and/or for a different Full
@@ -1650,18 +1586,16 @@ declare class Redirect {
1650
1586
  readonly trackName: Uint8Array;
1651
1587
  /** Undefined means reuse the current session's URI. */
1652
1588
  readonly connectUri: string | undefined;
1653
- constructor(connectUri: string | undefined, /** Empty, together with an empty {@link Redirect.trackName}, means reuse the original request's track. */
1654
-
1655
- trackNamespace: Tuple, /** Empty for namespace-scoped requests, which have no track name to redirect. */
1656
-
1589
+ constructor(connectUri: string | undefined,
1590
+ /** Empty, together with an empty {@link Redirect.trackName}, means reuse the original request's track. */
1591
+ trackNamespace: Tuple,
1592
+ /** Empty for namespace-scoped requests, which have no track name to redirect. */
1657
1593
  trackName: Uint8Array);
1658
1594
  /** True when the redirect names no track of its own, so the original request's track carries over. */
1659
1595
  get keepsOriginalTrack(): boolean;
1660
1596
  serialize(): FrozenByteBuffer;
1661
1597
  static deserialize(buf: BaseByteBuffer): Redirect;
1662
1598
  }
1663
- //#endregion
1664
- //#region src/model/parameter/message/largest_object.d.ts
1665
1599
  /**
1666
1600
  * The largest Location in the Track observed by the sending endpoint.
1667
1601
  * If omitted from a message, the sending endpoint has not published or
@@ -1674,8 +1608,6 @@ declare class LargestObject implements Parameter {
1674
1608
  toKeyValuePair(): KeyValuePair;
1675
1609
  static fromKeyValuePair(pair: KeyValuePair): LargestObject | undefined;
1676
1610
  }
1677
- //#endregion
1678
- //#region src/model/parameter/message/new_group_request.d.ts
1679
1611
  /**
1680
1612
  * The largest Group ID in the Track known by the subscriber, plus 1.
1681
1613
  * A value of 0 indicates the subscriber has no Group information for the Track.
@@ -1688,8 +1620,6 @@ declare class NewGroupRequest implements Parameter {
1688
1620
  toKeyValuePair(): KeyValuePair;
1689
1621
  static fromKeyValuePair(pair: KeyValuePair): NewGroupRequest | undefined;
1690
1622
  }
1691
- //#endregion
1692
- //#region src/model/parameter/message/switching_set_assignment.d.ts
1693
1623
  /**
1694
1624
  * Assigns a subscription to an SSTS (sender-side track switching) switching
1695
1625
  * set. Carried on SUBSCRIBE and on the PUBLISH_OK of a pushed track.
@@ -1711,18 +1641,16 @@ declare class SwitchingSetAssignment implements Parameter {
1711
1641
  /** Degradation priority; lower values are protected first. Default 0. */
1712
1642
  readonly setRank: number;
1713
1643
  static readonly TYPE = MessageParameterType.SwitchingSetAssignment;
1714
- constructor(switchingSetId: bigint, algorithmId: bigint, throughputThresholdKbps: bigint, /** Relative bandwidth weight among same-rank sets, 1 through 10. */
1715
-
1716
- setThroughputWeight: bigint, /** 0 pauses SSTS for the set; switching activates once the number of assigned tracks reaches this value. */
1717
-
1718
- activateSwitching: bigint, /** Degradation priority; lower values are protected first. Default 0. */
1719
-
1644
+ constructor(switchingSetId: bigint, algorithmId: bigint, throughputThresholdKbps: bigint,
1645
+ /** Relative bandwidth weight among same-rank sets, 1 through 10. */
1646
+ setThroughputWeight: bigint,
1647
+ /** 0 pauses SSTS for the set; switching activates once the number of assigned tracks reaches this value. */
1648
+ activateSwitching: bigint,
1649
+ /** Degradation priority; lower values are protected first. Default 0. */
1720
1650
  setRank?: number);
1721
1651
  toKeyValuePair(): KeyValuePair;
1722
1652
  static fromKeyValuePair(pair: KeyValuePair): SwitchingSetAssignment | undefined;
1723
1653
  }
1724
- //#endregion
1725
- //#region src/model/parameter/message/subscriber_priority.d.ts
1726
1654
  /**
1727
1655
  * Priority of a subscription relative to others in the same session.
1728
1656
  * Lower numbers have higher priority. Range: 0-255.
@@ -1736,8 +1664,6 @@ declare class SubscriberPriority implements Parameter {
1736
1664
  toKeyValuePair(): KeyValuePair;
1737
1665
  static fromKeyValuePair(pair: KeyValuePair): SubscriberPriority | undefined;
1738
1666
  }
1739
- //#endregion
1740
- //#region src/model/parameter/message/location_filter.d.ts
1741
1667
  /**
1742
1668
  * The range of Locations a subscription or fetch selects. The Location Filter
1743
1669
  * Type decides which fields are set, and the value is not length-prefixed.
@@ -1801,8 +1727,6 @@ declare class LocationFilter implements Parameter {
1801
1727
  toKeyValuePair(): KeyValuePair;
1802
1728
  static fromKeyValuePair(pair: KeyValuePair): LocationFilter | undefined;
1803
1729
  }
1804
- //#endregion
1805
- //#region src/model/parameter/message/switch_from.d.ts
1806
1730
  /**
1807
1731
  * Identifies the subscription being replaced by a switch request.
1808
1732
  * The value is two varints followed by a flags byte: bit 7 (MSB) is Publish Done;
@@ -1817,8 +1741,6 @@ declare class SwitchFrom implements Parameter {
1817
1741
  toKeyValuePair(): KeyValuePair;
1818
1742
  static fromKeyValuePair(pair: KeyValuePair): SwitchFrom | undefined;
1819
1743
  }
1820
- //#endregion
1821
- //#region src/model/parameter/message/fill_parameters.d.ts
1822
1744
  /**
1823
1745
  * Requests a fill fetch stream, and overrides for it. An omitted parameter keeps
1824
1746
  * the value it has for the live subscription; an omitted LOCATION_FILTER fills
@@ -1831,8 +1753,6 @@ declare class FillParameters implements Parameter {
1831
1753
  toKeyValuePair(): KeyValuePair;
1832
1754
  static fromKeyValuePair(pair: KeyValuePair): FillParameters | undefined;
1833
1755
  }
1834
- //#endregion
1835
- //#region src/model/error/error.d.ts
1836
1756
  /**
1837
1757
  * Copyright 2025 The MOQtail Authors
1838
1758
  *
@@ -1968,8 +1888,6 @@ declare class TerminationError extends MOQtailError {
1968
1888
  terminationCode: number;
1969
1889
  constructor(context: string, terminationCode: number);
1970
1890
  }
1971
- //#endregion
1972
- //#region src/model/parameter/message/range_filter.d.ts
1973
1891
  /**
1974
1892
  * What a Range Filter selects on. Each kind is its own parameter type, and the two
1975
1893
  * property kinds also name the Property they read.
@@ -2058,8 +1976,6 @@ declare class RangeFilter implements Parameter {
2058
1976
  */
2059
1977
  static fromKeyValuePair(pair: KeyValuePair): RangeFilter | undefined;
2060
1978
  }
2061
- //#endregion
2062
- //#region src/model/parameter/message_parameter.d.ts
2063
1979
  type MessageParameter = ObjectDeliveryTimeout | SubgroupDeliveryTimeout | RendezvousTimeout | FillTimeout | AuthorizationToken | Expires | LargestObject | Forward | SubscriberPriority | GroupOrderParam | LocationFilter | NewGroupRequest | SwitchFrom | FillParameters | RangeFilter | IncludeProperties | SwitchingSetAssignment;
2064
1980
  declare namespace MessageParameter {
2065
1981
  /**
@@ -2157,8 +2073,6 @@ declare function deserializeMessageParameterKvps(buf: BaseByteBuffer, count: num
2157
2073
  * Filter replaces its kind with nothing.
2158
2074
  */
2159
2075
  declare function applyMessageParameterUpdate(current: MessageParameter[], updates: MessageParameter[]): void;
2160
- //#endregion
2161
- //#region src/model/control/publish_namespace.d.ts
2162
2076
  /**
2163
2077
  * Represents a protocol PublishNamespace message, used to announce a track and its parameters.
2164
2078
  *
@@ -2202,8 +2116,6 @@ declare class PublishNamespace {
2202
2116
  */
2203
2117
  static parsePayload(buf: BaseByteBuffer): PublishNamespace;
2204
2118
  }
2205
- //#endregion
2206
- //#region src/model/control/namespace.d.ts
2207
2119
  /**
2208
2120
  * @public
2209
2121
  * Represents a NAMESPACE message sent on a SUBSCRIBE_NAMESPACE bi-stream.
@@ -2216,8 +2128,6 @@ declare class Namespace {
2216
2128
  serialize(): FrozenByteBuffer;
2217
2129
  static parsePayload(buf: BaseByteBuffer): Namespace;
2218
2130
  }
2219
- //#endregion
2220
- //#region src/model/control/namespace_done.d.ts
2221
2131
  /**
2222
2132
  * @public
2223
2133
  * Represents a NAMESPACE_DONE message sent on a SUBSCRIBE_NAMESPACE bi-stream.
@@ -2230,8 +2140,6 @@ declare class NamespaceDone {
2230
2140
  serialize(): FrozenByteBuffer;
2231
2141
  static parsePayload(buf: BaseByteBuffer): NamespaceDone;
2232
2142
  }
2233
- //#endregion
2234
- //#region src/model/control/setup.d.ts
2235
2143
  /**
2236
2144
  * The first message each endpoint sends on its control stream.
2237
2145
  *
@@ -2250,8 +2158,6 @@ declare class Setup {
2250
2158
  serialize(): FrozenByteBuffer;
2251
2159
  static parsePayload(buf: BaseByteBuffer): Setup;
2252
2160
  }
2253
- //#endregion
2254
- //#region src/model/control/fetch.d.ts
2255
2161
  declare class Fetch {
2256
2162
  readonly requestId: bigint;
2257
2163
  readonly fullTrackName: FullTrackName;
@@ -2266,8 +2172,6 @@ declare class Fetch {
2266
2172
  serialize(): FrozenByteBuffer;
2267
2173
  static parsePayload(buf: BaseByteBuffer): Fetch;
2268
2174
  }
2269
- //#endregion
2270
- //#region src/model/property/constant.d.ts
2271
2175
  /**
2272
2176
  * Copyright 2025 The MOQtail Authors
2273
2177
  *
@@ -2284,11 +2188,12 @@ declare class Fetch {
2284
2188
  * limitations under the License.
2285
2189
  */
2286
2190
  declare enum LOCPropertyId {
2287
- Timestamp = 6,
2288
2191
  Timescale = 8,
2289
- VideoFrameMarking = 10,
2192
+ VideoFrameMarking = 9,
2290
2193
  AudioLevel = 12,
2291
- VideoConfig = 13
2194
+ VideoConfig = 13,
2195
+ AudioConfig = 15,
2196
+ Timestamp = 16
2292
2197
  }
2293
2198
  declare enum TrackPropertyType {
2294
2199
  ObjectDeliveryTimeout = 2,
@@ -2317,26 +2222,32 @@ interface PropertyRange {
2317
2222
  *
2318
2223
  */
2319
2224
  declare const PropertyRanges: {
2320
- /** Standards Action or IESG Approval (1-byte encoding). */readonly StandardsAction: {
2225
+ /** Standards Action or IESG Approval (1-byte encoding). */
2226
+ readonly StandardsAction: {
2321
2227
  readonly from: 0n;
2322
2228
  readonly to: 119n;
2323
- }; /** Application-specific use, no registration permitted (1-byte encoding). */
2229
+ };
2230
+ /** Application-specific use, no registration permitted (1-byte encoding). */
2324
2231
  readonly AppSpecific1Byte: {
2325
2232
  readonly from: 120n;
2326
2233
  readonly to: 127n;
2327
- }; /** Specification Required (2-byte encoding). */
2234
+ };
2235
+ /** Specification Required (2-byte encoding). */
2328
2236
  readonly SpecRequired: {
2329
2237
  readonly from: 128n;
2330
2238
  readonly to: 14335n;
2331
- }; /** Application-specific use, no registration permitted (2-byte encoding). */
2239
+ };
2240
+ /** Application-specific use, no registration permitted (2-byte encoding). */
2332
2241
  readonly AppSpecific2Byte: {
2333
2242
  readonly from: 14336n;
2334
2243
  readonly to: 16383n;
2335
- }; /** Mandatory Track Properties; Track scope only. */
2244
+ };
2245
+ /** Mandatory Track Properties; Track scope only. */
2336
2246
  readonly MandatoryTrack: {
2337
2247
  readonly from: 16384n;
2338
2248
  readonly to: 32767n;
2339
- }; /** First Come First Served begins here (open-ended). */
2249
+ };
2250
+ /** First Come First Served begins here (open-ended). */
2340
2251
  readonly Fcfs: {
2341
2252
  readonly from: 32768n;
2342
2253
  };
@@ -2347,8 +2258,6 @@ declare const PropertyRanges: {
2347
2258
  * range), for which no IANA registration is permitted.
2348
2259
  */
2349
2260
  declare function isApplicationSpecificProperty(typeValue: bigint | number): boolean;
2350
- //#endregion
2351
- //#region src/model/property/track_property.d.ts
2352
2261
  /** A timeout of 0 means no timeout is set (§8), on this side as on the parameter side. */
2353
2262
  declare class ObjectDeliveryTimeoutProperty {
2354
2263
  readonly timeoutMs: bigint;
@@ -2419,8 +2328,6 @@ declare namespace TrackProperty {
2419
2328
  function isDynamicGroups(ext: TrackProperty): ext is DynamicGroupsProperty;
2420
2329
  function isUnknown(ext: TrackProperty): ext is UnknownTrackProperty;
2421
2330
  }
2422
- //#endregion
2423
- //#region src/model/control/fetch_ok.d.ts
2424
2331
  /**
2425
2332
  * FETCH_OK (0x18) keeps a body of its own rather than folding into REQUEST_OK, but like
2426
2333
  * every other response it carries no Request ID: the request stream it arrives on
@@ -2432,15 +2339,13 @@ declare class FetchOk {
2432
2339
  readonly endLocation: Location;
2433
2340
  readonly parameters: MessageParameter[];
2434
2341
  readonly trackProperties: TrackProperty[];
2435
- constructor(endOfTrack: boolean, /** The last Location the response covers, inclusive. Object 2^64-1 is all of that group. */
2436
-
2342
+ constructor(endOfTrack: boolean,
2343
+ /** The last Location the response covers, inclusive. Object 2^64-1 is all of that group. */
2437
2344
  endLocation: Location, parameters: MessageParameter[], trackProperties?: TrackProperty[]);
2438
2345
  getType(): ControlMessageType;
2439
2346
  serialize(): FrozenByteBuffer;
2440
2347
  static parsePayload(buf: BaseByteBuffer): FetchOk;
2441
2348
  }
2442
- //#endregion
2443
- //#region src/model/control/goaway.d.ts
2444
2349
  /** §10.4: a longer New Session URI is a protocol violation. */
2445
2350
  declare const MAX_NEW_SESSION_URI_LENGTH = 8192;
2446
2351
  /**
@@ -2460,8 +2365,6 @@ declare class GoAway {
2460
2365
  serialize(): FrozenByteBuffer;
2461
2366
  static parsePayload(buf: BaseByteBuffer): GoAway;
2462
2367
  }
2463
- //#endregion
2464
- //#region src/model/control/subscribe.d.ts
2465
2368
  declare class Subscribe {
2466
2369
  requestId: bigint;
2467
2370
  fullTrackName: FullTrackName;
@@ -2471,8 +2374,6 @@ declare class Subscribe {
2471
2374
  serialize(): FrozenByteBuffer;
2472
2375
  static parsePayload(buf: BaseByteBuffer): Subscribe;
2473
2376
  }
2474
- //#endregion
2475
- //#region src/model/control/publish_done.d.ts
2476
2377
  declare class PublishDone {
2477
2378
  readonly statusCode: PublishDoneStatusCode;
2478
2379
  readonly streamCount: bigint;
@@ -2488,8 +2389,6 @@ declare class PublishDone {
2488
2389
  serialize(): FrozenByteBuffer;
2489
2390
  static parsePayload(buf: BaseByteBuffer): PublishDone;
2490
2391
  }
2491
- //#endregion
2492
- //#region src/model/control/publish.d.ts
2493
2392
  declare class Publish {
2494
2393
  readonly requestId: bigint;
2495
2394
  readonly fullTrackName: FullTrackName;
@@ -2501,8 +2400,6 @@ declare class Publish {
2501
2400
  serialize(): FrozenByteBuffer;
2502
2401
  static parsePayload(buf: BaseByteBuffer): Publish;
2503
2402
  }
2504
- //#endregion
2505
- //#region src/model/control/subscribe_ok.d.ts
2506
2403
  /**
2507
2404
  * SUBSCRIBE_OK (0x4) keeps a body of its own rather than folding into REQUEST_OK, but
2508
2405
  * like every other response it carries no Request ID: the request stream it arrives on
@@ -2518,8 +2415,6 @@ declare class SubscribeOk {
2518
2415
  serialize(): FrozenByteBuffer;
2519
2416
  static parsePayload(buf: BaseByteBuffer): SubscribeOk;
2520
2417
  }
2521
- //#endregion
2522
- //#region src/model/control/request_update.d.ts
2523
2418
  declare class RequestUpdate {
2524
2419
  requestId: bigint;
2525
2420
  parameters: MessageParameter[];
@@ -2529,8 +2424,6 @@ declare class RequestUpdate {
2529
2424
  static parsePayload(buf: BaseByteBuffer): RequestUpdate;
2530
2425
  equals(other: RequestUpdate): boolean;
2531
2426
  }
2532
- //#endregion
2533
- //#region src/model/control/track_status.d.ts
2534
2427
  declare class TrackStatus {
2535
2428
  requestId: bigint;
2536
2429
  trackAlias: bigint;
@@ -2545,8 +2438,6 @@ declare class TrackStatus {
2545
2438
  serialize(): FrozenByteBuffer;
2546
2439
  static parsePayload(buf: BaseByteBuffer): TrackStatus;
2547
2440
  }
2548
- //#endregion
2549
- //#region src/model/control/subscribe_namespace.d.ts
2550
2441
  declare class SubscribeNamespace {
2551
2442
  readonly requestId: bigint;
2552
2443
  readonly trackNamespacePrefix: Tuple;
@@ -2556,8 +2447,6 @@ declare class SubscribeNamespace {
2556
2447
  serialize(): FrozenByteBuffer;
2557
2448
  static parsePayload(buf: BaseByteBuffer): SubscribeNamespace;
2558
2449
  }
2559
- //#endregion
2560
- //#region src/model/control/subscribe_tracks.d.ts
2561
2450
  /**
2562
2451
  * SUBSCRIBE_TRACKS (0x51) asks for a PUBLISH for every track under a matching
2563
2452
  * namespace prefix, present and future (§10.19).
@@ -2574,8 +2463,6 @@ declare class SubscribeTracks {
2574
2463
  serialize(): FrozenByteBuffer;
2575
2464
  static parsePayload(buf: BaseByteBuffer): SubscribeTracks;
2576
2465
  }
2577
- //#endregion
2578
- //#region src/model/control/request_ok.d.ts
2579
2466
  /**
2580
2467
  * @public
2581
2468
  * REQUEST_OK (0x7) answers PUBLISH, REQUEST_UPDATE, TRACK_STATUS, SUBSCRIBE_NAMESPACE,
@@ -2613,8 +2500,6 @@ declare class RequestOk {
2613
2500
  */
2614
2501
  static parsePayload(buf: BaseByteBuffer): RequestOk;
2615
2502
  }
2616
- //#endregion
2617
- //#region src/model/control/request_error.d.ts
2618
2503
  /**
2619
2504
  * REQUEST_ERROR (0x5) refuses any request type. It carries no Request ID: the request
2620
2505
  * stream it arrives on identifies the request (§10.1).
@@ -2632,112 +2517,11 @@ declare class RequestError {
2632
2517
  serialize(): FrozenByteBuffer;
2633
2518
  static parsePayload(buf: BaseByteBuffer): RequestError;
2634
2519
  }
2635
- //#endregion
2636
- //#region src/model/control/control_message.d.ts
2637
2520
  type ControlMessage = Publish | PublishSkipped | PublishDone | PublishNamespace | Namespace | NamespaceDone | Setup | Fetch | FetchOk | GoAway | Subscribe | RequestError | SubscribeOk | RequestUpdate | TrackStatus | SubscribeNamespace | SubscribeTracks | RequestOk;
2638
2521
  declare namespace ControlMessage {
2639
2522
  function deserialize(buf: FrozenByteBuffer): ControlMessage;
2640
2523
  function serialize(msg: ControlMessage): FrozenByteBuffer;
2641
2524
  }
2642
- //#endregion
2643
- //#region src/model/error/stream_reset.d.ts
2644
- /**
2645
- * Copyright 2026 The MOQtail Authors
2646
- *
2647
- * Licensed under the Apache License, Version 2.0 (the "License");
2648
- * you may not use this file except in compliance with the License.
2649
- * You may obtain a copy of the License at
2650
- *
2651
- * http://www.apache.org/licenses/LICENSE-2.0
2652
- *
2653
- * Unless required by applicable law or agreed to in writing, software
2654
- * distributed under the License is distributed on an "AS IS" BASIS,
2655
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2656
- * See the License for the specific language governing permissions and
2657
- * limitations under the License.
2658
- */
2659
- /**
2660
- * @public
2661
- * Codes carried when resetting a request stream or sending STOP_SENDING on one.
2662
- *
2663
- * A separate registry from {@link (RequestErrorCode:enum)}, which disagrees with it on
2664
- * the same names: `GOING_AWAY` is `0x4` here but `0x6` there.
2665
- */
2666
- declare enum StreamResetCode {
2667
- InternalError = 0,
2668
- Cancelled = 1,
2669
- DeliveryTimeout = 2,
2670
- SessionClosed = 3,
2671
- GoingAway = 4,
2672
- TooFarBehind = 5,
2673
- UnknownObjectStatus = 6,
2674
- ExpiredAuthToken = 7,
2675
- ExcessiveLoad = 9,
2676
- MalformedTrack = 18
2677
- }
2678
- declare namespace StreamResetCode {
2679
- /**
2680
- * Converts a numeric application error code to a StreamResetCode. The code is a
2681
- * `number` because that is what the transport reports it as
2682
- * (`WebTransportError.streamErrorCode`, an `unsigned long`).
2683
- *
2684
- * @throws :{@link InvalidEnumValue} if the code is not a defined stream reset code.
2685
- */
2686
- function tryFrom(code: number): StreamResetCode;
2687
- }
2688
- //#endregion
2689
- //#region src/model/catalog/cmsf.d.ts
2690
- /**
2691
- * Copyright 2026 The MOQtail Authors
2692
- *
2693
- * Licensed under the Apache License, Version 2.0 (the "License");
2694
- * you may not use this file except in compliance with the License.
2695
- * You may obtain a copy of the License at
2696
- *
2697
- * http://www.apache.org/licenses/LICENSE-2.0
2698
- *
2699
- * Unless required by applicable law or agreed to in writing, software
2700
- * distributed under the License is distributed on an "AS IS" BASIS,
2701
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2702
- * See the License for the specific language governing permissions and
2703
- * limitations under the License.
2704
- */
2705
- interface CMSFTrack {
2706
- name: string;
2707
- packaging: 'cmaf' | 'chunk-per-object' | 'timeline';
2708
- codec?: string;
2709
- role: 'video' | 'audio' | 'timeline';
2710
- depends?: string[];
2711
- mimeType?: string;
2712
- width?: number;
2713
- height?: number;
2714
- timescale?: number;
2715
- bitrate?: number;
2716
- initData?: string;
2717
- }
2718
- interface CMSF {
2719
- version: string;
2720
- tracks: CMSFTrack[];
2721
- }
2722
- declare class CMSFCatalog {
2723
- #private;
2724
- private constructor();
2725
- static from(payload: ArrayBufferLike): CMSFCatalog;
2726
- getByTrackName(trackName: string): CMSFTrack | undefined;
2727
- getTracks(role?: CMSF['tracks'][number]['role']): CMSFTrack[];
2728
- getVideo(index?: number): CMSFTrack | undefined;
2729
- getAudio(index?: number): CMSFTrack | undefined;
2730
- getTimeline(index?: number): CMSFTrack | undefined;
2731
- getCodecString(trackName: string): string | undefined;
2732
- getRole(trackName: string): "video" | "audio" | "timeline" | undefined;
2733
- getPackaging(trackName: string): "timeline" | "cmaf" | "chunk-per-object" | undefined;
2734
- isCMAF(trackName: string): boolean;
2735
- getTimescale(trackName: string): number | undefined;
2736
- getInitData(trackName: string): Uint8Array<ArrayBuffer> | undefined;
2737
- private extractTrackName;
2738
- }
2739
- //#endregion
2740
- //#region src/model/error/constant.d.ts
2741
2525
  /**
2742
2526
  * Copyright 2025 The MOQtail Authors
2743
2527
  *
@@ -2784,8 +2568,50 @@ declare namespace TerminationCode {
2784
2568
  */
2785
2569
  function tryFrom(code: number): TerminationCode;
2786
2570
  }
2787
- //#endregion
2788
- //#region src/model/property/timestamp.d.ts
2571
+ /**
2572
+ * Copyright 2026 The MOQtail Authors
2573
+ *
2574
+ * Licensed under the Apache License, Version 2.0 (the "License");
2575
+ * you may not use this file except in compliance with the License.
2576
+ * You may obtain a copy of the License at
2577
+ *
2578
+ * http://www.apache.org/licenses/LICENSE-2.0
2579
+ *
2580
+ * Unless required by applicable law or agreed to in writing, software
2581
+ * distributed under the License is distributed on an "AS IS" BASIS,
2582
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2583
+ * See the License for the specific language governing permissions and
2584
+ * limitations under the License.
2585
+ */
2586
+ /**
2587
+ * @public
2588
+ * Codes carried when resetting a request stream or sending STOP_SENDING on one.
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
+ }
2789
2615
  declare class Timestamp {
2790
2616
  readonly timestamp: bigint;
2791
2617
  static readonly TYPE = LOCPropertyId.Timestamp;
@@ -2793,8 +2619,6 @@ declare class Timestamp {
2793
2619
  toKeyValuePair(): KeyValuePair;
2794
2620
  static fromKeyValuePair(pair: KeyValuePair): Timestamp | undefined;
2795
2621
  }
2796
- //#endregion
2797
- //#region src/model/property/timescale.d.ts
2798
2622
  declare class Timescale {
2799
2623
  readonly timescale: bigint;
2800
2624
  static readonly TYPE = LOCPropertyId.Timescale;
@@ -2802,17 +2626,16 @@ declare class Timescale {
2802
2626
  toKeyValuePair(): KeyValuePair;
2803
2627
  static fromKeyValuePair(pair: KeyValuePair): Timescale | undefined;
2804
2628
  }
2805
- //#endregion
2806
- //#region src/model/property/video_frame_marking.d.ts
2807
2629
  declare class VideoFrameMarking {
2808
- readonly value: bigint;
2630
+ readonly value: Uint8Array;
2809
2631
  static readonly TYPE = LOCPropertyId.VideoFrameMarking;
2810
- constructor(value: bigint);
2632
+ /** The RFC 9626 frame-marking octets (1 to 4), without the length prefix. */
2633
+ constructor(value: Uint8Array);
2634
+ /** True if the frame decodes without temporally prior frames (the I bit). */
2635
+ get independent(): boolean;
2811
2636
  toKeyValuePair(): KeyValuePair;
2812
2637
  static fromKeyValuePair(pair: KeyValuePair): VideoFrameMarking | undefined;
2813
2638
  }
2814
- //#endregion
2815
- //#region src/model/property/audio_level.d.ts
2816
2639
  declare class AudioLevel {
2817
2640
  readonly audioLevel: bigint;
2818
2641
  static readonly TYPE = LOCPropertyId.AudioLevel;
@@ -2820,8 +2643,6 @@ declare class AudioLevel {
2820
2643
  toKeyValuePair(): KeyValuePair;
2821
2644
  static fromKeyValuePair(pair: KeyValuePair): AudioLevel | undefined;
2822
2645
  }
2823
- //#endregion
2824
- //#region src/model/property/video_config.d.ts
2825
2646
  declare class VideoConfig {
2826
2647
  readonly config: Uint8Array;
2827
2648
  static readonly TYPE = LOCPropertyId.VideoConfig;
@@ -2829,9 +2650,14 @@ declare class VideoConfig {
2829
2650
  toKeyValuePair(): KeyValuePair;
2830
2651
  static fromKeyValuePair(pair: KeyValuePair): VideoConfig | undefined;
2831
2652
  }
2832
- //#endregion
2833
- //#region src/model/property/loc.d.ts
2834
- type LOCProperty = Timestamp | Timescale | VideoFrameMarking | AudioLevel | VideoConfig;
2653
+ declare class AudioConfig {
2654
+ readonly config: Uint8Array;
2655
+ static readonly TYPE = LOCPropertyId.AudioConfig;
2656
+ constructor(config: Uint8Array);
2657
+ toKeyValuePair(): KeyValuePair;
2658
+ static fromKeyValuePair(pair: KeyValuePair): AudioConfig | undefined;
2659
+ }
2660
+ type LOCProperty = Timestamp | Timescale | VideoFrameMarking | AudioLevel | VideoConfig | AudioConfig;
2835
2661
  declare namespace LOCProperty {
2836
2662
  function fromKeyValuePair(pair: KeyValuePair): LOCProperty | undefined;
2837
2663
  function toKeyValuePair(header: LOCProperty): KeyValuePair;
@@ -2840,20 +2666,21 @@ declare namespace LOCProperty {
2840
2666
  function isVideoFrameMarking(header: LOCProperty): header is VideoFrameMarking;
2841
2667
  function isAudioLevel(header: LOCProperty): header is AudioLevel;
2842
2668
  function isVideoConfig(header: LOCProperty): header is VideoConfig;
2669
+ function isAudioConfig(header: LOCProperty): header is AudioConfig;
2843
2670
  }
2844
2671
  declare class LOCProperties {
2845
2672
  private kvps;
2846
2673
  addTimestamp(timestamp: bigint | number): this;
2847
2674
  addTimescale(timescale: bigint | number): this;
2848
- addVideoFrameMarking(marking: bigint | number): this;
2675
+ /** Marks a whole, non-scalable frame (RFC 9626 short form): S and E set, I set on a keyframe. */
2676
+ addVideoFrameMarking(isKey: boolean): this;
2849
2677
  addAudioLevel(audioLevel: bigint | number): this;
2850
2678
  addVideoConfig(config: Uint8Array): this;
2679
+ addAudioConfig(config: Uint8Array): this;
2851
2680
  addRaw(pair: KeyValuePair): this;
2852
2681
  build(): KeyValuePair[];
2853
2682
  static fromKeyValuePairs(kvps: KeyValuePair[]): LOCProperty[];
2854
2683
  }
2855
- //#endregion
2856
- //#region src/model/property/object_property.d.ts
2857
2684
  declare class ImmutablePropertiesObjectProperty {
2858
2685
  readonly properties: KeyValuePair[];
2859
2686
  static readonly TYPE = TrackPropertyType.ImmutableProperties;
@@ -2891,8 +2718,29 @@ declare namespace ObjectProperty {
2891
2718
  function isPriorObjectIdGap(ext: ObjectProperty): ext is PriorObjectIdGapProperty;
2892
2719
  function isUnknown(ext: ObjectProperty): ext is UnknownObjectProperty;
2893
2720
  }
2894
- //#endregion
2895
- //#region src/model/parameter/setup/path.d.ts
2721
+ /**
2722
+ * @public
2723
+ * A property class read by {@link findProperty}: its `TYPE` and `fromKeyValuePair`.
2724
+ * Every property class in the model already is one.
2725
+ */
2726
+ interface PropertyReader<T> {
2727
+ readonly TYPE: number | bigint;
2728
+ fromKeyValuePair(pair: KeyValuePair): T | undefined;
2729
+ }
2730
+ /**
2731
+ * @public
2732
+ * Finds the first property of `reader`'s type in a track or object property list and
2733
+ * returns it typed, or `undefined`. Unknown properties keep their raw key-value pair, so
2734
+ * a type the model doesn't know is still found.
2735
+ *
2736
+ * @example
2737
+ * ```ts
2738
+ * const timeout = findProperty(subscribeOk.trackProperties, ObjectDeliveryTimeoutProperty)
2739
+ * ```
2740
+ */
2741
+ declare function findProperty<T>(properties: readonly (KeyValuePair | {
2742
+ toKeyValuePair(): KeyValuePair;
2743
+ })[] | null | undefined, reader: PropertyReader<T>): T | undefined;
2896
2744
  declare class Path implements Parameter {
2897
2745
  readonly moqtPath: string;
2898
2746
  static readonly TYPE = SetupOptionType.Path;
@@ -2900,8 +2748,6 @@ declare class Path implements Parameter {
2900
2748
  toKeyValuePair(): KeyValuePair;
2901
2749
  static fromKeyValuePair(pair: KeyValuePair): Path | undefined;
2902
2750
  }
2903
- //#endregion
2904
- //#region src/model/parameter/setup/max_auth_token_cache_size.d.ts
2905
2751
  declare class MaxAuthTokenCacheSize implements Parameter {
2906
2752
  readonly maxSize: bigint;
2907
2753
  static readonly TYPE = SetupOptionType.MaxAuthTokenCacheSize;
@@ -2909,15 +2755,13 @@ declare class MaxAuthTokenCacheSize implements Parameter {
2909
2755
  toKeyValuePair(): KeyValuePair;
2910
2756
  static fromKeyValuePair(pair: KeyValuePair): MaxAuthTokenCacheSize | undefined;
2911
2757
  }
2912
- //#endregion
2913
- //#region src/model/parameter/setup/authority.d.ts
2914
2758
  /**
2915
2759
  * Raw-QUIC only: the authority component of the `moqt://` URI, carried in SETUP because
2916
2760
  * there is no HTTP CONNECT to carry it.
2917
2761
  *
2918
2762
  * Client-only; MUST NOT be sent by a server or over WebTransport. moqtail-ts always
2919
2763
  * connects over WebTransport, so its own handshake never sends this — see
2920
- * `MOQtailClient.new`.
2764
+ * `MOQtailClient.init`.
2921
2765
  */
2922
2766
  declare class Authority implements Parameter {
2923
2767
  readonly authority: string;
@@ -2926,8 +2770,6 @@ declare class Authority implements Parameter {
2926
2770
  toKeyValuePair(): KeyValuePair;
2927
2771
  static fromKeyValuePair(pair: KeyValuePair): Authority | undefined;
2928
2772
  }
2929
- //#endregion
2930
- //#region src/model/parameter/setup/max_filter_ranges.d.ts
2931
2773
  /**
2932
2774
  * Limits the total number of Ranges the peer may have across all Range filter parameters
2933
2775
  * of a single subscription or fetch. Zero, the default when absent, means the peer may
@@ -2940,8 +2782,6 @@ declare class MaxFilterRanges implements Parameter {
2940
2782
  toKeyValuePair(): KeyValuePair;
2941
2783
  static fromKeyValuePair(pair: KeyValuePair): MaxFilterRanges | undefined;
2942
2784
  }
2943
- //#endregion
2944
- //#region src/model/parameter/setup/moqt_implementation.d.ts
2945
2785
  /**
2946
2786
  * Free-form implementation identification string, e.g. for logging and debugging.
2947
2787
  * Either peer may send it.
@@ -2953,8 +2793,6 @@ declare class MoqtImplementation implements Parameter {
2953
2793
  toKeyValuePair(): KeyValuePair;
2954
2794
  static fromKeyValuePair(pair: KeyValuePair): MoqtImplementation | undefined;
2955
2795
  }
2956
- //#endregion
2957
- //#region src/model/parameter/setup/max_request_updates.d.ts
2958
2796
  /**
2959
2797
  * Maximum number of outstanding REQUEST_UPDATEs per request stream: an update counts
2960
2798
  * until its REQUEST_OK or REQUEST_ERROR arrives. Zero, the default when absent, means
@@ -2967,8 +2805,6 @@ declare class MaxRequestUpdates implements Parameter {
2967
2805
  toKeyValuePair(): KeyValuePair;
2968
2806
  static fromKeyValuePair(pair: KeyValuePair): MaxRequestUpdates | undefined;
2969
2807
  }
2970
- //#endregion
2971
- //#region src/model/parameter/setup/ssts_algorithms.d.ts
2972
2808
  /**
2973
2809
  * The sender-side track switching (SSTS) algorithms this endpoint supports.
2974
2810
  *
@@ -2984,8 +2820,6 @@ declare class SstsAlgorithms implements Parameter {
2984
2820
  toKeyValuePair(): KeyValuePair;
2985
2821
  static fromKeyValuePair(pair: KeyValuePair): SstsAlgorithms | undefined;
2986
2822
  }
2987
- //#endregion
2988
- //#region src/model/parameter/setup_option.d.ts
2989
2823
  type SetupOption = Path | MaxAuthTokenCacheSize | AuthorizationToken | Authority | MaxFilterRanges | MoqtImplementation | MaxRequestUpdates | SstsAlgorithms;
2990
2824
  declare namespace SetupOption {
2991
2825
  function fromKeyValuePair(pair: KeyValuePair): SetupOption | undefined;
@@ -3014,8 +2848,6 @@ declare class SetupOptions {
3014
2848
  build(): KeyValuePair[];
3015
2849
  static fromKeyValuePairs(kvps: KeyValuePair[]): SetupOption[];
3016
2850
  }
3017
- //#endregion
3018
- //#region src/model/parameter/message/combined_filter.d.ts
3019
2851
  /**
3020
2852
  * The object filter a request's Range Filters add up to.
3021
2853
  *
@@ -3047,5 +2879,4 @@ declare class CombinedFilter {
3047
2879
  */
3048
2880
  matches(obj: MoqtObject, subgroupId?: bigint | null): boolean;
3049
2881
  }
3050
- //#endregion
3051
- export { PropertyRange as $, isVarInt as $n, Expires as $t, RequestError as A, LocationFilterType as An, RequestIdError as At, GoAway as B, ObjectDatagramType as Bn, NewGroupRequest as Bt, Timestamp as C, MAX_FULL_TRACK_NAME_LENGTH as Cn, InvalidTypeError as Ct, CMSFTrack as D, FetchObjectContext as Dn, MOQtailError as Dt, CMSFCatalog as E, FetchObject as En, LengthExceedsMaxError as Et, RequestUpdate as F, TrackStatusCode as Fn, FillParameters as Ft, DynamicGroupsProperty as G, ReasonPhrase as Gn, resolveTransportUrl as Gt, FetchOk as H, ObjectStatus as Hn, Redirect as Ht, SubscribeOk as I, FetchHeader as In, SwitchFrom as It, ObjectDeliveryTimeoutProperty as J, Location as Jn, greaseValue as Jt, ImmutablePropertiesTrackProperty as K, Tuple as Kn, GREASE_BASE as Kt, Publish as L, Datagram as Ln, LocationFilter as Lt, SubscribeTracks as M, RequestErrorCode as Mn, TimeoutError as Mt, SubscribeNamespace as N, SUPPORTED_VERSIONS as Nn, TrackNameError as Nt, StreamResetCode as O, ControlMessageType as On, NotEnoughBytesError as Ot, TrackStatus as P, SwitchMode as Pn, VarIntOverflowError as Pt, LOCPropertyId as Q, isBytes as Qn, Forward as Qt, PublishDone as R, DEFAULT_PUBLISHER_PRIORITY as Rn, SubscriberPriority as Rt, Timescale as S, FullTrackName as Sn, InvalidEnumValue as St, CMSF as T, EndOfRangeKind as Tn, KeyValueFormattingError as Tt, DefaultPublisherGroupOrderProperty as U, SubgroupHeaderType as Un, MoqtFragment as Ut, MAX_NEW_SESSION_URI_LENGTH as V, ObjectForwardingPreference as Vn, LargestObject as Vt, DefaultPublisherPriorityProperty as W, MAX_REASON_PHRASE_LEN as Wn, MoqtUrl as Wt, TrackProperty as X, deserializeKvpList as Xn, GroupOrderParam as Xt, SubgroupDeliveryTimeoutProperty as Y, KeyValuePair as Yn, isGrease as Yt, UnknownTrackProperty as Z, deserializeKvpListUntilEmpty as Zn, IncludeProperties as Zt, LOCProperties as _, Header as _n, RangeFilter as _t, SstsAlgorithms as a, AuthorizationToken as an, Setup as at, AudioLevel as b, MoqtObject as bn, CastingError as bt, MaxFilterRanges as c, SetupOptionType as cn, PublishNamespace as ct, Path as d, setupOptionTypeFromNumber as dn, applyMessageParameterUpdate as dt, SubgroupDeliveryTimeout as en, serializeKvpList as er, PropertyRanges as et, ImmutablePropertiesObjectProperty as f, tokenAliasTypeFromNumber as fn, deserializeMessageParameterKvps as ft, UnknownObjectProperty as g, FrozenByteBuffer as gn, RangeDelta as gt, PriorObjectIdGapProperty as h, ByteBuffer as hn, Range as ht, assertNoAuthorityOverWebTransport as i, AuthTokenVariant as in, Fetch as it, RequestOk as j, PublishDoneStatusCode as jn, TerminationError as jt, ControlMessage as k, GroupOrder as kn, ProtocolViolationError as kt, Authority as l, TokenAliasType as ln, MessageParameter as lt, PriorGroupIdGapProperty as m, BaseByteBuffer as mn, InvalidFilterError as mt, SetupOption as n, ObjectDeliveryTimeout as nn, isApplicationSpecificProperty as nt, MaxRequestUpdates as o, Parameter as on, NamespaceDone as ot, ObjectProperty as p, PublishSkipped as pn, serializeMessageParameterKvps as pt, MaxCacheDurationProperty as q, TupleField as qn, GREASE_STEP as qt, SetupOptions as r, FillTimeout as rn, locPropertyIdFromNumber as rt, MoqtImplementation as s, MessageParameterType as sn, Namespace as st, CombinedFilter as t, RendezvousTimeout as tn, TrackPropertyType as tt, MaxAuthTokenCacheSize as u, messageParameterTypeFromNumber as un, MessageParameters as ut, LOCProperty as v, RequestIdMap as vn, RangeFilterKind as vt, TerminationCode as w, MAX_NAMESPACE_TUPLE_COUNT as wn, InvalidUTF8Error as wt, VideoFrameMarking as x, SubgroupObject as xn, InternalError as xt, VideoConfig as y, SubgroupHeader as yn, encodeRanges as yt, Subscribe as z, FetchHeaderType as zn, SwitchingSetAssignment as zt };
2882
+ export { PropertyRange as $, isVarInt as $n, Expires as $t, RequestError as A, LocationFilterType as An, RequestIdError as At, GoAway as B, ObjectDatagramType as Bn, NewGroupRequest as Bt, AudioLevel as C, MAX_FULL_TRACK_NAME_LENGTH as Cn, InvalidTypeError as Ct, StreamResetCode as D, FetchObjectContext as Dn, MOQtailError as Dt, Timestamp as E, FetchObject as En, LengthExceedsMaxError as Et, RequestUpdate as F, TrackStatusCode as Fn, FillParameters as Ft, DynamicGroupsProperty as G, ReasonPhrase as Gn, resolveTransportUrl as Gt, FetchOk as H, ObjectStatus as Hn, Redirect as Ht, SubscribeOk as I, FetchHeader as In, SwitchFrom as It, ObjectDeliveryTimeoutProperty as J, Location as Jn, greaseValue as Jt, ImmutablePropertiesTrackProperty as K, Tuple as Kn, GREASE_BASE as Kt, Publish as L, Datagram as Ln, LocationFilter as Lt, SubscribeTracks as M, RequestErrorCode as Mn, TimeoutError as Mt, SubscribeNamespace as N, SUPPORTED_VERSIONS as Nn, TrackNameError as Nt, TerminationCode as O, ControlMessageType as On, NotEnoughBytesError as Ot, TrackStatus as P, SwitchMode as Pn, VarIntOverflowError as Pt, LOCPropertyId as Q, isBytes as Qn, Forward as Qt, PublishDone as R, DEFAULT_PUBLISHER_PRIORITY as Rn, SubscriberPriority as Rt, VideoConfig as S, FullTrackName as Sn, InvalidEnumValue as St, Timescale as T, EndOfRangeKind as Tn, KeyValueFormattingError as Tt, DefaultPublisherGroupOrderProperty as U, SubgroupHeaderType as Un, MoqtFragment as Ut, MAX_NEW_SESSION_URI_LENGTH as V, ObjectForwardingPreference as Vn, LargestObject as Vt, DefaultPublisherPriorityProperty as W, MAX_REASON_PHRASE_LEN as Wn, MoqtUrl as Wt, TrackProperty as X, deserializeKvpList as Xn, GroupOrderParam as Xt, SubgroupDeliveryTimeoutProperty as Y, KeyValuePair as Yn, isGrease as Yt, UnknownTrackProperty as Z, deserializeKvpListUntilEmpty as Zn, IncludeProperties as Zt, PriorObjectIdGapProperty as _, Header as _n, RangeFilter as _t, SstsAlgorithms as a, AuthorizationToken as an, Setup as at, LOCProperty as b, MoqtObject as bn, CastingError as bt, MaxFilterRanges as c, SetupOptionType as cn, PublishNamespace as ct, Path as d, setupOptionTypeFromNumber as dn, applyMessageParameterUpdate as dt, SubgroupDeliveryTimeout as en, serializeKvpList as er, PropertyRanges as et, PropertyReader as f, tokenAliasTypeFromNumber as fn, deserializeMessageParameterKvps as ft, PriorGroupIdGapProperty as g, FrozenByteBuffer as gn, RangeDelta as gt, ObjectProperty as h, ByteBuffer as hn, Range as ht, assertNoAuthorityOverWebTransport as i, AuthTokenVariant as in, Fetch as it, RequestOk as j, PublishDoneStatusCode as jn, TerminationError as jt, ControlMessage as k, GroupOrder as kn, ProtocolViolationError as kt, Authority as l, TokenAliasType as ln, MessageParameter as lt, ImmutablePropertiesObjectProperty as m, BaseByteBuffer as mn, InvalidFilterError as mt, SetupOption as n, ObjectDeliveryTimeout as nn, isApplicationSpecificProperty as nt, MaxRequestUpdates as o, Parameter as on, NamespaceDone as ot, findProperty as p, PublishSkipped as pn, serializeMessageParameterKvps as pt, MaxCacheDurationProperty as q, TupleField as qn, GREASE_STEP as qt, SetupOptions as r, FillTimeout as rn, locPropertyIdFromNumber as rt, MoqtImplementation as s, MessageParameterType as sn, Namespace as st, CombinedFilter as t, RendezvousTimeout as tn, TrackPropertyType as tt, MaxAuthTokenCacheSize as u, messageParameterTypeFromNumber as un, MessageParameters as ut, UnknownObjectProperty as v, RequestIdMap as vn, RangeFilterKind as vt, VideoFrameMarking as w, MAX_NAMESPACE_TUPLE_COUNT as wn, InvalidUTF8Error as wt, AudioConfig as x, SubgroupObject as xn, InternalError as xt, LOCProperties as y, SubgroupHeader as yn, encodeRanges as yt, Subscribe as z, FetchHeaderType as zn, SwitchingSetAssignment as zt };