@moqtap/codec 0.8.1 → 0.9.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 (127) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/README.md +16 -4
  3. package/dist/chunk-BMJMY6FX.cjs +868 -0
  4. package/dist/chunk-MAXEHYVB.cjs +2362 -0
  5. package/dist/{chunk-3YAR3I3S.js → chunk-Q7NSUXXB.js} +3 -1
  6. package/dist/{chunk-VWXUT5R2.cjs → chunk-TVSFDQYE.cjs} +3 -1
  7. package/dist/chunk-WX5PU7HF.js +868 -0
  8. package/dist/chunk-YJGOD3Y4.js +2362 -0
  9. package/dist/{codec-BLYAy2OP.d.ts → codec--CVeqGQv.d.ts} +1 -1
  10. package/dist/{codec-DujHf55Z.d.ts → codec-BJ7BHuiZ.d.ts} +1 -1
  11. package/dist/{codec-D47r_-Rl.d.ts → codec-BKsVu3Fr.d.ts} +1 -1
  12. package/dist/{codec-BNS3gS77.d.ts → codec-BMwgZIgG.d.ts} +1 -1
  13. package/dist/{codec-CI0BjmHc.d.ts → codec-BNy5syCU.d.ts} +1 -1
  14. package/dist/{codec-v6Vloc7H.d.ts → codec-BQa6Qsav.d.ts} +1 -1
  15. package/dist/codec-Bym-K2q2.d.cts +49 -0
  16. package/dist/{codec-D2JbI2tp.d.ts → codec-C006F75E.d.ts} +1 -1
  17. package/dist/codec-C5evFHL-.d.ts +49 -0
  18. package/dist/{codec-DQWQSam3.d.cts → codec-C6Mx4bwz.d.cts} +1 -1
  19. package/dist/{codec-DL0njGkL.d.ts → codec-CA6nbbEk.d.ts} +1 -1
  20. package/dist/{codec-D89DWXbv.d.cts → codec-CSBFdPgP.d.cts} +1 -1
  21. package/dist/{codec-DvcJgYKq.d.cts → codec-CXCjya_G.d.cts} +1 -1
  22. package/dist/{codec-hvkJfCF5.d.cts → codec-C_xxsbKy.d.cts} +1 -1
  23. package/dist/{codec-BOyrk_C9.d.cts → codec-Cfo_z5ET.d.cts} +1 -1
  24. package/dist/{codec-xeuGZY77.d.cts → codec-CgZdadPt.d.cts} +2 -2
  25. package/dist/{codec-WwwUipaU.d.ts → codec-Cl73EfRW.d.ts} +1 -1
  26. package/dist/{codec-BOtv3R5j.d.cts → codec-CtvFK4aV.d.cts} +1 -1
  27. package/dist/{codec-DAePx2NL.d.ts → codec-CviAa4lp.d.ts} +2 -2
  28. package/dist/{codec-DJmV04i0.d.ts → codec-D4RvFQmu.d.ts} +1 -1
  29. package/dist/{codec-cou9XBMF.d.cts → codec-DAyiF5sq.d.cts} +1 -1
  30. package/dist/{codec-CyApDKwf.d.cts → codec-DJmqoIsp.d.cts} +1 -1
  31. package/dist/{codec-NMsTK0GX.d.cts → codec-DchsPfr3.d.cts} +1 -1
  32. package/dist/{codec-DplRgIKq.d.ts → codec-Dl_QIXMz.d.ts} +1 -1
  33. package/dist/{codec-N3g1lxQQ.d.cts → codec-DzLvG8Wb.d.cts} +1 -1
  34. package/dist/{codec-D95gT98n.d.cts → codec-DzkdW4kO.d.cts} +1 -1
  35. package/dist/{codec-CWj5iTxA.d.ts → codec-O-1Js7h4.d.ts} +1 -1
  36. package/dist/{codec-BqqoYdh_.d.cts → codec-vddqy0KY.d.cts} +1 -1
  37. package/dist/draft07-session.d.cts +3 -3
  38. package/dist/draft07-session.d.ts +3 -3
  39. package/dist/draft07.d.cts +3 -3
  40. package/dist/draft07.d.ts +3 -3
  41. package/dist/draft08-session.d.cts +3 -3
  42. package/dist/draft08-session.d.ts +3 -3
  43. package/dist/draft08.d.cts +4 -4
  44. package/dist/draft08.d.ts +4 -4
  45. package/dist/draft09-session.d.cts +3 -3
  46. package/dist/draft09-session.d.ts +3 -3
  47. package/dist/draft09.d.cts +4 -4
  48. package/dist/draft09.d.ts +4 -4
  49. package/dist/draft10-session.d.cts +3 -3
  50. package/dist/draft10-session.d.ts +3 -3
  51. package/dist/draft10.d.cts +4 -4
  52. package/dist/draft10.d.ts +4 -4
  53. package/dist/draft11-session.d.cts +3 -3
  54. package/dist/draft11-session.d.ts +3 -3
  55. package/dist/draft11.d.cts +4 -4
  56. package/dist/draft11.d.ts +4 -4
  57. package/dist/draft12-session.d.cts +3 -3
  58. package/dist/draft12-session.d.ts +3 -3
  59. package/dist/draft12.d.cts +4 -4
  60. package/dist/draft12.d.ts +4 -4
  61. package/dist/draft13-session.d.cts +3 -3
  62. package/dist/draft13-session.d.ts +3 -3
  63. package/dist/draft13.d.cts +4 -4
  64. package/dist/draft13.d.ts +4 -4
  65. package/dist/draft14-session.d.cts +3 -3
  66. package/dist/draft14-session.d.ts +3 -3
  67. package/dist/draft14.d.cts +4 -4
  68. package/dist/draft14.d.ts +4 -4
  69. package/dist/draft15-session.d.cts +3 -3
  70. package/dist/draft15-session.d.ts +3 -3
  71. package/dist/draft15.d.cts +4 -4
  72. package/dist/draft15.d.ts +4 -4
  73. package/dist/draft16-session.d.cts +3 -3
  74. package/dist/draft16-session.d.ts +3 -3
  75. package/dist/draft16.d.cts +4 -4
  76. package/dist/draft16.d.ts +4 -4
  77. package/dist/draft17-session.d.cts +3 -3
  78. package/dist/draft17-session.d.ts +3 -3
  79. package/dist/draft17.d.cts +3 -3
  80. package/dist/draft17.d.ts +3 -3
  81. package/dist/draft18-session.d.cts +3 -3
  82. package/dist/draft18-session.d.ts +3 -3
  83. package/dist/draft18.d.cts +3 -3
  84. package/dist/draft18.d.ts +3 -3
  85. package/dist/draft19-session.d.cts +3 -3
  86. package/dist/draft19-session.d.ts +3 -3
  87. package/dist/draft19.cjs +2 -2
  88. package/dist/draft19.d.cts +3 -3
  89. package/dist/draft19.d.ts +3 -3
  90. package/dist/draft19.js +1 -1
  91. package/dist/draft20-session.cjs +8 -0
  92. package/dist/draft20-session.d.cts +195 -0
  93. package/dist/draft20-session.d.ts +195 -0
  94. package/dist/draft20-session.js +8 -0
  95. package/dist/draft20.cjs +217 -0
  96. package/dist/draft20.d.cts +175 -0
  97. package/dist/draft20.d.ts +175 -0
  98. package/dist/draft20.js +217 -0
  99. package/dist/index.cjs +9 -3
  100. package/dist/index.d.cts +32 -17
  101. package/dist/index.d.ts +32 -17
  102. package/dist/index.js +8 -2
  103. package/dist/{session-types-KsqyVp6y.d.cts → session-types-B9idsih-.d.cts} +13 -1
  104. package/dist/{session-types-C0l_-Ups.d.ts → session-types-Dn7b3RZM.d.ts} +13 -1
  105. package/dist/session.cjs +5 -1
  106. package/dist/session.d.cts +5 -3
  107. package/dist/session.d.ts +5 -3
  108. package/dist/session.js +5 -1
  109. package/dist/types-CWCQwuvy.d.cts +359 -0
  110. package/dist/types-CWCQwuvy.d.ts +359 -0
  111. package/dist/{types-CdCSIfvI.d.cts → types-DG5_iKuv.d.cts} +1 -1
  112. package/dist/{types-CdCSIfvI.d.ts → types-DG5_iKuv.d.ts} +1 -1
  113. package/package.json +16 -3
  114. package/src/core/session-types.ts +7 -0
  115. package/src/core/types.ts +1 -0
  116. package/src/drafts/draft19/codec.ts +4 -2
  117. package/src/drafts/draft20/codec.ts +1737 -0
  118. package/src/drafts/draft20/data-streams.ts +1291 -0
  119. package/src/drafts/draft20/error-codes.ts +135 -0
  120. package/src/drafts/draft20/index.ts +165 -0
  121. package/src/drafts/draft20/messages.ts +68 -0
  122. package/src/drafts/draft20/rules.ts +107 -0
  123. package/src/drafts/draft20/session-fsm.ts +1063 -0
  124. package/src/drafts/draft20/session.ts +21 -0
  125. package/src/drafts/draft20/types.ts +455 -0
  126. package/src/index.ts +20 -2
  127. package/src/session.ts +4 -0
