@utilix-tech/sdk 0.26.0 → 0.28.0

package/dist/index.cjs

@@ -7154,6 +7154,7 @@ __export(units_exports, {
   calculateLoan: () => calculateLoan,
   calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
+  calculateRuleOf72: () => calculateRuleOf72,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
@@ -8771,6 +8772,39 @@ function calculateVideoBitrate(input) {
   }
   return { error: 'mode must be "size-from-bitrate" or "bitrate-from-size"' };
 }
+function calculateRuleOf72(value, direction) {
+  if (!Number.isFinite(value) || value <= 0) return { error: "Value must be a positive number" };
+  if (direction !== "rate-to-years" && direction !== "years-to-rate") {
+    return { error: 'Direction must be "rate-to-years" or "years-to-rate"' };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  if (direction === "rate-to-years") {
+    const ratePercent = value;
+    const ruleOf72Estimate2 = 72 / ratePercent;
+    const exactValue2 = Math.log(2) / Math.log(1 + ratePercent / 100);
+    const errorPercent2 = (ruleOf72Estimate2 - exactValue2) / exactValue2 * 100;
+    return {
+      direction,
+      ratePercent: round4(ratePercent),
+      years: round4(exactValue2),
+      ruleOf72Estimate: round4(ruleOf72Estimate2),
+      exactValue: round4(exactValue2),
+      errorPercent: round4(errorPercent2)
+    };
+  }
+  const years = value;
+  const ruleOf72Estimate = 72 / years;
+  const exactValue = (Math.pow(2, 1 / years) - 1) * 100;
+  const errorPercent = (ruleOf72Estimate - exactValue) / exactValue * 100;
+  return {
+    direction,
+    ratePercent: round4(exactValue),
+    years: round4(years),
+    ruleOf72Estimate: round4(ruleOf72Estimate),
+    exactValue: round4(exactValue),
+    errorPercent: round4(errorPercent)
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -19198,10 +19232,12 @@ function vectorSimilarity(a, b) {
 var media_exports = {};
 __export(media_exports, {
   readExifData: () => readExifData,
+  readFlacInfo: () => readFlacInfo,
   readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
 function readU32BE(bytes, offset) {
@@ -19958,6 +19994,349 @@ function readIcoInfo(bytes) {
   }
   return { imageCount: count, images };
 }
+var FLAC_TAG_FIELDS = {
+  TITLE: "title",
+  ARTIST: "artist",
+  ALBUM: "album",
+  DATE: "date",
+  GENRE: "genre",
+  TRACKNUMBER: "trackNumber"
+};
+function readU24BE(bytes, offset) {
+  return bytes[offset] << 16 | bytes[offset + 1] << 8 | bytes[offset + 2];
+}
+function readVorbisComment(bytes, start, end) {
+  let offset = start;
+  if (offset + 4 > end) return null;
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const vendorLength = view.getUint32(offset, true);
+  offset += 4;
+  if (offset + vendorLength > end) return null;
+  const vendor = Buffer.from(bytes.subarray(offset, offset + vendorLength)).toString("utf8");
+  offset += vendorLength;
+  if (offset + 4 > end) return null;
+  const commentCount = view.getUint32(offset, true);
+  offset += 4;
+  const tags = {};
+  for (let i = 0; i < commentCount; i++) {
+    if (offset + 4 > end) break;
+    const commentLength = view.getUint32(offset, true);
+    offset += 4;
+    if (offset + commentLength > end) break;
+    const comment = Buffer.from(bytes.subarray(offset, offset + commentLength)).toString("utf8");
+    offset += commentLength;
+    const eq = comment.indexOf("=");
+    if (eq > 0) {
+      const key = comment.slice(0, eq).toUpperCase();
+      const value = comment.slice(eq + 1);
+      tags[key] = value;
+    }
+  }
+  return { vendor, tags };
+}
+function readFlacInfo(bytes) {
+  if (bytes.length < 4) return { error: "File is too small to be a valid FLAC file" };
+  if (readAscii4(bytes, 0) !== "fLaC") return { error: 'Not a FLAC file (missing "fLaC" marker)' };
+  let offset = 4;
+  let streamInfo = null;
+  let vorbisComment = null;
+  while (offset + 4 <= bytes.length) {
+    const header = bytes[offset];
+    const isLast = (header & 128) !== 0;
+    const blockType = header & 127;
+    const length = readU24BE(bytes, offset + 1);
+    const dataStart = offset + 4;
+    const dataEnd = dataStart + length;
+    if (dataEnd > bytes.length) return { error: "Truncated metadata block" };
+    if (blockType === 0) {
+      if (length < 34) return { error: "Truncated STREAMINFO block" };
+      const minBlockSize = bytes[dataStart] << 8 | bytes[dataStart + 1];
+      const maxBlockSize = bytes[dataStart + 2] << 8 | bytes[dataStart + 3];
+      const minFrameSize = readU24BE(bytes, dataStart + 4);
+      const maxFrameSize = readU24BE(bytes, dataStart + 7);
+      let packed = 0n;
+      for (let i = 0; i < 8; i++) packed = packed << 8n | BigInt(bytes[dataStart + 10 + i]);
+      const sampleRate = Number(packed >> 44n & 0xfffffn);
+      const channels = Number(packed >> 41n & 0x7n) + 1;
+      const bitsPerSample = Number(packed >> 36n & 0x1fn) + 1;
+      const totalSamples = Number(packed & 0xfffffffffn);
+      if (sampleRate <= 0) return { error: "Invalid sample rate in STREAMINFO block" };
+      streamInfo = {
+        sampleRate,
+        channels,
+        bitsPerSample,
+        totalSamples,
+        durationSeconds: Math.round(totalSamples / sampleRate * 1e3) / 1e3,
+        minBlockSize,
+        maxBlockSize,
+        minFrameSize,
+        maxFrameSize
+      };
+    } else if (blockType === 4) {
+      vorbisComment = readVorbisComment(bytes, dataStart, dataEnd);
+    }
+    offset = dataEnd;
+    if (isLast) break;
+  }
+  if (!streamInfo) return { error: "No STREAMINFO block found in this FLAC file" };
+  const result = { ...streamInfo };
+  if (vorbisComment) {
+    result.vendor = vorbisComment.vendor;
+    result.tags = vorbisComment.tags;
+    for (const [key, field] of Object.entries(FLAC_TAG_FIELDS)) {
+      if (vorbisComment.tags[key] !== void 0) result[field] = vorbisComment.tags[key];
+    }
+  }
+  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

@@ -5,7 +5,7 @@ export { t as text } from './text-D1fySkCB.cjs';
 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-D2wEimKG.cjs';
+export { u as units } from './units-COt5uI20.cjs';
 export { n as network } from './network-BJOjJnmY.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-DaRvff2v.cjs';
@@ -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-9HEpTPGA.cjs';
+export { m as media } from './media-cuxfzXxw.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { t as text } from './text-D1fySkCB.js';
 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-D2wEimKG.js';
+export { u as units } from './units-COt5uI20.js';
 export { n as network } from './network-BJOjJnmY.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-DaRvff2v.js';
@@ -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-9HEpTPGA.js';
+export { m as media } from './media-cuxfzXxw.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,5 +1,5 @@
-export { media_exports as media } from './chunk-XMKJYVKB.js';
-export { units_exports as units } from './chunk-HP6C4VBX.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';
 export { code_exports as code } from './chunk-LXKIPPDG.js';

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

@@ -131,9 +131,59 @@ interface IcoInfoError {
  * the same container format but a different type flag.
  */
 declare function readIcoInfo(bytes: Uint8Array): IcoInfo | IcoInfoError;
+interface FlacInfo {
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+    totalSamples: number;
+    durationSeconds: number;
+    minBlockSize: number;
+    maxBlockSize: number;
+    minFrameSize: number;
+    maxFrameSize: number;
+    vendor?: string;
+    title?: string;
+    artist?: string;
+    album?: string;
+    date?: string;
+    genre?: string;
+    trackNumber?: string;
+    tags?: Record<string, string>;
+}
+interface FlacInfoError {
+    error: string;
+}
+/**
+ * Read a FLAC file's STREAMINFO metadata block (sample rate, channels, bit
+ * depth, total samples, duration) and, if present, its VORBIS_COMMENT block
+ * (vendor string and tags like ARTIST/TITLE/ALBUM), directly from the file's
+ * 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;
+type media_FlacInfo = FlacInfo;
+type media_FlacInfoError = FlacInfoError;
 type media_IcoImageEntry = IcoImageEntry;
 type media_IcoInfo = IcoInfo;
 type media_IcoInfoError = IcoInfoError;
@@ -144,16 +194,20 @@ 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;
+declare const media_readFlacInfo: typeof readFlacInfo;
 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_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_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 IcoImageEntry as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type IcoInfo as b, type IcoInfoError as c, type Id3Tags as d, type Id3TagsError as e, type ImageFormat as f, type ImageInfo as g, type ImageInfoError as h, type PdfMetadataError as i, type WavInfoError as j, readIcoInfo as k, readId3Tags as l, media as m, readImageInfo as n, readPdfMetadata as o, readWavInfo as p, readExifData as r };
+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-9HEpTPGA.d.ts → media-cuxfzXxw.d.ts}

@@ -131,9 +131,59 @@ interface IcoInfoError {
  * the same container format but a different type flag.
  */
 declare function readIcoInfo(bytes: Uint8Array): IcoInfo | IcoInfoError;
+interface FlacInfo {
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+    totalSamples: number;
+    durationSeconds: number;
+    minBlockSize: number;
+    maxBlockSize: number;
+    minFrameSize: number;
+    maxFrameSize: number;
+    vendor?: string;
+    title?: string;
+    artist?: string;
+    album?: string;
+    date?: string;
+    genre?: string;
+    trackNumber?: string;
+    tags?: Record<string, string>;
+}
+interface FlacInfoError {
+    error: string;
+}
+/**
+ * Read a FLAC file's STREAMINFO metadata block (sample rate, channels, bit
+ * depth, total samples, duration) and, if present, its VORBIS_COMMENT block
+ * (vendor string and tags like ARTIST/TITLE/ALBUM), directly from the file's
+ * 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;
+type media_FlacInfo = FlacInfo;
+type media_FlacInfoError = FlacInfoError;
 type media_IcoImageEntry = IcoImageEntry;
 type media_IcoInfo = IcoInfo;
 type media_IcoInfoError = IcoInfoError;
@@ -144,16 +194,20 @@ 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;
+declare const media_readFlacInfo: typeof readFlacInfo;
 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_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_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 IcoImageEntry as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type IcoInfo as b, type IcoInfoError as c, type Id3Tags as d, type Id3TagsError as e, type ImageFormat as f, type ImageInfo as g, type ImageInfoError as h, type PdfMetadataError as i, type WavInfoError as j, readIcoInfo as k, readId3Tags as l, media as m, readImageInfo as n, readPdfMetadata as o, readWavInfo as p, readExifData as r };
+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 };