@utilix-tech/sdk 0.25.0 → 0.27.0

package/dist/index.cjs

@@ -7154,10 +7154,12 @@ __export(units_exports, {
   calculateLoan: () => calculateLoan,
   calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
+  calculateRuleOf72: () => calculateRuleOf72,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
   calculateTipSplit: () => calculateTipSplit,
+  calculateVideoBitrate: () => calculateVideoBitrate,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertAprApy: () => convertAprApy,
@@ -8718,6 +8720,91 @@ function calculateBreakEven(input) {
   }
   return result;
 }
+function calculateVideoBitrate(input) {
+  const { mode, durationSeconds, videoBitrateKbps, targetSizeMB } = input;
+  const audioBitrateKbps = input.audioBitrateKbps ?? 0;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+    return { error: "durationSeconds must be a positive number" };
+  }
+  if (!Number.isFinite(audioBitrateKbps) || audioBitrateKbps < 0) {
+    return { error: "audioBitrateKbps must be zero or a positive number" };
+  }
+  const round23 = (n) => Math.round(n * 100) / 100;
+  if (mode === "size-from-bitrate") {
+    if (typeof videoBitrateKbps !== "number" || !Number.isFinite(videoBitrateKbps) || videoBitrateKbps <= 0) {
+      return { error: 'videoBitrateKbps must be a positive number for mode "size-from-bitrate"' };
+    }
+    const totalBitrateKbps = videoBitrateKbps + audioBitrateKbps;
+    const fileSizeBytes = totalBitrateKbps * 1e3 * durationSeconds / 8;
+    return {
+      mode,
+      durationSeconds,
+      videoBitrateKbps: round23(videoBitrateKbps),
+      audioBitrateKbps: round23(audioBitrateKbps),
+      totalBitrateKbps: round23(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round23(fileSizeBytes / 1e6),
+      fileSizeMiB: round23(fileSizeBytes / 1048576)
+    };
+  }
+  if (mode === "bitrate-from-size") {
+    if (typeof targetSizeMB !== "number" || !Number.isFinite(targetSizeMB) || targetSizeMB <= 0) {
+      return { error: 'targetSizeMB must be a positive number for mode "bitrate-from-size"' };
+    }
+    const fileSizeBytes = targetSizeMB * 1e6;
+    const totalBitrateKbps = fileSizeBytes * 8 / (1e3 * durationSeconds);
+    const videoKbps = totalBitrateKbps - audioBitrateKbps;
+    if (videoKbps <= 0) {
+      return {
+        error: "audioBitrateKbps exceeds the total bitrate available at this target size and duration; lower the audio bitrate or raise the target size"
+      };
+    }
+    return {
+      mode,
+      durationSeconds,
+      videoBitrateKbps: round23(videoKbps),
+      audioBitrateKbps: round23(audioBitrateKbps),
+      totalBitrateKbps: round23(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round23(targetSizeMB),
+      fileSizeMiB: round23(fileSizeBytes / 1048576)
+    };
+  }
+  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 = {};
@@ -10550,6 +10637,7 @@ __export(api_exports, {
   buildCurl: () => buildCurl,
   buildCurlMultiline: () => buildCurlMultiline,
   buildUrl: () => buildUrl,
+  computeJwkThumbprint: () => computeJwkThumbprint,
   convertToCode: () => convertToCode,
   decodeJwt: () => decodeJwt,
   decodeUrlComponent: () => decodeUrlComponent,
@@ -11068,6 +11156,48 @@ function parseJwks(input) {
   const duplicateKids = [...kidCounts.entries()].filter(([, c]) => c > 1).map(([kid]) => kid);
   return { ok: true, keys, count: keys.length, duplicateKids };
 }
+var JWK_THUMBPRINT_MEMBERS = {
+  oct: ["k", "kty"],
+  RSA: ["e", "kty", "n"],
+  EC: ["crv", "kty", "x", "y"],
+  OKP: ["crv", "kty", "x"]
+};
+var JWK_THUMBPRINT_NODE_HASH = {
+  "SHA-256": "sha256",
+  "SHA-384": "sha384",
+  "SHA-512": "sha512"
+};
+function computeJwkThumbprint(input, hashAlg = "SHA-256") {
+  const trimmed = input.trim();
+  if (!trimmed) return { ok: false, error: "No input provided" };
+  const nodeHash = JWK_THUMBPRINT_NODE_HASH[hashAlg];
+  if (!nodeHash) return { ok: false, error: 'hashAlg must be one of "SHA-256", "SHA-384", "SHA-512"' };
+  let jwk;
+  try {
+    jwk = JSON.parse(trimmed);
+  } catch (e) {
+    return { ok: false, error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  if (jwk === null || typeof jwk !== "object" || Array.isArray(jwk)) {
+    return { ok: false, error: "Input must be a single JWK object, not a JWKS set or array" };
+  }
+  const obj = jwk;
+  const kty = obj.kty;
+  if (typeof kty !== "string") return { ok: false, error: 'JWK must have a "kty" (key type) member' };
+  const members = JWK_THUMBPRINT_MEMBERS[kty];
+  if (!members) return { ok: false, error: `Unsupported key type "${kty}": supported types are RSA, EC, oct, OKP` };
+  const canonical = {};
+  for (const m of members) {
+    const v = obj[m];
+    if (typeof v !== "string" || v.length === 0) {
+      return { ok: false, error: `JWK is missing required member "${m}" for key type "${kty}"` };
+    }
+    canonical[m] = v;
+  }
+  const canonicalJson = "{" + members.map((m) => `${JSON.stringify(m)}:${JSON.stringify(canonical[m])}`).join(",") + "}";
+  const thumbprint = crypto.createHash(nodeHash).update(canonicalJson, "utf8").digest("base64url");
+  return { ok: true, kty, hashAlg, members, canonicalJson, thumbprint };
+}
 var ALG_TO_NODE_HASH = {
   HS256: "sha256",
   HS384: "sha384",
@@ -19102,6 +19232,7 @@ function vectorSimilarity(a, b) {
 var media_exports = {};
 __export(media_exports, {
   readExifData: () => readExifData,
+  readFlacInfo: () => readFlacInfo,
   readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
@@ -19862,6 +19993,101 @@ 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;
+}
 
 // src/index.ts
 var version = "0.1.0";

package/dist/index.d.cts

@@ -5,15 +5,15 @@ 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-DUqjk24x.cjs';
+export { u as units } from './units-COt5uI20.cjs';
 export { n as network } from './network-BJOjJnmY.cjs';
-export { a as api } from './api-Xl7OzIgq.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-9HEpTPGA.cjs';
+export { m as media } from './media-CN17a3MM.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -5,15 +5,15 @@ 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-DUqjk24x.js';
+export { u as units } from './units-COt5uI20.js';
 export { n as network } from './network-BJOjJnmY.js';
-export { a as api } from './api-Xl7OzIgq.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-9HEpTPGA.js';
+export { m as media } from './media-CN17a3MM.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,7 +1,7 @@
-export { media_exports as media } from './chunk-XMKJYVKB.js';
-export { units_exports as units } from './chunk-FVKNR3PV.js';
+export { media_exports as media } from './chunk-Q3M23WNJ.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-Q3B3YWOA.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';
 export { css_exports as css } from './chunk-6YPV2AB5.js';

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

@@ -131,9 +131,40 @@ 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;
 
 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;
@@ -147,13 +178,14 @@ type media_PdfMetadataError = PdfMetadataError;
 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_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_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 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 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 };

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

@@ -131,9 +131,40 @@ 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;
 
 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;
@@ -147,13 +178,14 @@ type media_PdfMetadataError = PdfMetadataError;
 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_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_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 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 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 };

package/dist/tools/api.cjs

@@ -493,6 +493,48 @@ function parseJwks(input) {
   const duplicateKids = [...kidCounts.entries()].filter(([, c]) => c > 1).map(([kid]) => kid);
   return { ok: true, keys, count: keys.length, duplicateKids };
 }
+var JWK_THUMBPRINT_MEMBERS = {
+  oct: ["k", "kty"],
+  RSA: ["e", "kty", "n"],
+  EC: ["crv", "kty", "x", "y"],
+  OKP: ["crv", "kty", "x"]
+};
+var JWK_THUMBPRINT_NODE_HASH = {
+  "SHA-256": "sha256",
+  "SHA-384": "sha384",
+  "SHA-512": "sha512"
+};
+function computeJwkThumbprint(input, hashAlg = "SHA-256") {
+  const trimmed = input.trim();
+  if (!trimmed) return { ok: false, error: "No input provided" };
+  const nodeHash = JWK_THUMBPRINT_NODE_HASH[hashAlg];
+  if (!nodeHash) return { ok: false, error: 'hashAlg must be one of "SHA-256", "SHA-384", "SHA-512"' };
+  let jwk;
+  try {
+    jwk = JSON.parse(trimmed);
+  } catch (e) {
+    return { ok: false, error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  if (jwk === null || typeof jwk !== "object" || Array.isArray(jwk)) {
+    return { ok: false, error: "Input must be a single JWK object, not a JWKS set or array" };
+  }
+  const obj = jwk;
+  const kty = obj.kty;
+  if (typeof kty !== "string") return { ok: false, error: 'JWK must have a "kty" (key type) member' };
+  const members = JWK_THUMBPRINT_MEMBERS[kty];
+  if (!members) return { ok: false, error: `Unsupported key type "${kty}": supported types are RSA, EC, oct, OKP` };
+  const canonical = {};
+  for (const m of members) {
+    const v = obj[m];
+    if (typeof v !== "string" || v.length === 0) {
+      return { ok: false, error: `JWK is missing required member "${m}" for key type "${kty}"` };
+    }
+    canonical[m] = v;
+  }
+  const canonicalJson = "{" + members.map((m) => `${JSON.stringify(m)}:${JSON.stringify(canonical[m])}`).join(",") + "}";
+  const thumbprint = crypto.createHash(nodeHash).update(canonicalJson, "utf8").digest("base64url");
+  return { ok: true, kty, hashAlg, members, canonicalJson, thumbprint };
+}
 var ALG_TO_NODE_HASH = {
   HS256: "sha256",
   HS384: "sha384",
@@ -1237,6 +1279,7 @@ exports.base64urlEncode = base64urlEncode;
 exports.buildCurl = buildCurl;
 exports.buildCurlMultiline = buildCurlMultiline;
 exports.buildUrl = buildUrl;
+exports.computeJwkThumbprint = computeJwkThumbprint;
 exports.convertToCode = convertToCode;
 exports.decodeJwt = decodeJwt;
 exports.decodeUrlComponent = decodeUrlComponent;

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 JwksError, p as JwksParseResult, q as JwksResult, r as JwtAlgorithm, s as JwtDecodeError, t as JwtDecodeResult, u as JwtExpiry, v as JwtPart, w as JwtResult, x as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, y as TwitterTags, z as addParam, A as base64urlDecode, B as base64urlEncode, E as buildCurl, G as buildCurlMultiline, I as buildUrl, K as convertToCode, L as decodeJwt, N as decodeUrlComponent, Q as detectFormat, U as encodeUrlComponent, V as extractJsonPaths, W as formatJwtJson, X as formatResponse, Y as generateCors, Z as generateCspHeader, _ as generateFullHeader, $ as generateMetaHtml, a0 as getParam, a1 as getStats, a2 as isValidUrl, a3 as normalizeUrl, a4 as parseCspHeader, a5 as parseCurl, a6 as parseCurlCommand, a7 as parseJwks, a8 as parseMetaTags, a9 as parseUrl, aa as removeParam, ab as signJwt, ac as validateCorsConfig, ad as validateCspConfig, ae as validateOgTags } from '../api-Xl7OzIgq.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 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';

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 JwksError, p as JwksParseResult, q as JwksResult, r as JwtAlgorithm, s as JwtDecodeError, t as JwtDecodeResult, u as JwtExpiry, v as JwtPart, w as JwtResult, x as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, y as TwitterTags, z as addParam, A as base64urlDecode, B as base64urlEncode, E as buildCurl, G as buildCurlMultiline, I as buildUrl, K as convertToCode, L as decodeJwt, N as decodeUrlComponent, Q as detectFormat, U as encodeUrlComponent, V as extractJsonPaths, W as formatJwtJson, X as formatResponse, Y as generateCors, Z as generateCspHeader, _ as generateFullHeader, $ as generateMetaHtml, a0 as getParam, a1 as getStats, a2 as isValidUrl, a3 as normalizeUrl, a4 as parseCspHeader, a5 as parseCurl, a6 as parseCurlCommand, a7 as parseJwks, a8 as parseMetaTags, a9 as parseUrl, aa as removeParam, ab as signJwt, ac as validateCorsConfig, ad as validateCspConfig, ae as validateOgTags } from '../api-Xl7OzIgq.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 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';

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, 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-Q3B3YWOA.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, generateMetaHtml, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags } from '../chunk-52ZDKSIX.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/media.cjs

@@ -755,8 +755,104 @@ 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;
+}
 
 exports.readExifData = readExifData;
+exports.readFlacInfo = readFlacInfo;
 exports.readIcoInfo = readIcoInfo;
 exports.readId3Tags = readId3Tags;
 exports.readImageInfo = readImageInfo;

package/dist/tools/media.d.cts

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

package/dist/tools/media.d.ts

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

package/dist/tools/media.js

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