@utilix-tech/sdk 0.69.0 → 0.71.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.71.0
+- Add `readMidiInfo` (midi-file-info): parse a Standard MIDI File's header and every track chunk to report format, tick division, initial tempo, time signature, and per-track event/note-on counts, plus total duration in seconds accounting for tempo changes.
+
+## 0.70.0
+- Add `generateHotp`, `generateTotp` (totp-hotp-generator): generate an HOTP code (RFC 4226) for a counter value, or the current TOTP code (RFC 6238) plus seconds until rotation, from a base32-encoded shared secret, supporting SHA-1/SHA-256/SHA-512 and 6-8 digit codes.
+- Add `calculateTaxEquivalentYield` (tax-equivalent-yield-calculator): convert between a tax-free municipal bond yield and its taxable equivalent given a marginal federal (plus optional state) tax rate, in both directions.
+
 ## 0.69.0
 - Add `parseCommitTrailers` (git-commit-trailer-parser): parse a commit message's trailer block (Co-authored-by, Signed-off-by, Fixes, Reviewed-by, etc.) per git's RFC 822-style trailer convention, returning each trailer's key and value plus the body with the trailer block removed.
 - Add `extractMarkdownFootnotes` (markdown-footnote-extractor): extract every Markdown-Extra-style footnote reference and definition from a document, flagging references with no matching definition and definitions that are never referenced.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**688 developer utility functions for Node.js: runs locally, no API key required.**
+**692 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)
@@ -876,10 +876,10 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media`: Image Header Parsing, EXIF, PDF Metadata & Page Dimensions, WAV, ID3, ICO, FLAC, Video & GIF Metadata
+### `/media`: Image Header Parsing, EXIF, PDF Metadata & Page Dimensions, WAV, ID3, ICO, FLAC, Video, GIF & MIDI Metadata
 
 ```ts
-import { readImageInfo, readExifData, readPdfMetadata, readPdfPageDimensions, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo, readVideoInfo, inspectGifFrames } from "@utilix-tech/sdk/media";
+import { readImageInfo, readExifData, readPdfMetadata, readPdfPageDimensions, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo, readVideoInfo, inspectGifFrames, readMidiInfo } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
 // file bytes: no decoding, no canvas, no image library.
@@ -945,9 +945,17 @@ readVideoInfo(new Uint8Array(videoBytes));
 const gifBytes = await fs.promises.readFile("animation.gif");
 inspectGifFrames(new Uint8Array(gifBytes));
 // { version: "89a", width: 480, height: 270, frameCount: 24, animated: true, loopCount: 0, totalDurationMs: 2400, ... }
+
+// Parses a Standard MIDI File's header and every track chunk to report
+// format, tick division, initial tempo, time signature, and per-track
+// event/note-on counts, plus total duration in seconds: no MIDI playback
+// or synthesis.
+const midiBytes = await fs.promises.readFile("song.mid");
+readMidiInfo(new Uint8Array(midiBytes));
+// { format: 1, trackCount: 2, initialTempoBpm: 120, timeSignature: { numerator: 4, denominator: 4 }, durationSeconds: 4, tracks: [...] }
 ```
 
-`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. `readVideoInfo` supports MP4 (ISO BMFF) and WebM (EBML/Matroska) containers only. `inspectGifFrames` reads the GIF87a/89a block structure only; it never decodes pixel data.
+`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. `readVideoInfo` supports MP4 (ISO BMFF) and WebM (EBML/Matroska) containers only. `inspectGifFrames` reads the GIF87a/89a block structure only; it never decodes pixel data. `readMidiInfo` reads Standard MIDI Files (format 0/1/2) only.
 
 ---
 
@@ -962,9 +970,9 @@ inspectGifFrames(new Uint8Array(gifBytes));
 | `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, NDJSON record deduplicator, SRT/WebVTT subtitles, Markdown front matter parser, YAML anchor/alias resolver, CSV column type inferencer, Markdown table column aligner |
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, entropy estimator, fake data, CSP nonce generator |
 | `@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, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator, ROI calculator, cash denomination/till calculator, payback period calculator, CD maturity calculator, debt-to-income ratio calculator, freelancer hourly rate calculator, debt snowball/avalanche payoff planner |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator, ROI calculator, cash denomination/till calculator, payback period calculator, CD maturity calculator, debt-to-income ratio calculator, freelancer hourly rate calculator, debt snowball/avalanche payoff planner, tax-equivalent yield calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand, Permissions-Policy header builder, Client Hints header builder/parser, Content-Disposition header builder/parser, X-Content-Type-Options header builder/risk assessor, sitemap.xml validator, sitemap index splitter, Prefer header builder/parser (RFC 7240), Retry-After header builder/parser (RFC 9110), Priority header builder/parser (RFC 9218), WebSocket close code reference/lookup, Strict-Transport-Security (HSTS) header builder/parser, X-Robots-Tag header builder/parser, WebSocket frame opcode reference/lookup, robots meta tag builder/parser |
-| `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header |
+| `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header, TOTP/HOTP code generator |
 | `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor, regex capture group/backreference visualizer, SVG sprite symbol extractor |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |

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