package/dist/index.d.ts CHANGED
@@ -1,18 +1,19 @@
1
- import { C as CodecOptions } from './types-CdCSIfvI.js';
2
- export { B as BaseCodec, D as DecodeError, a as DecodeErrorCode, b as DecodeResult, c as Draft } from './types-CdCSIfvI.js';
3
- import { D as Draft07Codec } from './codec-DujHf55Z.js';
4
- import { D as Draft08Codec } from './codec-DplRgIKq.js';
5
- import { D as Draft09Codec } from './codec-CI0BjmHc.js';
6
- import { D as Draft10Codec } from './codec-BLYAy2OP.js';
7
- import { D as Draft11Codec } from './codec-DL0njGkL.js';
8
- import { D as Draft12Codec } from './codec-D47r_-Rl.js';
9
- import { D as Draft13Codec } from './codec-CWj5iTxA.js';
10
- import { D as Draft14Codec } from './codec-v6Vloc7H.js';
11
- import { D as Draft15Codec } from './codec-BNS3gS77.js';
12
- import { D as Draft16Codec } from './codec-D2JbI2tp.js';
13
- import { D as Draft17Codec } from './codec-DJmV04i0.js';
14
- import { D as Draft18Codec } from './codec-WwwUipaU.js';
15
- import { D as Draft19Codec } from './codec-DAePx2NL.js';
1
+ import { C as CodecOptions } from './types-DG5_iKuv.js';
2
+ export { B as BaseCodec, D as DecodeError, a as DecodeErrorCode, b as DecodeResult, c as Draft } from './types-DG5_iKuv.js';
3
+ import { D as Draft07Codec } from './codec-BJ7BHuiZ.js';
4
+ import { D as Draft08Codec } from './codec-Dl_QIXMz.js';
5
+ import { D as Draft09Codec } from './codec-BNy5syCU.js';
6
+ import { D as Draft10Codec } from './codec--CVeqGQv.js';
7
+ import { D as Draft11Codec } from './codec-CA6nbbEk.js';
8
+ import { D as Draft12Codec } from './codec-BKsVu3Fr.js';
9
+ import { D as Draft13Codec } from './codec-O-1Js7h4.js';
10
+ import { D as Draft14Codec } from './codec-BQa6Qsav.js';
11
+ import { D as Draft15Codec } from './codec-BMwgZIgG.js';
12
+ import { D as Draft16Codec } from './codec-C006F75E.js';
13
+ import { D as Draft17Codec } from './codec-D4RvFQmu.js';
14
+ import { D as Draft18Codec } from './codec-Cl73EfRW.js';
15
+ import { D as Draft19Codec } from './codec-CviAa4lp.js';
16
+ import { D as Draft20Codec } from './codec-C5evFHL-.js';
16
17
  import './types-Dl4IaAHR.js';
