@utilix-tech/sdk 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.28.0
+- Add `readVideoInfo` (mp4-webm-video-info): duration, resolution, and video/audio codec identifiers from an MP4 (ISO BMFF moov box) or WebM (EBML/Matroska Segment) container header, with no frame decoding or transcoding.
+
 ## 0.27.0
 - Add `calculateRuleOf72` (rule-of-72-calculator): estimate years to double an investment from a rate, or the rate needed to double in a given number of years, alongside the exact logarithmic result.
 - Add `readFlacInfo` (flac-metadata-reader): sample rate, channels, bit depth, total samples, and duration from a FLAC file's STREAMINFO block, plus Vorbis comment tags when present.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**578 developer utility functions for Node.js: runs locally, no API key required.**
+**579 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -561,10 +561,10 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media`: Image Header Parsing, EXIF, PDF, WAV, ID3, ICO & FLAC Metadata
+### `/media`: Image Header Parsing, EXIF, PDF, WAV, ID3, ICO, FLAC & Video Metadata
 
 ```ts
-import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo } from "@utilix-tech/sdk/media";
+import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo, readVideoInfo } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
 // file bytes: no decoding, no canvas, no image library.
@@ -609,9 +609,16 @@ readIcoInfo(new Uint8Array(icoBytes));
 const flacBytes = await fs.promises.readFile("track.flac");
 readFlacInfo(new Uint8Array(flacBytes));
 // { sampleRate: 44100, channels: 2, bitsPerSample: 16, durationSeconds: 214.7, artist: "Artist Name", ... }
+
+// Reads duration, resolution, and video/audio codec identifiers from an
+// MP4 (ISO BMFF moov box) or WebM (EBML/Matroska Segment) container
+// header: no frame decoding, demuxing, or transcoding.
+const videoBytes = await fs.promises.readFile("clip.mp4");
+readVideoInfo(new Uint8Array(videoBytes));
+// { format: "mp4", durationSeconds: 12.5, width: 1920, height: 1080, videoCodec: "avc1", audioCodec: "mp4a", ... }
 ```
 
-`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only. `readWavInfo` supports the canonical RIFF/WAVE container only. `readId3Tags` decodes ID3v2.3/2.4 and ID3v1/1.1 only (ID3v2.2 is detected but not decoded). `readIcoInfo` reads .ico icon files only and rejects .cur cursor files. `readFlacInfo` reads the native FLAC container only, not FLAC-in-Ogg.
+`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only. `readWavInfo` supports the canonical RIFF/WAVE container only. `readId3Tags` decodes ID3v2.3/2.4 and ID3v1/1.1 only (ID3v2.2 is detected but not decoded). `readIcoInfo` reads .ico icon files only and rejects .cur cursor files. `readFlacInfo` reads the native FLAC container only, not FLAC-in-Ogg. `readVideoInfo` supports MP4 (ISO BMFF) and WebM (EBML/Matroska) containers only.
 
 ---
 
@@ -634,7 +641,7 @@ readFlacInfo(new Uint8Array(flacBytes));
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
 | `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect, vector similarity |
-| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info |
 
 ---
 

package/dist/{chunk-Q3M23WNJ.js → chunk-47DTCCQJ.js}

