@moqtap/codec 0.2.3 → 0.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 moqtap
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 moqtap
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,99 +1,100 @@
-# @moqtap/codec
-
-MoQT (Media over QUIC Transport) wire-format codec and session state machine for JavaScript/TypeScript.
-
-- Multi-draft support (drafts 07 through 17)
-- Stateless encode/decode of all MoQT control messages and data streams
-- Protocol session state machine with FSM-based validation per draft
-- Zero runtime dependencies
-- Works in Node.js, Bun, and browsers
-- Full TypeScript types with discriminated unions
-
-## Install
-
-```bash
-npm install @moqtap/codec
-```
-
-## Quick Start
-
-MoQT is pre-RFC, so a draft version must always be specified. Use draft-scoped imports for the best experience:
-
-```typescript
-import { createDraft07Codec } from '@moqtap/codec/draft7';
-
-const codec = createDraft07Codec();
-
-// Decode a message from bytes
-const result = codec.decodeMessage(bytes);
-if (result.ok) {
-  console.log(result.value.type); // e.g. 'subscribe'
-}
-
-// Encode a message to bytes
-const encoded = codec.encodeMessage({
-  type: 'client_setup',
-  supportedVersions: [0xff000007n],
-  parameters: new Map(),
-});
-```
-
-Or use the factory if your application supports multiple drafts:
-
-```typescript
-import { createCodec } from '@moqtap/codec';
-
-const codec = createCodec({ draft: '17' }); // '07' through '17'
-```
-
-## Subpath Exports
-
-Each draft is available as a subpath import with its own codec and session state machine:
-
-| Import path | Description |
-|---|---|
-| `@moqtap/codec` | Factory + shared types (`createCodec({ draft })`) |
-| `@moqtap/codec/draft7` | Draft-07 codec |
-| `@moqtap/codec/draft8` | Draft-08 codec |
-| `@moqtap/codec/draft9` | Draft-09 codec |
-| `@moqtap/codec/draft10` | Draft-10 codec |
-| `@moqtap/codec/draft11` | Draft-11 codec |
-| `@moqtap/codec/draft12` | Draft-12 codec |
-| `@moqtap/codec/draft13` | Draft-13 codec |
-| `@moqtap/codec/draft14` | Draft-14 codec |
-| `@moqtap/codec/draft15` | Draft-15 codec |
-| `@moqtap/codec/draft16` | Draft-16 codec |
-| `@moqtap/codec/draft17` | Draft-17 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-Specific Imports
-
-For applications targeting a single draft version:
-
-```typescript
-import { createDraft17Codec } from '@moqtap/codec/draft17';
-import { createDraft17SessionState } from '@moqtap/codec/draft17/session';
-```
-
-## Session State Machine
-
-Validate protocol message sequences without transport coupling:
-
-```typescript
-import { createDraft17SessionState } from '@moqtap/codec/draft17/session';
-import { createDraft17Codec } from '@moqtap/codec/draft17';
-
-const codec = createDraft17Codec();
-const session = createDraft17SessionState({ codec, role: 'client' });
-
-const result = session.receive(incomingMessage);
-if (!result.ok) {
-  console.error('Protocol violation:', result.violation);
-}
-```
-
-## License
-
-MIT
+# @moqtap/codec
+
+MoQT (Media over QUIC Transport) wire-format codec and session state machine for JavaScript/TypeScript.
+
+- Multi-draft support (drafts 07 through 17)
+- Stateless encode/decode of all MoQT control messages and data streams
+- Protocol session state machine with FSM-based validation per draft
+- Zero runtime dependencies
+- Works in Node.js, Bun, and browsers
+- Full TypeScript types with discriminated unions
+
+## Install
+
+```bash
+npm install @moqtap/codec
+```
+
+## Quick Start
+
+MoQT is pre-RFC, so a draft version must always be specified. Use draft-scoped imports for the best experience:
+
+```typescript
+import { createDraft07Codec, DRAFT_VERSION } from '@moqtap/codec/draft7'
+
+const codec = createDraft07Codec()
+
+// Decode a message from bytes
+const result = codec.decodeMessage(bytes)
+if (result.ok) {
+  console.log(result.value.type) // e.g. 'subscribe'
+}
+
+// Encode a message to bytes
+const encoded = codec.encodeMessage({
+  type: 'client_setup',
+  supportedVersions: [DRAFT_VERSION],
+  parameters: new Map(),
+})
+```
+
+Or use the factory if your application supports multiple drafts:
+
+```typescript
+import { createCodec, DRAFT_VERSIONS } from '@moqtap/codec'
+
+const codec = createCodec({ draft: '17' }) // '07' through '17'
+
+// DRAFT_VERSIONS provides wire version numbers under short aliases:
+//   DRAFT_VERSIONS['07'] — 0xff000007n
+```
+
+## Subpath Exports
+
+Each draft is available as a subpath import with its own codec and session state machine:
+
+| Import path                      | Description                                       |
+| -------------------------------- | ------------------------------------------------- |
+| `@moqtap/codec`                  | Factory + shared types (`createCodec({ draft })`) |
+| `@moqtap/codec/draft7`           | Draft-07 codec                                    |
+| `@moqtap/codec/draft8`           | Draft-08 codec                                    |
+| `@moqtap/codec/draft9`           | Draft-09 codec                                    |
+| `@moqtap/codec/draft10`          | Draft-10 codec                                    |
+| `@moqtap/codec/draft11`          | Draft-11 codec                                    |
+| `@moqtap/codec/draft12`          | Draft-12 codec                                    |
+| `@moqtap/codec/draft13`          | Draft-13 codec                                    |
+| `@moqtap/codec/draft14`          | Draft-14 codec                                    |
+| `@moqtap/codec/draft15`          | Draft-15 codec                                    |
+| `@moqtap/codec/draft16`          | Draft-16 codec                                    |
+| `@moqtap/codec/draft17`          | Draft-17 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-Specific Imports
+
+For applications targeting a single draft version:
+
+```typescript
+import { createDraft17Codec } from '@moqtap/codec/draft17'
+import { createDraft17SessionState } from '@moqtap/codec/draft17/session'
+```
+
+## Session State Machine
+
+Validate protocol message sequences without transport coupling:
+
+```typescript
+import { createDraft17SessionState } from '@moqtap/codec/draft17/session'
+
+const session = createDraft17SessionState('client')
+
+const result = session.receive(incomingMessage)
+if (!result.ok) {
+  console.error('Protocol violation:', result.violation)
+}
+```
+
+## License
+
+MIT

