webcodecs-node 0.7.5 → 0.8.5

package/dist/utils/codec-validation.js

@@ -1,253 +1,9 @@
 /**
  * Codec string validation according to WebCodecs specification
  *
- * The WebCodecs spec requires strict validation of codec strings:
- * - Case-sensitive matching
- * - Fully qualified codec strings (no ambiguous "vp9", must be "vp09.xx.xx.xx")
- * - Valid profile/level parameters
- *
- * @see https://www.w3.org/TR/webcodecs-codec-registry/
- */
-/**
- * Validate a video codec string according to WebCodecs spec
- *
- * Returns { valid: true, supported: true } for valid, supported codecs
- * Returns { valid: true, supported: false } for valid but unsupported codecs
- * Returns { valid: false, supported: false } for invalid codec strings
- */
-export function validateVideoCodec(codec) {
-    // Check for whitespace (invalid)
-    if (codec !== codec.trim()) {
-        return { valid: true, supported: false, error: 'Codec string contains whitespace' };
-    }
-    // Check for MIME type format (invalid for WebCodecs)
-    if (codec.includes('/') || codec.includes(';')) {
-        return { valid: true, supported: false, error: 'MIME type format not accepted' };
-    }
-    // AVC/H.264: avc1.PPCCLL or avc3.PPCCLL
-    if (codec.startsWith('avc1.') || codec.startsWith('avc3.')) {
-        return validateAvcCodec(codec);
-    }
-    // HEVC/H.265: hvc1.P.T.Lxx or hev1.P.T.Lxx
-    if (codec.startsWith('hvc1.') || codec.startsWith('hev1.')) {
-        return validateHevcCodec(codec);
-    }
-    // VP8: exactly "vp8"
-    if (codec === 'vp8') {
-        return { valid: true, supported: true };
-    }
-    // VP8 with wrong casing
-    if (codec.toLowerCase() === 'vp8' && codec !== 'vp8') {
-        return { valid: true, supported: false, error: 'VP8 codec must be lowercase "vp8"' };
-    }
-    // VP9: fully qualified vp09.PP.LL.DD or shorthand "vp9"
-    if (codec.startsWith('vp09.')) {
-        return validateVp9Codec(codec);
-    }
-    // Accept shorthand "vp9" as alias for vp09.00.10.08 (profile 0, level 1.0, 8-bit)
-    // This matches browser behavior for developer convenience
-    if (codec === 'vp9') {
-        return { valid: true, supported: true };
-    }
-    // VP9 with wrong casing
-    if (codec.toLowerCase() === 'vp9' && codec !== 'vp9') {
-        return { valid: true, supported: false, error: 'VP9 codec must be lowercase "vp9"' };
-    }
-    // AV1: fully qualified av01.P.LLT.DD or shorthand "av1"
-    if (codec.startsWith('av01.')) {
-        return validateAv1Codec(codec);
-    }
-    // Accept shorthand "av1" as alias for av01.0.01M.08 (Main profile, level 2.1, Main tier, 8-bit)
-    // This matches browser behavior for developer convenience
-    if (codec === 'av1') {
-        return { valid: true, supported: true };
-    }
-    // AV1 with wrong casing
-    if (codec.toLowerCase() === 'av1' && codec !== 'av1') {
-        return { valid: true, supported: false, error: 'AV1 codec must be lowercase "av1"' };
-    }
-    // Unknown codec
-    return { valid: true, supported: false, error: `Unrecognized codec: ${codec}` };
-}
-/**
- * Validate AVC/H.264 codec string
- * Format: avc1.PPCCLL or avc3.PPCCLL
- * PP = Profile (hex), CC = Constraints (hex), LL = Level (hex)
- */
-function validateAvcCodec(codec) {
-    // avc1.XXXXXX or avc3.XXXXXX (6 hex digits)
-    const match = codec.match(/^(avc[13])\.([0-9A-Fa-f]{6})$/);
-    if (!match) {
-        return { valid: true, supported: false, error: 'Invalid AVC codec format' };
-    }
-    const [, prefix, params] = match;
-    // Check case sensitivity of prefix
-    if (prefix !== prefix.toLowerCase()) {
-        return { valid: true, supported: false, error: 'AVC codec prefix must be lowercase' };
-    }
-    // Parse profile, constraints, level
-    const profile = parseInt(params.substring(0, 2), 16);
-    const constraints = parseInt(params.substring(2, 4), 16);
-    const level = parseInt(params.substring(4, 6), 16);
-    // Valid profiles: 66 (Baseline), 77 (Main), 88 (Extended), 100 (High), etc.
-    const validProfiles = [66, 77, 88, 100, 110, 122, 244, 44, 83, 86, 118, 128, 138, 139, 134];
-    if (!validProfiles.includes(profile)) {
-        // Future/unknown profile - mark as unsupported
-        return { valid: true, supported: false, error: `Unknown AVC profile: ${profile}` };
-    }
-    // Valid levels: 10, 11, 12, 13, 20, 21, 22, 30, 31, 32, 40, 41, 42, 50, 51, 52, 60, 61, 62
-    const validLevels = [10, 11, 12, 13, 20, 21, 22, 30, 31, 32, 40, 41, 42, 50, 51, 52, 60, 61, 62];
-    if (!validLevels.includes(level)) {
-        // Note: level 29 (0x1D) is not a valid H.264 level
-        return { valid: true, supported: false, error: `Unknown AVC level: ${level}` };
-    }
-    return { valid: true, supported: true };
-}
-/**
- * Validate HEVC/H.265 codec string
- * Format: hvc1.P.C.Lxx[.XX] or hev1.P.C.Lxx[.XX]
- * Where P = profile, C = compatibility, Lxx = level, XX = optional constraints
- * Example: hev1.1.6.L93.B0
- */
-function validateHevcCodec(codec) {
-    // HEVC codec format: prefix.profile.compatibility.level[.constraints]
-    // Examples: hev1.1.6.L93.B0, hvc1.1.6.L120, hev1.2.4.L153.90
-    const match = codec.match(/^(hvc1|hev1)\.(\d+)\.([0-9A-Fa-f]+)\.L(\d+)(?:\.([A-Za-z0-9]+))?$/);
-    if (!match) {
-        return { valid: true, supported: false, error: 'Invalid HEVC codec format' };
-    }
-    const [, prefix, profileStr, , levelStr] = match;
-    // Check case sensitivity of prefix
-    if (prefix !== prefix.toLowerCase()) {
-        return { valid: true, supported: false, error: 'HEVC codec prefix must be lowercase' };
-    }
-    const profile = parseInt(profileStr, 10);
-    const level = parseInt(levelStr, 10);
-    // Valid HEVC profiles: 1 (Main), 2 (Main 10), 3 (Main Still Picture), etc.
-    if (profile < 1 || profile > 11) {
-        return { valid: true, supported: false, error: `Unknown HEVC profile: ${profile}` };
-    }
-    // Valid HEVC levels (level * 30): 30, 60, 63, 90, 93, 120, 123, 150, 153, 156, 180, 183, 186
-    const validLevels = [30, 60, 63, 90, 93, 120, 123, 150, 153, 156, 180, 183, 186];
-    if (!validLevels.includes(level)) {
-        return { valid: true, supported: false, error: `Unknown HEVC level: ${level}` };
-    }
-    return { valid: true, supported: true };
-}
-/**
- * Validate VP9 codec string
- * Format: vp09.PP.LL.DD
- * PP = Profile (00-03), LL = Level (10-62), DD = Bit depth (08, 10, 12)
- */
-function validateVp9Codec(codec) {
-    const match = codec.match(/^vp09\.(\d{2})\.(\d{2})\.(\d{2})$/);
-    if (!match) {
-        return { valid: true, supported: false, error: 'Invalid VP9 codec format, expected vp09.PP.LL.DD' };
-    }
-    const [, profileStr, levelStr, bitDepthStr] = match;
-    const profile = parseInt(profileStr, 10);
-    const level = parseInt(levelStr, 10);
-    const bitDepth = parseInt(bitDepthStr, 10);
-    // Valid profiles: 0, 1, 2, 3
-    if (profile < 0 || profile > 3) {
-        return { valid: true, supported: false, error: `Unknown VP9 profile: ${profile}` };
-    }
-    // Valid levels: 10, 11, 20, 21, 30, 31, 40, 41, 50, 51, 52, 60, 61, 62
-    const validLevels = [10, 11, 20, 21, 30, 31, 40, 41, 50, 51, 52, 60, 61, 62];
-    if (!validLevels.includes(level)) {
-        return { valid: true, supported: false, error: `Unknown VP9 level: ${level}` };
-    }
-    // Valid bit depths: 8, 10, 12
-    if (bitDepth !== 8 && bitDepth !== 10 && bitDepth !== 12) {
-        return { valid: true, supported: false, error: `Unknown VP9 bit depth: ${bitDepth}` };
-    }
-    return { valid: true, supported: true };
-}
-/**
- * Validate AV1 codec string
- * Format: av01.P.LLT.DD
- * P = Profile (0=Main, 1=High, 2=Professional)
- * LL = Level (00-23)
- * T = Tier (M=Main, H=High)
- * DD = Bit depth (08, 10, 12)
- */
-function validateAv1Codec(codec) {
-    const match = codec.match(/^av01\.(\d)\.(\d{2})([MH])\.(\d{2})$/);
-    if (!match) {
-        return { valid: true, supported: false, error: 'Invalid AV1 codec format, expected av01.P.LLT.DD' };
-    }
-    const [, profileStr, levelStr, tier, bitDepthStr] = match;
-    const profile = parseInt(profileStr, 10);
-    const level = parseInt(levelStr, 10);
-    const bitDepth = parseInt(bitDepthStr, 10);
-    // Valid profiles: 0 (Main), 1 (High), 2 (Professional)
-    if (profile < 0 || profile > 2) {
-        return { valid: true, supported: false, error: `Unknown AV1 profile: ${profile}` };
-    }
-    // Valid levels: 0-23 (0=2.0, 1=2.1, ..., 23=7.3)
-    if (level < 0 || level > 23) {
-        return { valid: true, supported: false, error: `Unknown AV1 level: ${level}` };
-    }
-    // Valid bit depths: 8, 10, 12
-    if (bitDepth !== 8 && bitDepth !== 10 && bitDepth !== 12) {
-        return { valid: true, supported: false, error: `Unknown AV1 bit depth: ${bitDepth}` };
-    }
-    return { valid: true, supported: true };
-}
-/**
- * Check if a codec config is valid (should throw TypeError if invalid)
- * This checks for missing/empty required fields
- */
-export function validateVideoDecoderConfig(config) {
-    if (!config || typeof config !== 'object') {
-        throw new TypeError('config must be an object');
-    }
-    const cfg = config;
-    if (cfg.codec === undefined || cfg.codec === null) {
-        throw new TypeError('codec is required');
-    }
-    if (typeof cfg.codec !== 'string' || cfg.codec === '') {
-        throw new TypeError('codec must be a non-empty string');
-    }
-}
-/**
- * Check if an encoder config is valid (should throw TypeError if invalid)
+ * @deprecated Import from '../codecs/validation' instead for new code.
+ * This file re-exports from the new modular structure for backward compatibility.
  */
-export function validateVideoEncoderConfig(config) {
-    if (!config || typeof config !== 'object') {
-        throw new TypeError('config must be an object');
-    }
-    const cfg = config;
-    if (cfg.codec === undefined || cfg.codec === null) {
-        throw new TypeError('codec is required');
-    }
-    if (typeof cfg.codec !== 'string' || cfg.codec === '') {
-        throw new TypeError('codec must be a non-empty string');
-    }
-    if (cfg.width === undefined || cfg.width === null) {
-        throw new TypeError('width is required');
-    }
-    if (typeof cfg.width !== 'number' || cfg.width <= 0 || !Number.isFinite(cfg.width)) {
-        throw new TypeError('width must be a positive number');
-    }
-    if (cfg.height === undefined || cfg.height === null) {
-        throw new TypeError('height is required');
-    }
-    if (typeof cfg.height !== 'number' || cfg.height <= 0 || !Number.isFinite(cfg.height)) {
-        throw new TypeError('height must be a positive number');
-    }
-    // Optional field validations
-    if (cfg.displayWidth !== undefined && (typeof cfg.displayWidth !== 'number' || cfg.displayWidth <= 0)) {
-        throw new TypeError('displayWidth must be a positive number');
-    }
-    if (cfg.displayHeight !== undefined && (typeof cfg.displayHeight !== 'number' || cfg.displayHeight <= 0)) {
-        throw new TypeError('displayHeight must be a positive number');
-    }
-    if (cfg.bitrate !== undefined && (typeof cfg.bitrate !== 'number' || cfg.bitrate <= 0)) {
-        throw new TypeError('bitrate must be a positive number');
-    }
-    if (cfg.framerate !== undefined && (typeof cfg.framerate !== 'number' || cfg.framerate <= 0)) {
-        throw new TypeError('framerate must be a positive number');
-    }
-}
+// Re-export everything from the new modular structure
+export * from '../codecs/validation/index.js';
 //# sourceMappingURL=codec-validation.js.map

package/dist/utils/codec-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"codec-validation.js","sourceRoot":"","sources":["../../src/utils/codec-validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codec-validation.js","sourceRoot":"","sources":["../../src/utils/codec-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sDAAsD;AACtD,cAAc,+BAA+B,CAAC"}

package/docs/api.md

@@ -400,10 +400,12 @@ new VideoFrame(data: BufferSource, init: VideoFrameBufferInit)
 
 *10-bit formats (HDR):*
 - `'I420P10'` - YUV 4:2:0 planar, 10-bit (16-bit container)
-- `'I422P10'` - YUV 4:2:2 planar, 10-bit (16-bit container)
-- `'I444P10'` - YUV 4:4:4 planar, 10-bit (16-bit container)
+- `'I422P10'` - YUV 4:2:2 planar, 10-bit (16-bit container) - downconverted to 4:2:0 during encoding
+- `'I444P10'` - YUV 4:4:4 planar, 10-bit (16-bit container) - downconverted to 4:2:0 during encoding
 - `'P010'` - YUV 4:2:0 semi-planar, 10-bit (16-bit container)
 
+> **Note:** 10-bit encoding requires HEVC, VP9, or AV1 codec. H.264 will downconvert to 8-bit. I422P10/I444P10 are decoded correctly but downconverted to I420P10 during encoding.
+
 ### Instance Methods
 
 #### `allocationSize(options?: VideoFrameCopyToOptions): number`

package/docs/architecture-refactor-plan.md

@@ -0,0 +1,149 @@
+# Architecture Refactor Plan (No Behavior Changes)
+
+This document proposes a structural refactor to make the project more human-manageable by reducing large files and creating self-contained modules. It does **not** change runtime behavior; it only reorganizes code and responsibilities.
+
+## Goals
+- Reduce large multi-responsibility files into focused modules.
+- Make each module easy to read, test, and modify in isolation.
+- Keep public API surface and exports stable.
+- Enable incremental migration without breaking tests.
+
+## Target Layout (Proposed)
+```
+src/
+  api/
+    index.ts
+  core/
+    audio-data/
+      AudioData.ts
+      index.ts
+    encoded-chunk/
+      EncodedAudioChunk.ts
+      EncodedVideoChunk.ts
+      index.ts
+    video-frame/
+      VideoFrame.ts
+      canvas-source.ts
+      copy.ts
+      layout.ts
+      metadata.ts
+      orientation.ts
+      transfer.ts
+      validation.ts
+      index.ts
+  decoders/
+    audio/
+      AudioDecoder.ts
+      config.ts
+      output.ts
+      queue.ts
+      index.ts
+    video/
+      VideoDecoder.ts
+      codec-specific.ts
+      config.ts
+      output.ts
+      queue.ts
+      timestamps.ts
+      index.ts
+    image/
+      ImageDecoder.ts
+      orientation.ts
+      stream.ts
+      tracks.ts
+      index.ts
+  encoders/
+    audio/
+      AudioEncoder.ts
+      config.ts
+      output.ts
+      queue.ts
+      index.ts
+    video/
+      VideoEncoder.ts
+      config.ts
+      metadata.ts
+      orientation.ts
+      queue.ts
+      timestamps.ts
+      index.ts
+  backends/
+    node-av/
+      audio/
+        decoder.ts
+        encoder.ts
+      video/
+        decoder.ts
+        encoder.ts
+        filters.ts
+        mappings.ts
+        timestamps.ts
+      image/
+        decoder.ts
+      index.ts
+  formats/
+    pixel-format/
+      helpers.ts
+      layout.ts
+      sizes.ts
+      types.ts
+      index.ts
+    color-space/
+      convert.ts
+      extract.ts
+      maps.ts
+      types.ts
+      index.ts
+    conversions/
+      frame-converter.ts
+  codecs/
+    avc.ts
+    hevc.ts
+    aac.ts
+  transfer/
+    detach.ts
+    validate.ts
+    index.ts
+  validation/
+    audio-decoder.ts
+    audio-encoder.ts
+    video-decoder.ts
+    video-encoder.ts
+    index.ts
+  utils/
+    buffer.ts
+    buffer-pool.ts
+    errors.ts
+    event-target.ts
+    logger.ts
+    timeout.ts
+    type-guards.ts
+    index.ts
+  types/
+    index.ts
+  index.ts
+```
+
+## Mapping Highlights (Move / Split)
+- `src/core/VideoFrame.ts` → `src/core/video-frame/VideoFrame.ts` + `validation.ts` + `layout.ts` + `copy.ts` + `orientation.ts` + `transfer.ts` + `canvas-source.ts`.
+- `src/decoders/ImageDecoder.ts` → `src/decoders/image/ImageDecoder.ts` + `tracks.ts` + `stream.ts` + `orientation.ts`.
+- `src/decoders/VideoDecoder.ts` → `src/decoders/video/VideoDecoder.ts` + `config.ts` + `codec-specific.ts` + `queue.ts` + `output.ts`.
+- `src/encoders/VideoEncoder.ts` → `src/encoders/video/VideoEncoder.ts` + `config.ts` + `metadata.ts` + `queue.ts`.
+- `src/node-av/NodeAvVideoDecoder.ts` → `src/backends/node-av/video/decoder.ts` + `filters.ts` + `mappings.ts` + `timestamps.ts`.
+- `src/formats/color-space.ts` → `src/formats/color-space/{maps,extract,convert}.ts`.
+- `src/formats/pixel-formats.ts` → `src/formats/pixel-format/{types,sizes,layout,helpers}.ts`.
+- `src/codec-utils/*` + `src/utils/{avc,hevc,aac}.ts` → `src/codecs/` and `src/backends/node-av/*/mappings.ts`.
+
+## Migration Checklist (Incremental, No Behavior Change)
+1) Create new folders and `index.ts` barrels that re-export existing symbols.
+2) Extract pure helpers first (validation, layout, mapping, transfer), leaving public classes untouched.
+3) Move backend-specific logic into `src/backends/node-av/`, keeping thin adapters in old paths.
+4) Convert large classes into orchestrators that delegate to the new modules.
+5) Update internal imports incrementally; keep public exports stable from `src/index.ts`.
+6) Add `docs/architecture.md` with module boundaries and ownership rules.
+7) Enforce file size/complexity thresholds in lint/CI to prevent future bloat.
+
+## Optional Guardrails
+- Add a maximum file size or function length lint rule for `core/`, `decoders/`, `encoders/`, and `node-av/`.
+- Require new helper functions to live outside public classes unless they are public API.
+- Prefer one responsibility per module (validation, mapping, conversion, orchestration).