@moqtap/codec 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to `@moqtap/codec` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+This file starts at 0.9.0. Earlier releases are in the git history.
+
+## [0.9.0] - 2026-09-03
+
+Draft-20 support, and a fix to draft-19 that changes which state machine a
+draft-19 session runs.
+
+### Added
+
+- **Draft-20**: codec, message and data-stream tables, wire rules, error codes
+  and session FSM, exported as `@moqtap/codec/draft20` and
+  `@moqtap/codec/draft20/session`. `createCodec({ draft: '20' })` and
+  `createDraft20Codec()` both reach it.
+- `PUBLISH_STATE_NOTIFY` (`0x22`), the one control message draft-20 adds. It is
+  unilateral and not subject to `MAX_REQUEST_UPDATES`.
+- Draft-20's rewritten `FETCH`. The message keeps codepoint `0x16` but drops the
+  Fetch Type discriminator, carries Track Namespace and Track Name inline, and
+  moves its range into a `LOCATION_FILTER` parameter. Nothing on the wire
+  distinguishes it from a draft-19 `FETCH` at the type byte, so a session
+  decoded under the wrong draft will silently misparse it — pick the draft from
+  the negotiated `moqt-NN` protocol string, not from message content.
+- `INCLUDE_PROPERTIES` (`0x35`), a uint8 boolean defaulting to `1`.
+
+### Fixed
+
+- **`createDraft19Codec()` reported `draft: '18'`.** Since `createSessionState()`
+  keys off `codec.draft`, every draft-19 session was validated by the draft-18
+  FSM. Draft-19 sessions now run the draft-19 FSM, which enforces rules the
+  draft-18 one does not — a session that passed validation on 0.8.1 may now be
+  rejected, correctly.
+
+### Changed
+
+- Draft-20 ranges are **inclusive**. An end location names the last object, not
+  one past it; do not carry a draft-19 `+ 1` forward.
+- Retired error codes decode rather than being refused. Draft-20 Section 14
+  requires an unknown error code in any error context to be treated as
+  `INTERNAL_ERROR`, and forbids closing the session over one in `REQUEST_ERROR`
+  or `PUBLISH_DONE`. The `RETIRED_*` sets remain exported as advisory
+  diagnostics — useful for "this peer looks like draft-19" — but are no longer
+  decode gates.
+- `@moqtap/test-vectors` dependency raised to `^0.13.0` for the draft-20 corpus.

package/README.md

@@ -2,7 +2,7 @@
 
 MoQT (Media over QUIC Transport) wire-format codec and session state machine for JavaScript/TypeScript.
 
-- Multi-draft support (drafts 07 through 19)
+- Multi-draft support (drafts 07 through 20)
 - Stateless encode/decode of all MoQT control messages and data streams
 - Protocol session state machine with FSM-based validation per draft
 - Zero runtime dependencies
@@ -43,10 +43,11 @@ Or use the factory if your application supports multiple drafts:
 ```typescript
 import { createCodec, DRAFT_VERSIONS } from '@moqtap/codec'
 
-const codec = createCodec({ draft: '19' }) // '07' through '19'
+const codec = createCodec({ draft: '20' }) // '07' through '20'
 
-// DRAFT_VERSIONS provides wire version numbers under short aliases:
-//   DRAFT_VERSIONS['07'] — 0xff000007n
+// DRAFT_VERSIONS provides version identifiers under short aliases:
+//   DRAFT_VERSIONS['07'] — 0xff000007n, a real draft-07 wire value
+//   DRAFT_VERSIONS['20'] — 0xff000014n, derived; see the note below
 ```
 
 ## Subpath Exports
@@ -69,10 +70,21 @@ Each draft is available as a subpath import with its own codec and session state
 | `@moqtap/codec/draft17`          | Draft-17 codec                                    |
 | `@moqtap/codec/draft18`          | Draft-18 codec                                    |
 | `@moqtap/codec/draft19`          | Draft-19 codec                                    |
+| `@moqtap/codec/draft20`          | Draft-20 codec                                    |
 | `@moqtap/codec/draft{N}/session` | Session state machine for draft N                 |
 
 > **Note:** A default (versionless) codec will be available once the MoQT specification reaches RFC status. Until then, always specify a draft version.
 
+`DRAFT_VERSIONS` is a table of numeric keys, and only the entries up to `'14'` are values a peer
+ever puts on the wire. From draft-15 the version is negotiated by ALPN (raw QUIC) or
+`WT-Available-Protocols` (WebTransport) as the string `moqt-NN`, and no version number is sent at
+all — so `DRAFT_VERSIONS['20']` is a derived identifier, not something observed. Each draft module
+from 15 on exports the real one:
+
+```typescript
+import { PROTOCOL_STRING } from '@moqtap/codec/draft20' // 'moqt-20'
+```
+
 ## Draft-Specific Imports
 
 For applications targeting a single draft version: