@moqtap/codec 0.2.2 → 0.2.3

package/package.json

@@ -1,192 +1,192 @@
-{
-  "name": "@moqtap/codec",
-  "version": "0.2.2",
-  "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.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"
+  }
+}

package/src/core/buffer-reader.ts

@@ -1,114 +1,130 @@
-import { DecodeError } from "./types.js";
-
-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;
-  }
-
-  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.readBytes(length);
-    return new 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;
+  }
+}