@utilix-tech/sdk 0.43.0 → 0.45.0

package/dist/index.cjs

@@ -7999,12 +7999,14 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateBreakEven: () => calculateBreakEven,
   calculateCashBreakdown: () => calculateCashBreakdown,
+  calculateCdMaturity: () => calculateCdMaturity,
   calculateChange: () => calculateChange,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateDiscount: () => calculateDiscount,
   calculateEmi: () => calculateEmi,
   calculateLoan: () => calculateLoan,
   calculateMarginMarkup: () => calculateMarginMarkup,
+  calculatePaybackPeriod: () => calculatePaybackPeriod,
   calculatePercentageChange: () => calculatePercentageChange,
   calculateRoi: () => calculateRoi,
   calculateRuleOf72: () => calculateRuleOf72,
@@ -9905,21 +9907,117 @@ function calculateChange(amountDue, amountTendered, denominations) {
     remainder: breakdown.remainder
   };
 }
+function _computePayback(initialInvestment, flows) {
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  let cumulative = 0;
+  const cumulativeCashFlows = [];
+  let period = null;
+  for (let i = 0; i < flows.length; i++) {
+    const prevCumulative = cumulative;
+    cumulative += flows[i];
+    cumulativeCashFlows.push(round4(cumulative));
+    if (period === null && cumulative >= initialInvestment) {
+      const remaining = initialInvestment - prevCumulative;
+      const fraction = flows[i] !== 0 ? remaining / flows[i] : 0;
+      period = i + fraction;
+    }
+  }
+  return { cumulative: cumulativeCashFlows, period };
+}
+function calculatePaybackPeriod(input) {
+  const { initialInvestment, cashFlows, discountRatePercent } = input;
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  if (!Number.isFinite(initialInvestment) || initialInvestment <= 0) {
+    return { error: "initialInvestment must be a finite number greater than zero" };
+  }
+  if (!Array.isArray(cashFlows) || cashFlows.length === 0) {
+    return { error: "cashFlows must be a non-empty array of numbers" };
+  }
+  if (cashFlows.some((f) => !Number.isFinite(f))) {
+    return { error: "Every cash flow must be a finite number" };
+  }
+  const { cumulative, period } = _computePayback(initialInvestment, cashFlows);
+  const result = {
+    initialInvestment: round4(initialInvestment),
+    cashFlows: cashFlows.map(round4),
+    cumulativeCashFlows: cumulative,
+    paybackPeriod: period !== null ? round4(period) : null,
+    paybackPeriodRounded: period !== null ? Math.ceil(period) : null,
+    recovered: period !== null
+  };
+  if (discountRatePercent !== void 0) {
+    if (!Number.isFinite(discountRatePercent) || discountRatePercent < 0) {
+      return { error: "discountRatePercent must be a finite, non-negative number when provided" };
+    }
+    const r = discountRatePercent / 100;
+    const discountedCashFlows = cashFlows.map((f, i) => f / Math.pow(1 + r, i + 1));
+    const { cumulative: discountedCumulative, period: discountedPeriod } = _computePayback(initialInvestment, discountedCashFlows);
+    result.discountRatePercent = round4(discountRatePercent);
+    result.discountedCashFlows = discountedCashFlows.map(round4);
+    result.discountedCumulativeCashFlows = discountedCumulative;
+    result.discountedPaybackPeriod = discountedPeriod !== null ? round4(discountedPeriod) : null;
+    result.discountedPaybackPeriodRounded = discountedPeriod !== null ? Math.ceil(discountedPeriod) : null;
+    result.discountedRecovered = discountedPeriod !== null;
+  }
+  return result;
+}
+function calculateCdMaturity(principal, annualRatePercent, termMonths, compoundsPerYear, earlyWithdrawalPenaltyMonths) {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a finite number greater than zero" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isFinite(termMonths) || termMonths <= 0) return { error: "Term must be a positive number of months" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (earlyWithdrawalPenaltyMonths !== void 0 && (!Number.isFinite(earlyWithdrawalPenaltyMonths) || earlyWithdrawalPenaltyMonths < 0)) {
+    return { error: "earlyWithdrawalPenaltyMonths must be zero or a positive number when provided" };
+  }
+  const round23 = (n) => Math.round(n * 100) / 100;
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const ratePerPeriod = annualRatePercent / 100 / compoundsPerYear;
+  const totalPeriods = compoundsPerYear * (termMonths / 12);
+  const growth = ratePerPeriod === 0 ? 1 : Math.pow(1 + ratePerPeriod, totalPeriods);
+  const maturityValue = principal * growth;
+  const totalInterest = maturityValue - principal;
+  const apy = ratePerPeriod === 0 ? 0 : (Math.pow(1 + ratePerPeriod, compoundsPerYear) - 1) * 100;
+  const result = {
+    principal: round23(principal),
+    annualRatePercent: round4(annualRatePercent),
+    termMonths,
+    compoundsPerYear,
+    maturityValue: round23(maturityValue),
+    totalInterest: round23(totalInterest),
+    apy: round4(apy)
+  };
+  if (earlyWithdrawalPenaltyMonths !== void 0) {
+    const monthlyRate = annualRatePercent / 100 / 12;
+    const forfeited = Math.min(principal * monthlyRate * earlyWithdrawalPenaltyMonths, Math.max(totalInterest, 0));
+    result.earlyWithdrawalPenaltyMonths = earlyWithdrawalPenaltyMonths;
+    result.earlyWithdrawalForfeitedInterest = round23(forfeited);
+    result.earlyWithdrawalPayout = round23(maturityValue - forfeited);
+  }
+  return result;
+}
 
 // src/tools/network.ts
 var network_exports = {};
 __export(network_exports, {
+  CLIENT_HINTS: () => CLIENT_HINTS,
   DNS_RECORD_TYPES: () => DNS_RECORD_TYPES,
   HTTP_HEADERS: () => HTTP_HEADERS,
   LINK_REL_VALUES: () => LINK_REL_VALUES,
+  PERMISSIONS_POLICY_FEATURES: () => PERMISSIONS_POLICY_FEATURES,
   REFERRER_POLICY_VALUES: () => REFERRER_POLICY_VALUES,
   STATUS_CODES: () => STATUS_CODES,
   analyzeEmailHeaders: () => analyzeEmailHeaders,
   buildCacheControl: () => buildCacheControl,
+  buildClientHints: () => buildClientHints,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
   buildLinkHeader: () => buildLinkHeader,
   buildMapUrl: () => buildMapUrl,
+  buildPermissionsPolicy: () => buildPermissionsPolicy,
   buildRangeHeader: () => buildRangeHeader,
   buildReferrerPolicy: () => buildReferrerPolicy,
   buildVaryHeader: () => buildVaryHeader,
@@ -9938,11 +10036,13 @@ __export(network_exports, {
   isValidIp: () => isValidIp2,
   isValidIpv4: () => isValidIpv42,
   isValidIpv6: () => isValidIpv6,
+  parseClientHintHeaders: () => parseClientHintHeaders,
   parseContentRangeHeader: () => parseContentRangeHeader,
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
   parseIpv6Address: () => parseIpv6Address,
+  parsePermissionsPolicy: () => parsePermissionsPolicy,
   parseUserAgent: () => parseUserAgent,
   parseVaryHeader: () => parseVaryHeader,
   searchHeaders: () => searchHeaders,
@@ -12377,6 +12477,207 @@ function validateManifest(jsonText) {
     }
   };
 }
+var PERMISSIONS_POLICY_NOTES = {
+  camera: "Controls access to video capture devices (getUserMedia video).",
+  microphone: "Controls access to audio capture devices (getUserMedia audio).",
+  geolocation: "Controls access to the Geolocation API.",
+  autoplay: "Controls whether media elements can autoplay without a user gesture.",
+  fullscreen: "Controls access to the Fullscreen API (requestFullscreen).",
+  payment: "Controls access to the Payment Request API.",
+  usb: "Controls access to the WebUSB API.",
+  accelerometer: "Controls access to the Accelerometer sensor API.",
+  gyroscope: "Controls access to the Gyroscope sensor API.",
+  magnetometer: "Controls access to the Magnetometer sensor API.",
+  midi: "Controls access to the Web MIDI API.",
+  "picture-in-picture": "Controls whether video elements can enter picture-in-picture mode.",
+  "sync-xhr": "Controls whether synchronous XMLHttpRequest is allowed.",
+  "display-capture": "Controls access to screen/tab capture (getDisplayMedia).",
+  "encrypted-media": "Controls access to the Encrypted Media Extensions API (DRM playback).",
+  "clipboard-read": "Controls read access to the async Clipboard API.",
+  "clipboard-write": "Controls write access to the async Clipboard API.",
+  "screen-wake-lock": "Controls access to the Screen Wake Lock API.",
+  "web-share": "Controls access to the Web Share API.",
+  "xr-spatial-tracking": "Controls access to WebXR device sensors and spatial tracking."
+};
+var PERMISSIONS_POLICY_FEATURES = Object.keys(PERMISSIONS_POLICY_NOTES);
+function _formatPermissionsPolicyAllowlist(allowlist) {
+  if (allowlist.includes("*")) return "*";
+  if (allowlist.length === 0) return "()";
+  return "(" + allowlist.map((o) => o === "self" ? "self" : `"${o}"`).join(" ") + ")";
+}
+function buildPermissionsPolicy(features) {
+  if (!Array.isArray(features) || features.length === 0) return { error: "At least one feature is required" };
+  const warnings = [];
+  const seen = /* @__PURE__ */ new Map();
+  for (const f of features) {
+    if (!f || typeof f.feature !== "string" || f.feature.trim() === "") continue;
+    const name = f.feature.trim().toLowerCase();
+    const allowlist = Array.isArray(f.allowlist) ? f.allowlist.map((o) => typeof o === "string" ? o.trim() : "").filter((o) => o.length > 0) : [];
+    if (seen.has(name)) warnings.push(`duplicate feature "${name}" was merged, the last occurrence wins`);
+    seen.set(name, { feature: name, allowlist });
+  }
+  if (seen.size === 0) return { error: "At least one feature is required" };
+  const directives = [];
+  for (const { feature, allowlist } of seen.values()) {
+    if (!PERMISSIONS_POLICY_NOTES[feature]) {
+      warnings.push(`"${feature}" is not a widely recognized feature name, it will still be included as written`);
+    }
+    if (allowlist.includes("*") && allowlist.length > 1) {
+      warnings.push(`"${feature}" combines "*" with other origins; "*" already allows every origin so the others are redundant`);
+    }
+    const invalidOrigin = allowlist.find((o) => o !== "self" && o !== "*" && !/^https?:\/\//i.test(o));
+    if (invalidOrigin) {
+      warnings.push(`"${invalidOrigin}" on "${feature}" doesn't look like an origin (expected "self", "*", or an http(s):// URL); it will still be quoted as written`);
+    }
+    directives.push({
+      feature,
+      value: _formatPermissionsPolicyAllowlist(allowlist),
+      note: PERMISSIONS_POLICY_NOTES[feature] ?? `Controls access to the "${feature}" feature.`
+    });
+  }
+  const headerValue = directives.map((d) => `${d.feature}=${d.value}`).join(", ");
+  return { header: `Permissions-Policy: ${headerValue}`, headerValue, directives, warnings };
+}
+function _splitPermissionsPolicyTopLevel(input) {
+  const segments = [];
+  let depth = 0;
+  let current = "";
+  for (const ch of input) {
+    if (ch === "(") depth++;
+    if (ch === ")") depth--;
+    if (ch === "," && depth === 0) {
+      if (current.trim()) segments.push(current.trim());
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  if (current.trim()) segments.push(current.trim());
+  return segments;
+}
+function _parsePermissionsPolicyAllowlist(rawValue) {
+  if (rawValue === "*") return ["*"];
+  if (rawValue === "()" || rawValue === "") return [];
+  const inner = rawValue.replace(/^\(/, "").replace(/\)$/, "");
+  const tokens = inner.match(/"[^"]*"|\S+/g) ?? [];
+  return tokens.map((t) => t.replace(/^"|"$/g, ""));
+}
+function parsePermissionsPolicy(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^permissions-policy:\s*/i, "");
+  const segments = _splitPermissionsPolicyTopLevel(withoutLabel);
+  if (segments.length === 0) return { error: "No directives found" };
+  const features = [];
+  for (const segment of segments) {
+    const eq = segment.indexOf("=");
+    if (eq === -1) continue;
+    const feature = segment.slice(0, eq).trim();
+    const rawValue = segment.slice(eq + 1).trim();
+    features.push({ feature, allowlist: _parsePermissionsPolicyAllowlist(rawValue) });
+  }
+  if (features.length === 0) return { error: "No directives found" };
+  return buildPermissionsPolicy(features);
+}
+var CLIENT_HINTS = [
+  { name: "Sec-CH-UA", description: "The browser's brand(s) and significant version, sent automatically on every request without an Accept-CH opt-in.", lowEntropy: true, valueType: "sf-list-brand" },
+  { name: "Sec-CH-UA-Mobile", description: "Whether the browser is running on a mobile device (?1) or not (?0).", lowEntropy: true, valueType: "boolean" },
+  { name: "Sec-CH-UA-Platform", description: 'The platform/OS the browser is running on, e.g. "Windows" or "Android".', lowEntropy: true, valueType: "string" },
+  { name: "Sec-CH-UA-Full-Version-List", description: "The full version number for each brand in the user agent, not just the significant version.", lowEntropy: false, valueType: "sf-list-brand" },
+  { name: "Sec-CH-UA-Platform-Version", description: 'The exact OS version, e.g. "15.0.0".', lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-UA-Arch", description: 'The underlying CPU architecture, e.g. "x86" or "arm".', lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-UA-Bitness", description: 'The CPU architecture bitness, e.g. "64".', lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-UA-Model", description: "The device model, mostly populated on mobile devices.", lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-UA-WoW64", description: "Whether a 32-bit browser is running on 64-bit Windows.", lowEntropy: false, valueType: "boolean" },
+  { name: "Sec-CH-UA-Form-Factor", description: `The device's form factor, e.g. "Desktop", "Mobile", "Tablet", or "XR".`, lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-Prefers-Color-Scheme", description: "The user's preferred color scheme, mirrors the prefers-color-scheme media feature.", lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-Prefers-Reduced-Motion", description: "Whether the user has requested reduced motion.", lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-Prefers-Reduced-Transparency", description: "Whether the user has requested reduced transparency.", lowEntropy: false, valueType: "string" },
+  { name: "Sec-CH-Viewport-Width", description: "The layout viewport width in CSS pixels.", lowEntropy: false, valueType: "number" },
+  { name: "Sec-CH-Viewport-Height", description: "The layout viewport height in CSS pixels.", lowEntropy: false, valueType: "number" },
+  { name: "Sec-CH-DPR", description: "The device pixel ratio.", lowEntropy: false, valueType: "number" },
+  { name: "Sec-CH-Width", description: "The intrinsic width of a requested image resource, set per-request via the image's `sizes` attribute.", lowEntropy: false, valueType: "number" },
+  { name: "Sec-CH-Device-Memory", description: "Approximate device RAM in GiB, rounded to the nearest power of two for privacy.", lowEntropy: false, valueType: "number" },
+  { name: "Save-Data", description: "Legacy hint signaling the user opted into a reduced-data mode; sent automatically like a low-entropy hint.", lowEntropy: true, valueType: "boolean" }
+];
+function _findClientHint(raw) {
+  const normalized = raw.trim().toLowerCase();
+  return CLIENT_HINTS.find((d) => d.name.toLowerCase() === normalized);
+}
+function buildClientHints(hintNames, criticalHintNames = []) {
+  if (!Array.isArray(hintNames) || hintNames.length === 0) return { error: "At least one client hint is required" };
+  const resolved = [];
+  for (const raw of hintNames) {
+    if (typeof raw !== "string" || raw.trim() === "") continue;
+    const def = _findClientHint(raw);
+    if (!def) return { error: `Unknown client hint: "${raw}"` };
+    resolved.push(def);
+  }
+  if (resolved.length === 0) return { error: "At least one client hint is required" };
+  const critical = [];
+  if (Array.isArray(criticalHintNames)) {
+    for (const raw of criticalHintNames) {
+      if (typeof raw !== "string" || raw.trim() === "") continue;
+      const def = _findClientHint(raw);
+      if (!def) return { error: `Unknown client hint: "${raw}"` };
+      if (!resolved.some((d) => d.name === def.name)) {
+        return { error: `Critical hint "${def.name}" must also be included in hintNames` };
+      }
+      critical.push(def);
+    }
+  }
+  const uniqueNames = Array.from(new Set(resolved.map((d) => d.name)));
+  const result = {
+    acceptCH: uniqueNames.join(", "),
+    hints: resolved.map((d) => ({ name: d.name, description: d.description, lowEntropy: d.lowEntropy }))
+  };
+  if (critical.length > 0) {
+    result.criticalCH = Array.from(new Set(critical.map((d) => d.name))).join(", ");
+  }
+  return result;
+}
+function _decodeClientHintValue(valueType, rawValue) {
+  switch (valueType) {
+    case "boolean":
+      if (rawValue === "?1") return true;
+      if (rawValue === "?0") return false;
+      return rawValue;
+    case "string":
+      return rawValue.replace(/^"|"$/g, "");
+    case "number": {
+      const n = Number(rawValue);
+      return Number.isFinite(n) ? n : rawValue;
+    }
+    case "sf-list-brand":
+      return rawValue.split(",").map((part) => {
+        const m = part.trim().match(/^"([^"]*)";v="([^"]*)"$/);
+        return m ? { brand: m[1], version: m[2] } : { raw: part.trim() };
+      });
+    default:
+      return rawValue;
+  }
+}
+function parseClientHintHeaders(rawHeaders) {
+  if (typeof rawHeaders !== "string" || rawHeaders.trim() === "") return { error: "Provide one or more header lines to parse" };
+  const lines = rawHeaders.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+  const hints = [];
+  const unrecognized = [];
+  for (const line of lines) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const name = line.slice(0, idx).trim();
+    const rawValue = line.slice(idx + 1).trim();
+    const def = _findClientHint(name);
+    if (!def) {
+      unrecognized.push({ name, rawValue });
+      continue;
+    }
+    hints.push({ name: def.name, rawValue, description: def.description, value: _decodeClientHintValue(def.valueType, rawValue) });
+  }
+  if (hints.length === 0 && unrecognized.length === 0) {
+    return { error: 'No parsable header lines found (expected "Header-Name: value" per line)' };
+  }
+  return { hints, unrecognized };
+}
 
 // src/tools/api.ts
 var api_exports = {};

package/dist/index.d.cts

@@ -5,8 +5,8 @@ export { t as text } from './text-kHkT9VtT.cjs';
 export { d as data } from './data-BKpEOcOX.cjs';
 export { g as generators } from './generators-Du8cBesn.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
-export { u as units } from './units-CzPwRC03.cjs';
-export { n as network } from './network-DISiPMoK.cjs';
+export { u as units } from './units-DWRmbS_a.cjs';
+export { n as network } from './network-Bzm1tjMA.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-KXoRsHtl.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { t as text } from './text-kHkT9VtT.js';
 export { d as data } from './data-BKpEOcOX.js';
 export { g as generators } from './generators-Du8cBesn.js';
 export { t as time } from './time-KqJjdqII.js';
-export { u as units } from './units-CzPwRC03.js';
-export { n as network } from './network-DISiPMoK.js';
+export { u as units } from './units-DWRmbS_a.js';
+export { n as network } from './network-Bzm1tjMA.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-KXoRsHtl.js';
 export { c as color } from './color-tPwZCr9H.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { media_exports as media } from './chunk-L6V4W4SU.js';
-export { units_exports as units } from './chunk-2MTHD2LG.js';
-export { network_exports as network } from './chunk-XPNZYPM5.js';
+export { units_exports as units } from './chunk-DFLHX4NW.js';
+export { network_exports as network } from './chunk-7PEKYLRB.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-JL7YTXRB.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';

package/dist/{network-DISiPMoK.d.cts → network-Bzm1tjMA.d.cts}

@@ -19,6 +19,7 @@
  *   - email-header-analyzer: analyzeEmailHeaders
  *   - http-range-header-builder: buildRangeHeader, parseContentRangeHeader
  *   - vary-header-builder: buildVaryHeader, parseVaryHeader
+ *   - permissions-policy-builder: buildPermissionsPolicy, parsePermissionsPolicy
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -558,12 +559,101 @@ interface ManifestValidationResult {
 declare function validateManifest(jsonText: string): ManifestValidationResult | {
     error: string;
 };
+interface PermissionsPolicyFeatureInput {
+    feature: string;
+    allowlist: string[];
+}
+interface PermissionsPolicyDirective {
+    feature: string;
+    value: string;
+    note: string;
+}
+interface PermissionsPolicyResult {
+    header: string;
+    headerValue: string;
+    directives: PermissionsPolicyDirective[];
+    warnings: string[];
+}
+declare const PERMISSIONS_POLICY_FEATURES: string[];
+/**
+ * Build a `Permissions-Policy` response-header value from a list of browser
+ * features and their per-feature allowlist (`self`, specific origins, `*`
+ * for all origins, or an empty allowlist to disable the feature entirely),
+ * attaching a plain-English note on what each feature restricts.
+ */
+declare function buildPermissionsPolicy(features: PermissionsPolicyFeatureInput[]): PermissionsPolicyResult | {
+    error: string;
+};
+/**
+ * Parse an existing `Permissions-Policy` header value (with or without a
+ * leading `Permissions-Policy:` label) into the same shape
+ * `buildPermissionsPolicy` returns, for explaining a header you found on a
+ * real response rather than building one from scratch.
+ */
+declare function parsePermissionsPolicy(raw: string): PermissionsPolicyResult | {
+    error: string;
+};
+type ClientHintValueType = 'sf-list-brand' | 'boolean' | 'string' | 'number';
+interface ClientHintDef {
+    name: string;
+    description: string;
+    lowEntropy: boolean;
+    valueType: ClientHintValueType;
+}
+declare const CLIENT_HINTS: ClientHintDef[];
+interface ClientHintsBuildResult {
+    acceptCH: string;
+    criticalCH?: string;
+    hints: {
+        name: string;
+        description: string;
+        lowEntropy: boolean;
+    }[];
+}
+/**
+ * Build an `Accept-CH` response-header value from a list of client hint
+ * names the server wants the browser to send on future requests, attaching
+ * a plain-English note on what each hint reveals. Pass a subset of those
+ * names as `criticalHintNames` to also build a `Critical-CH` header value,
+ * for hints the server needs on the very first request of a session.
+ */
+declare function buildClientHints(hintNames: string[], criticalHintNames?: string[]): ClientHintsBuildResult | {
+    error: string;
+};
+interface ParsedClientHint {
+    name: string;
+    rawValue: string;
+    description: string;
+    value: unknown;
+}
+interface ClientHintsParseResult {
+    hints: ParsedClientHint[];
+    unrecognized: {
+        name: string;
+        rawValue: string;
+    }[];
+}
+/**
+ * Parse raw request-header text, one `Header-Name: value` per line, into
+ * decoded client hint values: brand/version pairs for Sec-CH-UA-style
+ * headers, booleans for `?1`/`?0` values, unquoted strings, and numbers.
+ * Lines whose header name isn't a recognized client hint are returned
+ * separately under `unrecognized` rather than dropped.
+ */
+declare function parseClientHintHeaders(rawHeaders: string): ClientHintsParseResult | {
+    error: string;
+};
 
 type network_AuthResultEntry = AuthResultEntry;
 type network_BuildRangeHeaderOptions = BuildRangeHeaderOptions;
+declare const network_CLIENT_HINTS: typeof CLIENT_HINTS;
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
 type network_CacheControlResult = CacheControlResult;
+type network_ClientHintDef = ClientHintDef;
+type network_ClientHintValueType = ClientHintValueType;
+type network_ClientHintsBuildResult = ClientHintsBuildResult;
+type network_ClientHintsParseResult = ClientHintsParseResult;
 type network_ContentRangeResult = ContentRangeResult;
 type network_CookieAttributes = CookieAttributes;
 type network_CookieCheckResult = CookieCheckResult;
@@ -590,8 +680,13 @@ type network_LinkRel = LinkRel;
 type network_ManifestIconInfo = ManifestIconInfo;
 type network_ManifestIssue = ManifestIssue;
 type network_ManifestValidationResult = ManifestValidationResult;
+declare const network_PERMISSIONS_POLICY_FEATURES: typeof PERMISSIONS_POLICY_FEATURES;
+type network_ParsedClientHint = ParsedClientHint;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
+type network_PermissionsPolicyDirective = PermissionsPolicyDirective;
+type network_PermissionsPolicyFeatureInput = PermissionsPolicyFeatureInput;
+type network_PermissionsPolicyResult = PermissionsPolicyResult;
 declare const network_REFERRER_POLICY_VALUES: typeof REFERRER_POLICY_VALUES;
 type network_RangeEntry = RangeEntry;
 type network_RangeEntryInput = RangeEntryInput;
@@ -617,10 +712,12 @@ type network_VaryHeaderEntry = VaryHeaderEntry;
 type network_VaryHeaderResult = VaryHeaderResult;
 declare const network_analyzeEmailHeaders: typeof analyzeEmailHeaders;
 declare const network_buildCacheControl: typeof buildCacheControl;
+declare const network_buildClientHints: typeof buildClientHints;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
 declare const network_buildLinkHeader: typeof buildLinkHeader;
 declare const network_buildMapUrl: typeof buildMapUrl;
+declare const network_buildPermissionsPolicy: typeof buildPermissionsPolicy;
 declare const network_buildRangeHeader: typeof buildRangeHeader;
 declare const network_buildReferrerPolicy: typeof buildReferrerPolicy;
 declare const network_buildVaryHeader: typeof buildVaryHeader;
@@ -639,11 +736,13 @@ declare const network_isSuccess: typeof isSuccess;
 declare const network_isValidIp: typeof isValidIp;
 declare const network_isValidIpv4: typeof isValidIpv4;
 declare const network_isValidIpv6: typeof isValidIpv6;
+declare const network_parseClientHintHeaders: typeof parseClientHintHeaders;
 declare const network_parseContentRangeHeader: typeof parseContentRangeHeader;
 declare const network_parseDnsResponse: typeof parseDnsResponse;
 declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
 declare const network_parseIpv6Address: typeof parseIpv6Address;
+declare const network_parsePermissionsPolicy: typeof parsePermissionsPolicy;
 declare const network_parseUserAgent: typeof parseUserAgent;
 declare const network_parseVaryHeader: typeof parseVaryHeader;
 declare const network_searchHeaders: typeof searchHeaders;
@@ -657,7 +756,7 @@ declare const network_validateManifest: typeof validateManifest;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { type network_AuthResultEntry as AuthResultEntry, type network_BuildRangeHeaderOptions as BuildRangeHeaderOptions, type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, type network_ContentRangeResult as ContentRangeResult, type network_CookieAttributes as CookieAttributes, type network_CookieCheckResult as CookieCheckResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_EmailHeaderAnalysis as EmailHeaderAnalysis, type network_EmailHeaderField as EmailHeaderField, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, network_LINK_REL_VALUES as LINK_REL_VALUES, type network_LinkHeaderEntry as LinkHeaderEntry, type network_LinkHeaderEntryInput as LinkHeaderEntryInput, type network_LinkHeaderResult as LinkHeaderResult, type network_LinkRel as LinkRel, type network_ManifestIconInfo as ManifestIconInfo, type network_ManifestIssue as ManifestIssue, type network_ManifestValidationResult as ManifestValidationResult, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, type network_RangeEntry as RangeEntry, type network_RangeEntryInput as RangeEntryInput, type network_RangeHeaderResult as RangeHeaderResult, type network_ReceivedHop as ReceivedHop, type network_ReferrerPolicyEntry as ReferrerPolicyEntry, type network_ReferrerPolicyResult as ReferrerPolicyResult, type network_ReferrerPolicyValue as ReferrerPolicyValue, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SameSiteValue as SameSiteValue, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, type network_VaryHeaderEntry as VaryHeaderEntry, type network_VaryHeaderResult as VaryHeaderResult, network_analyzeEmailHeaders as analyzeEmailHeaders, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildRangeHeader as buildRangeHeader, network_buildReferrerPolicy as buildReferrerPolicy, network_buildVaryHeader as buildVaryHeader, network_checkSetCookieHeader as checkSetCookieHeader, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseContentRangeHeader as parseContentRangeHeader, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_parseVaryHeader as parseVaryHeader, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateManifest as validateManifest, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_AuthResultEntry as AuthResultEntry, type network_BuildRangeHeaderOptions as BuildRangeHeaderOptions, network_CLIENT_HINTS as CLIENT_HINTS, type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, type network_ClientHintDef as ClientHintDef, type network_ClientHintValueType as ClientHintValueType, type network_ClientHintsBuildResult as ClientHintsBuildResult, type network_ClientHintsParseResult as ClientHintsParseResult, type network_ContentRangeResult as ContentRangeResult, type network_CookieAttributes as CookieAttributes, type network_CookieCheckResult as CookieCheckResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_EmailHeaderAnalysis as EmailHeaderAnalysis, type network_EmailHeaderField as EmailHeaderField, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, network_LINK_REL_VALUES as LINK_REL_VALUES, type network_LinkHeaderEntry as LinkHeaderEntry, type network_LinkHeaderEntryInput as LinkHeaderEntryInput, type network_LinkHeaderResult as LinkHeaderResult, type network_LinkRel as LinkRel, type network_ManifestIconInfo as ManifestIconInfo, type network_ManifestIssue as ManifestIssue, type network_ManifestValidationResult as ManifestValidationResult, network_PERMISSIONS_POLICY_FEATURES as PERMISSIONS_POLICY_FEATURES, type network_ParsedClientHint as ParsedClientHint, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_PermissionsPolicyDirective as PermissionsPolicyDirective, type network_PermissionsPolicyFeatureInput as PermissionsPolicyFeatureInput, type network_PermissionsPolicyResult as PermissionsPolicyResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, type network_RangeEntry as RangeEntry, type network_RangeEntryInput as RangeEntryInput, type network_RangeHeaderResult as RangeHeaderResult, type network_ReceivedHop as ReceivedHop, type network_ReferrerPolicyEntry as ReferrerPolicyEntry, type network_ReferrerPolicyResult as ReferrerPolicyResult, type network_ReferrerPolicyValue as ReferrerPolicyValue, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SameSiteValue as SameSiteValue, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, type network_VaryHeaderEntry as VaryHeaderEntry, type network_VaryHeaderResult as VaryHeaderResult, network_analyzeEmailHeaders as analyzeEmailHeaders, network_buildCacheControl as buildCacheControl, network_buildClientHints as buildClientHints, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildPermissionsPolicy as buildPermissionsPolicy, network_buildRangeHeader as buildRangeHeader, network_buildReferrerPolicy as buildReferrerPolicy, network_buildVaryHeader as buildVaryHeader, network_checkSetCookieHeader as checkSetCookieHeader, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseClientHintHeaders as parseClientHintHeaders, network_parseContentRangeHeader as parseContentRangeHeader, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parsePermissionsPolicy as parsePermissionsPolicy, network_parseUserAgent as parseUserAgent, network_parseVaryHeader as parseVaryHeader, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateManifest as validateManifest, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { type UaDeviceType as $, type AuthResultEntry as A, type BuildRangeHeaderOptions as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type ReceivedHop as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type ReferrerPolicyEntry as J, type ReferrerPolicyResult as K, LINK_REL_VALUES as L, type ManifestIconInfo as M, type ReferrerPolicyValue as N, type RobotsGroup as O, type ParsedDnsResult as P, type RobotsIssue as Q, REFERRER_POLICY_VALUES as R, type RobotsRule as S, type RobotsValidationResult as T, STATUS_CODES as U, type SameSiteValue as V, type SitemapIndexEntry as W, type SitemapIssue as X, type SitemapUrlEntry as Y, type SitemapValidationResult as Z, type StatusCode as _, type CacheControlOptions as a, type UserAgentInfo as a0, type VaryHeaderEntry as a1, type VaryHeaderResult as a2, analyzeEmailHeaders as a3, buildCacheControl as a4, buildDnsQueryUrl as a5, buildGeoUrl as a6, buildLinkHeader as a7, buildMapUrl as a8, buildRangeHeader as a9, statusCodeToText as aA, typeNumberToLabel as aB, validateDomain as aC, validateHeaderName as aD, validateHeaderValue as aE, validateManifest as aF, validateRobotsTxt as aG, validateSitemap as aH, buildReferrerPolicy as aa, buildVaryHeader as ab, checkSetCookieHeader as ac, countryCodeToFlag as ad, formatCoordinates as ae, formatTtl as af, getByCategory as ag, getHeader as ah, getHeadersByCategory as ai, getStatusByCategory as aj, getStatusCode as ak, isClientError as al, isServerError as am, isSuccess as an, isValidIp as ao, isValidIpv4 as ap, isValidIpv6 as aq, parseContentRangeHeader as ar, parseDnsResponse as as, parseGeoResponse as at, parseHar as au, parseIpv6Address as av, parseUserAgent as aw, parseVaryHeader as ax, searchHeaders as ay, searchStatusCodes as az, type CacheControlResult as b, type ContentRangeResult as c, type CookieAttributes as d, type CookieCheckResult as e, type DnsRecord as f, type DnsRecordType as g, type DnsResponse as h, type EmailHeaderField as i, type HarEntry as j, type HarParseResult as k, type HarSummary as l, type HeaderCategory as m, network as n, type HttpHeader as o, type Ipv6ParseResult as p, type LinkHeaderEntry as q, type LinkHeaderEntryInput as r, type LinkHeaderResult as s, type LinkRel as t, type ManifestIssue as u, type ManifestValidationResult as v, type ParsedGeoResult as w, type RangeEntry as x, type RangeEntryInput as y, type RangeHeaderResult as z };
+export { type RobotsIssue as $, type AuthResultEntry as A, type BuildRangeHeaderOptions as B, CLIENT_HINTS as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type ManifestValidationResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type ParsedClientHint as J, type ParsedDnsResult as K, LINK_REL_VALUES as L, type ManifestIconInfo as M, type ParsedGeoResult as N, type PermissionsPolicyDirective as O, PERMISSIONS_POLICY_FEATURES as P, type PermissionsPolicyFeatureInput as Q, type PermissionsPolicyResult as R, REFERRER_POLICY_VALUES as S, type RangeEntry as T, type RangeEntryInput as U, type RangeHeaderResult as V, type ReceivedHop as W, type ReferrerPolicyEntry as X, type ReferrerPolicyResult as Y, type ReferrerPolicyValue as Z, type RobotsGroup as _, type CacheControlDirective as a, type RobotsRule as a0, type RobotsValidationResult as a1, STATUS_CODES as a2, type SameSiteValue as a3, type SitemapIndexEntry as a4, type SitemapIssue as a5, type SitemapUrlEntry as a6, type SitemapValidationResult as a7, type StatusCode as a8, type UaDeviceType as a9, isValidIp as aA, isValidIpv4 as aB, isValidIpv6 as aC, parseClientHintHeaders as aD, parseContentRangeHeader as aE, parseDnsResponse as aF, parseGeoResponse as aG, parseHar as aH, parseIpv6Address as aI, parsePermissionsPolicy as aJ, parseUserAgent as aK, parseVaryHeader as aL, searchHeaders as aM, searchStatusCodes as aN, statusCodeToText as aO, typeNumberToLabel as aP, validateDomain as aQ, validateHeaderName as aR, validateHeaderValue as aS, validateManifest as aT, validateRobotsTxt as aU, validateSitemap as aV, type UserAgentInfo as aa, type VaryHeaderEntry as ab, type VaryHeaderResult as ac, analyzeEmailHeaders as ad, buildCacheControl as ae, buildClientHints as af, buildDnsQueryUrl as ag, buildGeoUrl as ah, buildLinkHeader as ai, buildMapUrl as aj, buildPermissionsPolicy as ak, buildRangeHeader as al, buildReferrerPolicy as am, buildVaryHeader as an, checkSetCookieHeader as ao, countryCodeToFlag as ap, formatCoordinates as aq, formatTtl as ar, getByCategory as as, getHeader as at, getHeadersByCategory as au, getStatusByCategory as av, getStatusCode as aw, isClientError as ax, isServerError as ay, isSuccess as az, type CacheControlOptions as b, type CacheControlResult as c, type ClientHintDef as d, type ClientHintValueType as e, type ClientHintsBuildResult as f, type ClientHintsParseResult as g, type ContentRangeResult as h, type CookieAttributes as i, type CookieCheckResult as j, type DnsRecord as k, type DnsRecordType as l, type DnsResponse as m, network as n, type EmailHeaderField as o, type HarEntry as p, type HarParseResult as q, type HarSummary as r, type HeaderCategory as s, type HttpHeader as t, type Ipv6ParseResult as u, type LinkHeaderEntry as v, type LinkHeaderEntryInput as w, type LinkHeaderResult as x, type LinkRel as y, type ManifestIssue as z };