@moqtap/codec 0.2.3 → 0.4.0

package/package.json

@@ -1,192 +1,192 @@
-{
-  "name": "@moqtap/codec",
-  "version": "0.2.3",
-  "description": "MoQT wire-format codec and session state machine — multi-draft, zero dependencies",
-  "type": "module",
-  "license": "MIT",
-  "author": "moqtap",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/moqtap/moqtap-js.git",
-    "directory": "packages/codec"
-  },
-  "homepage": "https://github.com/moqtap/moqtap-js/tree/master/packages/codec",
-  "bugs": "https://github.com/moqtap/moqtap-js/issues",
-  "keywords": [
-    "moqt",
-    "moq",
-    "media-over-quic",
-    "webtransport",
-    "codec",
-    "protocol",
-    "ietf",
-    "quic",
-    "streaming",
-    "real-time"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "exports": {
-    ".": {
-      "bun": "./src/index.ts",
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./draft7": {
-      "bun": "./src/drafts/draft07/index.ts",
-      "types": "./dist/draft7.d.ts",
-      "import": "./dist/draft7.js",
-      "require": "./dist/draft7.cjs"
-    },
-    "./draft8": {
-      "bun": "./src/drafts/draft08/index.ts",
-      "types": "./dist/draft8.d.ts",
-      "import": "./dist/draft8.js",
-      "require": "./dist/draft8.cjs"
-    },
-    "./draft8/session": {
-      "bun": "./src/drafts/draft08/session.ts",
-      "types": "./dist/draft8-session.d.ts",
-      "import": "./dist/draft8-session.js",
-      "require": "./dist/draft8-session.cjs"
-    },
-    "./draft9": {
-      "bun": "./src/drafts/draft09/index.ts",
-      "types": "./dist/draft9.d.ts",
-      "import": "./dist/draft9.js",
-      "require": "./dist/draft9.cjs"
-    },
-    "./draft9/session": {
-      "bun": "./src/drafts/draft09/session.ts",
-      "types": "./dist/draft9-session.d.ts",
-      "import": "./dist/draft9-session.js",
-      "require": "./dist/draft9-session.cjs"
-    },
-    "./draft10": {
-      "bun": "./src/drafts/draft10/index.ts",
-      "types": "./dist/draft10.d.ts",
-      "import": "./dist/draft10.js",
-      "require": "./dist/draft10.cjs"
-    },
-    "./draft10/session": {
-      "bun": "./src/drafts/draft10/session.ts",
-      "types": "./dist/draft10-session.d.ts",
-      "import": "./dist/draft10-session.js",
-      "require": "./dist/draft10-session.cjs"
-    },
-    "./draft11": {
-      "bun": "./src/drafts/draft11/index.ts",
-      "types": "./dist/draft11.d.ts",
-      "import": "./dist/draft11.js",
-      "require": "./dist/draft11.cjs"
-    },
-    "./draft11/session": {
-      "bun": "./src/drafts/draft11/session.ts",
-      "types": "./dist/draft11-session.d.ts",
-      "import": "./dist/draft11-session.js",
-      "require": "./dist/draft11-session.cjs"
-    },
-    "./draft12": {
-      "bun": "./src/drafts/draft12/index.ts",
-      "types": "./dist/draft12.d.ts",
-      "import": "./dist/draft12.js",
-      "require": "./dist/draft12.cjs"
-    },
-    "./draft12/session": {
-      "bun": "./src/drafts/draft12/session.ts",
-      "types": "./dist/draft12-session.d.ts",
-      "import": "./dist/draft12-session.js",
-      "require": "./dist/draft12-session.cjs"
-    },
-    "./draft13": {
-      "bun": "./src/drafts/draft13/index.ts",
-      "types": "./dist/draft13.d.ts",
-      "import": "./dist/draft13.js",
-      "require": "./dist/draft13.cjs"
-    },
-    "./draft13/session": {
-      "bun": "./src/drafts/draft13/session.ts",
-      "types": "./dist/draft13-session.d.ts",
-      "import": "./dist/draft13-session.js",
-      "require": "./dist/draft13-session.cjs"
-    },
-    "./draft14": {
-      "bun": "./src/drafts/draft14/index.ts",
-      "types": "./dist/draft14.d.ts",
-      "import": "./dist/draft14.js",
-      "require": "./dist/draft14.cjs"
-    },
-    "./session": {
-      "bun": "./src/session.ts",
-      "types": "./dist/session.d.ts",
-      "import": "./dist/session.js",
-      "require": "./dist/session.cjs"
-    },
-    "./draft7/session": {
-      "bun": "./src/drafts/draft07/session.ts",
-      "types": "./dist/draft7-session.d.ts",
-      "import": "./dist/draft7-session.js",
-      "require": "./dist/draft7-session.cjs"
-    },
-    "./draft14/session": {
-      "bun": "./src/drafts/draft14/session.ts",
-      "types": "./dist/draft14-session.d.ts",
-      "import": "./dist/draft14-session.js",
-      "require": "./dist/draft14-session.cjs"
-    },
-    "./draft15": {
-      "bun": "./src/drafts/draft15/index.ts",
-      "types": "./dist/draft15.d.ts",
-      "import": "./dist/draft15.js",
-      "require": "./dist/draft15.cjs"
-    },
-    "./draft15/session": {
-      "bun": "./src/drafts/draft15/session.ts",
-      "types": "./dist/draft15-session.d.ts",
-      "import": "./dist/draft15-session.js",
-      "require": "./dist/draft15-session.cjs"
-    },
-    "./draft16": {
-      "bun": "./src/drafts/draft16/index.ts",
-      "types": "./dist/draft16.d.ts",
-      "import": "./dist/draft16.js",
-      "require": "./dist/draft16.cjs"
-    },
-    "./draft16/session": {
-      "bun": "./src/drafts/draft16/session.ts",
-      "types": "./dist/draft16-session.d.ts",
-      "import": "./dist/draft16-session.js",
-      "require": "./dist/draft16-session.cjs"
-    },
-    "./draft17": {
-      "bun": "./src/drafts/draft17/index.ts",
-      "types": "./dist/draft17.d.ts",
-      "import": "./dist/draft17.js",
-      "require": "./dist/draft17.cjs"
-    },
-    "./draft17/session": {
-      "bun": "./src/drafts/draft17/session.ts",
-      "types": "./dist/draft17-session.d.ts",
-      "import": "./dist/draft17-session.js",
-      "require": "./dist/draft17-session.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "src",
-    "!src/__tests__"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run"
-  },
-  "devDependencies": {
-    "@moqtap/test-vectors": "^0.7.3",
-    "tsup": "^8.0.0",
-    "typescript": "^5.5.0",
-    "vitest": "^3.0.0"
-  }
-}
+{
+  "name": "@moqtap/codec",
+  "version": "0.4.0",
+  "description": "MoQT wire-format codec and session state machine — multi-draft, zero dependencies",
+  "type": "module",
+  "license": "MIT",
+  "author": "moqtap",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moqtap/moqtap-js.git",
+    "directory": "packages/codec"
+  },
+  "homepage": "https://github.com/moqtap/moqtap-js/tree/master/packages/codec",
+  "bugs": "https://github.com/moqtap/moqtap-js/issues",
+  "keywords": [
+    "moqt",
+    "moq",
+    "media-over-quic",
+    "webtransport",
+    "codec",
+    "protocol",
+    "ietf",
+    "quic",
+    "streaming",
+    "real-time"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./session": {
+      "bun": "./src/session.ts",
+      "types": "./dist/session.d.ts",
+      "import": "./dist/session.js",
+      "require": "./dist/session.cjs"
+    },
+    "./draft07": {
+      "bun": "./src/drafts/draft07/index.ts",
+      "types": "./dist/draft07.d.ts",
+      "import": "./dist/draft07.js",
+      "require": "./dist/draft07.cjs"
+    },
+    "./draft07/session": {
+      "bun": "./src/drafts/draft07/session.ts",
+      "types": "./dist/draft07-session.d.ts",
+      "import": "./dist/draft07-session.js",
+      "require": "./dist/draft07-session.cjs"
+    },
+    "./draft08": {
+      "bun": "./src/drafts/draft08/index.ts",
+      "types": "./dist/draft08.d.ts",
+      "import": "./dist/draft08.js",
+      "require": "./dist/draft08.cjs"
+    },
+    "./draft08/session": {
+      "bun": "./src/drafts/draft08/session.ts",
+      "types": "./dist/draft08-session.d.ts",
+      "import": "./dist/draft08-session.js",
+      "require": "./dist/draft08-session.cjs"
+    },
+    "./draft09": {
+      "bun": "./src/drafts/draft09/index.ts",
+      "types": "./dist/draft09.d.ts",
+      "import": "./dist/draft09.js",
+      "require": "./dist/draft09.cjs"
+    },
+    "./draft09/session": {
+      "bun": "./src/drafts/draft09/session.ts",
+      "types": "./dist/draft09-session.d.ts",
+      "import": "./dist/draft09-session.js",
+      "require": "./dist/draft09-session.cjs"
+    },
+    "./draft10": {
+      "bun": "./src/drafts/draft10/index.ts",
+      "types": "./dist/draft10.d.ts",
+      "import": "./dist/draft10.js",
+      "require": "./dist/draft10.cjs"
+    },
+    "./draft10/session": {
+      "bun": "./src/drafts/draft10/session.ts",
+      "types": "./dist/draft10-session.d.ts",
+      "import": "./dist/draft10-session.js",
+      "require": "./dist/draft10-session.cjs"
+    },
+    "./draft11": {
+      "bun": "./src/drafts/draft11/index.ts",
+      "types": "./dist/draft11.d.ts",
+      "import": "./dist/draft11.js",
+      "require": "./dist/draft11.cjs"
+    },
+    "./draft11/session": {
+      "bun": "./src/drafts/draft11/session.ts",
+      "types": "./dist/draft11-session.d.ts",
+      "import": "./dist/draft11-session.js",
+      "require": "./dist/draft11-session.cjs"
+    },
+    "./draft12": {
+      "bun": "./src/drafts/draft12/index.ts",
+      "types": "./dist/draft12.d.ts",
+      "import": "./dist/draft12.js",
+      "require": "./dist/draft12.cjs"
+    },
+    "./draft12/session": {
+      "bun": "./src/drafts/draft12/session.ts",
+      "types": "./dist/draft12-session.d.ts",
+      "import": "./dist/draft12-session.js",
+      "require": "./dist/draft12-session.cjs"
+    },
+    "./draft13": {
+      "bun": "./src/drafts/draft13/index.ts",
+      "types": "./dist/draft13.d.ts",
+      "import": "./dist/draft13.js",
+      "require": "./dist/draft13.cjs"
+    },
+    "./draft13/session": {
+      "bun": "./src/drafts/draft13/session.ts",
+      "types": "./dist/draft13-session.d.ts",
+      "import": "./dist/draft13-session.js",
+      "require": "./dist/draft13-session.cjs"
+    },
+    "./draft14": {
+      "bun": "./src/drafts/draft14/index.ts",
+      "types": "./dist/draft14.d.ts",
+      "import": "./dist/draft14.js",
+      "require": "./dist/draft14.cjs"
+    },
+    "./draft14/session": {
+      "bun": "./src/drafts/draft14/session.ts",
+      "types": "./dist/draft14-session.d.ts",
+      "import": "./dist/draft14-session.js",
+      "require": "./dist/draft14-session.cjs"
+    },
+    "./draft15": {
+      "bun": "./src/drafts/draft15/index.ts",
+      "types": "./dist/draft15.d.ts",
+      "import": "./dist/draft15.js",
+      "require": "./dist/draft15.cjs"
+    },
+    "./draft15/session": {
+      "bun": "./src/drafts/draft15/session.ts",
+      "types": "./dist/draft15-session.d.ts",
+      "import": "./dist/draft15-session.js",
+      "require": "./dist/draft15-session.cjs"
+    },
+    "./draft16": {
+      "bun": "./src/drafts/draft16/index.ts",
+      "types": "./dist/draft16.d.ts",
+      "import": "./dist/draft16.js",
+      "require": "./dist/draft16.cjs"
+    },
+    "./draft16/session": {
+      "bun": "./src/drafts/draft16/session.ts",
+      "types": "./dist/draft16-session.d.ts",
+      "import": "./dist/draft16-session.js",
+      "require": "./dist/draft16-session.cjs"
+    },
+    "./draft17": {
+      "bun": "./src/drafts/draft17/index.ts",
+      "types": "./dist/draft17.d.ts",
+      "import": "./dist/draft17.js",
+      "require": "./dist/draft17.cjs"
+    },
+    "./draft17/session": {
+      "bun": "./src/drafts/draft17/session.ts",
+      "types": "./dist/draft17-session.d.ts",
+      "import": "./dist/draft17-session.js",
+      "require": "./dist/draft17-session.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/__tests__"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@moqtap/test-vectors": "^0.8.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  }
+}

