@utilix-tech/sdk 0.60.0 → 0.62.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.62.0
+- Add `buildPriorityHeader`, `parsePriorityHeader` (priority-header): build an HTTP Priority request/response-header value from an urgency (0-7) and/or an incremental flag per RFC 9218, or parse an existing one into the same shape.
+- Add `lookupCloseCode`, `listCloseCodes` (websocket-close-codes): look up what a WebSocket close code means per RFC 6455 and the IANA reserved ranges, or list every well-known code.
+
+## 0.61.0
+- Add `calculateExtraPaymentPayoff` (extra-payment-mortgage-calculator): compute how much faster a fixed-rate loan pays off, and how much interest is saved, when a fixed extra amount is added to every monthly payment.
+
 ## 0.60.0
 - Add `buildRetryAfterHeader`, `parseRetryAfterHeader` (retry-after-builder): build an HTTP Retry-After response header from a delay in seconds or a target date, or parse an existing one, per RFC 9110.
 - Add `calculateFreelancerRate` (freelancer-rate-calculator): solve for the minimum hourly rate a freelancer must charge to hit a target annual income, given billable hours, weeks worked, overhead, and a profit margin.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**665 developer utility functions for Node.js: runs locally, no API key required.**
+**670 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)
@@ -343,7 +343,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, calculateVideoBitrate, calculateRuleOf72, calculateEmi, calculateRoi, compareUnitPrices, calculatePaybackPeriod, calculateCdMaturity, calculateDepreciationSchedule, calculateCashRounding, calculateMovingAverages, calculateGpa, calculateCreditUtilization, calculateDebtToIncomeRatio, calculateBlendedLoanRate, calculateFreelancerRate } 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, calculateEmi, calculateRoi, compareUnitPrices, calculatePaybackPeriod, calculateCdMaturity, calculateDepreciationSchedule, calculateCashRounding, calculateMovingAverages, calculateGpa, calculateCreditUtilization, calculateDebtToIncomeRatio, calculateBlendedLoanRate, calculateFreelancerRate, calculateExtraPaymentPayoff } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -489,6 +489,10 @@ calculateDebtToIncomeRatio([{ label: "Rent", amount: 1500 }, { label: "Car loan"
 // Minimum hourly rate to hit a target annual income, given billable hours, weeks worked, overhead, and margin
 calculateFreelancerRate({ targetAnnualIncome: 80000, billableHoursPerWeek: 25, weeksPerYear: 48 });
 // { hourlyRate: 66.67, dailyRate: 533.33, requiredAnnualRevenue: 80000, annualBillableHours: 1200, monthlyRevenueTarget: 6666.67 }
+
+// How much sooner a loan pays off, and how much interest is saved, with a fixed extra monthly payment
+calculateExtraPaymentPayoff(200000, 6, 360, 200);
+// { monthlyPayment: 1199.1, newPayoffMonths: 252, monthsSaved: 108, interestSaved: 79800.86, ... }
 ```
 
 ---
@@ -639,6 +643,22 @@ buildRetryAfterHeader({ seconds: 120 });
 // Parse an existing Retry-After header value into the same shape
 parseRetryAfterHeader("Retry-After: 120");
 // { header: "Retry-After: 120", headerValue: "120", type: "seconds", seconds: 120 }
+
+// Build a Priority request/response header from urgency (0-7) and/or incremental, per RFC 9218
+buildPriorityHeader({ urgency: 1, incremental: true });
+// { header: "Priority: u=1, i", headerValue: "u=1, i", urgency: 1, incremental: true }
+
+// Parse an existing Priority header value into the same shape, with spec defaults applied
+parsePriorityHeader("u=2");
+// { header: "Priority: u=2, i=?0", headerValue: "u=2, i=?0", urgency: 2, incremental: false }
+
+// Look up what a WebSocket close code means, per RFC 6455 and the IANA reserved ranges
+lookupCloseCode(1006);
+// { code: 1006, name: "Abnormal Closure", description: "...", range: "standard", sentOnWire: false }
+
+// List every well-known WebSocket close code (1000-1015)
+listCloseCodes();
+// [{ code: 1000, name: "Normal Closure", ... }, ...]
 ```
 
 ---
@@ -898,7 +918,7 @@ inspectGifFrames(new Uint8Array(gifBytes));
 | `@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 |
-| `@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) |
+| `@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 |
 | `@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, regex ReDoS detector, Conventional Commits linter, package.json exports field validator |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |

package/dist/{chunk-2WT347WO.js → chunk-43L7H3L2.js}

@@ -23,6 +23,7 @@ __export(network_exports, {
   buildMapUrl: () => buildMapUrl,
   buildPermissionsPolicy: () => buildPermissionsPolicy,
   buildPreferHeader: () => buildPreferHeader,
+  buildPriorityHeader: () => buildPriorityHeader,
   buildRangeHeader: () => buildRangeHeader,
   buildReferrerPolicy: () => buildReferrerPolicy,
   buildRetryAfterHeader: () => buildRetryAfterHeader,
@@ -43,6 +44,8 @@ __export(network_exports, {
   isValidIp: () => isValidIp,
   isValidIpv4: () => isValidIpv4,
   isValidIpv6: () => isValidIpv6,
+  listCloseCodes: () => listCloseCodes,
+  lookupCloseCode: () => lookupCloseCode,
   parseAcceptLanguage: () => parseAcceptLanguage,
   parseClientHintHeaders: () => parseClientHintHeaders,
   parseContentDisposition: () => parseContentDisposition,
@@ -53,6 +56,7 @@ __export(network_exports, {
   parseIpv6Address: () => parseIpv6Address,
   parsePermissionsPolicy: () => parsePermissionsPolicy,
   parsePreferHeader: () => parsePreferHeader,
+  parsePriorityHeader: () => parsePriorityHeader,
   parseRetryAfterHeader: () => parseRetryAfterHeader,
   parseUserAgent: () => parseUserAgent,
   parseVaryHeader: () => parseVaryHeader,
@@ -3019,5 +3023,96 @@ function parseRetryAfterHeader(raw) {
   const httpDate = parsed.toUTCString();
   return { header: `Retry-After: ${httpDate}`, headerValue: httpDate, type: "http-date", httpDate, iso: parsed.toISOString() };
 }
+function isValidUrgency(n) {
+  return typeof n === "number" && Number.isInteger(n) && n >= 0 && n <= 7;
+}
+function buildPriorityHeader(input) {
+  const { urgency, incremental } = input ?? {};
+  if (urgency === void 0 && incremental === void 0) {
+    return { error: "Provide at least one of urgency or incremental" };
+  }
+  if (urgency !== void 0 && !isValidUrgency(urgency)) {
+    return { error: "urgency must be an integer between 0 and 7" };
+  }
+  const parts = [];
+  if (urgency !== void 0) parts.push(`u=${urgency}`);
+  if (incremental === true) parts.push("i");
+  else if (incremental === false) parts.push("i=?0");
+  const headerValue = parts.join(", ");
+  return {
+    header: `Priority: ${headerValue}`,
+    headerValue,
+    urgency: urgency ?? 3,
+    incremental: incremental ?? false
+  };
+}
+function parsePriorityHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^priority:\s*/i, "");
+  const parts = withoutLabel.split(",").map((p) => p.trim()).filter((p) => p.length > 0);
+  if (parts.length === 0) return { error: "Input is empty" };
+  let urgency = 3;
+  let incremental = false;
+  for (const part of parts) {
+    const eq = part.indexOf("=");
+    const key = (eq === -1 ? part : part.slice(0, eq)).trim();
+    const rawValue = eq === -1 ? void 0 : part.slice(eq + 1).trim();
+    if (key === "u") {
+      if (rawValue === void 0 || !/^\d+$/.test(rawValue)) return { error: `Invalid urgency value in "${part}"` };
+      const n = Number(rawValue);
+      if (n < 0 || n > 7) return { error: `urgency must be between 0 and 7, got ${n}` };
+      urgency = n;
+    } else if (key === "i") {
+      if (rawValue === void 0 || rawValue === "?1") incremental = true;
+      else if (rawValue === "?0") incremental = false;
+      else return { error: `Invalid incremental value in "${part}"` };
+    }
+  }
+  const headerValue = incremental ? `u=${urgency}, i` : `u=${urgency}, i=?0`;
+  return { header: `Priority: ${headerValue}`, headerValue, urgency, incremental };
+}
+var WELL_KNOWN_CLOSE_CODES = {
+  1e3: { name: "Normal Closure", description: "The connection successfully completed the purpose for which it was created.", sentOnWire: true },
+  1001: { name: "Going Away", description: "An endpoint is going away, such as a server shutting down or a browser navigating away from the page.", sentOnWire: true },
+  1002: { name: "Protocol Error", description: "An endpoint is terminating the connection due to a protocol error.", sentOnWire: true },
+  1003: { name: "Unsupported Data", description: "An endpoint received a data type it cannot accept, such as a binary-only endpoint receiving a text message.", sentOnWire: true },
+  1004: { name: "Reserved", description: "Reserved. A meaning might be defined in the future.", sentOnWire: true },
+  1005: { name: "No Status Received", description: "A reserved value used internally by libraries to indicate no status code was actually present in the close frame. Must not be sent on the wire.", sentOnWire: false },
+  1006: { name: "Abnormal Closure", description: "A reserved value used internally by libraries to indicate the connection closed without a close frame, e.g. the TCP connection dropped. Must not be sent on the wire.", sentOnWire: false },
+  1007: { name: "Invalid frame payload data", description: "An endpoint is terminating the connection because it received data inconsistent with the message type, such as non-UTF-8 data in a text message.", sentOnWire: true },
+  1008: { name: "Policy Violation", description: "A generic status code used when no other code fits and the endpoint does not want to reveal further details, or a message violated its policy.", sentOnWire: true },
+  1009: { name: "Message Too Big", description: "An endpoint is terminating the connection because it received a message too large to process.", sentOnWire: true },
+  1010: { name: "Mandatory Extension", description: "A client is terminating the connection because the server did not negotiate one or more extensions the client required.", sentOnWire: true },
+  1011: { name: "Internal Error", description: "A server is terminating the connection because it encountered an unexpected condition that prevented it from fulfilling the request.", sentOnWire: true },
+  1012: { name: "Service Restart", description: "The server is terminating the connection because it is restarting.", sentOnWire: true },
+  1013: { name: "Try Again Later", description: "The server is terminating the connection due to a temporary condition, such as being overloaded, and the client should reconnect later.", sentOnWire: true },
+  1014: { name: "Bad Gateway", description: "The server, acting as a gateway or proxy, received an invalid response from an upstream server it connected to while processing the request.", sentOnWire: true },
+  1015: { name: "TLS Handshake", description: "A reserved value used internally by libraries to indicate the TLS handshake failed. Must not be sent on the wire.", sentOnWire: false }
+};
+function listCloseCodes() {
+  return Object.entries(WELL_KNOWN_CLOSE_CODES).map(([code, info]) => ({ code: Number(code), name: info.name, description: info.description, range: "standard", sentOnWire: info.sentOnWire })).sort((a, b) => a.code - b.code);
+}
+function lookupCloseCode(code) {
+  if (typeof code !== "number" || !Number.isInteger(code) || code < 0 || code > 65535) {
+    return { error: "code must be an integer between 0 and 65535" };
+  }
+  const known = WELL_KNOWN_CLOSE_CODES[code];
+  if (known) {
+    return { code, name: known.name, description: known.description, range: "standard", sentOnWire: known.sentOnWire };
+  }
+  if (code < 1e3) {
+    return { error: `${code} is not a valid WebSocket close code; codes below 1000 are not permitted on the wire` };
+  }
+  if (code <= 2999) {
+    return { code, name: "Unassigned", description: "Reserved for future use by the WebSocket protocol specification. No meaning is defined yet.", range: "reserved-future", sentOnWire: true };
+  }
+  if (code <= 3999) {
+    return { code, name: "Library/Framework Use", description: "Reserved for use by libraries, frameworks, and applications. Codes in this range are meant to be registered directly with IANA in the WebSocket Close Code Number Registry, so their meaning depends on which library or application defined them.", range: "library-framework", sentOnWire: true };
+  }
+  if (code <= 4999) {
+    return { code, name: "Private Use", description: "Reserved for private use between a specific client and server implementation. These codes cannot be registered with IANA, so their meaning is defined entirely by the application using them.", range: "private-use", sentOnWire: true };
+  }
+  return { error: `${code} is outside the defined close code ranges (0-4999); codes 5000 and above have no assigned meaning` };
+}
 
-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, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildPreferHeader, buildRangeHeader, buildReferrerPolicy, buildRetryAfterHeader, buildVaryHeader, buildXContentTypeOptionsHeader, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseAcceptLanguage, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parsePermissionsPolicy, parsePreferHeader, parseRetryAfterHeader, parseUserAgent, parseVaryHeader, parseXContentTypeOptionsHeader, 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, buildCacheControl, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildPreferHeader, buildPriorityHeader, buildRangeHeader, buildReferrerPolicy, buildRetryAfterHeader, buildVaryHeader, buildXContentTypeOptionsHeader, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, listCloseCodes, lookupCloseCode, network_exports, parseAcceptLanguage, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parsePermissionsPolicy, parsePreferHeader, parsePriorityHeader, parseRetryAfterHeader, parseUserAgent, parseVaryHeader, parseXContentTypeOptionsHeader, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap };

package/dist/{chunk-B7366PQJ.js → chunk-43WFN3CW.js}

@@ -33,6 +33,7 @@ __export(units_exports, {
   calculateDepreciationSchedule: () => calculateDepreciationSchedule,
   calculateDiscount: () => calculateDiscount,
   calculateEmi: () => calculateEmi,
+  calculateExtraPaymentPayoff: () => calculateExtraPaymentPayoff,
   calculateFreelancerRate: () => calculateFreelancerRate,
   calculateGpa: () => calculateGpa,
   calculateLoan: () => calculateLoan,
@@ -1152,6 +1153,39 @@ function calculateLoan(principal, annualRatePercent, termMonths) {
     schedule
   };
 }
+function calculateExtraPaymentPayoff(principal, annualRatePercent, termMonths, extraMonthlyPayment) {
+  const baseline = calculateLoan(principal, annualRatePercent, termMonths);
+  if ("error" in baseline) return baseline;
+  if (!Number.isFinite(extraMonthlyPayment) || extraMonthlyPayment < 0) {
+    return { error: "Extra monthly payment must be zero or a positive number" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  const payment = round2(baseline.monthlyPayment) + round2(extraMonthlyPayment);
+  let balance = round2(principal);
+  let totalInterestPaid = 0;
+  let payoffMonths = termMonths;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = payment - interest;
+    if (principalPortion > balance) principalPortion = balance;
+    totalInterestPaid += interest;
+    balance = round2(balance - principalPortion);
+    if (balance <= 0) {
+      payoffMonths = month;
+      break;
+    }
+  }
+  return {
+    monthlyPayment: round2(baseline.monthlyPayment),
+    extraMonthlyPayment: round2(extraMonthlyPayment),
+    baselinePayoffMonths: termMonths,
+    baselineTotalInterest: baseline.totalInterest,
+    newPayoffMonths: payoffMonths,
+    newTotalInterest: round2(totalInterestPaid),
+    monthsSaved: termMonths - payoffMonths,
+    interestSaved: round2(baseline.totalInterest - totalInterestPaid)
+  };
+}
 var BARCODE_FORMAT_BY_LENGTH = { 8: "EAN-8", 12: "UPC-A", 13: "EAN-13" };
 function computeBarcodeCheckDigit(dataDigits) {
   let sum = 0;
@@ -2348,4 +2382,4 @@ function calculateFreelancerRate(input) {
   };
 }
 
-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, calculateFreelancerRate, calculateGpa, calculateLoan, 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, 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, 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, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };

package/dist/index.cjs

@@ -8431,6 +8431,7 @@ __export(units_exports, {
   calculateDepreciationSchedule: () => calculateDepreciationSchedule,
   calculateDiscount: () => calculateDiscount,
   calculateEmi: () => calculateEmi,
+  calculateExtraPaymentPayoff: () => calculateExtraPaymentPayoff,
   calculateFreelancerRate: () => calculateFreelancerRate,
   calculateGpa: () => calculateGpa,
   calculateLoan: () => calculateLoan,
@@ -9550,6 +9551,39 @@ function calculateLoan(principal, annualRatePercent, termMonths) {
     schedule
   };
 }
+function calculateExtraPaymentPayoff(principal, annualRatePercent, termMonths, extraMonthlyPayment) {
+  const baseline = calculateLoan(principal, annualRatePercent, termMonths);
+  if ("error" in baseline) return baseline;
+  if (!Number.isFinite(extraMonthlyPayment) || extraMonthlyPayment < 0) {
+    return { error: "Extra monthly payment must be zero or a positive number" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  const payment = round2(baseline.monthlyPayment) + round2(extraMonthlyPayment);
+  let balance = round2(principal);
+  let totalInterestPaid = 0;
+  let payoffMonths = termMonths;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = payment - interest;
+    if (principalPortion > balance) principalPortion = balance;
+    totalInterestPaid += interest;
+    balance = round2(balance - principalPortion);
+    if (balance <= 0) {
+      payoffMonths = month;
+      break;
+    }
+  }
+  return {
+    monthlyPayment: round2(baseline.monthlyPayment),
+    extraMonthlyPayment: round2(extraMonthlyPayment),
+    baselinePayoffMonths: termMonths,
+    baselineTotalInterest: baseline.totalInterest,
+    newPayoffMonths: payoffMonths,
+    newTotalInterest: round2(totalInterestPaid),
+    monthsSaved: termMonths - payoffMonths,
+    interestSaved: round2(baseline.totalInterest - totalInterestPaid)
+  };
+}
 var BARCODE_FORMAT_BY_LENGTH = { 8: "EAN-8", 12: "UPC-A", 13: "EAN-13" };
 function computeBarcodeCheckDigit(dataDigits) {
   let sum = 0;
@@ -10769,6 +10803,7 @@ __export(network_exports, {
   buildMapUrl: () => buildMapUrl,
   buildPermissionsPolicy: () => buildPermissionsPolicy,
   buildPreferHeader: () => buildPreferHeader,
+  buildPriorityHeader: () => buildPriorityHeader,
   buildRangeHeader: () => buildRangeHeader,
   buildReferrerPolicy: () => buildReferrerPolicy,
   buildRetryAfterHeader: () => buildRetryAfterHeader,
@@ -10789,6 +10824,8 @@ __export(network_exports, {
   isValidIp: () => isValidIp2,
   isValidIpv4: () => isValidIpv42,
   isValidIpv6: () => isValidIpv6,
+  listCloseCodes: () => listCloseCodes,
+  lookupCloseCode: () => lookupCloseCode,
   parseAcceptLanguage: () => parseAcceptLanguage,
   parseClientHintHeaders: () => parseClientHintHeaders,
   parseContentDisposition: () => parseContentDisposition,
@@ -10799,6 +10836,7 @@ __export(network_exports, {
   parseIpv6Address: () => parseIpv6Address,
   parsePermissionsPolicy: () => parsePermissionsPolicy,
   parsePreferHeader: () => parsePreferHeader,
+  parsePriorityHeader: () => parsePriorityHeader,
   parseRetryAfterHeader: () => parseRetryAfterHeader,
   parseUserAgent: () => parseUserAgent,
   parseVaryHeader: () => parseVaryHeader,
@@ -13765,6 +13803,97 @@ function parseRetryAfterHeader(raw) {
   const httpDate = parsed.toUTCString();
   return { header: `Retry-After: ${httpDate}`, headerValue: httpDate, type: "http-date", httpDate, iso: parsed.toISOString() };
 }
+function isValidUrgency(n) {
+  return typeof n === "number" && Number.isInteger(n) && n >= 0 && n <= 7;
+}
+function buildPriorityHeader(input) {
+  const { urgency, incremental } = input ?? {};
+  if (urgency === void 0 && incremental === void 0) {
+    return { error: "Provide at least one of urgency or incremental" };
+  }
+  if (urgency !== void 0 && !isValidUrgency(urgency)) {
+    return { error: "urgency must be an integer between 0 and 7" };
+  }
+  const parts = [];
+  if (urgency !== void 0) parts.push(`u=${urgency}`);
+  if (incremental === true) parts.push("i");
+  else if (incremental === false) parts.push("i=?0");
+  const headerValue = parts.join(", ");
+  return {
+    header: `Priority: ${headerValue}`,
+    headerValue,
+    urgency: urgency ?? 3,
+    incremental: incremental ?? false
+  };
+}
+function parsePriorityHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^priority:\s*/i, "");
+  const parts = withoutLabel.split(",").map((p) => p.trim()).filter((p) => p.length > 0);
+  if (parts.length === 0) return { error: "Input is empty" };
+  let urgency = 3;
+  let incremental = false;
+  for (const part of parts) {
+    const eq = part.indexOf("=");
+    const key = (eq === -1 ? part : part.slice(0, eq)).trim();
+    const rawValue = eq === -1 ? void 0 : part.slice(eq + 1).trim();
+    if (key === "u") {
+      if (rawValue === void 0 || !/^\d+$/.test(rawValue)) return { error: `Invalid urgency value in "${part}"` };
+      const n = Number(rawValue);
+      if (n < 0 || n > 7) return { error: `urgency must be between 0 and 7, got ${n}` };
+      urgency = n;
+    } else if (key === "i") {
+      if (rawValue === void 0 || rawValue === "?1") incremental = true;
+      else if (rawValue === "?0") incremental = false;
+      else return { error: `Invalid incremental value in "${part}"` };
+    }
+  }
+  const headerValue = incremental ? `u=${urgency}, i` : `u=${urgency}, i=?0`;
+  return { header: `Priority: ${headerValue}`, headerValue, urgency, incremental };
+}
+var WELL_KNOWN_CLOSE_CODES = {
+  1e3: { name: "Normal Closure", description: "The connection successfully completed the purpose for which it was created.", sentOnWire: true },
+  1001: { name: "Going Away", description: "An endpoint is going away, such as a server shutting down or a browser navigating away from the page.", sentOnWire: true },
+  1002: { name: "Protocol Error", description: "An endpoint is terminating the connection due to a protocol error.", sentOnWire: true },
+  1003: { name: "Unsupported Data", description: "An endpoint received a data type it cannot accept, such as a binary-only endpoint receiving a text message.", sentOnWire: true },
+  1004: { name: "Reserved", description: "Reserved. A meaning might be defined in the future.", sentOnWire: true },
+  1005: { name: "No Status Received", description: "A reserved value used internally by libraries to indicate no status code was actually present in the close frame. Must not be sent on the wire.", sentOnWire: false },
+  1006: { name: "Abnormal Closure", description: "A reserved value used internally by libraries to indicate the connection closed without a close frame, e.g. the TCP connection dropped. Must not be sent on the wire.", sentOnWire: false },
+  1007: { name: "Invalid frame payload data", description: "An endpoint is terminating the connection because it received data inconsistent with the message type, such as non-UTF-8 data in a text message.", sentOnWire: true },
+  1008: { name: "Policy Violation", description: "A generic status code used when no other code fits and the endpoint does not want to reveal further details, or a message violated its policy.", sentOnWire: true },
+  1009: { name: "Message Too Big", description: "An endpoint is terminating the connection because it received a message too large to process.", sentOnWire: true },
+  1010: { name: "Mandatory Extension", description: "A client is terminating the connection because the server did not negotiate one or more extensions the client required.", sentOnWire: true },
+  1011: { name: "Internal Error", description: "A server is terminating the connection because it encountered an unexpected condition that prevented it from fulfilling the request.", sentOnWire: true },
+  1012: { name: "Service Restart", description: "The server is terminating the connection because it is restarting.", sentOnWire: true },
+  1013: { name: "Try Again Later", description: "The server is terminating the connection due to a temporary condition, such as being overloaded, and the client should reconnect later.", sentOnWire: true },
+  1014: { name: "Bad Gateway", description: "The server, acting as a gateway or proxy, received an invalid response from an upstream server it connected to while processing the request.", sentOnWire: true },
+  1015: { name: "TLS Handshake", description: "A reserved value used internally by libraries to indicate the TLS handshake failed. Must not be sent on the wire.", sentOnWire: false }
+};
+function listCloseCodes() {
+  return Object.entries(WELL_KNOWN_CLOSE_CODES).map(([code, info]) => ({ code: Number(code), name: info.name, description: info.description, range: "standard", sentOnWire: info.sentOnWire })).sort((a, b) => a.code - b.code);
+}
+function lookupCloseCode(code) {
+  if (typeof code !== "number" || !Number.isInteger(code) || code < 0 || code > 65535) {
+    return { error: "code must be an integer between 0 and 65535" };
+  }
+  const known = WELL_KNOWN_CLOSE_CODES[code];
+  if (known) {
+    return { code, name: known.name, description: known.description, range: "standard", sentOnWire: known.sentOnWire };
+  }
+  if (code < 1e3) {
+    return { error: `${code} is not a valid WebSocket close code; codes below 1000 are not permitted on the wire` };
+  }
+  if (code <= 2999) {
+    return { code, name: "Unassigned", description: "Reserved for future use by the WebSocket protocol specification. No meaning is defined yet.", range: "reserved-future", sentOnWire: true };
+  }
+  if (code <= 3999) {
+    return { code, name: "Library/Framework Use", description: "Reserved for use by libraries, frameworks, and applications. Codes in this range are meant to be registered directly with IANA in the WebSocket Close Code Number Registry, so their meaning depends on which library or application defined them.", range: "library-framework", sentOnWire: true };
+  }
+  if (code <= 4999) {
+    return { code, name: "Private Use", description: "Reserved for private use between a specific client and server implementation. These codes cannot be registered with IANA, so their meaning is defined entirely by the application using them.", range: "private-use", sentOnWire: true };
+  }
+  return { error: `${code} is outside the defined close code ranges (0-4999); codes 5000 and above have no assigned meaning` };
+}
 
 // src/tools/api.ts
 var api_exports = {};

package/dist/index.d.cts

@@ -5,8 +5,8 @@ export { t as text } from './text-DWUcY8H1.cjs';
 export { d as data } from './data-vxXrBlWh.cjs';
 export { g as generators } from './generators-DAXXrMvG.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
-export { u as units } from './units-ClKR6Jxz.cjs';
-export { n as network } from './network-CXt69chQ.cjs';
+export { u as units } from './units-izyUpUAb.cjs';
+export { n as network } from './network-DewFJy4E.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-rxidGgvB.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { t as text } from './text-DWUcY8H1.js';
 export { d as data } from './data-vxXrBlWh.js';
 export { g as generators } from './generators-DAXXrMvG.js';
 export { t as time } from './time-KqJjdqII.js';
-export { u as units } from './units-ClKR6Jxz.js';
-export { n as network } from './network-CXt69chQ.js';
+export { u as units } from './units-izyUpUAb.js';
+export { n as network } from './network-DewFJy4E.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-rxidGgvB.js';
 export { c as color } from './color-tPwZCr9H.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { media_exports as media } from './chunk-226EH3ZI.js';
-export { units_exports as units } from './chunk-B7366PQJ.js';
-export { network_exports as network } from './chunk-2WT347WO.js';
+export { units_exports as units } from './chunk-43WFN3CW.js';
+export { network_exports as network } from './chunk-43L7H3L2.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-JW4NG2GN.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';