@utilix-tech/sdk 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 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.42.0
+- Add `buildVaryHeader`, `parseVaryHeader` (vary-header-builder): build a `Vary` response header from request-header names with a plain-English caching note per header, or parse an existing Vary header into the same shape.
+
 ## 0.41.0
 - Add `buildRangeHeader`, `parseContentRangeHeader` (http-range-header-builder): build an HTTP `Range` request header from explicit, open-ended, or suffix ("last N bytes") byte ranges, and parse a server's `Content-Range` response to verify what it actually sent back.
 - Add `findCsvDuplicateRows` (csv-duplicate-row-finder): group CSV/TSV rows that share the same value across a chosen set of key columns, or the entire row, and report each duplicate group's occurrence count and data row numbers.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**618 developer utility functions for Node.js: runs locally, no API key required.**
+**620 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)
@@ -433,7 +433,7 @@ import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
          parseHar, validateSitemap, validateRobotsTxt,
          parseUserAgent, buildCacheControl, buildReferrerPolicy, parseIpv6Address, buildLinkHeader, checkSetCookieHeader, analyzeEmailHeaders,
-         buildRangeHeader, parseContentRangeHeader } from "@utilix-tech/sdk/network";
+         buildRangeHeader, parseContentRangeHeader, buildVaryHeader, parseVaryHeader } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -496,6 +496,14 @@ buildRangeHeader([{ start: 0, end: 1023 }], { totalSize: 146515 });
 // Parse a Content-Range response header to verify what a server actually sent back
 parseContentRangeHeader("bytes 200-1000/67589");
 // { unit: "bytes", start: 200, end: 1000, total: 67589, byteLength: 801, isUnsatisfiable: false }