17
18
  import './types-jV1yDDBA.js';
18
19
  import './types-B3g5G9KP.js';
@@ -26,6 +27,7 @@ import './types-Cm9fjeYC.js';
26
27
  import './types-D9eiB_9A.js';
27
28
  import './types-Cqp10JtB.js';
28
29
  import './types-zHgCS6o5.js';
30
+ import './types-CWCQwuvy.js';
29
31
 
30
32
  /**
31
33
  * Draft-agnostic readers for decoded control messages.
@@ -111,7 +113,17 @@ declare function joiningRequestIdOf(msg: AnyMessage): bigint | undefined;
111
113
  */
112
114
 
113
115
  /**
114
- * Wire version numbers for each MoQT draft, keyed by short aliases.
116
+ * Version identifiers for each MoQT draft, keyed by short aliases.
117
+ *
118
+ * Only the entries up to '14' are wire values: those drafts negotiated the
119
+ * version inside CLIENT_SETUP/SERVER_SETUP and really do put `0xff0000NN` on
120
+ * the wire. From draft-15 on, the version is negotiated by ALPN (raw QUIC) or
121
+ * `WT-Available-Protocols` (WebTransport) as the string `moqt-NN`, and no
122
+ * version number is sent at all — so '15' through '20' are *derived*
123
+ * identifiers kept as stable numeric keys, not observed values. Do not report
124
+ * one to a user as a version seen on the wire; report the protocol string.
125
+ * Each draft's own module exports it (e.g. `PROTOCOL_STRING` in
126
+ * `@moqtap/codec/draft20`).
115
127
  */
116
128
  declare const DRAFT_VERSIONS: Record<string, bigint>;