@@ -13,6 +13,7 @@
  *  - url-parser      : parseUrl, buildUrl, addParam, removeParam, getParam,
  *                      encodeUrlComponent, decodeUrlComponent, isValidUrl, normalizeUrl
  *  - og-meta         : parseMetaTags, validateOgTags, generateMetaHtml
+ *  - totp-hotp-generator : generateHotp, generateTotp
  *
  * Node 18+ only. All crypto uses node:crypto; no browser-only APIs.
  */
@@ -287,6 +288,51 @@ declare function validateOgTags(tags: OgTags): {
     missing: string[];
 };
 declare function generateMetaHtml(tags: Partial<OgTags & TwitterTags>): string;
+type OtpAlgorithm = 'SHA1' | 'SHA256' | 'SHA512';
+interface OtpOptions {
+    digits?: number;
+    algorithm?: OtpAlgorithm;
+}
+interface HotpResult {
+    code: string;
+    counter: number;
+    digits: number;
+    algorithm: OtpAlgorithm;
+}
+/**
+ * Generates an HOTP code (RFC 4226) for a given counter value from a
+ * base32-encoded shared secret. Supports 6-8 digit codes and
+ * SHA-1/SHA-256/SHA-512 (SHA-1 is the default per the RFC and what most
+ * authenticator apps expect). The secret is never stored, only used for
+ * this one HMAC computation.
+ */
+declare function generateHotp(secret: string, counter: number, options?: OtpOptions): HotpResult | {
+    error: string;
+};
+interface TotpOptions extends OtpOptions {
+    periodSeconds?: number;
+    /** Unix timestamp in seconds. Defaults to the current time; pass an
+     *  explicit value for deterministic/testable output. */
+    timestamp?: number;
+}
+interface TotpResult {
+    code: string;
+    counter: number;
+    digits: number;
+    algorithm: OtpAlgorithm;
+    periodSeconds: number;
+    secondsRemaining: number;
+}
+/**
+ * Generates the current TOTP code (RFC 6238) from a base32-encoded shared
+ * secret, plus how many seconds remain before it rotates. TOTP is HOTP
+ * where the counter is the number of `periodSeconds` windows elapsed since
+ * the Unix epoch. Defaults (30s period, 6 digits, SHA-1) match what
+ * Google Authenticator and most other authenticator apps use.
+ */
+declare function generateTotp(secret: string, options?: TotpOptions): TotpResult | {
+    error: string;
+};
 
 declare const api_COMMON_HEADERS: typeof COMMON_HEADERS;
 declare const api_COMMON_PRESETS: typeof COMMON_PRESETS;
@@ -304,6 +350,7 @@ type api_DirectiveConfig = DirectiveConfig;
 type api_FormatResult = FormatResult;
 declare const api_HTTP_METHODS: typeof HTTP_METHODS;
 type api_Header = Header;
+type api_HotpResult = HotpResult;
 type api_HttpMethod = HttpMethod;
 type api_JwkSummary = JwkSummary;
 type api_JwkThumbprintErrorResult = JwkThumbprintErrorResult;
@@ -322,10 +369,14 @@ type api_JwtResult = JwtResult;
 type api_JwtSignOptions = JwtSignOptions;
 type api_MetaTags = MetaTags;
 type api_OgTags = OgTags;