@@ -9,6 +9,7 @@ __export(media_exports, {
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
 function readU32BE(bytes, offset) {
@@ -860,5 +861,253 @@ function readFlacInfo(bytes) {
   }
   return result;
 }
+function readU64BE(bytes, offset) {
+  return readU32BE(bytes, offset) * 4294967296 + readU32BE(bytes, offset + 4);
+}
+function readMp4Boxes(bytes, start, end) {
+  const boxes = [];
+  let offset = start;
+  while (offset + 8 <= end) {
+    let size = readU32BE(bytes, offset);
+    const type = readAscii4(bytes, offset + 4);
+    let headerSize = 8;
+    if (size === 1) {
+      if (offset + 16 > end) break;
+      size = readU64BE(bytes, offset + 8);
+      headerSize = 16;
+    } else if (size === 0) {
+      size = end - offset;
+    }
+    if (size < headerSize || offset + size > end) break;
+    boxes.push({ type, start: offset + headerSize, end: offset + size });
+    offset += size;
+  }
+  return boxes;
+}
+function findMp4Box(boxes, type) {
+  return boxes.find((b) => b.type === type);
+}
+function parseMp4Mvhd(bytes, box) {
+  const o = box.start;
+  if (o >= box.end) return null;
+  const version = bytes[o];
+  if (version === 1) {
+    if (o + 32 > box.end) return null;
+    return { timescale: readU32BE(bytes, o + 20), duration: readU64BE(bytes, o + 24) };
+  }
+  if (o + 20 > box.end) return null;
+  return { timescale: readU32BE(bytes, o + 12), duration: readU32BE(bytes, o + 16) };
+}
+function parseMp4Tkhd(bytes, box) {
+  const o = box.start;
+  if (o >= box.end) return null;
+  const version = bytes[o];
+  const fixedFieldsSize = version === 1 ? 4 + 8 + 8 + 4 + 4 + 8 : 4 + 4 + 4 + 4 + 4 + 4;
+  const afterDuration = o + fixedFieldsSize;
+  const matrixStart = afterDuration + 8 + 2 + 2 + 2 + 2;
+  const widthOffset = matrixStart + 36;
+  if (widthOffset + 8 > box.end) return null;
+  return { width: readU32BE(bytes, widthOffset) / 65536, height: readU32BE(bytes, widthOffset + 4) / 65536 };
+}
+function parseMp4Hdlr(bytes, box) {
+  const o = box.start;
+  if (o + 12 > box.end) return null;
+  return readAscii4(bytes, o + 8);
+}
+function parseMp4StsdCodec(bytes, box) {
+  const o = box.start;
+  if (o + 8 > box.end) return null;
+  const entryCount = readU32BE(bytes, o + 4);
+  if (entryCount < 1) return null;
+  const entryStart = o + 8;
+  if (entryStart + 8 > box.end) return null;
+  return readAscii4(bytes, entryStart + 4);
+}
+function parseMp4StsdVideoDims(bytes, box) {
+  const o = box.start;
+  if (o + 8 > box.end) return null;
+  const entryCount = readU32BE(bytes, o + 4);
+  if (entryCount < 1) return null;
+  const entryStart = o + 8;
+  if (entryStart + 36 > box.end) return null;
+  return {
+    width: bytes[entryStart + 32] << 8 | bytes[entryStart + 33],
+    height: bytes[entryStart + 34] << 8 | bytes[entryStart + 35]
+  };
+}
+function parseMp4(bytes) {
+  const topBoxes = readMp4Boxes(bytes, 0, bytes.length);
+  const ftyp = findMp4Box(topBoxes, "ftyp");
+  const moov = findMp4Box(topBoxes, "moov");
+  if (!moov) return { error: "No moov box found (not a valid or fully-downloaded MP4 file)" };
+  const result = { format: "mp4" };
+  if (ftyp && ftyp.start + 4 <= ftyp.end) result.majorBrand = readAscii4(bytes, ftyp.start);
+  const moovBoxes = readMp4Boxes(bytes, moov.start, moov.end);
+  const mvhd = findMp4Box(moovBoxes, "mvhd");
+  if (mvhd) {
+    const info = parseMp4Mvhd(bytes, mvhd);
+    if (info && info.timescale > 0) result.durationSeconds = Math.round(info.duration / info.timescale * 1e3) / 1e3;
+  }
+  for (const trak of moovBoxes.filter((b) => b.type === "trak")) {
+    const trakBoxes = readMp4Boxes(bytes, trak.start, trak.end);
+    const mdia = findMp4Box(trakBoxes, "mdia");
+    if (!mdia) continue;
+    const mdiaBoxes = readMp4Boxes(bytes, mdia.start, mdia.end);
+    const hdlr = findMp4Box(mdiaBoxes, "hdlr");
+    const handlerType = hdlr ? parseMp4Hdlr(bytes, hdlr) : null;
+    const minf = findMp4Box(mdiaBoxes, "minf");
+    if (!minf) continue;
+    const stbl = findMp4Box(readMp4Boxes(bytes, minf.start, minf.end), "stbl");
+    if (!stbl) continue;
+    const stsd = findMp4Box(readMp4Boxes(bytes, stbl.start, stbl.end), "stsd");
+    const codec = stsd ? parseMp4StsdCodec(bytes, stsd) : null;
+    if (handlerType === "vide") {
+      if (codec) result.videoCodec = codec;
+      const tkhd = findMp4Box(trakBoxes, "tkhd");
+      const dims = tkhd ? parseMp4Tkhd(bytes, tkhd) : null;
+      if (dims && dims.width > 0 && dims.height > 0) {
+        result.width = Math.round(dims.width);
+        result.height = Math.round(dims.height);
+      } else if (stsd) {
+        const pixelDims = parseMp4StsdVideoDims(bytes, stsd);
+        if (pixelDims && pixelDims.width > 0 && pixelDims.height > 0) {
+          result.width = pixelDims.width;
+          result.height = pixelDims.height;
+        }
+      }
+    } else if (handlerType === "soun") {
+      if (codec) result.audioCodec = codec;
+    }
+  }
+  if (result.durationSeconds === void 0 && !result.videoCodec && !result.audioCodec) {
+    return { error: "Could not find any usable track metadata in this MP4 file's moov box" };
+  }
+  return result;
+}
+function ebmlVintLength(firstByte) {
+  if (firstByte === 0) return 0;
+  let mask = 128;
+  let length = 1;
+  while (length <= 8 && (firstByte & mask) === 0) {
+    mask >>= 1;
+    length++;
+  }
+  return length;
+}
+function readEbmlId(bytes, offset) {
+  if (offset >= bytes.length) return null;
+  const length = ebmlVintLength(bytes[offset]);
+  if (length === 0 || offset + length > bytes.length) return null;
+  let id = 0;
+  for (let i = 0; i < length; i++) id = id * 256 + bytes[offset + i];
+  return { id, length };
+}
+function readEbmlSize(bytes, offset) {
+  if (offset >= bytes.length) return null;
+  const length = ebmlVintLength(bytes[offset]);
+  if (length === 0 || offset + length > bytes.length) return null;
+  const mask = 255 >> length;
+  let value = bytes[offset] & mask;
+  let allOnes = value === mask;
+  for (let i = 1; i < length; i++) {
+    value = value * 256 + bytes[offset + i];
+    if (bytes[offset + i] !== 255) allOnes = false;
+  }
+  return { value, length, unknown: allOnes };
+}
+function readEbmlUint(bytes, offset, length) {
+  let value = 0;
+  for (let i = 0; i < length; i++) value = value * 256 + bytes[offset + i];
+  return value;
+}
+function readEbmlFloat(bytes, offset, length) {
+  if (offset + length > bytes.length) return 0;
+  const view = new DataView(bytes.buffer, bytes.byteOffset + offset, length);
+  if (length === 4) return view.getFloat32(0, false);
+  if (length === 8) return view.getFloat64(0, false);
+  return 0;
+}
+function ebmlChildren(bytes, start, end) {
+  const children = [];
+  let offset = start;
+  while (offset < end) {
+    const idInfo = readEbmlId(bytes, offset);
+    if (!idInfo) break;
+    const sizeInfo = readEbmlSize(bytes, offset + idInfo.length);
+    if (!sizeInfo) break;
+    const dataStart = offset + idInfo.length + sizeInfo.length;
+    const dataEnd = sizeInfo.unknown ? end : Math.min(dataStart + sizeInfo.value, end);
+    children.push({ id: idInfo.id, dataStart, dataEnd });
+    offset = dataEnd;
+  }
+  return children;
+}
+var EBML_ID_SEGMENT = 408125543;
+var EBML_ID_INFO = 357149030;
+var EBML_ID_TIMECODE_SCALE = 2807729;
+var EBML_ID_DURATION = 17545;
+var EBML_ID_TRACKS = 374648427;
+var EBML_ID_TRACK_ENTRY = 174;
+var EBML_ID_TRACK_TYPE = 131;
+var EBML_ID_CODEC_ID = 134;
+var EBML_ID_VIDEO = 224;
+var EBML_ID_PIXEL_WIDTH = 176;
+var EBML_ID_PIXEL_HEIGHT = 186;
+var EBML_ID_CLUSTER = 524531317;
+function readVideoInfo(bytes) {
+  if (bytes.length < 12) return { error: "File is too small to be a valid video file" };
+  if (readAscii4(bytes, 4) === "ftyp") return parseMp4(bytes);
+  if (bytes[0] === 26 && bytes[1] === 69 && bytes[2] === 223 && bytes[3] === 163) return parseWebm(bytes);
+  return { error: 'Not a recognized MP4 or WebM file (missing an "ftyp" box or an EBML header signature)' };
+}
+function parseWebm(bytes) {
+  const top = ebmlChildren(bytes, 0, bytes.length);
+  const segment = top.find((c) => c.id === EBML_ID_SEGMENT);
+  if (!segment) return { error: "No Segment element found (not a valid WebM/Matroska file)" };
+  const result = { format: "webm" };
+  let timecodeScale = 1e6;
+  let rawDuration;
+  for (const child of ebmlChildren(bytes, segment.dataStart, segment.dataEnd)) {
+    if (child.id === EBML_ID_CLUSTER) break;
+    if (child.id === EBML_ID_INFO) {
+      for (const f of ebmlChildren(bytes, child.dataStart, child.dataEnd)) {
+        if (f.id === EBML_ID_TIMECODE_SCALE) timecodeScale = readEbmlUint(bytes, f.dataStart, f.dataEnd - f.dataStart) || 1e6;
+        else if (f.id === EBML_ID_DURATION) rawDuration = readEbmlFloat(bytes, f.dataStart, f.dataEnd - f.dataStart);
+      }
+    } else if (child.id === EBML_ID_TRACKS) {
+      for (const entry of ebmlChildren(bytes, child.dataStart, child.dataEnd)) {
+        if (entry.id !== EBML_ID_TRACK_ENTRY) continue;
+        let trackType;
+        let codecId;
+        let pixelWidth;
+        let pixelHeight;
+        for (const f of ebmlChildren(bytes, entry.dataStart, entry.dataEnd)) {
+          if (f.id === EBML_ID_TRACK_TYPE) trackType = readEbmlUint(bytes, f.dataStart, f.dataEnd - f.dataStart);
+          else if (f.id === EBML_ID_CODEC_ID) codecId = Buffer.from(bytes.subarray(f.dataStart, f.dataEnd)).toString("ascii").replace(/\0+$/, "");
+          else if (f.id === EBML_ID_VIDEO) {
+            for (const v of ebmlChildren(bytes, f.dataStart, f.dataEnd)) {
+              if (v.id === EBML_ID_PIXEL_WIDTH) pixelWidth = readEbmlUint(bytes, v.dataStart, v.dataEnd - v.dataStart);
+              else if (v.id === EBML_ID_PIXEL_HEIGHT) pixelHeight = readEbmlUint(bytes, v.dataStart, v.dataEnd - v.dataStart);
+            }
+          }
+        }
+        if (trackType === 1) {
+          if (codecId) result.videoCodec = codecId;
+          if (pixelWidth) result.width = pixelWidth;
+          if (pixelHeight) result.height = pixelHeight;
+        } else if (trackType === 2) {
+          if (codecId) result.audioCodec = codecId;
+        }
+      }
+    }
+  }
+  if (rawDuration !== void 0 && timecodeScale > 0) {
+    result.durationSeconds = Math.round(rawDuration * timecodeScale / 1e9 * 1e3) / 1e3;
+  }
+  if (result.durationSeconds === void 0 && !result.videoCodec && !result.audioCodec) {
+    return { error: "Could not find any usable metadata in this WebM file's Segment element" };
+  }
+  return result;
+}
 
-export { media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo };
+export { media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readVideoInfo, readWavInfo };

package/dist/index.cjs

@@ -19237,6 +19237,7 @@ __export(media_exports, {
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
 function readU32BE(bytes, offset) {
@@ -20088,6 +20089,254 @@ function readFlacInfo(bytes) {
   }
   return result;
 }
+function readU64BE(bytes, offset) {
+  return readU32BE(bytes, offset) * 4294967296 + readU32BE(bytes, offset + 4);
+}
+function readMp4Boxes(bytes, start, end) {
+  const boxes = [];
+  let offset = start;
+  while (offset + 8 <= end) {
+    let size = readU32BE(bytes, offset);
+    const type = readAscii4(bytes, offset + 4);
+    let headerSize = 8;
+    if (size === 1) {
+      if (offset + 16 > end) break;
+      size = readU64BE(bytes, offset + 8);
+      headerSize = 16;
+    } else if (size === 0) {
+      size = end - offset;
+    }
+    if (size < headerSize || offset + size > end) break;
+    boxes.push({ type, start: offset + headerSize, end: offset + size });
+    offset += size;
+  }
+  return boxes;
+}
+function findMp4Box(boxes, type) {
+  return boxes.find((b) => b.type === type);
+}
+function parseMp4Mvhd(bytes, box) {
+  const o = box.start;
+  if (o >= box.end) return null;
+  const version2 = bytes[o];
+  if (version2 === 1) {
+    if (o + 32 > box.end) return null;
+    return { timescale: readU32BE(bytes, o + 20), duration: readU64BE(bytes, o + 24) };
+  }
+  if (o + 20 > box.end) return null;
+  return { timescale: readU32BE(bytes, o + 12), duration: readU32BE(bytes, o + 16) };
+}
+function parseMp4Tkhd(bytes, box) {
+  const o = box.start;
+  if (o >= box.end) return null;
+  const version2 = bytes[o];
+  const fixedFieldsSize = version2 === 1 ? 4 + 8 + 8 + 4 + 4 + 8 : 4 + 4 + 4 + 4 + 4 + 4;
+  const afterDuration = o + fixedFieldsSize;
+  const matrixStart = afterDuration + 8 + 2 + 2 + 2 + 2;
+  const widthOffset = matrixStart + 36;
+  if (widthOffset + 8 > box.end) return null;
+  return { width: readU32BE(bytes, widthOffset) / 65536, height: readU32BE(bytes, widthOffset + 4) / 65536 };
+}
+function parseMp4Hdlr(bytes, box) {
+  const o = box.start;
+  if (o + 12 > box.end) return null;
+  return readAscii4(bytes, o + 8);
+}
+function parseMp4StsdCodec(bytes, box) {
+  const o = box.start;
+  if (o + 8 > box.end) return null;
+  const entryCount = readU32BE(bytes, o + 4);
+  if (entryCount < 1) return null;
+  const entryStart = o + 8;
+  if (entryStart + 8 > box.end) return null;
+  return readAscii4(bytes, entryStart + 4);
+}
+function parseMp4StsdVideoDims(bytes, box) {
+  const o = box.start;
+  if (o + 8 > box.end) return null;
+  const entryCount = readU32BE(bytes, o + 4);
+  if (entryCount < 1) return null;
+  const entryStart = o + 8;
+  if (entryStart + 36 > box.end) return null;
+  return {
+    width: bytes[entryStart + 32] << 8 | bytes[entryStart + 33],
+    height: bytes[entryStart + 34] << 8 | bytes[entryStart + 35]
+  };
+}
+function parseMp4(bytes) {
+  const topBoxes = readMp4Boxes(bytes, 0, bytes.length);
+  const ftyp = findMp4Box(topBoxes, "ftyp");
+  const moov = findMp4Box(topBoxes, "moov");
+  if (!moov) return { error: "No moov box found (not a valid or fully-downloaded MP4 file)" };
+  const result = { format: "mp4" };
+  if (ftyp && ftyp.start + 4 <= ftyp.end) result.majorBrand = readAscii4(bytes, ftyp.start);
+  const moovBoxes = readMp4Boxes(bytes, moov.start, moov.end);
+  const mvhd = findMp4Box(moovBoxes, "mvhd");
+  if (mvhd) {
+    const info = parseMp4Mvhd(bytes, mvhd);
+    if (info && info.timescale > 0) result.durationSeconds = Math.round(info.duration / info.timescale * 1e3) / 1e3;
+  }
+  for (const trak of moovBoxes.filter((b) => b.type === "trak")) {
+    const trakBoxes = readMp4Boxes(bytes, trak.start, trak.end);
+    const mdia = findMp4Box(trakBoxes, "mdia");
+    if (!mdia) continue;
+    const mdiaBoxes = readMp4Boxes(bytes, mdia.start, mdia.end);
+    const hdlr = findMp4Box(mdiaBoxes, "hdlr");
+    const handlerType = hdlr ? parseMp4Hdlr(bytes, hdlr) : null;
+    const minf = findMp4Box(mdiaBoxes, "minf");
+    if (!minf) continue;
+    const stbl = findMp4Box(readMp4Boxes(bytes, minf.start, minf.end), "stbl");
+    if (!stbl) continue;
+    const stsd = findMp4Box(readMp4Boxes(bytes, stbl.start, stbl.end), "stsd");
+    const codec = stsd ? parseMp4StsdCodec(bytes, stsd) : null;
+    if (handlerType === "vide") {
+      if (codec) result.videoCodec = codec;
+      const tkhd = findMp4Box(trakBoxes, "tkhd");
+      const dims = tkhd ? parseMp4Tkhd(bytes, tkhd) : null;
+      if (dims && dims.width > 0 && dims.height > 0) {
+        result.width = Math.round(dims.width);
+        result.height = Math.round(dims.height);
+      } else if (stsd) {
+        const pixelDims = parseMp4StsdVideoDims(bytes, stsd);
+        if (pixelDims && pixelDims.width > 0 && pixelDims.height > 0) {
+          result.width = pixelDims.width;
+          result.height = pixelDims.height;
+        }
+      }
+    } else if (handlerType === "soun") {
+      if (codec) result.audioCodec = codec;
+    }
+  }
+  if (result.durationSeconds === void 0 && !result.videoCodec && !result.audioCodec) {
+    return { error: "Could not find any usable track metadata in this MP4 file's moov box" };
+  }
+  return result;
+}
+function ebmlVintLength(firstByte) {
+  if (firstByte === 0) return 0;
+  let mask = 128;
+  let length = 1;
+  while (length <= 8 && (firstByte & mask) === 0) {
+    mask >>= 1;
+    length++;
+  }
+  return length;
+}
+function readEbmlId(bytes, offset) {
+  if (offset >= bytes.length) return null;
+  const length = ebmlVintLength(bytes[offset]);
+  if (length === 0 || offset + length > bytes.length) return null;
+  let id = 0;
+  for (let i = 0; i < length; i++) id = id * 256 + bytes[offset + i];
+  return { id, length };
+}
+function readEbmlSize(bytes, offset) {
+  if (offset >= bytes.length) return null;
+  const length = ebmlVintLength(bytes[offset]);
+  if (length === 0 || offset + length > bytes.length) return null;
+  const mask = 255 >> length;
+  let value = bytes[offset] & mask;
+  let allOnes = value === mask;
+  for (let i = 1; i < length; i++) {
+    value = value * 256 + bytes[offset + i];
+    if (bytes[offset + i] !== 255) allOnes = false;
+  }
+  return { value, length, unknown: allOnes };
+}
+function readEbmlUint(bytes, offset, length) {
+  let value = 0;
+  for (let i = 0; i < length; i++) value = value * 256 + bytes[offset + i];
+  return value;
+}
+function readEbmlFloat(bytes, offset, length) {
+  if (offset + length > bytes.length) return 0;
+  const view = new DataView(bytes.buffer, bytes.byteOffset + offset, length);
+  if (length === 4) return view.getFloat32(0, false);
+  if (length === 8) return view.getFloat64(0, false);
+  return 0;
+}
+function ebmlChildren(bytes, start, end) {
+  const children = [];
+  let offset = start;
+  while (offset < end) {
+    const idInfo = readEbmlId(bytes, offset);
+    if (!idInfo) break;
+    const sizeInfo = readEbmlSize(bytes, offset + idInfo.length);
+    if (!sizeInfo) break;
+    const dataStart = offset + idInfo.length + sizeInfo.length;
+    const dataEnd = sizeInfo.unknown ? end : Math.min(dataStart + sizeInfo.value, end);
+    children.push({ id: idInfo.id, dataStart, dataEnd });
+    offset = dataEnd;
+  }
+  return children;
+}
+var EBML_ID_SEGMENT = 408125543;
+var EBML_ID_INFO = 357149030;
+var EBML_ID_TIMECODE_SCALE = 2807729;
+var EBML_ID_DURATION = 17545;
+var EBML_ID_TRACKS = 374648427;
+var EBML_ID_TRACK_ENTRY = 174;
+var EBML_ID_TRACK_TYPE = 131;
+var EBML_ID_CODEC_ID = 134;
+var EBML_ID_VIDEO = 224;
+var EBML_ID_PIXEL_WIDTH = 176;
+var EBML_ID_PIXEL_HEIGHT = 186;
+var EBML_ID_CLUSTER = 524531317;
+function readVideoInfo(bytes) {
+  if (bytes.length < 12) return { error: "File is too small to be a valid video file" };
+  if (readAscii4(bytes, 4) === "ftyp") return parseMp4(bytes);
+  if (bytes[0] === 26 && bytes[1] === 69 && bytes[2] === 223 && bytes[3] === 163) return parseWebm(bytes);
+  return { error: 'Not a recognized MP4 or WebM file (missing an "ftyp" box or an EBML header signature)' };
+}
+function parseWebm(bytes) {
+  const top = ebmlChildren(bytes, 0, bytes.length);
+  const segment = top.find((c) => c.id === EBML_ID_SEGMENT);
+  if (!segment) return { error: "No Segment element found (not a valid WebM/Matroska file)" };
+  const result = { format: "webm" };
+  let timecodeScale = 1e6;
+  let rawDuration;
+  for (const child of ebmlChildren(bytes, segment.dataStart, segment.dataEnd)) {
+    if (child.id === EBML_ID_CLUSTER) break;
+    if (child.id === EBML_ID_INFO) {
+      for (const f of ebmlChildren(bytes, child.dataStart, child.dataEnd)) {
+        if (f.id === EBML_ID_TIMECODE_SCALE) timecodeScale = readEbmlUint(bytes, f.dataStart, f.dataEnd - f.dataStart) || 1e6;
+        else if (f.id === EBML_ID_DURATION) rawDuration = readEbmlFloat(bytes, f.dataStart, f.dataEnd - f.dataStart);
+      }
+    } else if (child.id === EBML_ID_TRACKS) {
+      for (const entry of ebmlChildren(bytes, child.dataStart, child.dataEnd)) {
+        if (entry.id !== EBML_ID_TRACK_ENTRY) continue;
+        let trackType;
+        let codecId;
+        let pixelWidth;
+        let pixelHeight;
+        for (const f of ebmlChildren(bytes, entry.dataStart, entry.dataEnd)) {
+          if (f.id === EBML_ID_TRACK_TYPE) trackType = readEbmlUint(bytes, f.dataStart, f.dataEnd - f.dataStart);
+          else if (f.id === EBML_ID_CODEC_ID) codecId = Buffer.from(bytes.subarray(f.dataStart, f.dataEnd)).toString("ascii").replace(/\0+$/, "");
+          else if (f.id === EBML_ID_VIDEO) {
+            for (const v of ebmlChildren(bytes, f.dataStart, f.dataEnd)) {
+              if (v.id === EBML_ID_PIXEL_WIDTH) pixelWidth = readEbmlUint(bytes, v.dataStart, v.dataEnd - v.dataStart);
+              else if (v.id === EBML_ID_PIXEL_HEIGHT) pixelHeight = readEbmlUint(bytes, v.dataStart, v.dataEnd - v.dataStart);
+            }
+          }
+        }
+        if (trackType === 1) {
+          if (codecId) result.videoCodec = codecId;
+          if (pixelWidth) result.width = pixelWidth;
+          if (pixelHeight) result.height = pixelHeight;
+        } else if (trackType === 2) {
+          if (codecId) result.audioCodec = codecId;
+        }
+      }
+    }
+  }
+  if (rawDuration !== void 0 && timecodeScale > 0) {
+    result.durationSeconds = Math.round(rawDuration * timecodeScale / 1e9 * 1e3) / 1e3;
+  }
+  if (result.durationSeconds === void 0 && !result.videoCodec && !result.audioCodec) {
+    return { error: "Could not find any usable metadata in this WebM file's Segment element" };
+  }
+  return result;
+}
 
 // src/index.ts
 var version = "0.1.0";

package/dist/index.d.cts

@@ -13,7 +13,7 @@ export { c as color } from './color-tPwZCr9H.cjs';
 export { c as css } from './css-Cf7AMGM-.cjs';
 export { m as misc } from './misc-CA3N198T.cjs';
 export { a as ai_agent } from './ai_agent-B-c59NXD.cjs';
-export { m as media } from './media-CN17a3MM.cjs';
+export { m as media } from './media-cuxfzXxw.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { c as color } from './color-tPwZCr9H.js';
 export { c as css } from './css-Cf7AMGM-.js';
 export { m as misc } from './misc-CA3N198T.js';
 export { a as ai_agent } from './ai_agent-B-c59NXD.js';
-export { m as media } from './media-CN17a3MM.js';
+export { m as media } from './media-cuxfzXxw.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,4 +1,4 @@
-export { media_exports as media } from './chunk-Q3M23WNJ.js';
+export { media_exports as media } from './chunk-47DTCCQJ.js';
 export { units_exports as units } from './chunk-I63BCOAG.js';
 export { network_exports as network } from './chunk-Y5OOP6WN.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';

package/dist/{media-CN17a3MM.d.cts → media-cuxfzXxw.d.cts}

@@ -160,6 +160,25 @@ interface FlacInfoError {
  * metadata-block headers. No audio frame decoding is performed.
  */
 declare function readFlacInfo(bytes: Uint8Array): FlacInfo | FlacInfoError;
+interface VideoInfo {
+    format: 'mp4' | 'webm';
+    durationSeconds?: number;
+    width?: number;
+    height?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+    majorBrand?: string;
+}
+interface VideoInfoError {
+    error: string;
+}
+/**
+ * Read an MP4 (ISO BMFF) or WebM (EBML/Matroska) container's header boxes
+ * to report duration, resolution, and video/audio codec identifiers.
+ * No frame decoding, demuxing of sample data, or transcoding is performed;
+ * only the moov box (MP4) or Segment/Info/Tracks elements (WebM) are read.
+ */
+declare function readVideoInfo(bytes: Uint8Array): VideoInfo | VideoInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
@@ -175,6 +194,8 @@ type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+type media_VideoInfo = VideoInfo;
+type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
 type media_WavInfoError = WavInfoError;
 declare const media_readExifData: typeof readExifData;
@@ -183,9 +204,10 @@ declare const media_readIcoInfo: typeof readIcoInfo;
 declare const media_readId3Tags: typeof readId3Tags;
 declare const media_readImageInfo: typeof readImageInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
+declare const media_readVideoInfo: typeof readVideoInfo;
 declare const media_readWavInfo: typeof readWavInfo;
 declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, type media_IcoImageEntry as IcoImageEntry, type media_IcoInfo as IcoInfo, type media_IcoInfoError as IcoInfoError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, type media_IcoImageEntry as IcoImageEntry, type media_IcoInfo as IcoInfo, type media_IcoInfoError as IcoInfoError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type WavInfoError as k, readFlacInfo as l, media as m, readIcoInfo as n, readId3Tags as o, readImageInfo as p, readPdfMetadata as q, readExifData as r, readWavInfo as s };
+export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type VideoInfoError as k, type WavInfoError as l, media as m, readFlacInfo as n, readIcoInfo as o, readId3Tags as p, readImageInfo as q, readExifData as r, readPdfMetadata as s, readVideoInfo as t, readWavInfo as u };

package/dist/{media-CN17a3MM.d.ts → media-cuxfzXxw.d.ts}

@@ -160,6 +160,25 @@ interface FlacInfoError {
  * metadata-block headers. No audio frame decoding is performed.
  */
 declare function readFlacInfo(bytes: Uint8Array): FlacInfo | FlacInfoError;
+interface VideoInfo {
+    format: 'mp4' | 'webm';
+    durationSeconds?: number;
+    width?: number;
+    height?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+    majorBrand?: string;
+}
+interface VideoInfoError {
+    error: string;
+}
+/**
+ * Read an MP4 (ISO BMFF) or WebM (EBML/Matroska) container's header boxes
+ * to report duration, resolution, and video/audio codec identifiers.
+ * No frame decoding, demuxing of sample data, or transcoding is performed;
+ * only the moov box (MP4) or Segment/Info/Tracks elements (WebM) are read.
+ */
+declare function readVideoInfo(bytes: Uint8Array): VideoInfo | VideoInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
@@ -175,6 +194,8 @@ type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+type media_VideoInfo = VideoInfo;
+type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
 type media_WavInfoError = WavInfoError;
 declare const media_readExifData: typeof readExifData;
@@ -183,9 +204,10 @@ declare const media_readIcoInfo: typeof readIcoInfo;
 declare const media_readId3Tags: typeof readId3Tags;
 declare const media_readImageInfo: typeof readImageInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
+declare const media_readVideoInfo: typeof readVideoInfo;
 declare const media_readWavInfo: typeof readWavInfo;
 declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, type media_IcoImageEntry as IcoImageEntry, type media_IcoInfo as IcoInfo, type media_IcoInfoError as IcoInfoError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, type media_IcoImageEntry as IcoImageEntry, type media_IcoInfo as IcoInfo, type media_IcoInfoError as IcoInfoError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type WavInfoError as k, readFlacInfo as l, media as m, readIcoInfo as n, readId3Tags as o, readImageInfo as p, readPdfMetadata as q, readExifData as r, readWavInfo as s };
+export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type VideoInfoError as k, type WavInfoError as l, media as m, readFlacInfo as n, readIcoInfo as o, readId3Tags as p, readImageInfo as q, readExifData as r, readPdfMetadata as s, readVideoInfo as t, readWavInfo as u };

package/dist/tools/media.cjs

@@ -850,6 +850,254 @@ function readFlacInfo(bytes) {
   }
   return result;
 }
+function readU64BE(bytes, offset) {
+  return readU32BE(bytes, offset) * 4294967296 + readU32BE(bytes, offset + 4);
+}
+function readMp4Boxes(bytes, start, end) {
+  const boxes = [];
+  let offset = start;
+  while (offset + 8 <= end) {
+    let size = readU32BE(bytes, offset);
+    const type = readAscii4(bytes, offset + 4);
+    let headerSize = 8;
+    if (size === 1) {
+      if (offset + 16 > end) break;
+      size = readU64BE(bytes, offset + 8);
+      headerSize = 16;
+    } else if (size === 0) {
+      size = end - offset;
+    }
+    if (size < headerSize || offset + size > end) break;
+    boxes.push({ type, start: offset + headerSize, end: offset + size });
+    offset += size;
+  }
+  return boxes;
+}
+function findMp4Box(boxes, type) {
+  return boxes.find((b) => b.type === type);
+}
+function parseMp4Mvhd(bytes, box) {
+  const o = box.start;
+  if (o >= box.end) return null;
+  const version = bytes[o];
+  if (version === 1) {
+    if (o + 32 > box.end) return null;
+    return { timescale: readU32BE(bytes, o + 20), duration: readU64BE(bytes, o + 24) };
+  }
+  if (o + 20 > box.end) return null;
+  return { timescale: readU32BE(bytes, o + 12), duration: readU32BE(bytes, o + 16) };
+}
+function parseMp4Tkhd(bytes, box) {
+  const o = box.start;
+  if (o >= box.end) return null;
+  const version = bytes[o];
+  const fixedFieldsSize = version === 1 ? 4 + 8 + 8 + 4 + 4 + 8 : 4 + 4 + 4 + 4 + 4 + 4;
+  const afterDuration = o + fixedFieldsSize;
+  const matrixStart = afterDuration + 8 + 2 + 2 + 2 + 2;
+  const widthOffset = matrixStart + 36;
+  if (widthOffset + 8 > box.end) return null;
+  return { width: readU32BE(bytes, widthOffset) / 65536, height: readU32BE(bytes, widthOffset + 4) / 65536 };
+}
+function parseMp4Hdlr(bytes, box) {
+  const o = box.start;
+  if (o + 12 > box.end) return null;
+  return readAscii4(bytes, o + 8);
+}
+function parseMp4StsdCodec(bytes, box) {
+  const o = box.start;
+  if (o + 8 > box.end) return null;
+  const entryCount = readU32BE(bytes, o + 4);
+  if (entryCount < 1) return null;
+  const entryStart = o + 8;
+  if (entryStart + 8 > box.end) return null;
+  return readAscii4(bytes, entryStart + 4);
+}
+function parseMp4StsdVideoDims(bytes, box) {
+  const o = box.start;
+  if (o + 8 > box.end) return null;
+  const entryCount = readU32BE(bytes, o + 4);
+  if (entryCount < 1) return null;
+  const entryStart = o + 8;
+  if (entryStart + 36 > box.end) return null;
+  return {
+    width: bytes[entryStart + 32] << 8 | bytes[entryStart + 33],
+    height: bytes[entryStart + 34] << 8 | bytes[entryStart + 35]
+  };
+}
+function parseMp4(bytes) {
+  const topBoxes = readMp4Boxes(bytes, 0, bytes.length);
+  const ftyp = findMp4Box(topBoxes, "ftyp");
+  const moov = findMp4Box(topBoxes, "moov");
+  if (!moov) return { error: "No moov box found (not a valid or fully-downloaded MP4 file)" };
+  const result = { format: "mp4" };
+  if (ftyp && ftyp.start + 4 <= ftyp.end) result.majorBrand = readAscii4(bytes, ftyp.start);
+  const moovBoxes = readMp4Boxes(bytes, moov.start, moov.end);
+  const mvhd = findMp4Box(moovBoxes, "mvhd");
+  if (mvhd) {
+    const info = parseMp4Mvhd(bytes, mvhd);
+    if (info && info.timescale > 0) result.durationSeconds = Math.round(info.duration / info.timescale * 1e3) / 1e3;
+  }
+  for (const trak of moovBoxes.filter((b) => b.type === "trak")) {
+    const trakBoxes = readMp4Boxes(bytes, trak.start, trak.end);
+    const mdia = findMp4Box(trakBoxes, "mdia");
+    if (!mdia) continue;
+    const mdiaBoxes = readMp4Boxes(bytes, mdia.start, mdia.end);
+    const hdlr = findMp4Box(mdiaBoxes, "hdlr");
+    const handlerType = hdlr ? parseMp4Hdlr(bytes, hdlr) : null;
+    const minf = findMp4Box(mdiaBoxes, "minf");
+    if (!minf) continue;
+    const stbl = findMp4Box(readMp4Boxes(bytes, minf.start, minf.end), "stbl");
+    if (!stbl) continue;
+    const stsd = findMp4Box(readMp4Boxes(bytes, stbl.start, stbl.end), "stsd");
+    const codec = stsd ? parseMp4StsdCodec(bytes, stsd) : null;
+    if (handlerType === "vide") {
+      if (codec) result.videoCodec = codec;
+      const tkhd = findMp4Box(trakBoxes, "tkhd");
+      const dims = tkhd ? parseMp4Tkhd(bytes, tkhd) : null;
+      if (dims && dims.width > 0 && dims.height > 0) {
+        result.width = Math.round(dims.width);
+        result.height = Math.round(dims.height);
+      } else if (stsd) {
+        const pixelDims = parseMp4StsdVideoDims(bytes, stsd);
+        if (pixelDims && pixelDims.width > 0 && pixelDims.height > 0) {
+          result.width = pixelDims.width;
+          result.height = pixelDims.height;
+        }
+      }
+    } else if (handlerType === "soun") {
+      if (codec) result.audioCodec = codec;
+    }
+  }
+  if (result.durationSeconds === void 0 && !result.videoCodec && !result.audioCodec) {
+    return { error: "Could not find any usable track metadata in this MP4 file's moov box" };
+  }
+  return result;
+}
+function ebmlVintLength(firstByte) {
+  if (firstByte === 0) return 0;
+  let mask = 128;
+  let length = 1;
+  while (length <= 8 && (firstByte & mask) === 0) {
+    mask >>= 1;
+    length++;
+  }
+  return length;
+}
+function readEbmlId(bytes, offset) {
+  if (offset >= bytes.length) return null;
+  const length = ebmlVintLength(bytes[offset]);
+  if (length === 0 || offset + length > bytes.length) return null;
+  let id = 0;
+  for (let i = 0; i < length; i++) id = id * 256 + bytes[offset + i];
+  return { id, length };
+}
+function readEbmlSize(bytes, offset) {
+  if (offset >= bytes.length) return null;
+  const length = ebmlVintLength(bytes[offset]);
+  if (length === 0 || offset + length > bytes.length) return null;
+  const mask = 255 >> length;
+  let value = bytes[offset] & mask;
+  let allOnes = value === mask;
+  for (let i = 1; i < length; i++) {
+    value = value * 256 + bytes[offset + i];
+    if (bytes[offset + i] !== 255) allOnes = false;
+  }
+  return { value, length, unknown: allOnes };
+}
+function readEbmlUint(bytes, offset, length) {
+  let value = 0;
+  for (let i = 0; i < length; i++) value = value * 256 + bytes[offset + i];
+  return value;
+}
+function readEbmlFloat(bytes, offset, length) {
+  if (offset + length > bytes.length) return 0;
+  const view = new DataView(bytes.buffer, bytes.byteOffset + offset, length);
+  if (length === 4) return view.getFloat32(0, false);
+  if (length === 8) return view.getFloat64(0, false);
+  return 0;
+}
+function ebmlChildren(bytes, start, end) {
+  const children = [];
+  let offset = start;
+  while (offset < end) {
+    const idInfo = readEbmlId(bytes, offset);
+    if (!idInfo) break;
+    const sizeInfo = readEbmlSize(bytes, offset + idInfo.length);
+    if (!sizeInfo) break;
+    const dataStart = offset + idInfo.length + sizeInfo.length;
+    const dataEnd = sizeInfo.unknown ? end : Math.min(dataStart + sizeInfo.value, end);
+    children.push({ id: idInfo.id, dataStart, dataEnd });
+    offset = dataEnd;
+  }
+  return children;
+}
+var EBML_ID_SEGMENT = 408125543;
+var EBML_ID_INFO = 357149030;
+var EBML_ID_TIMECODE_SCALE = 2807729;
+var EBML_ID_DURATION = 17545;
+var EBML_ID_TRACKS = 374648427;
+var EBML_ID_TRACK_ENTRY = 174;
+var EBML_ID_TRACK_TYPE = 131;
+var EBML_ID_CODEC_ID = 134;
+var EBML_ID_VIDEO = 224;
+var EBML_ID_PIXEL_WIDTH = 176;
+var EBML_ID_PIXEL_HEIGHT = 186;
+var EBML_ID_CLUSTER = 524531317;
+function readVideoInfo(bytes) {
+  if (bytes.length < 12) return { error: "File is too small to be a valid video file" };
+  if (readAscii4(bytes, 4) === "ftyp") return parseMp4(bytes);
+  if (bytes[0] === 26 && bytes[1] === 69 && bytes[2] === 223 && bytes[3] === 163) return parseWebm(bytes);
+  return { error: 'Not a recognized MP4 or WebM file (missing an "ftyp" box or an EBML header signature)' };
+}
+function parseWebm(bytes) {
+  const top = ebmlChildren(bytes, 0, bytes.length);
+  const segment = top.find((c) => c.id === EBML_ID_SEGMENT);
+  if (!segment) return { error: "No Segment element found (not a valid WebM/Matroska file)" };
+  const result = { format: "webm" };
+  let timecodeScale = 1e6;
+  let rawDuration;
+  for (const child of ebmlChildren(bytes, segment.dataStart, segment.dataEnd)) {
+    if (child.id === EBML_ID_CLUSTER) break;
+    if (child.id === EBML_ID_INFO) {
+      for (const f of ebmlChildren(bytes, child.dataStart, child.dataEnd)) {
+        if (f.id === EBML_ID_TIMECODE_SCALE) timecodeScale = readEbmlUint(bytes, f.dataStart, f.dataEnd - f.dataStart) || 1e6;
+        else if (f.id === EBML_ID_DURATION) rawDuration = readEbmlFloat(bytes, f.dataStart, f.dataEnd - f.dataStart);
+      }
+    } else if (child.id === EBML_ID_TRACKS) {
+      for (const entry of ebmlChildren(bytes, child.dataStart, child.dataEnd)) {
+        if (entry.id !== EBML_ID_TRACK_ENTRY) continue;
+        let trackType;
+        let codecId;
+        let pixelWidth;
+        let pixelHeight;
+        for (const f of ebmlChildren(bytes, entry.dataStart, entry.dataEnd)) {
+          if (f.id === EBML_ID_TRACK_TYPE) trackType = readEbmlUint(bytes, f.dataStart, f.dataEnd - f.dataStart);
+          else if (f.id === EBML_ID_CODEC_ID) codecId = Buffer.from(bytes.subarray(f.dataStart, f.dataEnd)).toString("ascii").replace(/\0+$/, "");
+          else if (f.id === EBML_ID_VIDEO) {
+            for (const v of ebmlChildren(bytes, f.dataStart, f.dataEnd)) {
+              if (v.id === EBML_ID_PIXEL_WIDTH) pixelWidth = readEbmlUint(bytes, v.dataStart, v.dataEnd - v.dataStart);
+              else if (v.id === EBML_ID_PIXEL_HEIGHT) pixelHeight = readEbmlUint(bytes, v.dataStart, v.dataEnd - v.dataStart);
+            }
+          }
+        }
+        if (trackType === 1) {
+          if (codecId) result.videoCodec = codecId;
+          if (pixelWidth) result.width = pixelWidth;
+          if (pixelHeight) result.height = pixelHeight;
+        } else if (trackType === 2) {
+          if (codecId) result.audioCodec = codecId;
+        }
+      }
+    }
+  }
+  if (rawDuration !== void 0 && timecodeScale > 0) {
+    result.durationSeconds = Math.round(rawDuration * timecodeScale / 1e9 * 1e3) / 1e3;
+  }
+  if (result.durationSeconds === void 0 && !result.videoCodec && !result.audioCodec) {
+    return { error: "Could not find any usable metadata in this WebM file's Segment element" };
+  }
+  return result;
+}
 
 exports.readExifData = readExifData;
 exports.readFlacInfo = readFlacInfo;
@@ -857,4 +1105,5 @@ exports.readIcoInfo = readIcoInfo;
 exports.readId3Tags = readId3Tags;
 exports.readImageInfo = readImageInfo;
 exports.readPdfMetadata = readPdfMetadata;
+exports.readVideoInfo = readVideoInfo;
 exports.readWavInfo = readWavInfo;

package/dist/tools/media.d.cts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, W as WavInfo, k as WavInfoError, r as readExifData, l as readFlacInfo, n as readIcoInfo, o as readId3Tags, p as readImageInfo, q as readPdfMetadata, s as readWavInfo } from '../media-CN17a3MM.cjs';
+export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, V as VideoInfo, k as VideoInfoError, W as WavInfo, l as WavInfoError, r as readExifData, n as readFlacInfo, o as readIcoInfo, p as readId3Tags, q as readImageInfo, s as readPdfMetadata, t as readVideoInfo, u as readWavInfo } from '../media-cuxfzXxw.cjs';

package/dist/tools/media.d.ts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, W as WavInfo, k as WavInfoError, r as readExifData, l as readFlacInfo, n as readIcoInfo, o as readId3Tags, p as readImageInfo, q as readPdfMetadata, s as readWavInfo } from '../media-CN17a3MM.js';
+export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, V as VideoInfo, k as VideoInfoError, W as WavInfo, l as WavInfoError, r as readExifData, n as readFlacInfo, o as readIcoInfo, p as readId3Tags, q as readImageInfo, s as readPdfMetadata, t as readVideoInfo, u as readWavInfo } from '../media-cuxfzXxw.js';

package/dist/tools/media.js

@@ -1,2 +1,2 @@
-export { readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo } from '../chunk-Q3M23WNJ.js';
+export { readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readVideoInfo, readWavInfo } from '../chunk-47DTCCQJ.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",