@utilix-tech/sdk 0.25.0 → 0.27.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.27.0
+- Add `calculateRuleOf72` (rule-of-72-calculator): estimate years to double an investment from a rate, or the rate needed to double in a given number of years, alongside the exact logarithmic result.
+- Add `readFlacInfo` (flac-metadata-reader): sample rate, channels, bit depth, total samples, and duration from a FLAC file's STREAMINFO block, plus Vorbis comment tags when present.
+
+## 0.26.0
+- Add `computeJwkThumbprint` (jwk-thumbprint): RFC 7638 canonical thumbprint of a single JWK, hashed with SHA-256/384/512.
+- Add `calculateVideoBitrate` (video-bitrate-calculator): resulting file size from a video/audio bitrate and duration, or the required bitrate to hit a target file size.
+
 ## 0.25.0
 - Add `calculateBreakEven` (break-even-calculator): break-even unit count and revenue from fixed costs, variable cost per unit, and price per unit, plus profit and margin of safety at an optional sales volume.
 - Add `calculateStringDistance` (string-distance): Levenshtein edit distance and normalized similarity between two strings, with an optional Damerau (transposition) mode.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**574 developer utility functions for Node.js: runs locally, no API key required.**
+**578 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -272,7 +272,7 @@ formatIso8601Duration(90061);        // { iso: "P1DT1H1M1S", ... }
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange, convertAprApy, calculateMarginMarkup, calculateDiscount, applySuccessiveDiscounts, calculateBreakEven } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange, convertAprApy, calculateMarginMarkup, calculateDiscount, applySuccessiveDiscounts, calculateBreakEven, calculateVideoBitrate, calculateRuleOf72 } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -354,6 +354,14 @@ applySuccessiveDiscounts(100, [20, 10]);
 // Break-even point: fixed costs, variable cost/unit, price/unit
 calculateBreakEven({ fixedCosts: 10000, variableCostPerUnit: 20, pricePerUnit: 50 });
 // { breakEvenUnitsRounded: 334, breakEvenRevenue: 16666.6667, contributionMarginPerUnit: 30, ... }
+
+// Video file size from a bitrate + duration, or the bitrate to hit a target size
+calculateVideoBitrate({ mode: "size-from-bitrate", durationSeconds: 600, videoBitrateKbps: 5000, audioBitrateKbps: 192 });
+// { totalBitrateKbps: 5192, fileSizeBytes: 389400000, fileSizeMB: 389.4, fileSizeMiB: 371.36, ... }
+
+// Rule of 72: years to double from a rate, or the rate needed to double in N years
+calculateRuleOf72(8, "rate-to-years");
+// { ruleOf72Estimate: 9, exactValue: 9.0065, errorPercent: -0.0718, ... }
 ```
 
 ---
@@ -405,7 +413,7 @@ buildCacheControl({ visibility: "public", maxAge: 3600, mustRevalidate: true });
 ### `/api`: cURL, JWT, CORS, HTTP
 
 ```ts