package/dist/{chunk-RZHAPEXO.js → chunk-2A57DRXV.js}

@@ -310,7 +310,11 @@ var Draft13SessionFSM = class {
       };
     }
     this._phase = "ready";
-    return { ok: true, phase: this._phase, sideEffects: [{ type: "session-ready" }] };
+    return {
+      ok: true,
+      phase: this._phase,
+      sideEffects: [{ type: "session-ready" }]
+    };
   }
   handleGoAway(message, sideEffects) {
     if (this._phase !== "ready" && this._phase !== "draining") {
@@ -326,7 +330,10 @@ var Draft13SessionFSM = class {
     }
     this._phase = "draining";
     const goaway = message;
-    sideEffects.push({ type: "session-draining", goAwayUri: goaway.new_session_uri });
+    sideEffects.push({
+      type: "session-draining",
+      goAwayUri: goaway.new_session_uri
+    });
     return { ok: true, phase: this._phase, sideEffects };
   }
   requireReady(msgType) {
@@ -384,7 +391,10 @@ var Draft13SessionFSM = class {
         )
       };
     this._subscriptions.set(ok.request_id, { ...existing, phase: "active" });
-    sideEffects.push({ type: "subscription-activated", subscribeId: ok.request_id });
+    sideEffects.push({
+      type: "subscription-activated",
+      subscribeId: ok.request_id
+    });
     return { ok: true, phase: this._phase, sideEffects };
   }
   handleSubscribeError(message, sideEffects) {
@@ -508,7 +518,10 @@ var Draft13SessionFSM = class {
     const ann = message;
     const nsKey = ann.track_namespace.join("/");
     this._requestIds.add(ann.request_id);
-    this._announces.set(nsKey, { namespace: ann.track_namespace, phase: "pending" });
+    this._announces.set(nsKey, {
+      namespace: ann.track_namespace,
+      phase: "pending"
+    });
     return { ok: true, phase: this._phase, sideEffects };
   }
   handleAnnounceOk(message, sideEffects) {
@@ -535,7 +548,10 @@ var Draft13SessionFSM = class {
     const existing = this._announces.get(nsKey);
     if (existing) {
       this._announces.delete(nsKey);
-      sideEffects.push({ type: "announce-ended", namespace: unann.track_namespace });
+      sideEffects.push({
+        type: "announce-ended",
+        namespace: unann.track_namespace
+      });
     }
     return { ok: true, phase: this._phase, sideEffects };
   }
@@ -547,7 +563,10 @@ var Draft13SessionFSM = class {
     const existing = this._announces.get(nsKey);
     if (existing) {
       this._announces.delete(nsKey);
-      sideEffects.push({ type: "announce-ended", namespace: cancel.track_namespace });
+      sideEffects.push({
+        type: "announce-ended",
+        namespace: cancel.track_namespace
+      });
     }
     return { ok: true, phase: this._phase, sideEffects };
   }
@@ -585,7 +604,10 @@ var Draft13SessionFSM = class {
     const dupErr = this.checkDuplicateRequestId(fetch.request_id, message.type);
     if (dupErr) return { ok: false, violation: dupErr };
     this._requestIds.add(fetch.request_id);
-    this._fetches.set(fetch.request_id, { requestId: fetch.request_id, phase: "pending" });
+    this._fetches.set(fetch.request_id, {
+      requestId: fetch.request_id,
+      phase: "pending"
+    });
     return { ok: true, phase: this._phase, sideEffects };
   }
   handleFetchOk(message, sideEffects) {
@@ -662,7 +684,11 @@ var Draft13SessionFSM = class {
         )
       };
     this._fetches.set(cancel.request_id, { ...existing, phase: "cancelled" });
-    sideEffects.push({ type: "fetch-ended", requestId: cancel.request_id, reason: "cancelled" });
+    sideEffects.push({
+      type: "fetch-ended",
+      requestId: cancel.request_id,
+      reason: "cancelled"
+    });
     return { ok: true, phase: this._phase, sideEffects };
   }
   // ─── Track status lifecycle ───
@@ -733,8 +759,8 @@ var Draft13SessionFSM = class {
 };
 
 // src/drafts/draft13/session.ts
-function createDraft13SessionState(options) {
-  return new Draft13SessionFSM(options.role);
+function createDraft13SessionState(role) {
+  return new Draft13SessionFSM(role);
 }
 
 export {