+type api_OtpAlgorithm = OtpAlgorithm;
+type api_OtpOptions = OtpOptions;
 type api_ParsedUrl = ParsedUrl;
 type api_ResponseFormat = ResponseFormat;
 declare const api_SUPPORTED_LANGUAGES: typeof SUPPORTED_LANGUAGES;
 type api_TargetLanguage = TargetLanguage;
+type api_TotpOptions = TotpOptions;
+type api_TotpResult = TotpResult;
 type api_TwitterTags = TwitterTags;
 declare const api_addParam: typeof addParam;
 declare const api_base64urlDecode: typeof base64urlDecode;
@@ -345,7 +396,9 @@ declare const api_formatResponse: typeof formatResponse;
 declare const api_generateCors: typeof generateCors;
 declare const api_generateCspHeader: typeof generateCspHeader;
 declare const api_generateFullHeader: typeof generateFullHeader;
+declare const api_generateHotp: typeof generateHotp;
 declare const api_generateMetaHtml: typeof generateMetaHtml;
+declare const api_generateTotp: typeof generateTotp;
 declare const api_getParam: typeof getParam;
 declare const api_getStats: typeof getStats;
 declare const api_isValidUrl: typeof isValidUrl;
@@ -362,7 +415,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_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 { 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_HotpResult as HotpResult, 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_OtpAlgorithm as OtpAlgorithm, type api_OtpOptions as OtpOptions, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TotpOptions as TotpOptions, type api_TotpResult as TotpResult, 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_generateHotp as generateHotp, api_generateMetaHtml as generateMetaHtml, api_generateTotp as generateTotp, 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 { 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 };
+export { decodeJwt as $, type JwtPart as A, type JwtResult as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, type JwtSignOptions as E, type FormatResult as F, type OtpAlgorithm as G, HTTP_METHODS as H, type OtpOptions as I, type JwkSummary as J, type TotpOptions as K, type TotpResult as L, type MetaTags as M, type TwitterTags as N, type OgTags as O, type ParsedUrl as P, addParam as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, base64urlDecode as U, base64urlEncode as V, buildCurl as W, buildCurlMultiline as X, buildUrl as Y, computeJwkThumbprint as Z, convertToCode as _, api as a, decodeUrlComponent as a0, detectFormat as a1, encodeUrlComponent as a2, extractJsonPaths as a3, formatJwtJson as a4, formatResponse as a5, generateCors as a6, generateCspHeader as a7, generateFullHeader as a8, generateHotp as a9, generateMetaHtml as aa, generateTotp as ab, getParam as ac, getStats as ad, isValidUrl as ae, normalizeUrl as af, parseCspHeader as ag, parseCurl as ah, parseCurlCommand as ai, parseJwks as aj, parseMetaTags as ak, parseUrl as al, removeParam as am, signJwt as an, validateCorsConfig as ao, validateCspConfig as ap, validateOgTags as aq, 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 HotpResult as n, type HttpMethod as o, type JwkThumbprintErrorResult as p, type JwkThumbprintHash as q, type JwkThumbprintOutcome as r, type JwkThumbprintResult as s, type JwksError as t, type JwksParseResult as u, type JwksResult as v, type JwtAlgorithm as w, type JwtDecodeError as x, type JwtDecodeResult as y, type JwtExpiry as z };

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

@@ -13,6 +13,7 @@
  *  - url-parser      : parseUrl, buildUrl, addParam, removeParam, getParam,
  *                      encodeUrlComponent, decodeUrlComponent, isValidUrl, normalizeUrl
  *  - og-meta         : parseMetaTags, validateOgTags, generateMetaHtml
+ *  - totp-hotp-generator : generateHotp, generateTotp
  *
  * Node 18+ only. All crypto uses node:crypto; no browser-only APIs.
  */
@@ -287,6 +288,51 @@ declare function validateOgTags(tags: OgTags): {
     missing: string[];
 };
 declare function generateMetaHtml(tags: Partial<OgTags & TwitterTags>): string;
+type OtpAlgorithm = 'SHA1' | 'SHA256' | 'SHA512';
+interface OtpOptions {
+    digits?: number;
+    algorithm?: OtpAlgorithm;
+}
+interface HotpResult {
+    code: string;
+    counter: number;
+    digits: number;
+    algorithm: OtpAlgorithm;
+}
+/**
+ * Generates an HOTP code (RFC 4226) for a given counter value from a
+ * base32-encoded shared secret. Supports 6-8 digit codes and
+ * SHA-1/SHA-256/SHA-512 (SHA-1 is the default per the RFC and what most
+ * authenticator apps expect). The secret is never stored, only used for
+ * this one HMAC computation.
+ */
+declare function generateHotp(secret: string, counter: number, options?: OtpOptions): HotpResult | {
+    error: string;
+};
+interface TotpOptions extends OtpOptions {
+    periodSeconds?: number;
+    /** Unix timestamp in seconds. Defaults to the current time; pass an
+     *  explicit value for deterministic/testable output. */
+    timestamp?: number;
+}
+interface TotpResult {
+    code: string;
+    counter: number;
+    digits: number;
+    algorithm: OtpAlgorithm;
+    periodSeconds: number;
+    secondsRemaining: number;
+}
+/**
+ * Generates the current TOTP code (RFC 6238) from a base32-encoded shared
+ * secret, plus how many seconds remain before it rotates. TOTP is HOTP
+ * where the counter is the number of `periodSeconds` windows elapsed since
+ * the Unix epoch. Defaults (30s period, 6 digits, SHA-1) match what
+ * Google Authenticator and most other authenticator apps use.
+ */
+declare function generateTotp(secret: string, options?: TotpOptions): TotpResult | {
+    error: string;
+};
 
 declare const api_COMMON_HEADERS: typeof COMMON_HEADERS;
 declare const api_COMMON_PRESETS: typeof COMMON_PRESETS;
@@ -304,6 +350,7 @@ type api_DirectiveConfig = DirectiveConfig;
 type api_FormatResult = FormatResult;
 declare const api_HTTP_METHODS: typeof HTTP_METHODS;
 type api_Header = Header;
+type api_HotpResult = HotpResult;
 type api_HttpMethod = HttpMethod;
 type api_JwkSummary = JwkSummary;
 type api_JwkThumbprintErrorResult = JwkThumbprintErrorResult;
@@ -322,10 +369,14 @@ type api_JwtResult = JwtResult;
 type api_JwtSignOptions = JwtSignOptions;
 type api_MetaTags = MetaTags;
 type api_OgTags = OgTags;
+type api_OtpAlgorithm = OtpAlgorithm;
+type api_OtpOptions = OtpOptions;
 type api_ParsedUrl = ParsedUrl;
 type api_ResponseFormat = ResponseFormat;
 declare const api_SUPPORTED_LANGUAGES: typeof SUPPORTED_LANGUAGES;
 type api_TargetLanguage = TargetLanguage;
+type api_TotpOptions = TotpOptions;
+type api_TotpResult = TotpResult;
 type api_TwitterTags = TwitterTags;
 declare const api_addParam: typeof addParam;
 declare const api_base64urlDecode: typeof base64urlDecode;
@@ -345,7 +396,9 @@ declare const api_formatResponse: typeof formatResponse;
 declare const api_generateCors: typeof generateCors;
 declare const api_generateCspHeader: typeof generateCspHeader;
 declare const api_generateFullHeader: typeof generateFullHeader;
+declare const api_generateHotp: typeof generateHotp;
 declare const api_generateMetaHtml: typeof generateMetaHtml;
+declare const api_generateTotp: typeof generateTotp;
 declare const api_getParam: typeof getParam;
 declare const api_getStats: typeof getStats;
 declare const api_isValidUrl: typeof isValidUrl;
@@ -362,7 +415,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_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 { 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_HotpResult as HotpResult, 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_OtpAlgorithm as OtpAlgorithm, type api_OtpOptions as OtpOptions, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TotpOptions as TotpOptions, type api_TotpResult as TotpResult, 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_generateHotp as generateHotp, api_generateMetaHtml as generateMetaHtml, api_generateTotp as generateTotp, 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 { 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 };
+export { decodeJwt as $, type JwtPart as A, type JwtResult as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, type JwtSignOptions as E, type FormatResult as F, type OtpAlgorithm as G, HTTP_METHODS as H, type OtpOptions as I, type JwkSummary as J, type TotpOptions as K, type TotpResult as L, type MetaTags as M, type TwitterTags as N, type OgTags as O, type ParsedUrl as P, addParam as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, base64urlDecode as U, base64urlEncode as V, buildCurl as W, buildCurlMultiline as X, buildUrl as Y, computeJwkThumbprint as Z, convertToCode as _, api as a, decodeUrlComponent as a0, detectFormat as a1, encodeUrlComponent as a2, extractJsonPaths as a3, formatJwtJson as a4, formatResponse as a5, generateCors as a6, generateCspHeader as a7, generateFullHeader as a8, generateHotp as a9, generateMetaHtml as aa, generateTotp as ab, getParam as ac, getStats as ad, isValidUrl as ae, normalizeUrl as af, parseCspHeader as ag, parseCurl as ah, parseCurlCommand as ai, parseJwks as aj, parseMetaTags as ak, parseUrl as al, removeParam as am, signJwt as an, validateCorsConfig as ao, validateCspConfig as ap, validateOgTags as aq, 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 HotpResult as n, type HttpMethod as o, type JwkThumbprintErrorResult as p, type JwkThumbprintHash as q, type JwkThumbprintOutcome as r, type JwkThumbprintResult as s, type JwksError as t, type JwksParseResult as u, type JwksResult as v, type JwtAlgorithm as w, type JwtDecodeError as x, type JwtDecodeResult as y, type JwtExpiry as z };

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

@@ -29,7 +29,9 @@ __export(api_exports, {
   generateCors: () => generateCors,
   generateCspHeader: () => generateCspHeader,
   generateFullHeader: () => generateFullHeader,
+  generateHotp: () => generateHotp,
   generateMetaHtml: () => generateMetaHtml,
+  generateTotp: () => generateTotp,
   getParam: () => getParam,
   getStats: () => getStats,
   isValidUrl: () => isValidUrl,
@@ -1308,5 +1310,74 @@ 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 = 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 };
+}
 
-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 };
+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, generateHotp, generateMetaHtml, generateTotp, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags };

package/dist/{chunk-4HNHEOJL.js → chunk-653HDWXW.js}

@@ -47,6 +47,7 @@ __export(units_exports, {
   calculateSavingsGoal: () => calculateSavingsGoal,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
+  calculateTaxEquivalentYield: () => calculateTaxEquivalentYield,
   calculateTimeValue: () => calculateTimeValue,
   calculateTipSplit: () => calculateTipSplit,
   calculateVideoBitrate: () => calculateVideoBitrate,
@@ -2503,5 +2504,44 @@ 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)
+  };
+}
 
-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, GPA_GRADE_POINTS, USD_DENOMINATIONS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBlendedLoanRate, calculateBreakEven, calculateCashBreakdown, calculateCashRounding, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateCreditUtilization, calculateDebtToIncomeRatio, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateExtraPaymentPayoff, calculateFreelancerRate, calculateGpa, calculateLoan, calculateLoanRefinance, calculateMarginMarkup, calculateMovingAverages, calculatePaybackPeriod, calculatePercentageChange, calculateRoi, calculateRuleOf72, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, compareUnitPrices, 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, planDebtPayoff, 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, GPA_GRADE_POINTS, USD_DENOMINATIONS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBlendedLoanRate, calculateBreakEven, calculateCashBreakdown, calculateCashRounding, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateCreditUtilization, calculateDebtToIncomeRatio, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateExtraPaymentPayoff, calculateFreelancerRate, calculateGpa, calculateLoan, calculateLoanRefinance, calculateMarginMarkup, calculateMovingAverages, calculatePaybackPeriod, calculatePercentageChange, calculateRoi, calculateRuleOf72, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTaxEquivalentYield, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, compareUnitPrices, 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, planDebtPayoff, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };

package/dist/{chunk-226EH3ZI.js → chunk-PT4N4UBL.js}

@@ -9,6 +9,7 @@ __export(media_exports, {
   readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
+  readMidiInfo: () => readMidiInfo,
   readPdfMetadata: () => readPdfMetadata,
   readPdfPageDimensions: () => readPdfPageDimensions,
   readVideoInfo: () => readVideoInfo,
@@ -1306,5 +1307,135 @@ 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
+  };
+}
 
-export { inspectGifFrames, media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readPdfPageDimensions, readVideoInfo, readWavInfo };
+export { inspectGifFrames, media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readMidiInfo, readPdfMetadata, readPdfPageDimensions, readVideoInfo, readWavInfo };