klv-ts 0.1.0

package/LICENSE

@@ -0,0 +1 @@
+MIT

package/README.md

@@ -0,0 +1,30 @@
+# klv-ts
+
+A modern TypeScript parser for SMPTE 336M KLV packets.
+
+## Features
+
+- Generic SMPTE 336M parser
+- Browser support
+- Node.js support
+- Zero dependencies
+- Tree-shakeable
+- TypeScript first
+
+## Installation
+
+```bash
+npm install klv-ts
+```
+
+## Usage
+
+```ts
+import { KlvParser } from "klv-ts";
+
+const parser = new KlvParser();
+
+const packet = parser.parse(bytes);
+
+console.log(packet.length);
+```

package/dist/index.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+// src/parser/ByteReader.ts
+var ByteReader = class {
+  data;
+  offset = 0;
+  constructor(data) {
+    this.data = data;
+  }
+  get position() {
+    return this.offset;
+  }
+  get remaining() {
+    return this.data.length - this.offset;
+  }
+  hasRemaining(length = 1) {
+    return this.remaining >= length;
+  }
+  readByte() {
+    if (!this.hasRemaining()) {
+      throw new Error("Unexpected end of buffer.");
+    }
+    return this.data[this.offset++];
+  }
+  readBytes(length) {
+    if (!this.hasRemaining(length)) {
+      throw new Error("Unexpected end of buffer.");
+    }
+    const bytes = this.data.slice(this.offset, this.offset + length);
+    this.offset += length;
+    return bytes;
+  }
+  skip(length) {
+    if (!this.hasRemaining(length)) {
+      throw new Error("Unexpected end of buffer.");
+    }
+    this.offset += length;
+  }
+};
+
+// src/parser/BerReader.ts
+var BerReader = class {
+  static readLength(reader) {
+    const first = reader.readByte();
+    if ((first & 128) === 0) {
+      return first;
+    }
+    const octets = first & 127;
+    if (octets === 0) {
+      throw new Error("Indefinite BER lengths are not supported.");
+    }
+    let length = 0;
+    for (let i = 0; i < octets; i++) {
+      length = length << 8 | reader.readByte();
+    }
+    return length;
+  }
+};
+
+// src/parser/UniversalKey.ts
+var UniversalKey = class _UniversalKey {
+  constructor(bytes) {
+    this.bytes = bytes;
+    if (bytes.length !== _UniversalKey.LENGTH) {
+      throw new Error("Universal Key must contain 16 bytes.");
+    }
+  }
+  bytes;
+  static LENGTH = 16;
+  isSmpte() {
+    return this.bytes[0] === 6 && this.bytes[1] === 14 && this.bytes[2] === 43 && this.bytes[3] === 52;
+  }
+  equals(other) {
+    return this.bytes.every((v, i) => v === other.bytes[i]);
+  }
+  toHex(separator = "") {
+    return Array.from(this.bytes).map((b) => b.toString(16).padStart(2, "0")).join(separator);
+  }
+};
+
+// src/parser/KlvParser.ts
+var KlvParser = class {
+  parse(data) {
+    const reader = new ByteReader(data);
+    const keyBytes = reader.readBytes(UniversalKey.LENGTH);
+    const key = new UniversalKey(keyBytes);
+    const length = BerReader.readLength(reader);
+    const value = reader.readBytes(length);
+    return {
+      key,
+      length,
+      value,
+      raw: data
+    };
+  }
+};
+
+exports.BerReader = BerReader;
+exports.ByteReader = ByteReader;
+exports.KlvParser = KlvParser;
+exports.UniversalKey = UniversalKey;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parser/ByteReader.ts","../src/parser/BerReader.ts","../src/parser/UniversalKey.ts","../src/parser/KlvParser.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export class ByteReader {\r\n\r\n    private readonly data: Uint8Array;\r\n    private offset = 0;\r\n\r\n    constructor(data: Uint8Array) {\r\n        this.data = data;\r\n    }\r\n\r\n    get position(): number {\r\n        return this.offset;\r\n    }\r\n\r\n    get remaining(): number {\r\n        return this.data.length - this.offset;\r\n    }\r\n\r\n    hasRemaining(length = 1): boolean {\r\n        return this.remaining >= length;\r\n    }\r\n\r\n    readByte(): number {\r\n        if (!this.hasRemaining()) {\r\n            throw new Error(\"Unexpected end of buffer.\");\r\n        }\r\n\r\n        return this.data[this.offset++];\r\n    }\r\n\r\n    readBytes(length: number): Uint8Array {\r\n        if (!this.hasRemaining(length)) {\r\n            throw new Error(\"Unexpected end of buffer.\");\r\n        }\r\n\r\n        const bytes = this.data.slice(this.offset, this.offset + length);\r\n        this.offset += length;\r\n\r\n        return bytes;\r\n    }\r\n\r\n    skip(length: number): void {\r\n        if (!this.hasRemaining(length)) {\r\n            throw new Error(\"Unexpected end of buffer.\");\r\n        }\r\n\r\n        this.offset += length;\r\n    }\r\n}","import { ByteReader } from \"./ByteReader\";\r\n\r\nexport class BerReader {\r\n\r\n    static readLength(reader: ByteReader): number {\r\n\r\n        const first = reader.readByte();\r\n\r\n        // Short form\r\n        if ((first & 0x80) === 0) {\r\n            return first;\r\n        }\r\n\r\n        const octets = first & 0x7F;\r\n\r\n        if (octets === 0) {\r\n            throw new Error(\"Indefinite BER lengths are not supported.\");\r\n        }\r\n\r\n        let length = 0;\r\n\r\n        for (let i = 0; i < octets; i++) {\r\n            length = (length << 8) | reader.readByte();\r\n        }\r\n\r\n        return length;\r\n    }\r\n\r\n}","export class UniversalKey {\r\n\r\n    static readonly LENGTH = 16;\r\n\r\n    constructor(\r\n        public readonly bytes: Uint8Array\r\n    ) {\r\n\r\n        if (bytes.length !== UniversalKey.LENGTH) {\r\n            throw new Error(\"Universal Key must contain 16 bytes.\");\r\n        }\r\n\r\n    }\r\n\r\n    isSmpte(): boolean {\r\n\r\n        return (\r\n            this.bytes[0] === 0x06 &&\r\n            this.bytes[1] === 0x0E &&\r\n            this.bytes[2] === 0x2B &&\r\n            this.bytes[3] === 0x34\r\n        );\r\n\r\n    }\r\n\r\n    equals(other: UniversalKey): boolean {\r\n\r\n        return this.bytes.every((v, i) => v === other.bytes[i]);\r\n\r\n    }\r\n\r\n    toHex(separator = \"\"): string {\r\n\r\n        return Array.from(this.bytes)\r\n            .map(b => b.toString(16).padStart(2, \"0\"))\r\n            .join(separator);\r\n\r\n    }\r\n\r\n}","import { KlvPacket } from \"../packet/KlvPacket\";\r\nimport { BerReader } from \"./BerReader\";\r\nimport { ByteReader } from \"./ByteReader\";\r\nimport { UniversalKey } from \"./UniversalKey\";\r\n\r\nexport class KlvParser {\r\n\r\n    parse(data: Uint8Array): KlvPacket {\r\n\r\n        const reader = new ByteReader(data);\r\n\r\n        const keyBytes = reader.readBytes(UniversalKey.LENGTH);\r\n\r\n        const key = new UniversalKey(keyBytes);\r\n\r\n        const length = BerReader.readLength(reader);\r\n\r\n        const value = reader.readBytes(length);\r\n\r\n        return {\r\n\r\n            key,\r\n\r\n            length,\r\n\r\n            value,\r\n\r\n            raw: data\r\n\r\n        };\r\n\r\n    }\r\n\r\n}"]}

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+declare class UniversalKey {
+    readonly bytes: Uint8Array;
+    static readonly LENGTH = 16;
+    constructor(bytes: Uint8Array);
+    isSmpte(): boolean;
+    equals(other: UniversalKey): boolean;
+    toHex(separator?: string): string;
+}
+
+interface KlvPacket {
+    key: UniversalKey;
+    length: number;
+    value: Uint8Array;
+    raw: Uint8Array;
+}
+
+declare class ByteReader {
+    private readonly data;
+    private offset;
+    constructor(data: Uint8Array);
+    get position(): number;
+    get remaining(): number;
+    hasRemaining(length?: number): boolean;
+    readByte(): number;
+    readBytes(length: number): Uint8Array;
+    skip(length: number): void;
+}
+
+declare class BerReader {
+    static readLength(reader: ByteReader): number;
+}
+
+declare class KlvParser {
+    parse(data: Uint8Array): KlvPacket;
+}
+
+export { BerReader, ByteReader, type KlvPacket, KlvParser, UniversalKey };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+declare class UniversalKey {
+    readonly bytes: Uint8Array;
+    static readonly LENGTH = 16;
+    constructor(bytes: Uint8Array);
+    isSmpte(): boolean;
+    equals(other: UniversalKey): boolean;
+    toHex(separator?: string): string;
+}
+
+interface KlvPacket {
+    key: UniversalKey;
+    length: number;
+    value: Uint8Array;
+    raw: Uint8Array;
+}
+
+declare class ByteReader {
+    private readonly data;
+    private offset;
+    constructor(data: Uint8Array);
+    get position(): number;
+    get remaining(): number;
+    hasRemaining(length?: number): boolean;
+    readByte(): number;
+    readBytes(length: number): Uint8Array;
+    skip(length: number): void;
+}
+
+declare class BerReader {
+    static readLength(reader: ByteReader): number;
+}
+
+declare class KlvParser {
+    parse(data: Uint8Array): KlvPacket;
+}
+
+export { BerReader, ByteReader, type KlvPacket, KlvParser, UniversalKey };

package/dist/index.js

@@ -0,0 +1,98 @@
+// src/parser/ByteReader.ts
+var ByteReader = class {
+  data;
+  offset = 0;
+  constructor(data) {
+    this.data = data;
+  }
+  get position() {
+    return this.offset;
+  }
+  get remaining() {
+    return this.data.length - this.offset;
+  }
+  hasRemaining(length = 1) {
+    return this.remaining >= length;
+  }
+  readByte() {
+    if (!this.hasRemaining()) {
+      throw new Error("Unexpected end of buffer.");
+    }
+    return this.data[this.offset++];
+  }
+  readBytes(length) {
+    if (!this.hasRemaining(length)) {
+      throw new Error("Unexpected end of buffer.");
+    }
+    const bytes = this.data.slice(this.offset, this.offset + length);
+    this.offset += length;
+    return bytes;
+  }
+  skip(length) {
+    if (!this.hasRemaining(length)) {
+      throw new Error("Unexpected end of buffer.");
+    }
+    this.offset += length;
+  }
+};
+
+// src/parser/BerReader.ts
+var BerReader = class {
+  static readLength(reader) {
+    const first = reader.readByte();
+    if ((first & 128) === 0) {
+      return first;
+    }
+    const octets = first & 127;
+    if (octets === 0) {
+      throw new Error("Indefinite BER lengths are not supported.");
+    }
+    let length = 0;
+    for (let i = 0; i < octets; i++) {
+      length = length << 8 | reader.readByte();
+    }
+    return length;
+  }
+};
+
+// src/parser/UniversalKey.ts
+var UniversalKey = class _UniversalKey {
+  constructor(bytes) {
+    this.bytes = bytes;
+    if (bytes.length !== _UniversalKey.LENGTH) {
+      throw new Error("Universal Key must contain 16 bytes.");
+    }
+  }
+  bytes;
+  static LENGTH = 16;
+  isSmpte() {
+    return this.bytes[0] === 6 && this.bytes[1] === 14 && this.bytes[2] === 43 && this.bytes[3] === 52;
+  }
+  equals(other) {
+    return this.bytes.every((v, i) => v === other.bytes[i]);
+  }
+  toHex(separator = "") {
+    return Array.from(this.bytes).map((b) => b.toString(16).padStart(2, "0")).join(separator);
+  }
+};
+
+// src/parser/KlvParser.ts
+var KlvParser = class {
+  parse(data) {
+    const reader = new ByteReader(data);
+    const keyBytes = reader.readBytes(UniversalKey.LENGTH);
+    const key = new UniversalKey(keyBytes);
+    const length = BerReader.readLength(reader);
+    const value = reader.readBytes(length);
+    return {
+      key,
+      length,
+      value,
+      raw: data
+    };
+  }
+};
+
+export { BerReader, ByteReader, KlvParser, UniversalKey };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parser/ByteReader.ts","../src/parser/BerReader.ts","../src/parser/UniversalKey.ts","../src/parser/KlvParser.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export class ByteReader {\r\n\r\n    private readonly data: Uint8Array;\r\n    private offset = 0;\r\n\r\n    constructor(data: Uint8Array) {\r\n        this.data = data;\r\n    }\r\n\r\n    get position(): number {\r\n        return this.offset;\r\n    }\r\n\r\n    get remaining(): number {\r\n        return this.data.length - this.offset;\r\n    }\r\n\r\n    hasRemaining(length = 1): boolean {\r\n        return this.remaining >= length;\r\n    }\r\n\r\n    readByte(): number {\r\n        if (!this.hasRemaining()) {\r\n            throw new Error(\"Unexpected end of buffer.\");\r\n        }\r\n\r\n        return this.data[this.offset++];\r\n    }\r\n\r\n    readBytes(length: number): Uint8Array {\r\n        if (!this.hasRemaining(length)) {\r\n            throw new Error(\"Unexpected end of buffer.\");\r\n        }\r\n\r\n        const bytes = this.data.slice(this.offset, this.offset + length);\r\n        this.offset += length;\r\n\r\n        return bytes;\r\n    }\r\n\r\n    skip(length: number): void {\r\n        if (!this.hasRemaining(length)) {\r\n            throw new Error(\"Unexpected end of buffer.\");\r\n        }\r\n\r\n        this.offset += length;\r\n    }\r\n}","import { ByteReader } from \"./ByteReader\";\r\n\r\nexport class BerReader {\r\n\r\n    static readLength(reader: ByteReader): number {\r\n\r\n        const first = reader.readByte();\r\n\r\n        // Short form\r\n        if ((first & 0x80) === 0) {\r\n            return first;\r\n        }\r\n\r\n        const octets = first & 0x7F;\r\n\r\n        if (octets === 0) {\r\n            throw new Error(\"Indefinite BER lengths are not supported.\");\r\n        }\r\n\r\n        let length = 0;\r\n\r\n        for (let i = 0; i < octets; i++) {\r\n            length = (length << 8) | reader.readByte();\r\n        }\r\n\r\n        return length;\r\n    }\r\n\r\n}","export class UniversalKey {\r\n\r\n    static readonly LENGTH = 16;\r\n\r\n    constructor(\r\n        public readonly bytes: Uint8Array\r\n    ) {\r\n\r\n        if (bytes.length !== UniversalKey.LENGTH) {\r\n            throw new Error(\"Universal Key must contain 16 bytes.\");\r\n        }\r\n\r\n    }\r\n\r\n    isSmpte(): boolean {\r\n\r\n        return (\r\n            this.bytes[0] === 0x06 &&\r\n            this.bytes[1] === 0x0E &&\r\n            this.bytes[2] === 0x2B &&\r\n            this.bytes[3] === 0x34\r\n        );\r\n\r\n    }\r\n\r\n    equals(other: UniversalKey): boolean {\r\n\r\n        return this.bytes.every((v, i) => v === other.bytes[i]);\r\n\r\n    }\r\n\r\n    toHex(separator = \"\"): string {\r\n\r\n        return Array.from(this.bytes)\r\n            .map(b => b.toString(16).padStart(2, \"0\"))\r\n            .join(separator);\r\n\r\n    }\r\n\r\n}","import { KlvPacket } from \"../packet/KlvPacket\";\r\nimport { BerReader } from \"./BerReader\";\r\nimport { ByteReader } from \"./ByteReader\";\r\nimport { UniversalKey } from \"./UniversalKey\";\r\n\r\nexport class KlvParser {\r\n\r\n    parse(data: Uint8Array): KlvPacket {\r\n\r\n        const reader = new ByteReader(data);\r\n\r\n        const keyBytes = reader.readBytes(UniversalKey.LENGTH);\r\n\r\n        const key = new UniversalKey(keyBytes);\r\n\r\n        const length = BerReader.readLength(reader);\r\n\r\n        const value = reader.readBytes(length);\r\n\r\n        return {\r\n\r\n            key,\r\n\r\n            length,\r\n\r\n            value,\r\n\r\n            raw: data\r\n\r\n        };\r\n\r\n    }\r\n\r\n}"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "klv-ts",
+  "version": "0.1.0",
+  "description": "Generic SMPTE 336M KLV parser for JavaScript and TypeScript",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "pnpm build && pnpm test"
+  },
+  "keywords": [
+    "klv",
+    "misb",
+    "mpegts",
+    "smpte",
+    "metadata",
+    "video",
+    "uas"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JuankAnacona/klv-ts.git"
+  },
+  "dependencies": {
+    "tsup": "^8.5.1",
+    "vitest": "^4.1.10"
+  },
+  "devDependencies": {
+    "typescript": "5.9.2"
+  }
+}