117
129
  declare function createCodec(options: CodecOptions & {
@@ -153,12 +165,15 @@ declare function createCodec(options: CodecOptions & {
153
165
  declare function createCodec(options: CodecOptions & {
154
166
  draft: '19';
155
167
  }): Draft19Codec;
168
+ declare function createCodec(options: CodecOptions & {
169
+ draft: '20';
170
+ }): Draft20Codec;
156
171
  /**
157
172
  * Create a codec for the specified draft version.
158
173
  *
159
174
  * A draft must always be specified — there is no default while the
160
175
  * MoQT specification is still in draft stage.
161
176
  */
162
- declare function createCodec(options: CodecOptions): Draft07Codec | Draft08Codec | Draft09Codec | Draft10Codec | Draft11Codec | Draft12Codec | Draft13Codec | Draft14Codec | Draft15Codec | Draft16Codec | Draft17Codec | Draft18Codec | Draft19Codec;
177
+ declare function createCodec(options: CodecOptions): Draft07Codec | Draft08Codec | Draft09Codec | Draft10Codec | Draft11Codec | Draft12Codec | Draft13Codec | Draft14Codec | Draft15Codec | Draft16Codec | Draft17Codec | Draft18Codec | Draft19Codec | Draft20Codec;
163
178
 
164
179
  export { type AnyMessage, CodecOptions, DRAFT_VERSIONS, type TrackIdentity, createCodec, joiningRequestIdOf, requestIdOf, trackAliasOf, trackOf };
package/dist/index.js CHANGED
@@ -3,7 +3,10 @@ import {
3
3
  } from "./chunk-2XH6PHXR.js";
4
4
  import {
5
5
  createDraft19Codec
6
- } from "./chunk-3YAR3I3S.js";
6
+ } from "./chunk-Q7NSUXXB.js";
7
+ import {
8
+ createDraft20Codec
9
+ } from "./chunk-YJGOD3Y4.js";
7
10
  import {
8
11
  createDraft14Codec
9
12
  } from "./chunk-XQGEOFGE.js";
@@ -103,7 +106,8 @@ var DRAFT_VERSIONS = {
103
106
  "16": 0xff000010n,
104
107
  "17": 0xff000011n,
105
108
  "18": 0xff000012n,
106
- "19": 0xff000013n
109
+ "19": 0xff000013n,
110
+ "20": 0xff000014n
107
111
  };
108
112
  function createCodec(options) {
109
113
  const draft = DRAFT_VERSIONS[options.draft];
@@ -140,6 +144,8 @@ Supported draft values: ${Object.keys(DRAFT_VERSIONS).join(", ")}`
140
144
  return createDraft18Codec();
141
145
  case "19":
142
146
  return createDraft19Codec();
147
+ case "20":
148
+ return createDraft20Codec();
143
149
  default:
144
150
  throw new Error(`Unsupported draft: ${draft}`);
145
151
  }
@@ -1,4 +1,4 @@
1
- import { c as Draft } from './types-CdCSIfvI.cjs';
1
+ import { c as Draft } from './types-DG5_iKuv.cjs';
2
2
 
3
3
  type SessionPhase = 'idle' | 'setup' | 'ready' | 'draining' | 'closed' | 'error';
4
4
  type SubscriptionPhase = 'pending' | 'active' | 'error' | 'done';
@@ -70,6 +70,18 @@ type SideEffect = {
70
70
  type: 'subscription-ended';
71
71
  subscribeId: bigint;
72
72
  reason: string;
73
+ } | {
74
+ type: 'fill-fetch-stream-opened';
75
+ subscribeId: bigint;
76
+ requestId: bigint;
77
+ } | {
78
+ type: 'fill-fetch-stream-closed';
79
+ subscribeId: bigint;
80
+ requestId: bigint;
81
+ reason: string;
82
+ } | {
83
+ type: 'subscription-state-notified';
84
+ subscribeId: bigint;
73
85
  } | {
74
86
  type: 'announce-activated';
75
87
  namespace: string[];
@@ -1,4 +1,4 @@
1
- import { c as Draft } from './types-CdCSIfvI.js';
1
+ import { c as Draft } from './types-DG5_iKuv.js';
2
2
 
3
3
  type SessionPhase = 'idle' | 'setup' | 'ready' | 'draining' | 'closed' | 'error';
4
4
  type SubscriptionPhase = 'pending' | 'active' | 'error' | 'done';
@@ -70,6 +70,18 @@ type SideEffect = {
70
70
  type: 'subscription-ended';
71
71
  subscribeId: bigint;
72
72
  reason: string;
73
+ } | {
74
+ type: 'fill-fetch-stream-opened';
75
+ subscribeId: bigint;
76
+ requestId: bigint;
77
+ } | {
78
+ type: 'fill-fetch-stream-closed';
79
+ subscribeId: bigint;
80
+ requestId: bigint;
81
+ reason: string;
82
+ } | {
83
+ type: 'subscription-state-notified';
84
+ subscribeId: bigint;
73
85
  } | {
74
86
  type: 'announce-activated';
75
87
  namespace: string[];
package/dist/session.cjs CHANGED
@@ -6,6 +6,9 @@ var _chunkA655PHFXcjs = require('./chunk-A655PHFX.cjs');
6
6
  var _chunkCQ65LKPQcjs = require('./chunk-CQ65LKPQ.cjs');
7
7
 
8
8
 
9
+ var _chunkBMJMY6FXcjs = require('./chunk-BMJMY6FX.cjs');
10
+
11
+
9
12
  var _chunkE65QKRSNcjs = require('./chunk-E65QKRSN.cjs');
10
13
 
11
14
 
@@ -55,7 +58,8 @@ function createSessionState(options) {
55
58
  "16": _chunk7RE6KSIYcjs.createDraft16SessionState,
56
59
  "17": _chunkYTPZZI2Mcjs.createDraft17SessionState,
57
60
  "18": _chunkA655PHFXcjs.createDraft18SessionState,
58
- "19": _chunkCQ65LKPQcjs.createDraft19SessionState
61
+ "19": _chunkCQ65LKPQcjs.createDraft19SessionState,
62
+ "20": _chunkBMJMY6FXcjs.createDraft20SessionState
59
63
  };
60
64
  const factory = factories[draft];
61
65
  if (!factory) {
@@ -1,6 +1,6 @@
1
- import { S as SessionStateOptions, a as SessionState } from './session-types-KsqyVp6y.cjs';
2
- export { A as AnnouncePhase, b as AnnounceState, F as FetchPhase, c as FetchState, P as ProtocolViolation, d as ProtocolViolationCode, e as PublishPhase, f as PublishState, g as SessionPhase, h as SideEffect, i as SubscriptionPhase, j as SubscriptionState, T as TransitionResult, V as ValidationResult } from './session-types-KsqyVp6y.cjs';
3
- import { c as Draft } from './types-CdCSIfvI.cjs';
1
+ import { S as SessionStateOptions, a as SessionState } from './session-types-B9idsih-.cjs';
2
+ export { A as AnnouncePhase, b as AnnounceState, F as FetchPhase, c as FetchState, P as ProtocolViolation, d as ProtocolViolationCode, e as PublishPhase, f as PublishState, g as SessionPhase, h as SideEffect, i as SubscriptionPhase, j as SubscriptionState, T as TransitionResult, V as ValidationResult } from './session-types-B9idsih-.cjs';
3
+ import { c as Draft } from './types-DG5_iKuv.cjs';
4
4
  import { D as Draft07Message, a as Draft07MessageType } from './types-Dl4IaAHR.cjs';
5
5
  import { D as Draft08Message, a as Draft08MessageType } from './types-jV1yDDBA.cjs';
6
6
  import { D as Draft09Message, a as Draft09MessageType } from './types-B3g5G9KP.cjs';
@@ -14,6 +14,7 @@ import { D as Draft16Message, a as Draft16MessageType } from './types-Cm9fjeYC.c
14
14
  import { D as Draft17Message, a as Draft17MessageType } from './types-D9eiB_9A.cjs';
15
15
  import { D as Draft18Message, a as Draft18MessageType } from './types-Cqp10JtB.cjs';
16
16
  import { D as Draft19Message, a as Draft19MessageType } from './types-zHgCS6o5.cjs';
17
+ import { D as Draft20Message, a as Draft20MessageType } from './types-CWCQwuvy.cjs';
17
18
 
18
19
  /**
19
20
  * @moqtap/codec/session — MoQT session state machine
@@ -37,6 +38,7 @@ type DraftSessionStateMap = {
37
38
  '17': SessionState<Draft17Message, Draft17MessageType>;
38
39
  '18': SessionState<Draft18Message, Draft18MessageType>;
39
40
  '19': SessionState<Draft19Message, Draft19MessageType>;
41
+ '20': SessionState<Draft20Message, Draft20MessageType>;
40
42
  };
41
43
  /**
42
44
  * Create a session state machine for the given draft version.
package/dist/session.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { S as SessionStateOptions, a as SessionState } from './session-types-C0l_-Ups.js';
2
- export { A as AnnouncePhase, b as AnnounceState, F as FetchPhase, c as FetchState, P as ProtocolViolation, d as ProtocolViolationCode, e as PublishPhase, f as PublishState, g as SessionPhase, h as SideEffect, i as SubscriptionPhase, j as SubscriptionState, T as TransitionResult, V as ValidationResult } from './session-types-C0l_-Ups.js';
3
- import { c as Draft } from './types-CdCSIfvI.js';
1
+ import { S as SessionStateOptions, a as SessionState } from './session-types-Dn7b3RZM.js';
2
+ export { A as AnnouncePhase, b as AnnounceState, F as FetchPhase, c as FetchState, P as ProtocolViolation, d as ProtocolViolationCode, e as PublishPhase, f as PublishState, g as SessionPhase, h as SideEffect, i as SubscriptionPhase, j as SubscriptionState, T as TransitionResult, V as ValidationResult } from './session-types-Dn7b3RZM.js';
3
+ import { c as Draft } from './types-DG5_iKuv.js';
4
4
  import { D as Draft07Message, a as Draft07MessageType } from './types-Dl4IaAHR.js';
5
5
  import { D as Draft08Message, a as Draft08MessageType } from './types-jV1yDDBA.js';
6
6
  import { D as Draft09Message, a as Draft09MessageType } from './types-B3g5G9KP.js';
@@ -14,6 +14,7 @@ import { D as Draft16Message, a as Draft16MessageType } from './types-Cm9fjeYC.j
14
14
  import { D as Draft17Message, a as Draft17MessageType } from './types-D9eiB_9A.js';
15
15
  import { D as Draft18Message, a as Draft18MessageType } from './types-Cqp10JtB.js';
16
16
  import { D as Draft19Message, a as Draft19MessageType } from './types-zHgCS6o5.js';
17
+ import { D as Draft20Message, a as Draft20MessageType } from './types-CWCQwuvy.js';
17
18
 
18
19
  /**
19
20
  * @moqtap/codec/session — MoQT session state machine
@@ -37,6 +38,7 @@ type DraftSessionStateMap = {
37
38
  '17': SessionState<Draft17Message, Draft17MessageType>;
38
39
  '18': SessionState<Draft18Message, Draft18MessageType>;
39
40
  '19': SessionState<Draft19Message, Draft19MessageType>;
41
+ '20': SessionState<Draft20Message, Draft20MessageType>;
40
42
  };
41
43
  /**
42
44
  * Create a session state machine for the given draft version.
package/dist/session.js CHANGED
@@ -4,6 +4,9 @@ import {
4
4
  import {
5
5
  createDraft19SessionState
6
6
  } from "./chunk-O5DQ44TM.js";
7
+ import {
8
+ createDraft20SessionState
9
+ } from "./chunk-WX5PU7HF.js";
7
10
  import {
8
11
  createDraft14SessionState
9
12
  } from "./chunk-MZ7HUCGJ.js";
@@ -55,7 +58,8 @@ function createSessionState(options) {
55
58
  "16": createDraft16SessionState,
56
59
  "17": createDraft17SessionState,
57
60
  "18": createDraft18SessionState,
58
- "19": createDraft19SessionState
61
+ "19": createDraft19SessionState,
62
+ "20": createDraft20SessionState
59
63
  };
60
64
  const factory = factories[draft];
61
65
  if (!factory) {
@@ -0,0 +1,359 @@
1
+ interface UnknownParam {
2
+ readonly id: string;
3
+ readonly length: number;
4
+ readonly raw_hex: string;
5
+ }
6
+ interface AuthorizationToken {
7
+ readonly alias_type: bigint;
8
+ readonly token_alias?: bigint;
9
+ readonly token_type?: bigint;
10
+ readonly token_value?: Uint8Array;
11
+ }
12
+ interface Draft20SetupOptions {
13
+ path?: string;
14
+ authorization_token?: AuthorizationToken;
15
+ max_auth_token_cache_size?: bigint;
16
+ authority?: string;
17
+ max_filter_ranges?: bigint;
18
+ moqt_implementation?: string;
19
+ max_request_updates?: bigint;
20
+ unknown?: UnknownParam[];
21
+ }
22
+ /**
23
+ * LOCATION_FILTER (0x21) — restructured in draft-20 (Section 5.1.2).
24
+ *
25
+ * The draft-19 `Filter Type` discriminator (0x1 Next Group Start / 0x2 Largest
26
+ * Object / 0x3 AbsoluteStart / 0x4 AbsoluteRange) is gone; the shape is the
27
+ * number of vi64 fields the value holds. The fields below carry the wire
28
+ * values verbatim, unresolved:
29
+ *
30
+ * - 1 field → `start_group` alone is RELATIVE: start is
31
+ * {Largest Object.Group + 1 - start_group, 0}. Open-ended.
32
+ * - 2 fields → absolute start {start_group, start_object}, except that
33
+ * {0, 0} means the Next Object. Open-ended.
34
+ * - 3 fields → end group is `start_group + end_group_delta`; `end_object`
35
+ * omitted means every object in that group.
36
+ * - 4 fields → the fully specified INCLUSIVE range
37
+ * {start_group, start_object} … {start_group + end_group_delta,
38
+ * end_object}.
39
+ *
40
+ * `removed: true` is the `Length == 0` form, which in REQUEST_UPDATE removes an
41
+ * existing filter.
42
+ *
43
+ * The range is inclusive at both ends. draft-19's "last Object, plus 1" and
44
+ * "Object == 0 means the whole group" conventions are gone, so nothing here is
45
+ * ever incremented or decremented on the way in or out.
46
+ */
47
+ interface LocationFilter {
48
+ readonly start_group?: bigint;
49
+ readonly start_object?: bigint;
50
+ readonly end_group_delta?: bigint;
51
+ readonly end_object?: bigint;
52
+ readonly removed?: boolean;
53
+ }
54
+ interface RangeFilterRange {
55
+ readonly start: bigint;
56
+ readonly end?: bigint;
57
+ }
58
+ interface RangeFilter {
59
+ readonly set_id?: bigint;
60
+ readonly property_type?: bigint;
61
+ readonly ranges?: RangeFilterRange[];
62
+ readonly removed?: boolean;
63
+ }
64
+ interface LargestObject {
65
+ readonly group: bigint;
66
+ readonly object: bigint;
67
+ }
68
+ /**
69
+ * FILL_PARAMETERS (0x23) value — NEW in draft-20 (Section 10.2.15).
70
+ *
71
+ * A separate parameter scope carrying only the settings that differ from the
72
+ * subscription's. Table 6 closes the list to exactly these eight types;
73
+ * TRACK_PROPERTY_FILTER (0x29) is deliberately excluded.
74
+ *
75
+ * The mere presence of the parameter is what requests a fill fetch stream, so
76
+ * an empty value is meaningful — it asks for a fill with everything inherited.
77
+ */
78
+ interface Draft20FillParameters {
79
+ fill_timeout?: bigint;
80
+ subscriber_priority?: bigint;
81
+ location_filter?: LocationFilter;
82
+ group_order?: bigint;
83
+ subgroup_filter?: RangeFilter;
84
+ objectid_filter?: RangeFilter;
85
+ priority_filter?: RangeFilter;
86
+ object_property_filter?: RangeFilter;
87
+ }
88
+ interface Draft20Params {
89
+ object_delivery_timeout?: bigint;
90
+ authorization_token?: AuthorizationToken;
91
+ rendezvous_timeout?: bigint;
92
+ subgroup_delivery_timeout?: bigint;
93
+ expires?: bigint;
94
+ largest_object?: LargestObject;
95
+ fill_timeout?: bigint;
96
+ forward?: bigint;
97
+ subscriber_priority?: bigint;
98
+ location_filter?: LocationFilter;
99
+ group_order?: bigint;
100
+ fill_parameters?: Draft20FillParameters;
101
+ subgroup_filter?: RangeFilter;
102
+ objectid_filter?: RangeFilter;
103
+ priority_filter?: RangeFilter;
104
+ object_property_filter?: RangeFilter;
105
+ track_property_filter?: RangeFilter;
106
+ new_group_request?: bigint;
107
+ track_namespace_prefix?: string[];
108
+ include_properties?: bigint;
109
+ unknown?: UnknownParam[];
110
+ }
111
+ interface Draft20TrackProperties {
112
+ object_delivery_timeout?: bigint;
113
+ max_cache_duration?: bigint;
114
+ subgroup_delivery_timeout?: bigint;
115
+ immutable_properties?: Uint8Array;
116
+ default_publisher_priority?: bigint;
117
+ default_publisher_group_order?: bigint;
118
+ dynamic_groups?: bigint;
119
+ unknown?: UnknownParam[];
120
+ }
121
+ type Draft20MessageType = 'setup' | 'subscribe' | 'subscribe_ok' | 'request_update' | 'publish_state_notify' | 'publish' | 'publish_done' | 'publish_namespace' | 'namespace' | 'namespace_done' | 'subscribe_namespace' | 'subscribe_tracks' | 'publish_skipped' | 'fetch' | 'fetch_ok' | 'track_status' | 'request_ok' | 'request_error' | 'goaway';
122
+ interface Draft20BaseMessage {
123
+ readonly type: Draft20MessageType;
124
+ }
125
+ interface Draft20Setup extends Draft20BaseMessage {
126
+ readonly type: 'setup';
127
+ readonly options: Draft20SetupOptions;
128
+ }
129
+ interface Draft20Subscribe extends Draft20BaseMessage {
130
+ readonly type: 'subscribe';
131
+ readonly request_id: bigint;
132
+ readonly track_namespace: string[];
133
+ readonly track_name: string;
134
+ readonly parameters: Draft20Params;
135
+ }
136
+ interface Draft20SubscribeOk extends Draft20BaseMessage {
137
+ readonly type: 'subscribe_ok';
138
+ readonly track_alias: bigint;
139
+ readonly parameters: Draft20Params;
140
+ readonly track_properties: Draft20TrackProperties;
141
+ }
142
+ interface Draft20RequestUpdate extends Draft20BaseMessage {
143
+ readonly type: 'request_update';
144
+ readonly request_id: bigint;
145
+ readonly parameters: Draft20Params;
146
+ }
147
+ /**
148
+ * PUBLISH_STATE_NOTIFY (0x22) — NEW in draft-20, Section 10.10.
149
+ *
150
+ * No Request ID: the message is identified by the subscription's bidirectional
151
+ * stream it arrives on, like SUBSCRIBE_OK, PUBLISH_DONE and FETCH_OK.
152
+ */
153
+ interface Draft20PublishStateNotify extends Draft20BaseMessage {
154
+ readonly type: 'publish_state_notify';
155
+ readonly parameters: Draft20Params;
156
+ }
157
+ interface Draft20Publish extends Draft20BaseMessage {
158
+ readonly type: 'publish';
159
+ readonly request_id: bigint;
160
+ readonly track_namespace: string[];
161
+ readonly track_name: string;
162
+ readonly track_alias: bigint;
163
+ readonly parameters: Draft20Params;
164
+ readonly track_properties: Draft20TrackProperties;
165
+ }
166
+ interface Draft20PublishDone extends Draft20BaseMessage {
167
+ readonly type: 'publish_done';
168
+ readonly status_code: bigint;
169
+ /**
170
+ * Number of streams opened for the subscription, including empty subgroups
171
+ * and — new in draft-20 — fill fetch streams (Section 10.12), or the
172
+ * `UNKNOWN_STREAM_COUNT` sentinel exported from `codec.ts` (2^64 - 1, raised
173
+ * from draft-19's 2^62 - 1) when the publisher cannot state it exactly.
174
+ *
175
+ * `bigint`, not `number`: the sentinel does not fit a double.
176
+ */
177
+ readonly stream_count: bigint;
178
+ readonly reason_phrase: string;
179
+ }
180
+ interface Draft20PublishNamespace extends Draft20BaseMessage {
181
+ readonly type: 'publish_namespace';
182
+ readonly request_id: bigint;
183
+ readonly track_namespace: string[];
184
+ readonly parameters: Draft20Params;
185
+ }
186
+ interface Draft20Namespace extends Draft20BaseMessage {
187
+ readonly type: 'namespace';
188
+ readonly namespace_suffix: string[];
189
+ }
190
+ interface Draft20NamespaceDone extends Draft20BaseMessage {
191
+ readonly type: 'namespace_done';
192
+ readonly namespace_suffix: string[];
193
+ }
194
+ interface Draft20SubscribeNamespace extends Draft20BaseMessage {
195
+ readonly type: 'subscribe_namespace';
196
+ readonly request_id: bigint;
197
+ readonly namespace_prefix: string[];
198
+ readonly parameters: Draft20Params;
199
+ }
200
+ interface Draft20SubscribeTracks extends Draft20BaseMessage {
201
+ readonly type: 'subscribe_tracks';
202
+ readonly request_id: bigint;
203
+ readonly namespace_prefix: string[];
204
+ readonly parameters: Draft20Params;
205
+ }
206
+ interface Draft20PublishSkipped extends Draft20BaseMessage {
207
+ readonly type: 'publish_skipped';
208
+ readonly namespace_suffix: string[];
209
+ readonly track_name: string;
210
+ }
211
+ /**
212
+ * FETCH (0x16) — the byte layout was rewritten in draft-20 (Section 10.13).
213
+ *
214
+ * Gone: the `Fetch Type` field and its enum, the `Standalone Fetch` and
215
+ * `Joining Fetch` structures, and the inline `Start Location` / `End Location`.
216
+ * Track Namespace and Track Name are inline fields of FETCH itself, and the
217
+ * range travels in the LOCATION_FILTER parameter. A FETCH with no
218
+ * LOCATION_FILTER covers {0,0} through Largest Object, inclusive.
219
+ *
220
+ * The codepoint did not change, so a draft-19 decoder fed one of these reads
221
+ * the Number of Track Namespace Fields count as a Fetch Type and mis-parses in
222
+ * silence. There is no in-band version signal that catches it.
223
+ */
224
+ interface Draft20Fetch extends Draft20BaseMessage {
225
+ readonly type: 'fetch';
226
+ readonly request_id: bigint;
227
+ readonly track_namespace: string[];
228
+ readonly track_name: string;
229
+ readonly parameters: Draft20Params;
230
+ }
231
+ /**
232
+ * FETCH_OK (0x18) — bytes identical to draft-19, meaning changed.
233
+ *
234
+ * `end_group` / `end_object` are the INCLUSIVE end of the range the response
235
+ * covers: the last Object actually covered. draft-19's "the last Object, plus
236
+ * 1; or 0 to indicate the entire Group" is gone (draft-20 Section 10.14 with
237
+ * Section 5.1.2). The same bytes mean a different object under the two drafts,
238
+ * and nothing on the wire distinguishes them.
239
+ */
240
+ interface Draft20FetchOk extends Draft20BaseMessage {
241
+ readonly type: 'fetch_ok';
242
+ readonly end_of_track: number;
243
+ readonly end_group: bigint;
244
+ readonly end_object: bigint;
245
+ readonly parameters: Draft20Params;
246
+ readonly track_properties: Draft20TrackProperties;
247
+ }
248
+ interface Draft20TrackStatus extends Draft20BaseMessage {
249
+ readonly type: 'track_status';
250
+ readonly request_id: bigint;
251
+ readonly track_namespace: string[];
252
+ readonly track_name: string;
253
+ readonly parameters: Draft20Params;
254
+ }
255
+ interface Draft20RequestOk extends Draft20BaseMessage {
256
+ readonly type: 'request_ok';
257
+ readonly parameters: Draft20Params;
258
+ readonly track_properties: Draft20TrackProperties;
259
+ }
260
+ /**
261
+ * Redirect structure, used inside REQUEST_ERROR when error_code = REDIRECT (0x34).
262
+ *
263
+ * draft-20 Section 10.6.1 names the namespace/name pair "the Redirect target"
264
+ * and dropped draft-19's rule that a zero-length pair meant "reuse the values
265
+ * from the original request". An empty namespace and name are now a literal
266
+ * empty namespace and name.
267
+ */
268
+ interface Redirect {
269
+ readonly connect_uri: string;
270
+ readonly track_namespace: string[];
271
+ readonly track_name: string;
272
+ }
273
+ interface Draft20RequestError extends Draft20BaseMessage {
274
+ readonly type: 'request_error';
275
+ readonly error_code: bigint;
276
+ readonly retry_interval: bigint;
277
+ readonly reason_phrase: string;
278
+ readonly redirect?: Redirect;
279
+ }
280
+ interface Draft20GoAway extends Draft20BaseMessage {
281
+ readonly type: 'goaway';
282
+ readonly new_session_uri: string;
283
+ readonly timeout: bigint;
284
+ }
285
+ type Draft20Message = Draft20Setup | Draft20Subscribe | Draft20SubscribeOk | Draft20RequestUpdate | Draft20PublishStateNotify | Draft20Publish | Draft20PublishDone | Draft20PublishNamespace | Draft20Namespace | Draft20NamespaceDone | Draft20SubscribeNamespace | Draft20SubscribeTracks | Draft20PublishSkipped | Draft20Fetch | Draft20FetchOk | Draft20TrackStatus | Draft20RequestOk | Draft20RequestError | Draft20GoAway;
286
+ interface ObjectPayload {
287
+ readonly type: 'object';
288
+ readonly byteOffset: number;
289
+ readonly payloadByteOffset: number;
290
+ readonly objectId: bigint;
291
+ /** The Object ID Delta as it appeared on the wire, before delta resolution. */
292
+ readonly objectIdDelta?: bigint;
293
+ readonly payloadLength: number;
294
+ readonly status?: bigint;
295
+ readonly extensionData: Uint8Array;
296
+ readonly objectProperties?: Record<string, bigint>;
297
+ readonly payload: Uint8Array;
298
+ }
299
+ interface SubgroupStream {
300
+ readonly type: 'subgroup';
301
+ /** SUBGROUP_HEADER `Type Flags` (draft-20 Section 11.4.2). */
302
+ readonly headerType: number;
303
+ readonly trackAlias: bigint;
304
+ readonly groupId: bigint;
305
+ readonly subgroupId: bigint;
306
+ readonly publisherPriority: number;
307
+ readonly endOfGroup?: boolean;
308
+ readonly firstObject?: boolean;
309
+ readonly objects: ObjectPayload[];
310
+ }
311
+ interface DatagramObject {
312
+ readonly type: 'datagram';
313
+ /** OBJECT_DATAGRAM `Type Flags` (draft-20 Section 11.3.1). */
314
+ readonly datagramType: number;
315
+ readonly trackAlias: bigint;
316
+ readonly groupId: bigint;
317
+ readonly objectId: bigint;
318
+ readonly publisherPriority: number;
319
+ readonly endOfGroup?: boolean;
320
+ readonly objectStatus?: bigint;
321
+ readonly objectProperties?: Record<string, bigint>;
322
+ readonly payloadLength: number;
323
+ readonly payload: Uint8Array;
324
+ }
325
+ interface FetchObjectPayload extends ObjectPayload {
326
+ readonly serializationFlags: number;
327
+ readonly groupId: bigint;
328
+ /** The Group ID Delta as it appeared on the wire, before delta resolution. */
329
+ readonly groupIdDelta?: bigint;
330
+ readonly subgroupId: bigint;
331
+ readonly publisherPriority: number;
332
+ readonly objectProperties?: Record<string, bigint>;
333
+ }
334
+ interface FetchStream {
335
+ readonly type: 'fetch';
336
+ /**
337
+ * The Request ID of the message that opened the stream. In draft-20 that is
338
+ * not necessarily a FETCH: a fill fetch stream (Section 5.1.3) carries the
339
+ * Request ID of the SUBSCRIBE or REQUEST_UPDATE that requested the fill.
340
+ */
341
+ readonly requestId: bigint;
342
+ readonly objects: FetchObjectPayload[];
343
+ }
344
+ type Draft20DataStream = SubgroupStream | DatagramObject | FetchStream;
345
+ interface SubgroupStreamHeader {
346
+ readonly type: 'subgroup_header';
347
+ readonly trackAlias: bigint;
348
+ readonly groupId: bigint;
349
+ readonly subgroupId: bigint;
350
+ readonly publisherPriority: number;
351
+ }
352
+ interface FetchStreamHeader {
353
+ readonly type: 'fetch_header';
354
+ readonly requestId: bigint;
355
+ }
356
+ type DataStreamHeader = SubgroupStreamHeader | FetchStreamHeader;
357
+ type DataStreamEvent = DataStreamHeader | ObjectPayload;
358
+
359
+ export type { Draft20SubscribeNamespace as A, Draft20SubscribeOk as B, Draft20SubscribeTracks as C, Draft20Message as D, Draft20TrackProperties as E, FetchStreamHeader as F, Draft20TrackStatus as G, FetchObjectPayload as H, LocationFilter as I, RangeFilterRange as J, Redirect as K, LargestObject as L, ObjectPayload as O, RangeFilter as R, SubgroupStreamHeader as S, UnknownParam as U, Draft20MessageType as a, DataStreamEvent as b, Draft20DataStream as c, DatagramObject as d, FetchStream as e, SubgroupStream as f, DataStreamHeader as g, Draft20BaseMessage as h, Draft20Fetch as i, Draft20FetchOk as j, Draft20FillParameters as k, Draft20GoAway as l, Draft20Namespace as m, Draft20NamespaceDone as n, Draft20Params as o, Draft20Publish as p, Draft20PublishDone as q, Draft20PublishNamespace as r, Draft20PublishSkipped as s, Draft20PublishStateNotify as t, Draft20RequestError as u, Draft20RequestOk as v, Draft20RequestUpdate as w, Draft20Setup as x, Draft20SetupOptions as y, Draft20Subscribe as z };