@utilix-tech/sdk 0.27.0 → 0.29.0

package/dist/index.cjs

@@ -8833,6 +8833,7 @@ __export(network_exports, {
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
+  parseIpv6Address: () => parseIpv6Address,
   parseUserAgent: () => parseUserAgent,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
@@ -10620,6 +10621,94 @@ function buildCacheControl(options = {}) {
   const snippet = `Cache-Control: ${header}`;
   return { header, headerName: "Cache-Control", snippet, directives, warnings };
 }
+function isValidIpv6HexGroup(g) {
+  return /^[0-9a-fA-F]{1,4}$/.test(g);
+}
+function isValidIpv6Ipv4Quad(quad) {
+  const parts = quad.split(".");
+  if (parts.length !== 4) return false;
+  return parts.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255);
+}
+function classifyIpv6(groups) {
+  const first = parseInt(groups[0], 16);
+  if (groups.every((g) => g === "0000")) return "unspecified";
+  if (groups.slice(0, 7).every((g) => g === "0000") && groups[7] === "0001") return "loopback";
+  if (groups.slice(0, 4).every((g) => g === "0000") && groups[4] === "0000" && groups[5] === "ffff") return "ipv4-mapped";
+  if (groups[0] === "2001" && groups[1] === "0db8") return "documentation";
+  if ((first & 65280) === 65280) return "multicast";
+  if ((first & 65472) === 65152) return "link-local";
+  if ((first & 65024) === 64512) return "unique-local";
+  return "global-unicast";
+}
+function compressIpv6Groups(groups) {
+  const short = groups.map((g) => g.replace(/^0+(?=.)/, ""));
+  let bestStart = -1;
+  let bestLen = 0;
+  let curStart = -1;
+  let curLen = 0;
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] === "0") {
+      if (curStart === -1) curStart = i;
+      curLen++;
+      if (curLen > bestLen) {
+        bestLen = curLen;
+        bestStart = curStart;
+      }
+    } else {
+      curStart = -1;
+      curLen = 0;
+    }
+  }
+  if (bestLen < 2) return short.join(":");
+  const before = short.slice(0, bestStart).join(":");
+  const after = short.slice(bestStart + bestLen).join(":");
+  return `${before}::${after}`;
+}
+function parseIpv6Address(input) {
+  let s = input.trim();
+  if (s.startsWith("[") && s.includes("]")) s = s.slice(1, s.indexOf("]"));
+  let zoneId = null;
+  const pctIdx = s.indexOf("%");
+  if (pctIdx !== -1) {
+    zoneId = s.slice(pctIdx + 1);
+    s = s.slice(0, pctIdx);
+  }
+  if (!s) return { error: "Empty address" };
+  const doubleColonCount = (s.match(/::/g) ?? []).length;
+  if (doubleColonCount > 1) return { error: 'Address contains more than one "::"' };
+  const ipv4Match = s.match(/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (ipv4Match) {
+    const quad = ipv4Match[1];
+    if (!isValidIpv6Ipv4Quad(quad)) return { error: `Invalid embedded IPv4 address: ${quad}` };
+    const parts = quad.split(".").map(Number);
+    const hi = (parts[0] << 8 | parts[1]).toString(16);
+    const lo = (parts[2] << 8 | parts[3]).toString(16);
+    s = s.slice(0, s.length - quad.length) + `${hi}:${lo}`;
+  }
+  let groups;
+  if (s.includes("::")) {
+    const [left, right] = s.split("::");
+    const leftGroups = left ? left.split(":") : [];
+    const rightGroups = right ? right.split(":") : [];
+    const missing = 8 - (leftGroups.length + rightGroups.length);
+    if (missing < 1) return { error: 'The "::" shorthand must represent at least one group of zeros' };
+    if (![...leftGroups, ...rightGroups].every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+    groups = [...leftGroups, ...Array(missing).fill("0"), ...rightGroups];
+  } else {
+    groups = s.split(":");
+    if (groups.length !== 8) return { error: `Expected 8 groups, got ${groups.length}` };
+    if (!groups.every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+  }
+  const expandedGroups = groups.map((g) => g.padStart(4, "0").toLowerCase());
+  const suffix = zoneId ? `%${zoneId}` : "";
+  return {
+    expanded: expandedGroups.join(":") + suffix,
+    compressed: compressIpv6Groups(expandedGroups) + suffix,
+    groups: expandedGroups,
+    zoneId,
+    addressType: classifyIpv6(expandedGroups)
+  };
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -19237,6 +19326,8 @@ __export(media_exports, {
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readPdfPageDimensions: () => readPdfPageDimensions,
+  readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
 function readU32BE(bytes, offset) {
@@ -19695,6 +19786,116 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var PDF_COMMON_PAPER_SIZES = [
+  { name: "Letter", widthPt: 612, heightPt: 792 },
+  { name: "Legal", widthPt: 612, heightPt: 1008 },
+  { name: "Tabloid", widthPt: 792, heightPt: 1224 },
+  { name: "A3", widthPt: 842, heightPt: 1191 },
+  { name: "A4", widthPt: 595, heightPt: 842 },
+  { name: "A5", widthPt: 420, heightPt: 595 },
+  { name: "B5", widthPt: 499, heightPt: 709 }
+];
+function matchPaperSize(widthPt, heightPt) {
+  for (const size of PDF_COMMON_PAPER_SIZES) {
+    const w = Math.abs(widthPt - size.widthPt) <= 1;
+    const h = Math.abs(heightPt - size.heightPt) <= 1;
+    const wSwapped = Math.abs(widthPt - size.heightPt) <= 1;
+    const hSwapped = Math.abs(heightPt - size.widthPt) <= 1;
+    if (w && h || wSwapped && hSwapped) return size.name;
+  }
+  return null;
+}
+function parsePdfMediaBox(dict) {
+  const m = dict.match(/\/MediaBox\s*\[\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s*\]/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+function parsePdfRotate(dict) {
+  const m = dict.match(/\/Rotate\s+(-?\d+)/);
+  return m ? Number(m[1]) : null;
+}
+function buildPdfPageDimension(pageNumber, mediaBox, rotate) {
+  const rotation = (rotate % 360 + 360) % 360;
+  if (!mediaBox) {
+    return { pageNumber, widthPt: null, heightPt: null, widthIn: null, heightIn: null, rotation, orientation: null, paperSize: null };
+  }
+  const [llx, lly, urx, ury] = mediaBox;
+  let widthPt = Math.abs(urx - llx);
+  let heightPt = Math.abs(ury - lly);
+  if (rotation === 90 || rotation === 270) [widthPt, heightPt] = [heightPt, widthPt];
+  const orientation = widthPt === heightPt ? "square" : widthPt > heightPt ? "landscape" : "portrait";
+  return {
+    pageNumber,
+    widthPt: round22(widthPt),
+    heightPt: round22(heightPt),
+    widthIn: round22(widthPt / 72),
+    heightIn: round22(heightPt / 72),
+    rotation,
+    orientation,
+    paperSize: matchPaperSize(widthPt, heightPt)
+  };
+}
+function walkPdfPageTree(objMap, nodeBody, inherited, visited, nodeKey, out) {
+  if (visited.has(nodeKey)) return;
+  visited.add(nodeKey);
+  const mediaBox = parsePdfMediaBox(nodeBody) ?? inherited.mediaBox;
+  const rotateMatch = parsePdfRotate(nodeBody);
+  const rotate = rotateMatch !== null ? rotateMatch : inherited.rotate;
+  if (/\/Type\s*\/Page(?!s)\b/.test(nodeBody)) {
+    out.push(buildPdfPageDimension(out.length + 1, mediaBox, rotate));
+    return;
+  }
+  const kidsMatch = nodeBody.match(/\/Kids\s*\[([^\]]*)\]/);
+  if (!kidsMatch) return;
+  const kidRefs = [...kidsMatch[1].matchAll(/(\d+)\s+(\d+)\s+R/g)];
+  for (const ref of kidRefs) {
+    const key = `${ref[1]} ${ref[2]}`;
+    const body = objMap.get(key);
+    if (body) walkPdfPageTree(objMap, body, { mediaBox, rotate }, visited, key, out);
+  }
+}
+function readPdfPageDimensions(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version2 = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  const objMap = /* @__PURE__ */ new Map();
+  for (const b of objBlocks) objMap.set(`${b[1]} ${b[2]}`, b[3]);
+  const out = [];
+  const visited = /* @__PURE__ */ new Set();
+  let pagesRootBody = null;
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    const rootRef = trailer.match(/\/Root\s+(\d+)\s+(\d+)\s+R/);
+    if (rootRef) {
+      const catalogBody = objMap.get(`${rootRef[1]} ${rootRef[2]}`);
+      const pagesRef = catalogBody?.match(/\/Pages\s+(\d+)\s+(\d+)\s+R/);
+      if (pagesRef) pagesRootBody = objMap.get(`${pagesRef[1]} ${pagesRef[2]}`) ?? null;
+    }
+  }
+  if (!pagesRootBody) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Pages\b/.test(b[3]) && !/\/Parent\s+\d+\s+\d+\s+R/.test(b[3])) {
+        pagesRootBody = b[3];
+        break;
+      }
+    }
+  }
+  if (pagesRootBody) walkPdfPageTree(objMap, pagesRootBody, { mediaBox: null, rotate: 0 }, visited, "root", out);
+  if (out.length === 0) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Page(?!s)\b/.test(b[3])) {
+        out.push(buildPdfPageDimension(out.length + 1, parsePdfMediaBox(b[3]), parsePdfRotate(b[3]) ?? 0));
+      }
+    }
+  }
+  if (out.length === 0) return { error: "Could not locate any page objects in this PDF" };
+  return { version: version2, pageCount: out.length, pages: out };
+}
 var AUDIO_FORMAT_LABELS = {
   1: "PCM",
   3: "IEEE float",
@@ -20088,6 +20289,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

@@ -6,14 +6,14 @@ export { d as data } from './data-XRb0D7Zn.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
 export { u as units } from './units-COt5uI20.cjs';
-export { n as network } from './network-BJOjJnmY.cjs';
+export { n as network } from './network-D7Epuerc.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-DaRvff2v.cjs';
 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-fD8dJ5qR.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -6,14 +6,14 @@ export { d as data } from './data-XRb0D7Zn.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-KqJjdqII.js';
 export { u as units } from './units-COt5uI20.js';
-export { n as network } from './network-BJOjJnmY.js';
+export { n as network } from './network-D7Epuerc.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-DaRvff2v.js';
 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-fD8dJ5qR.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,6 +1,6 @@
-export { media_exports as media } from './chunk-Q3M23WNJ.js';
+export { media_exports as media } from './chunk-L6V4W4SU.js';
 export { units_exports as units } from './chunk-I63BCOAG.js';
-export { network_exports as network } from './chunk-Y5OOP6WN.js';
+export { network_exports as network } from './chunk-CSNTHZHF.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-LXKIPPDG.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';

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

@@ -64,6 +64,29 @@ interface PdfMetadataError {
  * pdf.js or other PDF rendering library required.
  */
 declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
+type PdfPageOrientation = 'portrait' | 'landscape' | 'square' | null;
+interface PdfPageDimension {
+    pageNumber: number;
+    widthPt: number | null;
+    heightPt: number | null;
+    widthIn: number | null;
+    heightIn: number | null;
+    rotation: number;
+    orientation: PdfPageOrientation;
+    paperSize: string | null;
+}
+interface PdfPageDimensionsResult {
+    version: string | null;
+    pageCount: number;
+    pages: PdfPageDimension[];
+}
+/**
+ * List each page's MediaBox width/height (in points and inches), rotation,
+ * and orientation, in document order — walking the Root -> Pages -> Kids
+ * tree and inheriting /MediaBox / /Rotate from ancestor nodes the way the
+ * PDF spec requires. No PDF rendering library required.
+ */
+declare function readPdfPageDimensions(bytes: Uint8Array): PdfPageDimensionsResult | PdfMetadataError;
 interface WavInfo {
     audioFormat: number;
     audioFormatLabel: string;
@@ -160,6 +183,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 +217,11 @@ type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+type media_PdfPageDimension = PdfPageDimension;
+type media_PdfPageDimensionsResult = PdfPageDimensionsResult;
+type media_PdfPageOrientation = PdfPageOrientation;
+type media_VideoInfo = VideoInfo;
+type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
 type media_WavInfoError = WavInfoError;
 declare const media_readExifData: typeof readExifData;
@@ -183,9 +230,11 @@ 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_readPdfPageDimensions: typeof readPdfPageDimensions;
+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_PdfPageDimension as PdfPageDimension, type media_PdfPageDimensionsResult as PdfPageDimensionsResult, type media_PdfPageOrientation as PdfPageOrientation, 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_readPdfPageDimensions as readPdfPageDimensions, 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 PdfPageDimension as k, type PdfPageDimensionsResult as l, media as m, type PdfPageOrientation as n, type VideoInfoError as o, type WavInfoError as p, readFlacInfo as q, readExifData as r, readIcoInfo as s, readId3Tags as t, readImageInfo as u, readPdfMetadata as v, readPdfPageDimensions as w, readVideoInfo as x, readWavInfo as y };