-import { buildCurl, parseCurlCommand, decodeJwt, signJwt, parseJwks,
+import { buildCurl, parseCurlCommand, decodeJwt, signJwt, parseJwks, computeJwkThumbprint,
          generateCors, generateCspHeader } from "@utilix-tech/sdk/api";
 
 buildCurl({
@@ -429,6 +437,10 @@ decodeJwt("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
 parseJwks('{"keys":[{"kty":"RSA","use":"sig","kid":"1","n":"...","e":"AQAB"}]}');
 // { ok: true, keys: [{ kty: "RSA", kid: "1", keySize: 2048, ... }], count: 1, duplicateKids: [] }
 
+// JWK thumbprint (RFC 7638): canonical fingerprint of a single JWK
+computeJwkThumbprint('{"kty":"oct","k":"c2VjcmV0"}');
+// { ok: true, kty: "oct", hashAlg: "SHA-256", thumbprint: "DWBh0SEIAPYh1x5uvot4z3AhaikHkxNJa3Ada2fT-Cg", ... }
+
 // Generate CORS headers
 generateCors({ origins: ["https://myapp.com"], methods: ["GET", "POST"] });
 
@@ -549,10 +561,10 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media`: Image Header Parsing, EXIF, PDF, WAV, ID3 & ICO Metadata
+### `/media`: Image Header Parsing, EXIF, PDF, WAV, ID3, ICO & FLAC Metadata
 
 ```ts
-import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags, readIcoInfo } from "@utilix-tech/sdk/media";
+import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
 // file bytes: no decoding, no canvas, no image library.
@@ -590,9 +602,16 @@ readId3Tags(new Uint8Array(mp3Bytes));
 const icoBytes = await fs.promises.readFile("favicon.ico");
 readIcoInfo(new Uint8Array(icoBytes));
 // { imageCount: 3, images: [{ width: 16, height: 16, bitCount: 32, bytesInRes: 1128, ... }, ...] }
+
+// Reads sample rate, channels, bit depth, total samples, and duration from a
+// FLAC file's STREAMINFO block, plus Vorbis comment tags (artist, title,
+// album, ...) from its VORBIS_COMMENT block if present.
+const flacBytes = await fs.promises.readFile("track.flac");
+readFlacInfo(new Uint8Array(flacBytes));
+// { sampleRate: 44100, channels: 2, bitsPerSample: 16, durationSeconds: 214.7, artist: "Artist Name", ... }
 ```
 
-`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only. `readWavInfo` supports the canonical RIFF/WAVE container only. `readId3Tags` decodes ID3v2.3/2.4 and ID3v1/1.1 only (ID3v2.2 is detected but not decoded). `readIcoInfo` reads .ico icon files only and rejects .cur cursor files.
+`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only. `readWavInfo` supports the canonical RIFF/WAVE container only. `readId3Tags` decodes ID3v2.3/2.4 and ID3v1/1.1 only (ID3v2.2 is detected but not decoded). `readIcoInfo` reads .ico icon files only and rejects .cur cursor files. `readFlacInfo` reads the native FLAC container only, not FLAC-in-Ogg.
 
 ---
 
@@ -607,7 +626,7 @@ readIcoInfo(new Uint8Array(icoBytes));
 | `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, SRT/WebVTT subtitles |
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, fake data |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
-| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header |
 | `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing |
@@ -615,7 +634,7 @@ readIcoInfo(new Uint8Array(icoBytes));
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
 | `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect, vector similarity |
-| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info; ID3 tags; ICO favicon inspection |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading |
 
 ---
 

package/dist/{api-Xl7OzIgq.d.cts → api-DmTNE4c1.d.cts}

@@ -5,6 +5,7 @@
  *  - curl-to-code    : parseCurlCommand, convertToCode
  *  - jwt-decoder     : decodeJwt, formatJwtJson
  *  - jwk-viewer      : parseJwks
+ *  - jwk-thumbprint  : computeJwkThumbprint
  *  - jwt-signer      : base64urlEncode, base64urlDecode, signJwt
  *  - cors-builder    : validateCorsConfig, generateCors
  *  - csp-builder     : generateCspHeader, generateFullHeader, parseCspHeader, validateCspConfig
@@ -106,6 +107,27 @@ type JwksParseResult = JwksResult | JwksError;
  * use the keys cryptographically: this is inspection only.
  */
 declare function parseJwks(input: string): JwksParseResult;
+type JwkThumbprintHash = 'SHA-256' | 'SHA-384' | 'SHA-512';
+interface JwkThumbprintResult {
+    ok: true;
+    kty: string;
+    hashAlg: JwkThumbprintHash;
+    members: string[];
+    canonicalJson: string;
+    thumbprint: string;
+}
+interface JwkThumbprintErrorResult {
+    ok: false;
+    error: string;
+}
+type JwkThumbprintOutcome = JwkThumbprintResult | JwkThumbprintErrorResult;
+/**
+ * Compute the RFC 7638 thumbprint of a single JWK: build the canonical JSON
+ * of its required members (lexicographic key order, no whitespace) and hash
+ * it. This is a fingerprint for identifying/matching a key, not a signature
+ * or verification, and it only accepts a bare JWK, not a JWKS set.
+ */
+declare function computeJwkThumbprint(input: string, hashAlg?: JwkThumbprintHash): JwkThumbprintOutcome;
 type JwtAlgorithm = 'HS256' | 'HS384' | 'HS512';
 interface JwtSignOptions {
     algorithm?: JwtAlgorithm;
@@ -284,6 +306,10 @@ declare const api_HTTP_METHODS: typeof HTTP_METHODS;
 type api_Header = Header;
 type api_HttpMethod = HttpMethod;
 type api_JwkSummary = JwkSummary;
+type api_JwkThumbprintErrorResult = JwkThumbprintErrorResult;
+type api_JwkThumbprintHash = JwkThumbprintHash;
+type api_JwkThumbprintOutcome = JwkThumbprintOutcome;
+type api_JwkThumbprintResult = JwkThumbprintResult;
 type api_JwksError = JwksError;
 type api_JwksParseResult = JwksParseResult;
 type api_JwksResult = JwksResult;
@@ -307,6 +333,7 @@ declare const api_base64urlEncode: typeof base64urlEncode;
 declare const api_buildCurl: typeof buildCurl;
 declare const api_buildCurlMultiline: typeof buildCurlMultiline;
 declare const api_buildUrl: typeof buildUrl;
+declare const api_computeJwkThumbprint: typeof computeJwkThumbprint;
 declare const api_convertToCode: typeof convertToCode;
 declare const api_decodeJwt: typeof decodeJwt;
 declare const api_decodeUrlComponent: typeof decodeUrlComponent;
@@ -335,7 +362,7 @@ declare const api_validateCorsConfig: typeof validateCorsConfig;
 declare const api_validateCspConfig: typeof validateCspConfig;
 declare const api_validateOgTags: typeof validateOgTags;
 declare namespace api {
-  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
+  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwkThumbprintErrorResult as JwkThumbprintErrorResult, type api_JwkThumbprintHash as JwkThumbprintHash, type api_JwkThumbprintOutcome as JwkThumbprintOutcome, type api_JwkThumbprintResult as JwkThumbprintResult, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_computeJwkThumbprint as computeJwkThumbprint, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
 }
 
-export { generateMetaHtml as $, base64urlDecode as A, base64urlEncode as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, buildCurl as E, type FormatResult as F, buildCurlMultiline as G, HTTP_METHODS as H, buildUrl as I, type JwkSummary as J, convertToCode as K, decodeJwt as L, type MetaTags as M, decodeUrlComponent as N, type OgTags as O, type ParsedUrl as P, detectFormat as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, encodeUrlComponent as U, extractJsonPaths as V, formatJwtJson as W, formatResponse as X, generateCors as Y, generateCspHeader as Z, generateFullHeader as _, api as a, getParam as a0, getStats as a1, isValidUrl as a2, normalizeUrl as a3, parseCspHeader as a4, parseCurl as a5, parseCurlCommand as a6, parseJwks as a7, parseMetaTags as a8, parseUrl as a9, removeParam as aa, signJwt as ab, validateCorsConfig as ac, validateCspConfig as ad, validateOgTags as ae, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwksError as o, type JwksParseResult as p, type JwksResult as q, type JwtAlgorithm as r, type JwtDecodeError as s, type JwtDecodeResult as t, type JwtExpiry as u, type JwtPart as v, type JwtResult as w, type JwtSignOptions as x, type TwitterTags as y, addParam as z };
+export { formatJwtJson as $, type JwtResult as A, type JwtSignOptions as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, type TwitterTags as E, type FormatResult as F, addParam as G, HTTP_METHODS as H, base64urlDecode as I, type JwkSummary as J, base64urlEncode as K, buildCurl as L, type MetaTags as M, buildCurlMultiline as N, type OgTags as O, type ParsedUrl as P, buildUrl as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, computeJwkThumbprint as U, convertToCode as V, decodeJwt as W, decodeUrlComponent as X, detectFormat as Y, encodeUrlComponent as Z, extractJsonPaths as _, api as a, formatResponse as a0, generateCors as a1, generateCspHeader as a2, generateFullHeader as a3, generateMetaHtml as a4, getParam as a5, getStats as a6, isValidUrl as a7, normalizeUrl as a8, parseCspHeader as a9, parseCurl as aa, parseCurlCommand as ab, parseJwks as ac, parseMetaTags as ad, parseUrl as ae, removeParam as af, signJwt as ag, validateCorsConfig as ah, validateCspConfig as ai, validateOgTags as aj, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwkThumbprintErrorResult as o, type JwkThumbprintHash as p, type JwkThumbprintOutcome as q, type JwkThumbprintResult as r, type JwksError as s, type JwksParseResult as t, type JwksResult as u, type JwtAlgorithm as v, type JwtDecodeError as w, type JwtDecodeResult as x, type JwtExpiry as y, type JwtPart as z };

package/dist/{api-Xl7OzIgq.d.ts → api-DmTNE4c1.d.ts}

@@ -5,6 +5,7 @@
  *  - curl-to-code    : parseCurlCommand, convertToCode
  *  - jwt-decoder     : decodeJwt, formatJwtJson
  *  - jwk-viewer      : parseJwks
+ *  - jwk-thumbprint  : computeJwkThumbprint
  *  - jwt-signer      : base64urlEncode, base64urlDecode, signJwt
  *  - cors-builder    : validateCorsConfig, generateCors
  *  - csp-builder     : generateCspHeader, generateFullHeader, parseCspHeader, validateCspConfig
@@ -106,6 +107,27 @@ type JwksParseResult = JwksResult | JwksError;
  * use the keys cryptographically: this is inspection only.
  */
 declare function parseJwks(input: string): JwksParseResult;
+type JwkThumbprintHash = 'SHA-256' | 'SHA-384' | 'SHA-512';
+interface JwkThumbprintResult {
+    ok: true;
+    kty: string;
+    hashAlg: JwkThumbprintHash;
+    members: string[];
+    canonicalJson: string;
+    thumbprint: string;
+}
+interface JwkThumbprintErrorResult {
+    ok: false;
+    error: string;
+}
+type JwkThumbprintOutcome = JwkThumbprintResult | JwkThumbprintErrorResult;
+/**
+ * Compute the RFC 7638 thumbprint of a single JWK: build the canonical JSON
+ * of its required members (lexicographic key order, no whitespace) and hash
+ * it. This is a fingerprint for identifying/matching a key, not a signature
+ * or verification, and it only accepts a bare JWK, not a JWKS set.
+ */
+declare function computeJwkThumbprint(input: string, hashAlg?: JwkThumbprintHash): JwkThumbprintOutcome;
 type JwtAlgorithm = 'HS256' | 'HS384' | 'HS512';
 interface JwtSignOptions {
     algorithm?: JwtAlgorithm;
@@ -284,6 +306,10 @@ declare const api_HTTP_METHODS: typeof HTTP_METHODS;
 type api_Header = Header;
 type api_HttpMethod = HttpMethod;
 type api_JwkSummary = JwkSummary;
+type api_JwkThumbprintErrorResult = JwkThumbprintErrorResult;
+type api_JwkThumbprintHash = JwkThumbprintHash;
+type api_JwkThumbprintOutcome = JwkThumbprintOutcome;
+type api_JwkThumbprintResult = JwkThumbprintResult;
 type api_JwksError = JwksError;
 type api_JwksParseResult = JwksParseResult;
 type api_JwksResult = JwksResult;
@@ -307,6 +333,7 @@ declare const api_base64urlEncode: typeof base64urlEncode;
 declare const api_buildCurl: typeof buildCurl;
 declare const api_buildCurlMultiline: typeof buildCurlMultiline;
 declare const api_buildUrl: typeof buildUrl;
+declare const api_computeJwkThumbprint: typeof computeJwkThumbprint;
 declare const api_convertToCode: typeof convertToCode;
 declare const api_decodeJwt: typeof decodeJwt;
 declare const api_decodeUrlComponent: typeof decodeUrlComponent;
@@ -335,7 +362,7 @@ declare const api_validateCorsConfig: typeof validateCorsConfig;
 declare const api_validateCspConfig: typeof validateCspConfig;
 declare const api_validateOgTags: typeof validateOgTags;
 declare namespace api {
-  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
+  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwkThumbprintErrorResult as JwkThumbprintErrorResult, type api_JwkThumbprintHash as JwkThumbprintHash, type api_JwkThumbprintOutcome as JwkThumbprintOutcome, type api_JwkThumbprintResult as JwkThumbprintResult, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_computeJwkThumbprint as computeJwkThumbprint, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
 }
 
-export { generateMetaHtml as $, base64urlDecode as A, base64urlEncode as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, buildCurl as E, type FormatResult as F, buildCurlMultiline as G, HTTP_METHODS as H, buildUrl as I, type JwkSummary as J, convertToCode as K, decodeJwt as L, type MetaTags as M, decodeUrlComponent as N, type OgTags as O, type ParsedUrl as P, detectFormat as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, encodeUrlComponent as U, extractJsonPaths as V, formatJwtJson as W, formatResponse as X, generateCors as Y, generateCspHeader as Z, generateFullHeader as _, api as a, getParam as a0, getStats as a1, isValidUrl as a2, normalizeUrl as a3, parseCspHeader as a4, parseCurl as a5, parseCurlCommand as a6, parseJwks as a7, parseMetaTags as a8, parseUrl as a9, removeParam as aa, signJwt as ab, validateCorsConfig as ac, validateCspConfig as ad, validateOgTags as ae, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwksError as o, type JwksParseResult as p, type JwksResult as q, type JwtAlgorithm as r, type JwtDecodeError as s, type JwtDecodeResult as t, type JwtExpiry as u, type JwtPart as v, type JwtResult as w, type JwtSignOptions as x, type TwitterTags as y, addParam as z };
+export { formatJwtJson as $, type JwtResult as A, type JwtSignOptions as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, type TwitterTags as E, type FormatResult as F, addParam as G, HTTP_METHODS as H, base64urlDecode as I, type JwkSummary as J, base64urlEncode as K, buildCurl as L, type MetaTags as M, buildCurlMultiline as N, type OgTags as O, type ParsedUrl as P, buildUrl as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, computeJwkThumbprint as U, convertToCode as V, decodeJwt as W, decodeUrlComponent as X, detectFormat as Y, encodeUrlComponent as Z, extractJsonPaths as _, api as a, formatResponse as a0, generateCors as a1, generateCspHeader as a2, generateFullHeader as a3, generateMetaHtml as a4, getParam as a5, getStats as a6, isValidUrl as a7, normalizeUrl as a8, parseCspHeader as a9, parseCurl as aa, parseCurlCommand as ab, parseJwks as ac, parseMetaTags as ad, parseUrl as ae, removeParam as af, signJwt as ag, validateCorsConfig as ah, validateCspConfig as ai, validateOgTags as aj, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwkThumbprintErrorResult as o, type JwkThumbprintHash as p, type JwkThumbprintOutcome as q, type JwkThumbprintResult as r, type JwksError as s, type JwksParseResult as t, type JwksResult as u, type JwtAlgorithm as v, type JwtDecodeError as w, type JwtDecodeResult as x, type JwtExpiry as y, type JwtPart as z };

package/dist/{chunk-Q3B3YWOA.js → chunk-52ZDKSIX.js}

@@ -1,5 +1,5 @@
 import { __export } from './chunk-MLKGABMK.js';
-import { createHmac } from 'crypto';
+import { createHash, createHmac } from 'crypto';
 
 // src/tools/api.ts
 var api_exports = {};
@@ -17,6 +17,7 @@ __export(api_exports, {
   buildCurl: () => buildCurl,
   buildCurlMultiline: () => buildCurlMultiline,
   buildUrl: () => buildUrl,
+  computeJwkThumbprint: () => computeJwkThumbprint,
   convertToCode: () => convertToCode,
   decodeJwt: () => decodeJwt,
   decodeUrlComponent: () => decodeUrlComponent,
@@ -535,6 +536,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 = createHash(nodeHash).update(canonicalJson, "utf8").digest("base64url");
+  return { ok: true, kty, hashAlg, members, canonicalJson, thumbprint };
+}
 var ALG_TO_NODE_HASH = {
   HS256: "sha256",
   HS384: "sha384",
@@ -1266,4 +1309,4 @@ function generateMetaHtml(tags) {
   return lines.join("\n");
 }
 
-export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, api_exports, 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 };
+export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, api_exports, 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 };

package/dist/{chunk-FVKNR3PV.js → chunk-I63BCOAG.js}

@@ -25,10 +25,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,
@@ -1589,5 +1591,90 @@ 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 round22 = (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: round22(videoBitrateKbps),
+      audioBitrateKbps: round22(audioBitrateKbps),
+      totalBitrateKbps: round22(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(fileSizeBytes / 1e6),
+      fileSizeMiB: round22(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: round22(videoKbps),
+      audioBitrateKbps: round22(audioBitrateKbps),
+      totalBitrateKbps: round22(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(targetSizeMB),
+      fileSizeMiB: round22(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)
+  };
+}
 
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCompoundInterest, calculateDiscount, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, compareSemver, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, marginToMarkup, markupToMargin, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCompoundInterest, calculateDiscount, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateRuleOf72, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, marginToMarkup, markupToMargin, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };

package/dist/{chunk-XMKJYVKB.js → chunk-Q3M23WNJ.js}

@@ -4,6 +4,7 @@ import { __export } from './chunk-MLKGABMK.js';
 var media_exports = {};
 __export(media_exports, {
   readExifData: () => readExifData,
+  readFlacInfo: () => readFlacInfo,
   readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
@@ -764,5 +765,100 @@ 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;
+}
 
-export { media_exports, readExifData, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo };
+export { media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo };