@utilix-tech/sdk 0.93.0 → 0.95.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.95.0
+- Add `readPngChunks` (png-chunk-inspector): walk a PNG's chunk stream directly from its bytes to report every chunk's type, offset, size, and CRC-32 validity, plus the decoded IHDR header and common ancillary chunks (tEXt, pHYs, gAMA, tIME, acTL).
+- Add `estimateAudioFileSize` (audio-file-size-estimator): estimate an audio file's size before recording or exporting it, uncompressed PCM size from sample rate/bit depth/channels or compressed size from a target bitrate.
+
+## 0.94.0
+- Add `buildAltSvcHeader`/`parseAltSvcHeader` (alt-svc-header-builder): build an `Alt-Svc` response header (RFC 7838) from one or more alternative services with a plain-English note per protocol-id, flagging outdated HTTP/3 draft protocol-ids, or parse an existing header back into its alternatives, including the special `clear` value.
+
 ## 0.93.0
 - Add `findDuplicateLockfileVersions`/`detectLockfileFormat` (lockfile-duplicate-version-reporter): parse an npm, yarn, or pnpm lockfile and report every package installed at more than one resolved version, with a count of install locations per version.
 - Add `summarizeGitDiffStat` (git-diff-stat-summarizer): parse `git diff --stat` / `git log --stat` output into structured per-file insertion/deletion counts plus overall totals, flagging a scaled-down bar's split as approximate.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**738 developer utility functions for Node.js: runs locally, no API key required.**