+
+// Build a Vary response header from request-header names, with a plain-English caching note per header
+buildVaryHeader(["Accept-Encoding", "Accept-Language"]);
+// { header: "Vary: Accept-Encoding, Accept-Language", entries: [...], warnings: [] }
+
+// Parse an existing Vary header value into the same shape
+parseVaryHeader("Vary: Accept-Encoding, Accept-Language");
+// { header: "Vary: Accept-Encoding, Accept-Language", entries: [...], warnings: [] }
 ```
 
 ---

package/dist/{chunk-7WSFJTYP.js → chunk-UD45LBG7.js}

@@ -16,6 +16,7 @@ __export(network_exports, {
   buildMapUrl: () => buildMapUrl,
   buildRangeHeader: () => buildRangeHeader,
   buildReferrerPolicy: () => buildReferrerPolicy,
+  buildVaryHeader: () => buildVaryHeader,
   checkSetCookieHeader: () => checkSetCookieHeader,
   countryCodeToFlag: () => countryCodeToFlag,
   formatCoordinates: () => formatCoordinates,
@@ -37,6 +38,7 @@ __export(network_exports, {
   parseHar: () => parseHar,
   parseIpv6Address: () => parseIpv6Address,
   parseUserAgent: () => parseUserAgent,
+  parseVaryHeader: () => parseVaryHeader,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
   statusCodeToText: () => statusCodeToText,
@@ -2324,5 +2326,43 @@ function parseContentRangeHeader(header) {
   }
   return { unit, start, end, total, isUnsatisfiable, isTotalUnknown, byteLength: end - start + 1 };
 }
+var VARY_HEADER_NOTES = {
+  "accept-encoding": "Caches must store a separate response per compression scheme (gzip, br, etc.) the client accepts.",
+  "accept-language": "Caches must store a separate response per requested language, which can fragment a shared cache badly if Accept-Language values are highly varied.",
+  "accept": "Caches must store a separate response per requested content type (e.g. JSON vs HTML).",
+  "user-agent": "Caches must store a separate response per distinct User-Agent string, which is often unique enough to make caching nearly ineffective.",
+  "authorization": "Signals the response is user-specific; most shared caches will refuse to cache it at all rather than key on this header.",
+  "cookie": "Same effect as Authorization: shared caches typically treat the response as private and skip caching rather than key on cookie values.",
+  "origin": "Caches must store a separate response per requesting Origin, needed whenever a response includes CORS headers that differ by origin.",
+  "x-requested-with": "Caches must store a separate response depending on whether the request was made via an XHR/fetch client hint.",
+  "x-forwarded-proto": "Caches must store a separate response for HTTP vs HTTPS requests, relevant behind a proxy or load balancer that terminates TLS."
+};
+function buildVaryHeader(headers) {
+  if (!Array.isArray(headers) || headers.length === 0) return { error: "At least one header is required" };
+  const trimmed = headers.map((h) => typeof h === "string" ? h.trim() : "").filter((h) => h.length > 0);
+  if (trimmed.length === 0) return { error: "At least one header is required" };
+  const warnings = [];
+  if (trimmed.some((h) => h === "*") && trimmed.length > 1) {
+    warnings.push('"*" makes every request effectively uncacheable; combining it with other header names is redundant, most caches will just skip caching entirely');
+  }
+  const seen = /* @__PURE__ */ new Map();
+  for (const h of trimmed) {
+    const key = h.toLowerCase();
+    if (!seen.has(key)) seen.set(key, h);
+  }
+  if (seen.size < trimmed.length) warnings.push("duplicate header names were removed");
+  const entries = Array.from(seen.values()).map((h) => ({
+    header: h,
+    note: h === "*" ? "Every response is considered unique; most caches will not store it at all." : VARY_HEADER_NOTES[h.toLowerCase()] ?? `Caches must store a separate response per distinct ${h} value.`
+  }));
+  const headerValue = entries.map((e) => e.header).join(", ");
+  return { header: `Vary: ${headerValue}`, headerValue, entries, warnings };
+}
+function parseVaryHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^vary:\s*/i, "");
+  const headers = withoutLabel.split(",").map((h) => h.trim()).filter((h) => h.length > 0);
+  return buildVaryHeader(headers);
+}
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildRangeHeader, buildReferrerPolicy, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };
+export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildRangeHeader, buildReferrerPolicy, buildVaryHeader, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, parseVaryHeader, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/index.cjs

@@ -9922,6 +9922,7 @@ __export(network_exports, {
   buildMapUrl: () => buildMapUrl,
   buildRangeHeader: () => buildRangeHeader,
   buildReferrerPolicy: () => buildReferrerPolicy,
+  buildVaryHeader: () => buildVaryHeader,
   checkSetCookieHeader: () => checkSetCookieHeader,
   countryCodeToFlag: () => countryCodeToFlag,
   formatCoordinates: () => formatCoordinates,
@@ -9943,6 +9944,7 @@ __export(network_exports, {
   parseHar: () => parseHar,
   parseIpv6Address: () => parseIpv6Address,
   parseUserAgent: () => parseUserAgent,
+  parseVaryHeader: () => parseVaryHeader,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
   statusCodeToText: () => statusCodeToText,
@@ -12230,6 +12232,44 @@ function parseContentRangeHeader(header) {
   }
   return { unit, start, end, total, isUnsatisfiable, isTotalUnknown, byteLength: end - start + 1 };
 }
+var VARY_HEADER_NOTES = {
+  "accept-encoding": "Caches must store a separate response per compression scheme (gzip, br, etc.) the client accepts.",
+  "accept-language": "Caches must store a separate response per requested language, which can fragment a shared cache badly if Accept-Language values are highly varied.",
+  "accept": "Caches must store a separate response per requested content type (e.g. JSON vs HTML).",
+  "user-agent": "Caches must store a separate response per distinct User-Agent string, which is often unique enough to make caching nearly ineffective.",
+  "authorization": "Signals the response is user-specific; most shared caches will refuse to cache it at all rather than key on this header.",
+  "cookie": "Same effect as Authorization: shared caches typically treat the response as private and skip caching rather than key on cookie values.",
+  "origin": "Caches must store a separate response per requesting Origin, needed whenever a response includes CORS headers that differ by origin.",
+  "x-requested-with": "Caches must store a separate response depending on whether the request was made via an XHR/fetch client hint.",
+  "x-forwarded-proto": "Caches must store a separate response for HTTP vs HTTPS requests, relevant behind a proxy or load balancer that terminates TLS."
+};
+function buildVaryHeader(headers) {
+  if (!Array.isArray(headers) || headers.length === 0) return { error: "At least one header is required" };
+  const trimmed = headers.map((h) => typeof h === "string" ? h.trim() : "").filter((h) => h.length > 0);
+  if (trimmed.length === 0) return { error: "At least one header is required" };
+  const warnings = [];
+  if (trimmed.some((h) => h === "*") && trimmed.length > 1) {
+    warnings.push('"*" makes every request effectively uncacheable; combining it with other header names is redundant, most caches will just skip caching entirely');
+  }
+  const seen = /* @__PURE__ */ new Map();
+  for (const h of trimmed) {
+    const key = h.toLowerCase();
+    if (!seen.has(key)) seen.set(key, h);
+  }
+  if (seen.size < trimmed.length) warnings.push("duplicate header names were removed");
+  const entries = Array.from(seen.values()).map((h) => ({
+    header: h,
+    note: h === "*" ? "Every response is considered unique; most caches will not store it at all." : VARY_HEADER_NOTES[h.toLowerCase()] ?? `Caches must store a separate response per distinct ${h} value.`
+  }));
+  const headerValue = entries.map((e) => e.header).join(", ");
+  return { header: `Vary: ${headerValue}`, headerValue, entries, warnings };
+}
+function parseVaryHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^vary:\s*/i, "");
+  const headers = withoutLabel.split(",").map((h) => h.trim()).filter((h) => h.length > 0);
+  return buildVaryHeader(headers);
+}
 
 // src/tools/api.ts
 var api_exports = {};

package/dist/index.d.cts

@@ -6,7 +6,7 @@ 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-BC8McQOh.cjs';
+export { n as network } from './network-oAs83Ztn.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

@@ -6,7 +6,7 @@ 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-BC8McQOh.js';
+export { n as network } from './network-oAs83Ztn.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-7WSFJTYP.js';
+export { network_exports as network } from './chunk-UD45LBG7.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-BC8McQOh.d.cts → network-oAs83Ztn.d.cts}

@@ -18,6 +18,7 @@
  *   - same-site-cookie-checker: checkSetCookieHeader
  *   - email-header-analyzer: analyzeEmailHeaders
  *   - http-range-header-builder: buildRangeHeader, parseContentRangeHeader
+ *   - vary-header-builder: buildVaryHeader, parseVaryHeader
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -498,6 +499,32 @@ interface ContentRangeResult {
 declare function parseContentRangeHeader(header: string): ContentRangeResult | {
     error: string;
 };
+interface VaryHeaderEntry {
+    header: string;
+    note: string;
+}
+interface VaryHeaderResult {
+    header: string;
+    headerValue: string;
+    entries: VaryHeaderEntry[];
+    warnings: string[];
+}
+/**
+ * Build a `Vary` response-header value from a list of request-header names,
+ * de-duplicating case-insensitively and attaching a plain-English caching
+ * note for each well-known header (Accept-Encoding, Authorization, etc.).
+ */
+declare function buildVaryHeader(headers: string[]): VaryHeaderResult | {
+    error: string;
+};
+/**
+ * Parse an existing `Vary` header value (with or without a leading `Vary:`
+ * label) into the same shape `buildVaryHeader` returns, for explaining a
+ * header you found on a real response rather than building one from scratch.
+ */
+declare function parseVaryHeader(raw: string): VaryHeaderResult | {
+    error: string;
+};
 
 type network_AuthResultEntry = AuthResultEntry;
 type network_BuildRangeHeaderOptions = BuildRangeHeaderOptions;
@@ -550,6 +577,8 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+type network_VaryHeaderEntry = VaryHeaderEntry;
+type network_VaryHeaderResult = VaryHeaderResult;
 declare const network_analyzeEmailHeaders: typeof analyzeEmailHeaders;
 declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
@@ -558,6 +587,7 @@ declare const network_buildLinkHeader: typeof buildLinkHeader;
 declare const network_buildMapUrl: typeof buildMapUrl;
 declare const network_buildRangeHeader: typeof buildRangeHeader;
 declare const network_buildReferrerPolicy: typeof buildReferrerPolicy;
+declare const network_buildVaryHeader: typeof buildVaryHeader;
 declare const network_checkSetCookieHeader: typeof checkSetCookieHeader;
 declare const network_countryCodeToFlag: typeof countryCodeToFlag;
 declare const network_formatCoordinates: typeof formatCoordinates;
@@ -579,6 +609,7 @@ declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
 declare const network_parseIpv6Address: typeof parseIpv6Address;
 declare const network_parseUserAgent: typeof parseUserAgent;
+declare const network_parseVaryHeader: typeof parseVaryHeader;
 declare const network_searchHeaders: typeof searchHeaders;
 declare const network_searchStatusCodes: typeof searchStatusCodes;
 declare const network_statusCodeToText: typeof statusCodeToText;
@@ -589,7 +620,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 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_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, 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_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_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_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  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_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_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { buildCacheControl as $, type AuthResultEntry as A, type BuildRangeHeaderOptions as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type ReferrerPolicyResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type ReferrerPolicyValue as J, type RobotsGroup as K, LINK_REL_VALUES as L, type RobotsIssue as M, type RobotsRule as N, type RobotsValidationResult as O, type ParsedDnsResult as P, type SameSiteValue as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, type SitemapIndexEntry as T, type SitemapIssue as U, type SitemapUrlEntry as V, type SitemapValidationResult as W, type StatusCode as X, type UaDeviceType as Y, type UserAgentInfo as Z, analyzeEmailHeaders as _, type CacheControlOptions as a, buildDnsQueryUrl as a0, buildGeoUrl as a1, buildLinkHeader as a2, buildMapUrl as a3, buildRangeHeader as a4, buildReferrerPolicy as a5, checkSetCookieHeader as a6, countryCodeToFlag as a7, formatCoordinates as a8, formatTtl as a9, getByCategory as aa, getHeader as ab, getHeadersByCategory as ac, getStatusByCategory as ad, getStatusCode as ae, isClientError as af, isServerError as ag, isSuccess as ah, isValidIp as ai, isValidIpv4 as aj, isValidIpv6 as ak, parseContentRangeHeader as al, parseDnsResponse as am, parseGeoResponse as an, parseHar as ao, parseIpv6Address as ap, parseUserAgent as aq, searchHeaders as ar, searchStatusCodes as as, statusCodeToText as at, typeNumberToLabel as au, validateDomain as av, validateHeaderName as aw, validateHeaderValue as ax, validateRobotsTxt as ay, validateSitemap 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 ParsedGeoResult as u, type RangeEntry as v, type RangeEntryInput as w, type RangeHeaderResult as x, type ReceivedHop as y, type ReferrerPolicyEntry as z };
+export { type VaryHeaderResult as $, type AuthResultEntry as A, type BuildRangeHeaderOptions as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type ReferrerPolicyResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type ReferrerPolicyValue as J, type RobotsGroup as K, LINK_REL_VALUES as L, type RobotsIssue as M, type RobotsRule as N, type RobotsValidationResult as O, type ParsedDnsResult as P, type SameSiteValue as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, type SitemapIndexEntry as T, type SitemapIssue as U, type SitemapUrlEntry as V, type SitemapValidationResult as W, type StatusCode as X, type UaDeviceType as Y, type UserAgentInfo as Z, type VaryHeaderEntry as _, type CacheControlOptions as a, analyzeEmailHeaders as a0, buildCacheControl as a1, buildDnsQueryUrl as a2, buildGeoUrl as a3, buildLinkHeader as a4, buildMapUrl as a5, buildRangeHeader as a6, buildReferrerPolicy as a7, buildVaryHeader as a8, checkSetCookieHeader as a9, validateHeaderName as aA, validateHeaderValue as aB, validateRobotsTxt as aC, validateSitemap as aD, countryCodeToFlag as aa, formatCoordinates as ab, formatTtl as ac, getByCategory as ad, getHeader as ae, getHeadersByCategory as af, getStatusByCategory as ag, getStatusCode as ah, isClientError as ai, isServerError as aj, isSuccess as ak, isValidIp as al, isValidIpv4 as am, isValidIpv6 as an, parseContentRangeHeader as ao, parseDnsResponse as ap, parseGeoResponse as aq, parseHar as ar, parseIpv6Address as as, parseUserAgent as at, parseVaryHeader as au, searchHeaders as av, searchStatusCodes as aw, statusCodeToText as ax, typeNumberToLabel as ay, validateDomain 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 ParsedGeoResult as u, type RangeEntry as v, type RangeEntryInput as w, type RangeHeaderResult as x, type ReceivedHop as y, type ReferrerPolicyEntry as z };

package/dist/{network-BC8McQOh.d.ts → network-oAs83Ztn.d.ts}

@@ -18,6 +18,7 @@
  *   - same-site-cookie-checker: checkSetCookieHeader
  *   - email-header-analyzer: analyzeEmailHeaders
  *   - http-range-header-builder: buildRangeHeader, parseContentRangeHeader
+ *   - vary-header-builder: buildVaryHeader, parseVaryHeader
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -498,6 +499,32 @@ interface ContentRangeResult {
 declare function parseContentRangeHeader(header: string): ContentRangeResult | {
     error: string;
 };
+interface VaryHeaderEntry {
+    header: string;
+    note: string;
+}
+interface VaryHeaderResult {
+    header: string;
+    headerValue: string;
+    entries: VaryHeaderEntry[];
+    warnings: string[];
+}
+/**
+ * Build a `Vary` response-header value from a list of request-header names,
+ * de-duplicating case-insensitively and attaching a plain-English caching
+ * note for each well-known header (Accept-Encoding, Authorization, etc.).
+ */
+declare function buildVaryHeader(headers: string[]): VaryHeaderResult | {
+    error: string;
+};
+/**
+ * Parse an existing `Vary` header value (with or without a leading `Vary:`
+ * label) into the same shape `buildVaryHeader` returns, for explaining a
+ * header you found on a real response rather than building one from scratch.
+ */
+declare function parseVaryHeader(raw: string): VaryHeaderResult | {
+    error: string;
+};
 
 type network_AuthResultEntry = AuthResultEntry;
 type network_BuildRangeHeaderOptions = BuildRangeHeaderOptions;
@@ -550,6 +577,8 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+type network_VaryHeaderEntry = VaryHeaderEntry;
+type network_VaryHeaderResult = VaryHeaderResult;
 declare const network_analyzeEmailHeaders: typeof analyzeEmailHeaders;
 declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
@@ -558,6 +587,7 @@ declare const network_buildLinkHeader: typeof buildLinkHeader;
 declare const network_buildMapUrl: typeof buildMapUrl;
 declare const network_buildRangeHeader: typeof buildRangeHeader;
 declare const network_buildReferrerPolicy: typeof buildReferrerPolicy;
+declare const network_buildVaryHeader: typeof buildVaryHeader;
 declare const network_checkSetCookieHeader: typeof checkSetCookieHeader;
 declare const network_countryCodeToFlag: typeof countryCodeToFlag;
 declare const network_formatCoordinates: typeof formatCoordinates;
@@ -579,6 +609,7 @@ declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
 declare const network_parseIpv6Address: typeof parseIpv6Address;
 declare const network_parseUserAgent: typeof parseUserAgent;
+declare const network_parseVaryHeader: typeof parseVaryHeader;
 declare const network_searchHeaders: typeof searchHeaders;
 declare const network_searchStatusCodes: typeof searchStatusCodes;
 declare const network_statusCodeToText: typeof statusCodeToText;
@@ -589,7 +620,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 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_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, 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_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_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_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  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_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_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { buildCacheControl as $, type AuthResultEntry as A, type BuildRangeHeaderOptions as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type ReferrerPolicyResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type ReferrerPolicyValue as J, type RobotsGroup as K, LINK_REL_VALUES as L, type RobotsIssue as M, type RobotsRule as N, type RobotsValidationResult as O, type ParsedDnsResult as P, type SameSiteValue as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, type SitemapIndexEntry as T, type SitemapIssue as U, type SitemapUrlEntry as V, type SitemapValidationResult as W, type StatusCode as X, type UaDeviceType as Y, type UserAgentInfo as Z, analyzeEmailHeaders as _, type CacheControlOptions as a, buildDnsQueryUrl as a0, buildGeoUrl as a1, buildLinkHeader as a2, buildMapUrl as a3, buildRangeHeader as a4, buildReferrerPolicy as a5, checkSetCookieHeader as a6, countryCodeToFlag as a7, formatCoordinates as a8, formatTtl as a9, getByCategory as aa, getHeader as ab, getHeadersByCategory as ac, getStatusByCategory as ad, getStatusCode as ae, isClientError as af, isServerError as ag, isSuccess as ah, isValidIp as ai, isValidIpv4 as aj, isValidIpv6 as ak, parseContentRangeHeader as al, parseDnsResponse as am, parseGeoResponse as an, parseHar as ao, parseIpv6Address as ap, parseUserAgent as aq, searchHeaders as ar, searchStatusCodes as as, statusCodeToText as at, typeNumberToLabel as au, validateDomain as av, validateHeaderName as aw, validateHeaderValue as ax, validateRobotsTxt as ay, validateSitemap 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 ParsedGeoResult as u, type RangeEntry as v, type RangeEntryInput as w, type RangeHeaderResult as x, type ReceivedHop as y, type ReferrerPolicyEntry as z };
+export { type VaryHeaderResult as $, type AuthResultEntry as A, type BuildRangeHeaderOptions as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type ReferrerPolicyResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type ReferrerPolicyValue as J, type RobotsGroup as K, LINK_REL_VALUES as L, type RobotsIssue as M, type RobotsRule as N, type RobotsValidationResult as O, type ParsedDnsResult as P, type SameSiteValue as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, type SitemapIndexEntry as T, type SitemapIssue as U, type SitemapUrlEntry as V, type SitemapValidationResult as W, type StatusCode as X, type UaDeviceType as Y, type UserAgentInfo as Z, type VaryHeaderEntry as _, type CacheControlOptions as a, analyzeEmailHeaders as a0, buildCacheControl as a1, buildDnsQueryUrl as a2, buildGeoUrl as a3, buildLinkHeader as a4, buildMapUrl as a5, buildRangeHeader as a6, buildReferrerPolicy as a7, buildVaryHeader as a8, checkSetCookieHeader as a9, validateHeaderName as aA, validateHeaderValue as aB, validateRobotsTxt as aC, validateSitemap as aD, countryCodeToFlag as aa, formatCoordinates as ab, formatTtl as ac, getByCategory as ad, getHeader as ae, getHeadersByCategory as af, getStatusByCategory as ag, getStatusCode as ah, isClientError as ai, isServerError as aj, isSuccess as ak, isValidIp as al, isValidIpv4 as am, isValidIpv6 as an, parseContentRangeHeader as ao, parseDnsResponse as ap, parseGeoResponse as aq, parseHar as ar, parseIpv6Address as as, parseUserAgent as at, parseVaryHeader as au, searchHeaders as av, searchStatusCodes as aw, statusCodeToText as ax, typeNumberToLabel as ay, validateDomain 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 ParsedGeoResult as u, type RangeEntry as v, type RangeEntryInput as w, type RangeHeaderResult as x, type ReceivedHop as y, type ReferrerPolicyEntry as z };

package/dist/tools/network.cjs

@@ -2278,6 +2278,44 @@ function parseContentRangeHeader(header) {
   }
   return { unit, start, end, total, isUnsatisfiable, isTotalUnknown, byteLength: end - start + 1 };
 }
+var VARY_HEADER_NOTES = {
+  "accept-encoding": "Caches must store a separate response per compression scheme (gzip, br, etc.) the client accepts.",
+  "accept-language": "Caches must store a separate response per requested language, which can fragment a shared cache badly if Accept-Language values are highly varied.",
+  "accept": "Caches must store a separate response per requested content type (e.g. JSON vs HTML).",
+  "user-agent": "Caches must store a separate response per distinct User-Agent string, which is often unique enough to make caching nearly ineffective.",
+  "authorization": "Signals the response is user-specific; most shared caches will refuse to cache it at all rather than key on this header.",
+  "cookie": "Same effect as Authorization: shared caches typically treat the response as private and skip caching rather than key on cookie values.",
+  "origin": "Caches must store a separate response per requesting Origin, needed whenever a response includes CORS headers that differ by origin.",
+  "x-requested-with": "Caches must store a separate response depending on whether the request was made via an XHR/fetch client hint.",
+  "x-forwarded-proto": "Caches must store a separate response for HTTP vs HTTPS requests, relevant behind a proxy or load balancer that terminates TLS."
+};
+function buildVaryHeader(headers) {
+  if (!Array.isArray(headers) || headers.length === 0) return { error: "At least one header is required" };
+  const trimmed = headers.map((h) => typeof h === "string" ? h.trim() : "").filter((h) => h.length > 0);
+  if (trimmed.length === 0) return { error: "At least one header is required" };
+  const warnings = [];
+  if (trimmed.some((h) => h === "*") && trimmed.length > 1) {
+    warnings.push('"*" makes every request effectively uncacheable; combining it with other header names is redundant, most caches will just skip caching entirely');
+  }
+  const seen = /* @__PURE__ */ new Map();
+  for (const h of trimmed) {
+    const key = h.toLowerCase();
+    if (!seen.has(key)) seen.set(key, h);
+  }
+  if (seen.size < trimmed.length) warnings.push("duplicate header names were removed");
+  const entries = Array.from(seen.values()).map((h) => ({
+    header: h,
+    note: h === "*" ? "Every response is considered unique; most caches will not store it at all." : VARY_HEADER_NOTES[h.toLowerCase()] ?? `Caches must store a separate response per distinct ${h} value.`
+  }));
+  const headerValue = entries.map((e) => e.header).join(", ");
+  return { header: `Vary: ${headerValue}`, headerValue, entries, warnings };
+}
+function parseVaryHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^vary:\s*/i, "");
+  const headers = withoutLabel.split(",").map((h) => h.trim()).filter((h) => h.length > 0);
+  return buildVaryHeader(headers);
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
@@ -2292,6 +2330,7 @@ exports.buildLinkHeader = buildLinkHeader;
 exports.buildMapUrl = buildMapUrl;
 exports.buildRangeHeader = buildRangeHeader;
 exports.buildReferrerPolicy = buildReferrerPolicy;
+exports.buildVaryHeader = buildVaryHeader;
 exports.checkSetCookieHeader = checkSetCookieHeader;
 exports.countryCodeToFlag = countryCodeToFlag;
 exports.formatCoordinates = formatCoordinates;
@@ -2313,6 +2352,7 @@ exports.parseGeoResponse = parseGeoResponse;
 exports.parseHar = parseHar;
 exports.parseIpv6Address = parseIpv6Address;
 exports.parseUserAgent = parseUserAgent;
+exports.parseVaryHeader = parseVaryHeader;
 exports.searchHeaders = searchHeaders;
 exports.searchStatusCodes = searchStatusCodes;
 exports.statusCodeToText = statusCodeToText;

package/dist/tools/network.d.cts

@@ -1 +1 @@
-export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, c as ContentRangeResult, d as CookieAttributes, e as CookieCheckResult, D as DNS_RECORD_TYPES, f as DnsRecord, g as DnsRecordType, h as DnsResponse, E as EmailHeaderAnalysis, i as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, j as HarEntry, k as HarParseResult, l as HarSummary, m as HeaderCategory, o as HttpHeader, I as Ipv6AddressType, p as Ipv6ParseResult, L as LINK_REL_VALUES, q as LinkHeaderEntry, r as LinkHeaderEntryInput, s as LinkHeaderResult, t as LinkRel, P as ParsedDnsResult, u as ParsedGeoResult, R as REFERRER_POLICY_VALUES, v as RangeEntry, w as RangeEntryInput, x as RangeHeaderResult, y as ReceivedHop, z as ReferrerPolicyEntry, F as ReferrerPolicyResult, J as ReferrerPolicyValue, K as RobotsGroup, M as RobotsIssue, N as RobotsRule, O as RobotsValidationResult, S as STATUS_CODES, Q as SameSiteValue, T as SitemapIndexEntry, U as SitemapIssue, V as SitemapUrlEntry, W as SitemapValidationResult, X as StatusCode, Y as UaDeviceType, Z as UserAgentInfo, _ as analyzeEmailHeaders, $ as buildCacheControl, a0 as buildDnsQueryUrl, a1 as buildGeoUrl, a2 as buildLinkHeader, a3 as buildMapUrl, a4 as buildRangeHeader, a5 as buildReferrerPolicy, a6 as checkSetCookieHeader, a7 as countryCodeToFlag, a8 as formatCoordinates, a9 as formatTtl, aa as getByCategory, ab as getHeader, ac as getHeadersByCategory, ad as getStatusByCategory, ae as getStatusCode, af as isClientError, ag as isServerError, ah as isSuccess, ai as isValidIp, aj as isValidIpv4, ak as isValidIpv6, al as parseContentRangeHeader, am as parseDnsResponse, an as parseGeoResponse, ao as parseHar, ap as parseIpv6Address, aq as parseUserAgent, ar as searchHeaders, as as searchStatusCodes, at as statusCodeToText, au as typeNumberToLabel, av as validateDomain, aw as validateHeaderName, ax as validateHeaderValue, ay as validateRobotsTxt, az as validateSitemap } from '../network-BC8McQOh.cjs';
+export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, c as ContentRangeResult, d as CookieAttributes, e as CookieCheckResult, D as DNS_RECORD_TYPES, f as DnsRecord, g as DnsRecordType, h as DnsResponse, E as EmailHeaderAnalysis, i as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, j as HarEntry, k as HarParseResult, l as HarSummary, m as HeaderCategory, o as HttpHeader, I as Ipv6AddressType, p as Ipv6ParseResult, L as LINK_REL_VALUES, q as LinkHeaderEntry, r as LinkHeaderEntryInput, s as LinkHeaderResult, t as LinkRel, P as ParsedDnsResult, u as ParsedGeoResult, R as REFERRER_POLICY_VALUES, v as RangeEntry, w as RangeEntryInput, x as RangeHeaderResult, y as ReceivedHop, z as ReferrerPolicyEntry, F as ReferrerPolicyResult, J as ReferrerPolicyValue, K as RobotsGroup, M as RobotsIssue, N as RobotsRule, O as RobotsValidationResult, S as STATUS_CODES, Q as SameSiteValue, T as SitemapIndexEntry, U as SitemapIssue, V as SitemapUrlEntry, W as SitemapValidationResult, X as StatusCode, Y as UaDeviceType, Z as UserAgentInfo, _ as VaryHeaderEntry, $ as VaryHeaderResult, a0 as analyzeEmailHeaders, a1 as buildCacheControl, a2 as buildDnsQueryUrl, a3 as buildGeoUrl, a4 as buildLinkHeader, a5 as buildMapUrl, a6 as buildRangeHeader, a7 as buildReferrerPolicy, a8 as buildVaryHeader, a9 as checkSetCookieHeader, aa as countryCodeToFlag, ab as formatCoordinates, ac as formatTtl, ad as getByCategory, ae as getHeader, af as getHeadersByCategory, ag as getStatusByCategory, ah as getStatusCode, ai as isClientError, aj as isServerError, ak as isSuccess, al as isValidIp, am as isValidIpv4, an as isValidIpv6, ao as parseContentRangeHeader, ap as parseDnsResponse, aq as parseGeoResponse, ar as parseHar, as as parseIpv6Address, at as parseUserAgent, au as parseVaryHeader, av as searchHeaders, aw as searchStatusCodes, ax as statusCodeToText, ay as typeNumberToLabel, az as validateDomain, aA as validateHeaderName, aB as validateHeaderValue, aC as validateRobotsTxt, aD as validateSitemap } from '../network-oAs83Ztn.cjs';

package/dist/tools/network.d.ts

@@ -1 +1 @@
-export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, c as ContentRangeResult, d as CookieAttributes, e as CookieCheckResult, D as DNS_RECORD_TYPES, f as DnsRecord, g as DnsRecordType, h as DnsResponse, E as EmailHeaderAnalysis, i as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, j as HarEntry, k as HarParseResult, l as HarSummary, m as HeaderCategory, o as HttpHeader, I as Ipv6AddressType, p as Ipv6ParseResult, L as LINK_REL_VALUES, q as LinkHeaderEntry, r as LinkHeaderEntryInput, s as LinkHeaderResult, t as LinkRel, P as ParsedDnsResult, u as ParsedGeoResult, R as REFERRER_POLICY_VALUES, v as RangeEntry, w as RangeEntryInput, x as RangeHeaderResult, y as ReceivedHop, z as ReferrerPolicyEntry, F as ReferrerPolicyResult, J as ReferrerPolicyValue, K as RobotsGroup, M as RobotsIssue, N as RobotsRule, O as RobotsValidationResult, S as STATUS_CODES, Q as SameSiteValue, T as SitemapIndexEntry, U as SitemapIssue, V as SitemapUrlEntry, W as SitemapValidationResult, X as StatusCode, Y as UaDeviceType, Z as UserAgentInfo, _ as analyzeEmailHeaders, $ as buildCacheControl, a0 as buildDnsQueryUrl, a1 as buildGeoUrl, a2 as buildLinkHeader, a3 as buildMapUrl, a4 as buildRangeHeader, a5 as buildReferrerPolicy, a6 as checkSetCookieHeader, a7 as countryCodeToFlag, a8 as formatCoordinates, a9 as formatTtl, aa as getByCategory, ab as getHeader, ac as getHeadersByCategory, ad as getStatusByCategory, ae as getStatusCode, af as isClientError, ag as isServerError, ah as isSuccess, ai as isValidIp, aj as isValidIpv4, ak as isValidIpv6, al as parseContentRangeHeader, am as parseDnsResponse, an as parseGeoResponse, ao as parseHar, ap as parseIpv6Address, aq as parseUserAgent, ar as searchHeaders, as as searchStatusCodes, at as statusCodeToText, au as typeNumberToLabel, av as validateDomain, aw as validateHeaderName, ax as validateHeaderValue, ay as validateRobotsTxt, az as validateSitemap } from '../network-BC8McQOh.js';
+export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, c as ContentRangeResult, d as CookieAttributes, e as CookieCheckResult, D as DNS_RECORD_TYPES, f as DnsRecord, g as DnsRecordType, h as DnsResponse, E as EmailHeaderAnalysis, i as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, j as HarEntry, k as HarParseResult, l as HarSummary, m as HeaderCategory, o as HttpHeader, I as Ipv6AddressType, p as Ipv6ParseResult, L as LINK_REL_VALUES, q as LinkHeaderEntry, r as LinkHeaderEntryInput, s as LinkHeaderResult, t as LinkRel, P as ParsedDnsResult, u as ParsedGeoResult, R as REFERRER_POLICY_VALUES, v as RangeEntry, w as RangeEntryInput, x as RangeHeaderResult, y as ReceivedHop, z as ReferrerPolicyEntry, F as ReferrerPolicyResult, J as ReferrerPolicyValue, K as RobotsGroup, M as RobotsIssue, N as RobotsRule, O as RobotsValidationResult, S as STATUS_CODES, Q as SameSiteValue, T as SitemapIndexEntry, U as SitemapIssue, V as SitemapUrlEntry, W as SitemapValidationResult, X as StatusCode, Y as UaDeviceType, Z as UserAgentInfo, _ as VaryHeaderEntry, $ as VaryHeaderResult, a0 as analyzeEmailHeaders, a1 as buildCacheControl, a2 as buildDnsQueryUrl, a3 as buildGeoUrl, a4 as buildLinkHeader, a5 as buildMapUrl, a6 as buildRangeHeader, a7 as buildReferrerPolicy, a8 as buildVaryHeader, a9 as checkSetCookieHeader, aa as countryCodeToFlag, ab as formatCoordinates, ac as formatTtl, ad as getByCategory, ae as getHeader, af as getHeadersByCategory, ag as getStatusByCategory, ah as getStatusCode, ai as isClientError, aj as isServerError, ak as isSuccess, al as isValidIp, am as isValidIpv4, an as isValidIpv6, ao as parseContentRangeHeader, ap as parseDnsResponse, aq as parseGeoResponse, ar as parseHar, as as parseIpv6Address, at as parseUserAgent, au as parseVaryHeader, av as searchHeaders, aw as searchStatusCodes, ax as statusCodeToText, ay as typeNumberToLabel, az as validateDomain, aA as validateHeaderName, aB as validateHeaderValue, aC as validateRobotsTxt, aD as validateSitemap } from '../network-oAs83Ztn.js';

package/dist/tools/network.js

@@ -1,2 +1,2 @@
-export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildRangeHeader, buildReferrerPolicy, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-7WSFJTYP.js';
+export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildRangeHeader, buildReferrerPolicy, buildVaryHeader, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, parseVaryHeader, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-UD45LBG7.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",