@utilix-tech/sdk 0.69.0 → 0.71.0

package/dist/index.cjs

@@ -8581,6 +8581,7 @@ __export(units_exports, {
   calculateSavingsGoal: () => calculateSavingsGoal,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
+  calculateTaxEquivalentYield: () => calculateTaxEquivalentYield,
   calculateTimeValue: () => calculateTimeValue,
   calculateTipSplit: () => calculateTipSplit,
   calculateVideoBitrate: () => calculateVideoBitrate,
@@ -11037,6 +11038,45 @@ function calculateLoanRefinance(currentBalance, currentRatePercent, currentRemai
     totalInterestSavings: round2(current.totalInterest - refinanced.totalInterest)
   };
 }
+function calculateTaxEquivalentYield(inputYieldPercent, federalTaxRatePercent, stateTaxRatePercent = 0, direction) {
+  if (!Number.isFinite(inputYieldPercent) || inputYieldPercent < 0) {
+    return { error: "Yield must be zero or a positive number" };
+  }
+  if (!Number.isFinite(federalTaxRatePercent) || federalTaxRatePercent < 0 || federalTaxRatePercent >= 100) {
+    return { error: "Federal tax rate must be a percentage between 0 and 100 (exclusive of 100)" };
+  }
+  if (!Number.isFinite(stateTaxRatePercent) || stateTaxRatePercent < 0 || stateTaxRatePercent >= 100) {
+    return { error: "State tax rate must be a percentage between 0 and 100 (exclusive of 100)" };
+  }
+  if (direction !== "tax-free-to-taxable" && direction !== "taxable-to-tax-free") {
+    return { error: 'Direction must be "tax-free-to-taxable" or "taxable-to-tax-free"' };
+  }
+  const combinedTaxRatePercent = federalTaxRatePercent + stateTaxRatePercent;
+  if (combinedTaxRatePercent >= 100) {
+    return { error: "Combined federal and state tax rate must be less than 100%" };
+  }
+  const round6 = (n) => Math.round(n * 1e6) / 1e6;
+  const combinedRateDecimal = combinedTaxRatePercent / 100;
+  let taxFreeYield;
+  let taxableYield;
+  if (direction === "tax-free-to-taxable") {
+    taxFreeYield = inputYieldPercent;
+    taxableYield = taxFreeYield / (1 - combinedRateDecimal);
+  } else {
+    taxableYield = inputYieldPercent;
+    taxFreeYield = taxableYield * (1 - combinedRateDecimal);
+  }
+  return {
+    direction,
+    inputYield: round6(inputYieldPercent),
+    federalTaxRatePercent: round6(federalTaxRatePercent),
+    stateTaxRatePercent: round6(stateTaxRatePercent),
+    combinedTaxRatePercent: round6(combinedTaxRatePercent),
+    taxFreeYield: round6(taxFreeYield),
+    taxableYield: round6(taxableYield),
+    yieldDifference: round6(taxableYield - taxFreeYield)
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -14547,7 +14587,9 @@ __export(api_exports, {
   generateCors: () => generateCors,
   generateCspHeader: () => generateCspHeader,
   generateFullHeader: () => generateFullHeader,
+  generateHotp: () => generateHotp,
   generateMetaHtml: () => generateMetaHtml,
+  generateTotp: () => generateTotp,
   getParam: () => getParam,
   getStats: () => getStats,
   isValidUrl: () => isValidUrl,
@@ -15826,6 +15868,75 @@ function generateMetaHtml(tags) {
   }
   return lines.join("\n");
 }
+var OTP_ALG_TO_NODE_HASH = {
+  SHA1: "sha1",
+  SHA256: "sha256",
+  SHA512: "sha512"
+};
+function decodeBase32Secret(secret) {
+  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+  const cleaned = secret.toUpperCase().replace(/[\s=]/g, "");
+  if (!cleaned) {
+    return { error: "Secret must not be empty" };
+  }
+  const bytes = [];
+  let buffer = 0;
+  let bitsLeft = 0;
+  for (const char of cleaned) {
+    const val = alphabet.indexOf(char);
+    if (val === -1) {
+      return { error: `Invalid base32 character '${char}' in secret` };
+    }
+    buffer = buffer << 5 | val;
+    bitsLeft += 5;
+    if (bitsLeft >= 8) {
+      bitsLeft -= 8;
+      bytes.push(buffer >> bitsLeft & 255);
+    }
+  }
+  return Buffer.from(bytes);
+}
+function hotpFromCounter(keyBytes, counter, digits, algorithm) {
+  const counterBuffer = Buffer.alloc(8);
+  counterBuffer.writeUInt32BE(Math.floor(counter / 4294967296), 0);
+  counterBuffer.writeUInt32BE(counter % 4294967296, 4);
+  const hmac = crypto.createHmac(OTP_ALG_TO_NODE_HASH[algorithm], keyBytes).update(counterBuffer).digest();
+  const offset = hmac[hmac.length - 1] & 15;
+  const binCode = (hmac[offset] & 127) << 24 | (hmac[offset + 1] & 255) << 16 | (hmac[offset + 2] & 255) << 8 | hmac[offset + 3] & 255;
+  const code = (binCode % 10 ** digits).toString().padStart(digits, "0");
+  return code;
+}
+function generateHotp(secret, counter, options = {}) {
+  const digits = options.digits ?? 6;
+  const algorithm = options.algorithm ?? "SHA1";
+  if (!Number.isInteger(counter) || counter < 0) {
+    return { error: "Counter must be a non-negative whole number" };
+  }
+  if (!Number.isInteger(digits) || digits < 6 || digits > 8) {
+    return { error: "Digits must be an integer between 6 and 8" };
+  }
+  if (!(algorithm in OTP_ALG_TO_NODE_HASH)) {
+    return { error: "Algorithm must be one of SHA1, SHA256, SHA512" };
+  }
+  const keyBytes = decodeBase32Secret(secret);
+  if ("error" in keyBytes) return keyBytes;
+  return { code: hotpFromCounter(keyBytes, counter, digits, algorithm), counter, digits, algorithm };
+}
+function generateTotp(secret, options = {}) {
+  const periodSeconds = options.periodSeconds ?? 30;
+  const timestamp = options.timestamp ?? Math.floor(Date.now() / 1e3);
+  if (!Number.isFinite(periodSeconds) || periodSeconds <= 0) {
+    return { error: "Period must be a positive number of seconds" };
+  }
+  if (!Number.isFinite(timestamp) || timestamp < 0) {
+    return { error: "Timestamp must be a non-negative number of seconds" };
+  }
+  const counter = Math.floor(timestamp / periodSeconds);
+  const hotp = generateHotp(secret, counter, options);
+  if ("error" in hotp) return hotp;
+  const secondsRemaining = periodSeconds - timestamp % periodSeconds;
+  return { ...hotp, periodSeconds, secondsRemaining };
+}
 
 // src/tools/code.ts
 var code_exports = {};
@@ -24246,6 +24357,7 @@ __export(media_exports, {
   readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
+  readMidiInfo: () => readMidiInfo,
   readPdfMetadata: () => readPdfMetadata,
   readPdfPageDimensions: () => readPdfPageDimensions,
   readVideoInfo: () => readVideoInfo,
@@ -25543,6 +25655,136 @@ function inspectGifFrames(bytes) {
     hasTransparency
   };
 }
+function readU16BE(bytes, offset) {
+  return bytes[offset] << 8 | bytes[offset + 1];
+}
+function readMidiVarLen(bytes, pos) {
+  let value = 0;
+  let i = pos;
+  for (let n = 0; n < 4; n++) {
+    if (i >= bytes.length) return null;
+    const b = bytes[i];
+    value = value << 7 | b & 127;
+    i++;
+    if ((b & 128) === 0) return { value, next: i };
+  }
+  return null;
+}
+function readMidiInfo(bytes) {
+  if (bytes.length < 14) return { error: "File is too small to be a valid MIDI file" };
+  if (Buffer.from(bytes.subarray(0, 4)).toString("ascii") !== "MThd") {
+    return { error: 'Not a valid MIDI file (missing "MThd" header chunk)' };
+  }
+  const headerLength = readU32BE(bytes, 4);
+  if (headerLength < 6 || 8 + headerLength > bytes.length) return { error: "Truncated or invalid MThd header chunk" };
+  const format = readU16BE(bytes, 8);
+  if (format !== 0 && format !== 1 && format !== 2) return { error: `Unsupported MIDI format: ${format} (expected 0, 1, or 2)` };
+  const trackCount = readU16BE(bytes, 10);
+  if (trackCount < 1) return { error: "MIDI file declares zero tracks" };
+  const divisionRaw = readU16BE(bytes, 12);
+  const division = (divisionRaw & 32768) !== 0 ? { type: "smpte", framesPerSecond: -(divisionRaw >> 8 << 24 >> 24), ticksPerFrame: divisionRaw & 255 } : { type: "ppq", ticksPerQuarterNote: divisionRaw & 32767 };
+  const tracks = [];
+  const tempoChanges = [];
+  let timeSignature = null;
+  let maxEndTick = 0;
+  let offset = 8 + headerLength;
+  let tracksParsed = 0;
+  while (tracksParsed < trackCount && offset + 8 <= bytes.length) {
+    const chunkId = Buffer.from(bytes.subarray(offset, offset + 4)).toString("ascii");
+    const chunkLength = readU32BE(bytes, offset + 4);
+    const dataStart = offset + 8;
+    const dataEnd = Math.min(dataStart + chunkLength, bytes.length);
+    if (chunkId !== "MTrk") {
+      offset = dataEnd;
+      continue;
+    }
+    let pos = dataStart;
+    let runningStatus = 0;
+    let absoluteTick = 0;
+    let eventCount = 0;
+    let noteOnCount = 0;
+    let name = null;
+    while (pos < dataEnd) {
+      const delta = readMidiVarLen(bytes, pos);
+      if (!delta) break;
+      pos = delta.next;
+      absoluteTick += delta.value;
+      if (pos >= dataEnd) break;
+      let statusByte = bytes[pos];
+      if (statusByte & 128) {
+        runningStatus = statusByte;
+        pos++;
+      }
+      statusByte = runningStatus;
+      eventCount++;
+      if (statusByte === 255) {
+        const metaType = bytes[pos];
+        pos++;
+        const len = readMidiVarLen(bytes, pos);
+        if (!len) break;
+        pos = len.next;
+        const data = bytes.subarray(pos, Math.min(pos + len.value, dataEnd));
+        pos += len.value;
+        if (metaType === 81 && data.length >= 3) {
+          tempoChanges.push({ tick: absoluteTick, usPerQuarter: data[0] << 16 | data[1] << 8 | data[2] });
+        } else if (metaType === 88 && data.length >= 2) {
+          if (!timeSignature) timeSignature = { numerator: data[0], denominator: 2 ** data[1] };
+        } else if (metaType === 3 && name === null) {
+          name = Buffer.from(data).toString("utf8").trim() || null;
+        } else if (metaType === 47) {
+          break;
+        }
+      } else if (statusByte === 240 || statusByte === 247) {
+        const len = readMidiVarLen(bytes, pos);
+        if (!len) break;
+        pos = len.next + len.value;
+      } else if (statusByte >= 128) {
+        const type = statusByte & 240;
+        if (type === 192 || type === 208) {
+          pos += 1;
+        } else {
+          if (type === 144 && (bytes[pos + 1] ?? 0) > 0) noteOnCount++;
+          pos += 2;
+        }
+      } else {
+        break;
+      }
+    }
+    tracks.push({ index: tracksParsed, name, eventCount, noteOnCount });
+    maxEndTick = Math.max(maxEndTick, absoluteTick);
+    offset = dataEnd;
+    tracksParsed++;
+  }
+  if (tracks.length === 0) return { error: "No MTrk track chunks found in this MIDI file" };
+  const DEFAULT_US_PER_QUARTER = 5e5;
+  const initialTempoBpm = Math.round(6e7 / (tempoChanges[0]?.usPerQuarter ?? DEFAULT_US_PER_QUARTER) * 100) / 100;
+  let durationSeconds = null;
+  if (division.type === "smpte") {
+    const ticksPerSecond = division.framesPerSecond * division.ticksPerFrame;
+    durationSeconds = ticksPerSecond > 0 ? Math.round(maxEndTick / ticksPerSecond * 1e3) / 1e3 : null;
+  } else {
+    const sorted = [...tempoChanges].sort((a, b) => a.tick - b.tick);
+    let seconds = 0;
+    let prevTick = 0;
+    let currentUsPerQuarter = DEFAULT_US_PER_QUARTER;
+    for (const change of sorted) {
+      seconds += (change.tick - prevTick) / division.ticksPerQuarterNote * (currentUsPerQuarter / 1e6);
+      prevTick = change.tick;
+      currentUsPerQuarter = change.usPerQuarter;
+    }
+    seconds += (maxEndTick - prevTick) / division.ticksPerQuarterNote * (currentUsPerQuarter / 1e6);
+    durationSeconds = Math.round(seconds * 1e3) / 1e3;
+  }
+  return {
+    format,
+    trackCount: tracks.length,
+    division,
+    initialTempoBpm,
+    timeSignature,
+    durationSeconds,
+    tracks
+  };
+}
 
 // src/index.ts
 var version = "0.1.0";

package/dist/index.d.cts

@@ -5,15 +5,15 @@ export { t as text } from './text-DWUcY8H1.cjs';
 export { d as data } from './data-26TALa9U.cjs';
 export { g as generators } from './generators-DAXXrMvG.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
-export { u as units } from './units-DPefgzmH.cjs';
+export { u as units } from './units-BT8P27G0.cjs';
 export { n as network } from './network-BmqYmfqY.cjs';
-export { a as api } from './api-DmTNE4c1.cjs';
+export { a as api } from './api-C8rImfka.cjs';
 export { c as code } from './code-CoeD4Fmq.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-CmrVjvYH.cjs';
-export { m as media } from './media-BUvwm4wU.cjs';
+export { m as media } from './media-56zrIBw4.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -5,15 +5,15 @@ export { t as text } from './text-DWUcY8H1.js';
 export { d as data } from './data-26TALa9U.js';
 export { g as generators } from './generators-DAXXrMvG.js';
 export { t as time } from './time-KqJjdqII.js';
-export { u as units } from './units-DPefgzmH.js';
+export { u as units } from './units-BT8P27G0.js';
 export { n as network } from './network-BmqYmfqY.js';
-export { a as api } from './api-DmTNE4c1.js';
+export { a as api } from './api-C8rImfka.js';
 export { c as code } from './code-CoeD4Fmq.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-CmrVjvYH.js';
-export { m as media } from './media-BUvwm4wU.js';
+export { m as media } from './media-56zrIBw4.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,7 +1,7 @@
-export { media_exports as media } from './chunk-226EH3ZI.js';
-export { units_exports as units } from './chunk-4HNHEOJL.js';
+export { media_exports as media } from './chunk-PT4N4UBL.js';
+export { units_exports as units } from './chunk-653HDWXW.js';
 export { network_exports as network } from './chunk-ACGCCOCK.js';
-export { api_exports as api } from './chunk-52ZDKSIX.js';
+export { api_exports as api } from './chunk-4S63T7Y4.js';
 export { code_exports as code } from './chunk-DAD2ZOTJ.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
 export { css_exports as css } from './chunk-6YPV2AB5.js';

package/dist/{media-BUvwm4wU.d.cts → media-56zrIBw4.d.cts}

@@ -224,6 +224,45 @@ interface GifInfoError {
  * any LZW-compressed pixel data.
  */
 declare function inspectGifFrames(bytes: Uint8Array): GifInfo | GifInfoError;
+type MidiDivision = {
+    type: 'ppq';
+    ticksPerQuarterNote: number;
+} | {
+    type: 'smpte';
+    framesPerSecond: number;
+    ticksPerFrame: number;
+};
+interface MidiTrackInfo {
+    index: number;
+    name: string | null;
+    eventCount: number;
+    noteOnCount: number;
+}
+interface MidiTimeSignature {
+    numerator: number;
+    denominator: number;
+}
+interface MidiInfo {
+    format: number;
+    trackCount: number;
+    division: MidiDivision;
+    initialTempoBpm: number;
+    timeSignature: MidiTimeSignature | null;
+    durationSeconds: number | null;
+    tracks: MidiTrackInfo[];
+}
+interface MidiInfoError {
+    error: string;
+}
+/**
+ * Parse a Standard MIDI File (SMF) header and every track chunk to report
+ * format (0/1/2), the tick division, initial tempo, time signature, a
+ * per-track event/note-on count, and total duration in seconds. Duration
+ * accounts for tempo-change meta events across the whole file when the
+ * division is ticks-per-quarter-note; the rarer SMPTE division uses a fixed
+ * frames-per-second/ticks-per-frame rate instead.
+ */
+declare function readMidiInfo(bytes: Uint8Array): MidiInfo | MidiInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
@@ -239,6 +278,11 @@ type media_Id3TagsError = Id3TagsError;
 type media_ImageFormat = ImageFormat;
 type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
+type media_MidiDivision = MidiDivision;
+type media_MidiInfo = MidiInfo;
+type media_MidiInfoError = MidiInfoError;
+type media_MidiTimeSignature = MidiTimeSignature;
+type media_MidiTrackInfo = MidiTrackInfo;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
 type media_PdfPageDimension = PdfPageDimension;
@@ -254,12 +298,13 @@ 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_readMidiInfo: typeof readMidiInfo;
 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_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_inspectGifFrames as inspectGifFrames, 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 media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, type media_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_MidiDivision as MidiDivision, type media_MidiInfo as MidiInfo, type media_MidiInfoError as MidiInfoError, type media_MidiTimeSignature as MidiTimeSignature, type media_MidiTrackInfo as MidiTrackInfo, 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_inspectGifFrames as inspectGifFrames, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readMidiInfo as readMidiInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfPageDimensions as readPdfPageDimensions, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { readWavInfo as A, type ExifData as E, type FlacInfo as F, type GifInfo as G, 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 GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type PdfMetadataError as k, type PdfPageDimension as l, media as m, type PdfPageDimensionsResult as n, type PdfPageOrientation as o, type VideoInfoError as p, type WavInfoError as q, inspectGifFrames as r, readExifData as s, readFlacInfo as t, readIcoInfo as u, readId3Tags as v, readImageInfo as w, readPdfMetadata as x, readPdfPageDimensions as y, readVideoInfo as z };
+export { readImageInfo as A, readMidiInfo as B, readPdfMetadata as C, readPdfPageDimensions as D, type ExifData as E, type FlacInfo as F, type GifInfo as G, readVideoInfo as H, type IcoImageEntry as I, readWavInfo as J, type MidiDivision as M, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type MidiInfo as k, type MidiInfoError as l, media as m, type MidiTimeSignature as n, type MidiTrackInfo as o, type PdfMetadataError as p, type PdfPageDimension as q, type PdfPageDimensionsResult as r, type PdfPageOrientation as s, type VideoInfoError as t, type WavInfoError as u, inspectGifFrames as v, readExifData as w, readFlacInfo as x, readIcoInfo as y, readId3Tags as z };

package/dist/{media-BUvwm4wU.d.ts → media-56zrIBw4.d.ts}

@@ -224,6 +224,45 @@ interface GifInfoError {
  * any LZW-compressed pixel data.
  */
 declare function inspectGifFrames(bytes: Uint8Array): GifInfo | GifInfoError;
+type MidiDivision = {
+    type: 'ppq';
+    ticksPerQuarterNote: number;
+} | {
+    type: 'smpte';
+    framesPerSecond: number;
+    ticksPerFrame: number;
+};
+interface MidiTrackInfo {
+    index: number;
+    name: string | null;
+    eventCount: number;
+    noteOnCount: number;
+}
+interface MidiTimeSignature {
+    numerator: number;
+    denominator: number;
+}
+interface MidiInfo {
+    format: number;
+    trackCount: number;
+    division: MidiDivision;
+    initialTempoBpm: number;
+    timeSignature: MidiTimeSignature | null;
+    durationSeconds: number | null;
+    tracks: MidiTrackInfo[];
+}
+interface MidiInfoError {
+    error: string;
+}
+/**
+ * Parse a Standard MIDI File (SMF) header and every track chunk to report
+ * format (0/1/2), the tick division, initial tempo, time signature, a
+ * per-track event/note-on count, and total duration in seconds. Duration
+ * accounts for tempo-change meta events across the whole file when the
+ * division is ticks-per-quarter-note; the rarer SMPTE division uses a fixed
+ * frames-per-second/ticks-per-frame rate instead.
+ */
+declare function readMidiInfo(bytes: Uint8Array): MidiInfo | MidiInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
@@ -239,6 +278,11 @@ type media_Id3TagsError = Id3TagsError;
 type media_ImageFormat = ImageFormat;
 type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
+type media_MidiDivision = MidiDivision;
+type media_MidiInfo = MidiInfo;
+type media_MidiInfoError = MidiInfoError;
+type media_MidiTimeSignature = MidiTimeSignature;
+type media_MidiTrackInfo = MidiTrackInfo;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
 type media_PdfPageDimension = PdfPageDimension;
@@ -254,12 +298,13 @@ 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_readMidiInfo: typeof readMidiInfo;
 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_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_inspectGifFrames as inspectGifFrames, 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 media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, type media_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_MidiDivision as MidiDivision, type media_MidiInfo as MidiInfo, type media_MidiInfoError as MidiInfoError, type media_MidiTimeSignature as MidiTimeSignature, type media_MidiTrackInfo as MidiTrackInfo, 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_inspectGifFrames as inspectGifFrames, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readMidiInfo as readMidiInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfPageDimensions as readPdfPageDimensions, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { readWavInfo as A, type ExifData as E, type FlacInfo as F, type GifInfo as G, 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 GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type PdfMetadataError as k, type PdfPageDimension as l, media as m, type PdfPageDimensionsResult as n, type PdfPageOrientation as o, type VideoInfoError as p, type WavInfoError as q, inspectGifFrames as r, readExifData as s, readFlacInfo as t, readIcoInfo as u, readId3Tags as v, readImageInfo as w, readPdfMetadata as x, readPdfPageDimensions as y, readVideoInfo as z };
+export { readImageInfo as A, readMidiInfo as B, readPdfMetadata as C, readPdfPageDimensions as D, type ExifData as E, type FlacInfo as F, type GifInfo as G, readVideoInfo as H, type IcoImageEntry as I, readWavInfo as J, type MidiDivision as M, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type MidiInfo as k, type MidiInfoError as l, media as m, type MidiTimeSignature as n, type MidiTrackInfo as o, type PdfMetadataError as p, type PdfPageDimension as q, type PdfPageDimensionsResult as r, type PdfPageOrientation as s, type VideoInfoError as t, type WavInfoError as u, inspectGifFrames as v, readExifData as w, readFlacInfo as x, readIcoInfo as y, readId3Tags as z };

package/dist/tools/api.cjs

@@ -1265,6 +1265,75 @@ function generateMetaHtml(tags) {
   }
   return lines.join("\n");
 }
+var OTP_ALG_TO_NODE_HASH = {
+  SHA1: "sha1",
+  SHA256: "sha256",
+  SHA512: "sha512"
+};
+function decodeBase32Secret(secret) {
+  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+  const cleaned = secret.toUpperCase().replace(/[\s=]/g, "");
+  if (!cleaned) {
+    return { error: "Secret must not be empty" };
+  }
+  const bytes = [];
+  let buffer = 0;
+  let bitsLeft = 0;
+  for (const char of cleaned) {
+    const val = alphabet.indexOf(char);
+    if (val === -1) {
+      return { error: `Invalid base32 character '${char}' in secret` };
+    }
+    buffer = buffer << 5 | val;
+    bitsLeft += 5;
+    if (bitsLeft >= 8) {
+      bitsLeft -= 8;
+      bytes.push(buffer >> bitsLeft & 255);
+    }
+  }
+  return Buffer.from(bytes);
+}
+function hotpFromCounter(keyBytes, counter, digits, algorithm) {
+  const counterBuffer = Buffer.alloc(8);
+  counterBuffer.writeUInt32BE(Math.floor(counter / 4294967296), 0);
+  counterBuffer.writeUInt32BE(counter % 4294967296, 4);
+  const hmac = crypto.createHmac(OTP_ALG_TO_NODE_HASH[algorithm], keyBytes).update(counterBuffer).digest();
+  const offset = hmac[hmac.length - 1] & 15;
+  const binCode = (hmac[offset] & 127) << 24 | (hmac[offset + 1] & 255) << 16 | (hmac[offset + 2] & 255) << 8 | hmac[offset + 3] & 255;
+  const code = (binCode % 10 ** digits).toString().padStart(digits, "0");
+  return code;
+}
+function generateHotp(secret, counter, options = {}) {
+  const digits = options.digits ?? 6;
+  const algorithm = options.algorithm ?? "SHA1";
+  if (!Number.isInteger(counter) || counter < 0) {
+    return { error: "Counter must be a non-negative whole number" };
+  }
+  if (!Number.isInteger(digits) || digits < 6 || digits > 8) {
+    return { error: "Digits must be an integer between 6 and 8" };
+  }
+  if (!(algorithm in OTP_ALG_TO_NODE_HASH)) {
+    return { error: "Algorithm must be one of SHA1, SHA256, SHA512" };
+  }
+  const keyBytes = decodeBase32Secret(secret);
+  if ("error" in keyBytes) return keyBytes;
+  return { code: hotpFromCounter(keyBytes, counter, digits, algorithm), counter, digits, algorithm };
+}
+function generateTotp(secret, options = {}) {
+  const periodSeconds = options.periodSeconds ?? 30;
+  const timestamp = options.timestamp ?? Math.floor(Date.now() / 1e3);
+  if (!Number.isFinite(periodSeconds) || periodSeconds <= 0) {
+    return { error: "Period must be a positive number of seconds" };
+  }
+  if (!Number.isFinite(timestamp) || timestamp < 0) {
+    return { error: "Timestamp must be a non-negative number of seconds" };
+  }
+  const counter = Math.floor(timestamp / periodSeconds);
+  const hotp = generateHotp(secret, counter, options);
+  if ("error" in hotp) return hotp;
+  const secondsRemaining = periodSeconds - timestamp % periodSeconds;
+  return { ...hotp, periodSeconds, secondsRemaining };
+}
 
 exports.COMMON_HEADERS = COMMON_HEADERS;
 exports.COMMON_PRESETS = COMMON_PRESETS;
@@ -1291,7 +1360,9 @@ exports.formatResponse = formatResponse;
 exports.generateCors = generateCors;
 exports.generateCspHeader = generateCspHeader;
 exports.generateFullHeader = generateFullHeader;
+exports.generateHotp = generateHotp;
 exports.generateMetaHtml = generateMetaHtml;
+exports.generateTotp = generateTotp;
 exports.getParam = getParam;
 exports.getStats = getStats;
 exports.isValidUrl = isValidUrl;

package/dist/tools/api.d.cts

@@ -1 +1 @@
-export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HttpMethod, J as JwkSummary, o as JwkThumbprintErrorResult, p as JwkThumbprintHash, q as JwkThumbprintOutcome, r as JwkThumbprintResult, s as JwksError, t as JwksParseResult, u as JwksResult, v as JwtAlgorithm, w as JwtDecodeError, x as JwtDecodeResult, y as JwtExpiry, z as JwtPart, A as JwtResult, B as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, E as TwitterTags, G as addParam, I as base64urlDecode, K as base64urlEncode, L as buildCurl, N as buildCurlMultiline, Q as buildUrl, U as computeJwkThumbprint, V as convertToCode, W as decodeJwt, X as decodeUrlComponent, Y as detectFormat, Z as encodeUrlComponent, _ as extractJsonPaths, $ as formatJwtJson, a0 as formatResponse, a1 as generateCors, a2 as generateCspHeader, a3 as generateFullHeader, a4 as generateMetaHtml, a5 as getParam, a6 as getStats, a7 as isValidUrl, a8 as normalizeUrl, a9 as parseCspHeader, aa as parseCurl, ab as parseCurlCommand, ac as parseJwks, ad as parseMetaTags, ae as parseUrl, af as removeParam, ag as signJwt, ah as validateCorsConfig, ai as validateCspConfig, aj as validateOgTags } from '../api-DmTNE4c1.cjs';
+export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HotpResult, o as HttpMethod, J as JwkSummary, p as JwkThumbprintErrorResult, q as JwkThumbprintHash, r as JwkThumbprintOutcome, s as JwkThumbprintResult, t as JwksError, u as JwksParseResult, v as JwksResult, w as JwtAlgorithm, x as JwtDecodeError, y as JwtDecodeResult, z as JwtExpiry, A as JwtPart, B as JwtResult, E as JwtSignOptions, M as MetaTags, O as OgTags, G as OtpAlgorithm, I as OtpOptions, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, K as TotpOptions, L as TotpResult, N as TwitterTags, Q as addParam, U as base64urlDecode, V as base64urlEncode, W as buildCurl, X as buildCurlMultiline, Y as buildUrl, Z as computeJwkThumbprint, _ as convertToCode, $ as decodeJwt, a0 as decodeUrlComponent, a1 as detectFormat, a2 as encodeUrlComponent, a3 as extractJsonPaths, a4 as formatJwtJson, a5 as formatResponse, a6 as generateCors, a7 as generateCspHeader, a8 as generateFullHeader, a9 as generateHotp, aa as generateMetaHtml, ab as generateTotp, ac as getParam, ad as getStats, ae as isValidUrl, af as normalizeUrl, ag as parseCspHeader, ah as parseCurl, ai as parseCurlCommand, aj as parseJwks, ak as parseMetaTags, al as parseUrl, am as removeParam, an as signJwt, ao as validateCorsConfig, ap as validateCspConfig, aq as validateOgTags } from '../api-C8rImfka.cjs';

package/dist/tools/api.d.ts

@@ -1 +1 @@
-export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HttpMethod, J as JwkSummary, o as JwkThumbprintErrorResult, p as JwkThumbprintHash, q as JwkThumbprintOutcome, r as JwkThumbprintResult, s as JwksError, t as JwksParseResult, u as JwksResult, v as JwtAlgorithm, w as JwtDecodeError, x as JwtDecodeResult, y as JwtExpiry, z as JwtPart, A as JwtResult, B as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, E as TwitterTags, G as addParam, I as base64urlDecode, K as base64urlEncode, L as buildCurl, N as buildCurlMultiline, Q as buildUrl, U as computeJwkThumbprint, V as convertToCode, W as decodeJwt, X as decodeUrlComponent, Y as detectFormat, Z as encodeUrlComponent, _ as extractJsonPaths, $ as formatJwtJson, a0 as formatResponse, a1 as generateCors, a2 as generateCspHeader, a3 as generateFullHeader, a4 as generateMetaHtml, a5 as getParam, a6 as getStats, a7 as isValidUrl, a8 as normalizeUrl, a9 as parseCspHeader, aa as parseCurl, ab as parseCurlCommand, ac as parseJwks, ad as parseMetaTags, ae as parseUrl, af as removeParam, ag as signJwt, ah as validateCorsConfig, ai as validateCspConfig, aj as validateOgTags } from '../api-DmTNE4c1.js';
+export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HotpResult, o as HttpMethod, J as JwkSummary, p as JwkThumbprintErrorResult, q as JwkThumbprintHash, r as JwkThumbprintOutcome, s as JwkThumbprintResult, t as JwksError, u as JwksParseResult, v as JwksResult, w as JwtAlgorithm, x as JwtDecodeError, y as JwtDecodeResult, z as JwtExpiry, A as JwtPart, B as JwtResult, E as JwtSignOptions, M as MetaTags, O as OgTags, G as OtpAlgorithm, I as OtpOptions, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, K as TotpOptions, L as TotpResult, N as TwitterTags, Q as addParam, U as base64urlDecode, V as base64urlEncode, W as buildCurl, X as buildCurlMultiline, Y as buildUrl, Z as computeJwkThumbprint, _ as convertToCode, $ as decodeJwt, a0 as decodeUrlComponent, a1 as detectFormat, a2 as encodeUrlComponent, a3 as extractJsonPaths, a4 as formatJwtJson, a5 as formatResponse, a6 as generateCors, a7 as generateCspHeader, a8 as generateFullHeader, a9 as generateHotp, aa as generateMetaHtml, ab as generateTotp, ac as getParam, ad as getStats, ae as isValidUrl, af as normalizeUrl, ag as parseCspHeader, ah as parseCurl, ai as parseCurlCommand, aj as parseJwks, ak as parseMetaTags, al as parseUrl, am as removeParam, an as signJwt, ao as validateCorsConfig, ap as validateCspConfig, aq as validateOgTags } from '../api-C8rImfka.js';

package/dist/tools/api.js

@@ -1,2 +1,2 @@
-export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, base64urlDecode, base64urlEncode, buildCurl, buildCurlMultiline, buildUrl, computeJwkThumbprint, convertToCode, decodeJwt, decodeUrlComponent, detectFormat, encodeUrlComponent, extractJsonPaths, formatJwtJson, formatResponse, generateCors, generateCspHeader, generateFullHeader, generateMetaHtml, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags } from '../chunk-52ZDKSIX.js';
+export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, base64urlDecode, base64urlEncode, buildCurl, buildCurlMultiline, buildUrl, computeJwkThumbprint, convertToCode, decodeJwt, decodeUrlComponent, detectFormat, encodeUrlComponent, extractJsonPaths, formatJwtJson, formatResponse, generateCors, generateCspHeader, generateFullHeader, generateHotp, generateMetaHtml, generateTotp, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags } from '../chunk-4S63T7Y4.js';
 import '../chunk-MLKGABMK.js';