+**742 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)
@@ -767,6 +767,21 @@ findDuplicateLockfileVersions('{"lockfileVersion":3,"packages":{"node_modules/lo
 import { summarizeGitDiffStat } from "@utilix-tech/sdk/code";
 summarizeGitDiffStat(" src/foo.ts | 12 +++++-------\n 1 file changed, 5 insertions(+), 7 deletions(-)\n");
 // { files: [{ file: "src/foo.ts", changes: 12, insertions: 5, deletions: 7, binary: false, approximate: false }], filesChanged: 1, totalInsertions: 5, totalDeletions: 7 }
+
+// Build an Alt-Svc header (RFC 7838) advertising HTTP/3, or parse an existing one
+import { buildAltSvcHeader, parseAltSvcHeader } from "@utilix-tech/sdk/network";
+buildAltSvcHeader([{ protocolId: "h3", port: 443, maxAge: 86400 }]);
+// { header: 'Alt-Svc: h3=":443"; ma=86400', headerValue: 'h3=":443"; ma=86400', entries: [{ protocolId: "h3", authority: ":443", maxAge: 86400, persist: false, note: "..." }], cleared: false, warnings: [] }
+
+// Walk a PNG's chunk stream directly from its bytes: type, offset, size, CRC validity
+import { readPngChunks } from "@utilix-tech/sdk/media";
+readPngChunks(pngBytes);
+// { valid: true, fileSize: 1024, chunkCount: 5, chunks: [{ type: "IHDR", offset: 8, dataLength: 13, crcValid: true, critical: true }, ...], header: { width: 64, height: 64, bitDepth: 8, colorType: "rgba", hasAlpha: true, interlace: false }, textChunks: [], physicalDimensions: null, gamma: null, lastModified: null, isAnimated: false }
+
+// Estimate an audio file's size before recording/exporting it
+import { estimateAudioFileSize } from "@utilix-tech/sdk/units";
+estimateAudioFileSize({ mode: "pcm", durationSeconds: 60, sampleRateHz: 44100, bitDepth: 16, channels: 2 });
+// { mode: "pcm", durationSeconds: 60, sampleRateHz: 44100, bitDepth: 16, channels: 2, dataBytes: 10584000, fileSizeBytes: 10584044, fileSizeMB: 10.58, fileSizeMiB: 10.09 }
 ```
 
 ---
@@ -1085,15 +1100,15 @@ readMidiInfo(new Uint8Array(midiBytes));
 | `@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, Markdown heading hierarchy validator, Markdown internal link checker |
 | `@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/VIN/ISIN 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, mortgage discount points break-even calculator, loan prepayment penalty calculator, data transfer time / required bandwidth estimator, real rate of return (Fisher equation) calculator, sales commission calculator (flat or tiered), annuity payout calculator, semver range intersection checker |
-| `@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, robots.txt validator, robots.txt generator, 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, Cookie header byte-size budget calculator |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN/VIN/ISIN 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, mortgage discount points break-even calculator, loan prepayment penalty calculator, data transfer time / required bandwidth estimator, real rate of return (Fisher equation) calculator, sales commission calculator (flat or tiered), annuity payout calculator, semver range intersection checker, audio file size estimator |
+| `@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, robots.txt validator, robots.txt generator, 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, Cookie header byte-size budget calculator, Alt-Svc header builder/parser (RFC 7838) |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header, TOTP/HOTP code generator, webhook HMAC signature verifier |
 | `@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, ARIA role & attribute validator, database connection string parser, Markdown code fence language tag validator, SQL query parameter placeholder counter, Markdown link reference extractor, regex character class builder, Dockerfile linter, Mermaid diagram syntax validator |
 | `@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 |
 | `@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, few-shot prompt formatter, tool-definition schema linter, retry/backoff schedule calculator, prompt template variable extractor |
-| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; PDF page dimension/orientation listing; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info; GIF frame/loop inspection |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; PDF page dimension/orientation listing; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info; GIF frame/loop inspection; PNG chunk stream inspection with CRC validation |
 
 ---
 

package/dist/{chunk-XAPHAUPI.js → chunk-G5NUC5MV.js}

@@ -70,6 +70,7 @@ __export(units_exports, {
   decimalToIpCidr: () => decimalToIpCidr,
   describePermissions: () => describePermissions,
   detectNegativeAmortization: () => detectNegativeAmortization,
+  estimateAudioFileSize: () => estimateAudioFileSize,
   fitIntoBox: () => fitIntoBox,
   formatNumber: () => formatNumber,
   formatValue: () => formatValue,
@@ -3166,5 +3167,55 @@ function detectNegativeAmortization(input) {
     capCrossedMonth
   };
 }
+var AUDIO_FILE_SIZE_WAV_HEADER_BYTES = 44;
+function estimateAudioFileSize(input) {
+  const { mode, durationSeconds } = input;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+    return { error: "durationSeconds must be a positive number" };
+  }
+  const round22 = (n) => Math.round(n * 100) / 100;
+  if (mode === "pcm") {
+    const { sampleRateHz, bitDepth, channels } = input;
+    if (!Number.isFinite(sampleRateHz) || sampleRateHz <= 0) {
+      return { error: 'sampleRateHz must be a positive number for mode "pcm"' };
+    }
+    if (!Number.isFinite(bitDepth) || bitDepth <= 0) {
+      return { error: 'bitDepth must be a positive number for mode "pcm"' };
+    }
+    if (!Number.isInteger(channels) || channels <= 0) {
+      return { error: 'channels must be a positive whole number for mode "pcm"' };
+    }
+    const dataBytes = sampleRateHz * (bitDepth / 8) * channels * durationSeconds;
+    const fileSizeBytes = dataBytes + AUDIO_FILE_SIZE_WAV_HEADER_BYTES;
+    return {
+      mode,
+      durationSeconds,
+      sampleRateHz,
+      bitDepth,
+      channels,
+      dataBytes: Math.round(dataBytes),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(fileSizeBytes / 1e6),
+      fileSizeMiB: round22(fileSizeBytes / 1048576)
+    };
+  }
+  if (mode === "compressed") {
+    const { bitrateKbps } = input;
+    if (!Number.isFinite(bitrateKbps) || bitrateKbps <= 0) {
+      return { error: 'bitrateKbps must be a positive number for mode "compressed"' };
+    }
+    const dataBytes = bitrateKbps * 1e3 * durationSeconds / 8;
+    return {
+      mode,
+      durationSeconds,
+      bitrateKbps,
+      dataBytes: Math.round(dataBytes),
+      fileSizeBytes: Math.round(dataBytes),
+      fileSizeMB: round22(dataBytes / 1e6),
+      fileSizeMiB: round22(dataBytes / 1048576)
+    };
+  }
+  return { error: 'mode must be "pcm" or "compressed"' };
+}
 
-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, calculateAnnuityPayout, calculateBlendedLoanRate, calculateBreakEven, calculateCashBreakdown, calculateCashRounding, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateCreditCardMinimumPayment, calculateCreditUtilization, calculateDebtToIncomeRatio, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateExtraPaymentPayoff, calculateFreelancerRate, calculateGpa, calculateLoan, calculateLoanPrepaymentPenalty, calculateLoanRefinance, calculateMarginMarkup, calculateMortgagePoints, calculateMovingAverages, calculatePaybackPeriod, calculatePercentageChange, calculateRealRateOfReturn, calculateRequiredBandwidth, calculateRoi, calculateRuleOf72, calculateSalesCommission, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTaxEquivalentYield, calculateTimeValue, calculateTipSplit, calculateTransferTime, calculateVideoBitrate, compareSemver, compareUnitPrices, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, detectNegativeAmortization, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, intersectSemverRanges, 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, validateIsin, validateVin, 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, calculateAnnuityPayout, calculateBlendedLoanRate, calculateBreakEven, calculateCashBreakdown, calculateCashRounding, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateCreditCardMinimumPayment, calculateCreditUtilization, calculateDebtToIncomeRatio, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateExtraPaymentPayoff, calculateFreelancerRate, calculateGpa, calculateLoan, calculateLoanPrepaymentPenalty, calculateLoanRefinance, calculateMarginMarkup, calculateMortgagePoints, calculateMovingAverages, calculatePaybackPeriod, calculatePercentageChange, calculateRealRateOfReturn, calculateRequiredBandwidth, calculateRoi, calculateRuleOf72, calculateSalesCommission, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTaxEquivalentYield, calculateTimeValue, calculateTipSplit, calculateTransferTime, calculateVideoBitrate, compareSemver, compareUnitPrices, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, detectNegativeAmortization, estimateAudioFileSize, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, intersectSemverRanges, 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, validateIsin, validateVin, viewportToPx };