package/src/core/buffer-reader.ts

@@ -1,130 +1,130 @@
-import { DecodeError } from "./types.js";
-
-const textDecoder = /* @__PURE__ */ new TextDecoder();
-
-export class BufferReader {
-  private readonly view: DataView;
-  private pos: number;
-
-  constructor(
-    readonly buffer: Uint8Array,
-    offset = 0,
-  ) {
-    this.view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
-    this.pos = offset;
-  }
-
-  get offset(): number {
-    return this.pos;
-  }
-
-  get remaining(): number {
-    return this.buffer.byteLength - this.pos;
-  }
-
-  readUint8(): number {
-    if (this.remaining < 1) {
-      throw new DecodeError("UNEXPECTED_END", "Not enough bytes to read uint8", this.pos);
-    }
-    const value = this.view.getUint8(this.pos);
-    this.pos += 1;
-    return value;
-  }
-
-  readBytes(length: number): Uint8Array<ArrayBuffer> {
-    if (this.remaining < length) {
-      throw new DecodeError(
-        "UNEXPECTED_END",
-        `Not enough bytes: need ${length}, have ${this.remaining}`,
-        this.pos,
-      );
-    }
-    const slice = this.buffer.slice(this.pos, this.pos + length);
-    this.pos += length;
-    return slice;
-  }
-
-  /** Zero-copy read: returns a view into the underlying buffer. */
-  readBytesView(length: number): Uint8Array<ArrayBuffer> {
-    if (this.remaining < length) {
-      throw new DecodeError(
-        "UNEXPECTED_END",
-        `Not enough bytes: need ${length}, have ${this.remaining}`,
-        this.pos,
-      );
-    }
-    const view = this.buffer.subarray(this.pos, this.pos + length);
-    this.pos += length;
-    return view as Uint8Array<ArrayBuffer>;
-  }
-
-  readVarInt(): bigint {
-    if (this.remaining < 1) {
-      throw new DecodeError("UNEXPECTED_END", "Not enough bytes for varint", this.pos);
-    }
-    const first = this.view.getUint8(this.pos);
-    const prefix = first >> 6;
-    let length: number;
-    let value: bigint;
-
-    switch (prefix) {
-      case 0:
-        length = 1;
-        value = BigInt(first & 0x3f);
-        break;
-      case 1:
-        length = 2;
-        if (this.remaining < 2) {
-          throw new DecodeError("UNEXPECTED_END", "Not enough bytes for 2-byte varint", this.pos);
-        }
-        value = BigInt(this.view.getUint16(this.pos) & 0x3fff);
-        break;
-      case 2:
-        length = 4;
-        if (this.remaining < 4) {
-          throw new DecodeError("UNEXPECTED_END", "Not enough bytes for 4-byte varint", this.pos);
-        }
-        value = BigInt(this.view.getUint32(this.pos)) & 0x3fffffffn;
-        break;
-      case 3:
-        length = 8;
-        if (this.remaining < 8) {
-          throw new DecodeError("UNEXPECTED_END", "Not enough bytes for 8-byte varint", this.pos);
-        }
-        value = this.view.getBigUint64(this.pos) & 0x3fffffffffffffffn;
-        break;
-      default:
-        throw new DecodeError("INVALID_VARINT", "Invalid varint prefix", this.pos);
-    }
-
-    this.pos += length;
-    return value;
-  }
-
-  readString(): string {
-    const length = Number(this.readVarInt());
-    const bytes = this.readBytesView(length);
-    return textDecoder.decode(bytes);
-  }
-
-  readTuple(): string[] {
-    const count = Number(this.readVarInt());
-    const result: string[] = [];
-    for (let i = 0; i < count; i++) {
-      result.push(this.readString());
-    }
-    return result;
-  }
-
-  readParameters(): Map<bigint, Uint8Array> {
-    const count = Number(this.readVarInt());
-    const params = new Map<bigint, Uint8Array>();
-    for (let i = 0; i < count; i++) {
-      const key = this.readVarInt();
-      const length = Number(this.readVarInt());
-      const value = this.readBytes(length);
-      params.set(key, value);
-    }
-    return params;
-  }
-}
+import { DecodeError } from './types.js'
+
+const textDecoder = /* @__PURE__ */ new TextDecoder()
+
+export class BufferReader {
+  private readonly view: DataView
+  private pos: number
+
+  constructor(
+    readonly buffer: Uint8Array,
+    offset = 0,
+  ) {
+    this.view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength)
+    this.pos = offset
+  }
+
+  get offset(): number {
+    return this.pos
+  }
+
+  get remaining(): number {
+    return this.buffer.byteLength - this.pos
+  }
+
+  readUint8(): number {
+    if (this.remaining < 1) {
+      throw new DecodeError('UNEXPECTED_END', 'Not enough bytes to read uint8', this.pos)
+    }
+    const value = this.view.getUint8(this.pos)
+    this.pos += 1
+    return value
+  }
+
+  readBytes(length: number): Uint8Array<ArrayBuffer> {
+    if (this.remaining < length) {
+      throw new DecodeError(
+        'UNEXPECTED_END',
+        `Not enough bytes: need ${length}, have ${this.remaining}`,
+        this.pos,
+      )
+    }
+    const slice = this.buffer.slice(this.pos, this.pos + length)
+    this.pos += length
+    return slice
+  }
+
+  /** Zero-copy read: returns a view into the underlying buffer. */
+  readBytesView(length: number): Uint8Array<ArrayBuffer> {
+    if (this.remaining < length) {
+      throw new DecodeError(
+        'UNEXPECTED_END',
+        `Not enough bytes: need ${length}, have ${this.remaining}`,
+        this.pos,
+      )
+    }
+    const view = this.buffer.subarray(this.pos, this.pos + length)
+    this.pos += length
+    return view as Uint8Array<ArrayBuffer>
+  }
+
+  readVarInt(): bigint {
+    if (this.remaining < 1) {
+      throw new DecodeError('UNEXPECTED_END', 'Not enough bytes for varint', this.pos)
+    }
+    const first = this.view.getUint8(this.pos)
+    const prefix = first >> 6
+    let length: number
+    let value: bigint
+
+    switch (prefix) {
+      case 0:
+        length = 1
+        value = BigInt(first & 0x3f)
+        break
+      case 1:
+        length = 2
+        if (this.remaining < 2) {
+          throw new DecodeError('UNEXPECTED_END', 'Not enough bytes for 2-byte varint', this.pos)
+        }
+        value = BigInt(this.view.getUint16(this.pos) & 0x3fff)
+        break
+      case 2:
+        length = 4
+        if (this.remaining < 4) {
+          throw new DecodeError('UNEXPECTED_END', 'Not enough bytes for 4-byte varint', this.pos)
+        }
+        value = BigInt(this.view.getUint32(this.pos)) & 0x3fffffffn
+        break
+      case 3:
+        length = 8
+        if (this.remaining < 8) {
+          throw new DecodeError('UNEXPECTED_END', 'Not enough bytes for 8-byte varint', this.pos)
+        }
+        value = this.view.getBigUint64(this.pos) & 0x3fffffffffffffffn
+        break
+      default:
+        throw new DecodeError('INVALID_VARINT', 'Invalid varint prefix', this.pos)
+    }
+
+    this.pos += length
+    return value
+  }
+
+  readString(): string {
+    const length = Number(this.readVarInt())
+    const bytes = this.readBytesView(length)
+    return textDecoder.decode(bytes)
+  }
+
+  readTuple(): string[] {
+    const count = Number(this.readVarInt())
+    const result: string[] = []
+    for (let i = 0; i < count; i++) {
+      result.push(this.readString())
+    }
+    return result
+  }
+
+  readParameters(): Map<bigint, Uint8Array> {
+    const count = Number(this.readVarInt())
+    const params = new Map<bigint, Uint8Array>()
+    for (let i = 0; i < count; i++) {
+      const key = this.readVarInt()
+      const length = Number(this.readVarInt())
+      const value = this.readBytes(length)
+      params.set(key, value)
+    }
+    return params
+  }
+}