package/dist/{chunk-K3B4JTHN.js → chunk-K242OOF4.js}

@@ -14,6 +14,7 @@ __export(network_exports, {
   analyzeEmailHeaders: () => analyzeEmailHeaders,
   assessContentTypeRisk: () => assessContentTypeRisk,
   buildAcceptLanguage: () => buildAcceptLanguage,
+  buildAltSvcHeader: () => buildAltSvcHeader,
   buildCacheControl: () => buildCacheControl,
   buildClearSiteData: () => buildClearSiteData,
   buildClientHints: () => buildClientHints,
@@ -56,6 +57,7 @@ __export(network_exports, {
   lookupCloseCode: () => lookupCloseCode,
   lookupOpcode: () => lookupOpcode,
   parseAcceptLanguage: () => parseAcceptLanguage,
+  parseAltSvcHeader: () => parseAltSvcHeader,
   parseClearSiteData: () => parseClearSiteData,
   parseClientHintHeaders: () => parseClientHintHeaders,
   parseContentDisposition: () => parseContentDisposition,
@@ -3711,5 +3713,113 @@ function parseClearSiteData(raw) {
   }
   return buildClearSiteData(directives);
 }
+var ALT_SVC_DEFAULT_MAX_AGE = 86400;
+var ALT_SVC_DEPRECATED_H3_DRAFTS = /* @__PURE__ */ new Set(["h3-29", "h3-27", "h3-25", "h3-24", "h3-23", "h3-22"]);
+var ALT_SVC_PROTOCOL_NOTES = {
+  "h3": "HTTP/3 over QUIC, the current protocol ID clients should be offered.",
+  "h3-29": 'An outdated HTTP/3 draft version (draft-29); modern clients only match "h3".',
+  "h3-27": 'An outdated HTTP/3 draft version (draft-27); modern clients only match "h3".',
+  "h3-25": 'An outdated HTTP/3 draft version (draft-25); modern clients only match "h3".',
+  "h2": "HTTP/2 over TLS.",
+  "h2c": "HTTP/2 over cleartext TCP; rarely advertised via Alt-Svc since it needs an out-of-band upgrade rather than ALPN negotiation.",
+  "http/1.1": "Plain HTTP/1.1; advertising it via Alt-Svc is unusual since it is already the universal fallback."
+};
+function buildAltSvcHeader(alternatives) {
+  if (!Array.isArray(alternatives) || alternatives.length === 0) {
+    return { error: "At least one alternative service is required" };
+  }
+  const warnings = [];
+  const entries = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const alt of alternatives) {
+    const protocolId = typeof alt.protocolId === "string" ? alt.protocolId.trim() : "";
+    if (!protocolId) return { error: 'Each alternative needs a protocol-id (e.g. "h3")' };
+    if (!Number.isInteger(alt.port) || alt.port < 1 || alt.port > 65535) {
+      return { error: `Each alternative needs a valid port (1-65535), got ${JSON.stringify(alt.port)}` };
+    }
+    const host = alt.host?.trim();
+    const authority = `${host ?? ""}:${alt.port}`;
+    const maxAge = alt.maxAge !== void 0 ? alt.maxAge : ALT_SVC_DEFAULT_MAX_AGE;
+    if (!Number.isFinite(maxAge) || maxAge < 0) return { error: "maxAge must be a non-negative number of seconds" };
+    const persist = alt.persist === true;
+    const dedupeKey = `${protocolId.toLowerCase()}|${authority.toLowerCase()}`;
+    if (seen.has(dedupeKey)) {
+      warnings.push(`duplicate alternative "${protocolId}=${JSON.stringify(authority)}" was removed`);
+      continue;
+    }
+    seen.add(dedupeKey);
+    if (maxAge === 0) warnings.push(`"${protocolId}" has ma=0, so clients should treat it as already expired`);
+    if (persist && maxAge === 0) warnings.push(`"${protocolId}" sets persist=1 with ma=0, which is contradictory: the entry expires immediately`);
+    if (ALT_SVC_DEPRECATED_H3_DRAFTS.has(protocolId.toLowerCase())) {
+      warnings.push(`"${protocolId}" is an outdated HTTP/3 draft protocol-id; modern clients only match "h3"`);
+    }
+    const note = ALT_SVC_PROTOCOL_NOTES[protocolId.toLowerCase()] ?? `Advertises "${protocolId}" as an alternative protocol clients may switch to for this authority.`;
+    entries.push({ protocolId, authority, maxAge, persist, note });
+  }
+  if (entries.length === 0) return { error: "At least one alternative service is required" };
+  const headerValue = entries.map((e) => {
+    let s = `${e.protocolId}="${e.authority}"; ma=${e.maxAge}`;
+    if (e.persist) s += "; persist=1";
+    return s;
+  }).join(", ");
+  return { header: `Alt-Svc: ${headerValue}`, headerValue, entries, cleared: false, warnings };
+}
+function altSvcSplitTopLevel(s, sep) {
+  const out = [];
+  let inQuotes = false;
+  let current = "";
+  for (const ch of s) {
+    if (ch === '"') inQuotes = !inQuotes;
+    if (ch === sep && !inQuotes) {
+      out.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  out.push(current);
+  return out;
+}
+function parseAltSvcHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^alt-svc:\s*/i, "");
+  if (withoutLabel.toLowerCase() === "clear") {
+    return { header: "Alt-Svc: clear", headerValue: "clear", entries: [], cleared: true, warnings: [] };
+  }
+  const parts = altSvcSplitTopLevel(withoutLabel, ",");
+  const alternatives = [];
+  for (const part of parts) {
+    const trimmedPart = part.trim();
+    if (!trimmedPart) continue;
+    const eq = trimmedPart.indexOf("=");
+    if (eq === -1) return { error: `Could not parse alternative: "${trimmedPart}"` };
+    const protocolId = trimmedPart.slice(0, eq).trim();
+    const rest = trimmedPart.slice(eq + 1).trim();
+    const segments = altSvcSplitTopLevel(rest, ";").map((s) => s.trim());
+    const authorityMatch = segments[0]?.match(/^"(.*)"$/);
+    if (!authorityMatch) return { error: `Alternative "${protocolId}" is missing a quoted authority (e.g. ":443")` };
+    const authority = authorityMatch[1];
+    const colonIdx = authority.lastIndexOf(":");
+    if (colonIdx === -1) return { error: `Alternative "${protocolId}" has an authority with no port: "${authority}"` };
+    const host = authority.slice(0, colonIdx) || void 0;
+    const portStr = authority.slice(colonIdx + 1);
+    const port = Number(portStr);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) return { error: `Alternative "${protocolId}" has an invalid port: "${portStr}"` };
+    let maxAge;
+    let persist = false;
+    for (const seg of segments.slice(1)) {
+      const sepIdx = seg.indexOf("=");
+      if (sepIdx === -1) continue;
+      const key = seg.slice(0, sepIdx).trim().toLowerCase();
+      const value = seg.slice(sepIdx + 1).trim();
+      if (key === "ma") maxAge = Number(value);
+      if (key === "persist") persist = value === "1";
+    }
+    if (maxAge !== void 0 && !Number.isFinite(maxAge)) return { error: `Alternative "${protocolId}" has a non-numeric ma value` };
+    alternatives.push({ protocolId, host, port, maxAge, persist });
+  }
+  if (alternatives.length === 0) return { error: "No alternative services found" };
+  return buildAltSvcHeader(alternatives);
+}
 
-export { CLIENT_HINTS, DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, PERMISSIONS_POLICY_FEATURES, REFERRER_POLICY_VALUES, STATUS_CODES, X_CONTENT_TYPE_OPTIONS_HEADER, analyzeEmailHeaders, assessContentTypeRisk, buildAcceptLanguage, buildCacheControl, buildClearSiteData, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildHsts, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildPreferHeader, buildPriorityHeader, buildRangeHeader, buildReferrerPolicy, buildRetryAfterHeader, buildRobotsMetaTag, buildVaryHeader, buildXContentTypeOptionsHeader, buildXRobotsTag, calculateCookieSizeBudget, checkSetCookieHeader, countryCodeToFlag, extractMultipartBoundary, formatCoordinates, formatTtl, generateRobotsTxt, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, listCloseCodes, listOpcodes, lookupCloseCode, lookupOpcode, network_exports, parseAcceptLanguage, parseClearSiteData, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseHsts, parseIpv6Address, parseMultipartFormData, parsePermissionsPolicy, parsePreferHeader, parsePriorityHeader, parseRetryAfterHeader, parseRobotsMetaTag, parseUserAgent, parseVaryHeader, parseXContentTypeOptionsHeader, parseXRobotsTag, scoreSecurityHeaders, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap };
+export { CLIENT_HINTS, DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, PERMISSIONS_POLICY_FEATURES, REFERRER_POLICY_VALUES, STATUS_CODES, X_CONTENT_TYPE_OPTIONS_HEADER, analyzeEmailHeaders, assessContentTypeRisk, buildAcceptLanguage, buildAltSvcHeader, buildCacheControl, buildClearSiteData, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildHsts, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildPreferHeader, buildPriorityHeader, buildRangeHeader, buildReferrerPolicy, buildRetryAfterHeader, buildRobotsMetaTag, buildVaryHeader, buildXContentTypeOptionsHeader, buildXRobotsTag, calculateCookieSizeBudget, checkSetCookieHeader, countryCodeToFlag, extractMultipartBoundary, formatCoordinates, formatTtl, generateRobotsTxt, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, listCloseCodes, listOpcodes, lookupCloseCode, lookupOpcode, network_exports, parseAcceptLanguage, parseAltSvcHeader, parseClearSiteData, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseHsts, parseIpv6Address, parseMultipartFormData, parsePermissionsPolicy, parsePreferHeader, parsePriorityHeader, parseRetryAfterHeader, parseRobotsMetaTag, parseUserAgent, parseVaryHeader, parseXContentTypeOptionsHeader, parseXRobotsTag, scoreSecurityHeaders, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap };

package/dist/{chunk-ZWFZRDQ4.js → chunk-YSS4VVZU.js}

@@ -13,6 +13,7 @@ __export(media_exports, {
   readPdfMetadata: () => readPdfMetadata,
   readPdfOutline: () => readPdfOutline,
   readPdfPageDimensions: () => readPdfPageDimensions,
+  readPngChunks: () => readPngChunks,
   readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
@@ -1506,5 +1507,115 @@ function readMidiInfo(bytes) {
     tracks
   };
 }
+var PNG_SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10];
+var PNG_CRC_TABLE = null;
+function getPngCrcTable() {
+  if (PNG_CRC_TABLE) return PNG_CRC_TABLE;
+  const table = new Uint32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) {
+      c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    }
+    table[n] = c;
+  }
+  PNG_CRC_TABLE = table;
+  return table;
+}
+function pngCrc32(bytes) {
+  const table = getPngCrcTable();
+  let crc = 4294967295;
+  for (let i = 0; i < bytes.length; i++) {
+    crc = table[(crc ^ bytes[i]) & 255] ^ crc >>> 8;
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function pad2(n) {
+  return n < 10 ? `0${n}` : `${n}`;
+}
+function readPngChunks(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a valid PNG file" };
+  for (let i = 0; i < 8; i++) {
+    if (bytes[i] !== PNG_SIGNATURE[i]) return { error: "Not a valid PNG file (bad 8-byte signature)" };
+  }
+  const chunks = [];
+  const textChunks = [];
+  let header = null;
+  let physicalDimensions = null;
+  let gamma = null;
+  let lastModified = null;
+  let isAnimated = false;
+  let offset = 8;
+  while (offset + 8 <= bytes.length) {
+    const dataLength = readU32BE(bytes, offset);
+    const type = String.fromCharCode(bytes[offset + 4], bytes[offset + 5], bytes[offset + 6], bytes[offset + 7]);
+    const dataStart = offset + 8;
+    const dataEnd = dataStart + dataLength;
+    const crcOffset = dataEnd;
+    if (crcOffset + 4 > bytes.length) {
+      return { error: `Truncated chunk "${type}" at offset ${offset}` };
+    }
+    const data = bytes.subarray(dataStart, dataEnd);
+    const expectedCrc = readU32BE(bytes, crcOffset);
+    const actualCrc = pngCrc32(bytes.subarray(offset + 4, dataEnd));
+    const firstChar = type.charCodeAt(0);
+    const critical = firstChar >= 65 && firstChar <= 90;
+    chunks.push({ type, offset, dataLength, crcValid: actualCrc === expectedCrc, critical });
+    if (type === "IHDR" && data.length >= 13) {
+      const colorTypeNum = data[9];
+      header = {
+        width: readU32BE(data, 0),
+        height: readU32BE(data, 4),
+        bitDepth: data[8],
+        colorType: PNG_COLOR_TYPES[colorTypeNum] ?? "unknown",
+        hasAlpha: colorTypeNum === 4 || colorTypeNum === 6,
+        interlace: data[12] === 1
+      };
+    } else if (type === "tEXt") {
+      const nullIdx = data.indexOf(0);
+      if (nullIdx !== -1) {
+        textChunks.push({
+          keyword: Buffer.from(data.subarray(0, nullIdx)).toString("latin1"),
+          text: Buffer.from(data.subarray(nullIdx + 1)).toString("latin1"),
+          compressed: false
+        });
+      }
+    } else if (type === "zTXt" || type === "iTXt") {
+      const nullIdx = data.indexOf(0);
+      if (nullIdx !== -1) {
+        textChunks.push({ keyword: Buffer.from(data.subarray(0, nullIdx)).toString("latin1"), text: null, compressed: true });
+      }
+    } else if (type === "pHYs" && data.length >= 9) {
+      physicalDimensions = {
+        pixelsPerUnitX: readU32BE(data, 0),
+        pixelsPerUnitY: readU32BE(data, 4),
+        unit: data[8] === 1 ? "meter" : "unknown"
+      };
+    } else if (type === "gAMA" && data.length >= 4) {
+      gamma = readU32BE(data, 0) / 1e5;
+    } else if (type === "tIME" && data.length >= 7) {
+      const year = data[0] << 8 | data[1];
+      lastModified = `${year}-${pad2(data[2])}-${pad2(data[3])}T${pad2(data[4])}:${pad2(data[5])}:${pad2(data[6])}Z`;
+    } else if (type === "acTL") {
+      isAnimated = true;
+    }
+    offset = crcOffset + 4;
+    if (type === "IEND") break;
+  }
+  if (chunks.length === 0) return { error: "No chunks found after the PNG signature" };
+  if (!header) return { error: "Missing required IHDR chunk" };
+  return {
+    valid: true,
+    fileSize: bytes.length,
+    chunkCount: chunks.length,
+    chunks,
+    header,
+    textChunks,
+    physicalDimensions,
+    gamma,
+    lastModified,
+    isAnimated
+  };
+}
 
-export { inspectGifFrames, media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readMidiInfo, readPdfMetadata, readPdfOutline, readPdfPageDimensions, readVideoInfo, readWavInfo };
+export { inspectGifFrames, media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readMidiInfo, readPdfMetadata, readPdfOutline, readPdfPageDimensions, readPngChunks, readVideoInfo, readWavInfo };