@utilix-tech/sdk 0.35.0 → 0.36.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.36.0
+- Add `buildLinkHeader` (link-header-builder): build an HTTP Link response header from URL/rel pairs (preload, preconnect, prefetch, canonical, pagination, etc.), including the as/type/crossorigin attributes preload needs, plus a plain-English explanation of each entry and warnings for common mistakes like a preload missing `as`.
+
 ## 0.35.0
 - Add `calculateRoi` (roi-calculator): return on investment percent from an initial and final value, plus the annualized (CAGR) return given an optional holding period in years.
 - Add `searchEmoji`, `getEmojiByShortcode`, `getEmojiByChar`, `getEmojiByCategory`, `getEmojiCategories` (emoji-lookup): search a curated table of ~280 common emoji by name, keyword, or GitHub-style shortcode, or look one up exactly.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**600 developer utility functions for Node.js: runs locally, no API key required.**
+**602 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)
@@ -404,7 +404,7 @@ calculateRoi({ initialValue: 1000, finalValue: 1610.51, years: 5 });
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
          parseHar, validateSitemap, validateRobotsTxt,
-         parseUserAgent, buildCacheControl, buildReferrerPolicy, parseIpv6Address } from "@utilix-tech/sdk/network";
+         parseUserAgent, buildCacheControl, buildReferrerPolicy, parseIpv6Address, buildLinkHeader } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -447,6 +447,10 @@ buildReferrerPolicy("strict-origin-when-cross-origin");
 parseIpv6Address("2001:db8::ff00:42:8329");
 // { expanded: "2001:0db8:0000:0000:0000:ff00:0042:8329", compressed: "2001:db8::ff00:42:8329",
 //   groups: [...], zoneId: null, addressType: "documentation" }
+
+// Build an HTTP Link header from URL/rel pairs (preload, preconnect, canonical, pagination, etc.)
+buildLinkHeader([{ url: "/fonts/inter.woff2", rel: "preload", as: "font", type: "font/woff2", crossorigin: true }]);
+// { header: '</fonts/inter.woff2>; rel="preload"; as="font"; type="font/woff2"; crossorigin', links: [...], warnings: [] }
 ```
 
 ---

package/dist/{chunk-3YUKLV5N.js → chunk-UTHAHRQ7.js}

@@ -5,11 +5,13 @@ var network_exports = {};
 __export(network_exports, {
   DNS_RECORD_TYPES: () => DNS_RECORD_TYPES,
   HTTP_HEADERS: () => HTTP_HEADERS,
+  LINK_REL_VALUES: () => LINK_REL_VALUES,
   REFERRER_POLICY_VALUES: () => REFERRER_POLICY_VALUES,
   STATUS_CODES: () => STATUS_CODES,
   buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
+  buildLinkHeader: () => buildLinkHeader,
   buildMapUrl: () => buildMapUrl,
   buildReferrerPolicy: () => buildReferrerPolicy,
   countryCodeToFlag: () => countryCodeToFlag,
@@ -1895,6 +1897,73 @@ function buildReferrerPolicy(policies) {
   const metaTag = `<meta name="referrer" content="${last.value}">`;
   return { header, headerName: "Referrer-Policy", snippet, metaTag, policies: entries, warnings };
 }
+var LINK_REL_VALUES = [
+  "preload",
+  "preconnect",
+  "prefetch",
+  "prerender",
+  "dns-prefetch",
+  "canonical",
+  "next",
+  "prev",
+  "alternate",
+  "stylesheet",
+  "icon",
+  "modulepreload"
+];
+var _LINK_REL_INFO = {
+  preload: "Tells the browser to fetch this resource early, before the parser would otherwise discover it, without blocking rendering. Requires an `as` attribute so the browser applies the right request priority and Content-Security-Policy check; omitting it commonly causes the resource to be fetched twice.",
+  preconnect: "Tells the browser to start the connection handshake (DNS, TCP, TLS) to this origin early, before any real request to it is made, so the first actual request lands faster.",
+  prefetch: "Tells the browser to fetch this resource at low priority for a likely future navigation and cache it. Unlike preload, it does not affect the current page load.",
+  prerender: "Tells the browser to fetch and render this page in the background so navigating to it feels instant, at a real bandwidth and CPU cost if the user never navigates there.",
+  "dns-prefetch": "Tells the browser to resolve this origin's DNS early, a lighter-weight version of preconnect that skips the TCP/TLS handshake.",
+  canonical: "Tells search engines which URL is the authoritative version of this page, used to consolidate duplicate-content signals across query-string or protocol variants.",
+  next: "Marks the next page in a paginated sequence, a hint search engines and some browsers use for pagination.",
+  prev: "Marks the previous page in a paginated sequence.",
+  alternate: "Points to an alternate version of this resource, such as a different language or an RSS feed.",
+  stylesheet: 'Loads an external stylesheet, the same effect as a `<link rel="stylesheet">` tag but delivered as a response header instead.',
+  icon: 'Points to this resource\'s favicon, the same effect as a `<link rel="icon">` tag but delivered as a response header instead.',
+  modulepreload: "Tells the browser to fetch and parse this JavaScript module early, ahead of when the module graph would otherwise discover it."
+};
+function buildLinkHeader(links) {
+  if (!Array.isArray(links) || links.length === 0) {
+    return { error: "At least one link entry is required" };
+  }
+  const entries = [];
+  for (const link of links) {
+    const url = typeof link.url === "string" ? link.url.trim() : "";
+    const rel = typeof link.rel === "string" ? link.rel.trim() : "";
+    if (!url) return { error: "Each link entry requires a non-empty url" };
+    if (!rel) return { error: "Each link entry requires a non-empty rel" };
+    if (!LINK_REL_VALUES.includes(rel)) {
+      return { error: `'${rel}' is not a supported rel value. Supported values: ${LINK_REL_VALUES.join(", ")}` };
+    }
+    const as = link.as?.trim() || void 0;
+    const type = link.type?.trim() || void 0;
+    const crossorigin = link.crossorigin === true;
+    let value = `<${url}>; rel="${rel}"`;
+    if (as) value += `; as="${as}"`;
+    if (type) value += `; type="${type}"`;
+    if (crossorigin) value += "; crossorigin";
+    entries.push({ url, rel, as, type, crossorigin: crossorigin || void 0, value, explanation: _LINK_REL_INFO[rel] });
+  }
+  const warnings = [];
+  for (const entry of entries) {
+    if (entry.rel === "preload" && !entry.as) {
+      warnings.push(`preload link for "${entry.url}" is missing an \`as\` attribute \u2014 the browser may fetch it twice or apply the wrong request priority.`);
+    }
+    if ((entry.rel === "preconnect" || entry.rel === "dns-prefetch") && (entry.as || entry.type)) {
+      warnings.push(`${entry.rel} link for "${entry.url}" sets \`as\`/\`type\`, which it ignores since no specific resource is being fetched yet.`);
+    }
+  }
+  const canonicalCount = entries.filter((e) => e.rel === "canonical").length;
+  if (canonicalCount > 1) {
+    warnings.push(`${canonicalCount} canonical links present \u2014 only one canonical URL should be declared per page.`);
+  }
+  const header = entries.map((e) => e.value).join(", ");
+  const snippet = `Link: ${header}`;
+  return { header, headerName: "Link", snippet, links: entries, warnings };
+}
 function isValidIpv6HexGroup(g) {
   return /^[0-9a-fA-F]{1,4}$/.test(g);
 }
@@ -1984,4 +2053,4 @@ function parseIpv6Address(input) {
   };
 }
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, REFERRER_POLICY_VALUES, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, buildReferrerPolicy, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, 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, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildReferrerPolicy, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/index.cjs

@@ -9676,11 +9676,13 @@ var network_exports = {};
 __export(network_exports, {
   DNS_RECORD_TYPES: () => DNS_RECORD_TYPES,
   HTTP_HEADERS: () => HTTP_HEADERS,
+  LINK_REL_VALUES: () => LINK_REL_VALUES,
   REFERRER_POLICY_VALUES: () => REFERRER_POLICY_VALUES,
   STATUS_CODES: () => STATUS_CODES,
   buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
+  buildLinkHeader: () => buildLinkHeader,
   buildMapUrl: () => buildMapUrl,
   buildReferrerPolicy: () => buildReferrerPolicy,
   countryCodeToFlag: () => countryCodeToFlag,
@@ -11566,6 +11568,73 @@ function buildReferrerPolicy(policies) {
   const metaTag = `<meta name="referrer" content="${last.value}">`;
   return { header, headerName: "Referrer-Policy", snippet, metaTag, policies: entries, warnings };
 }
+var LINK_REL_VALUES = [
+  "preload",
+  "preconnect",
+  "prefetch",
+  "prerender",
+  "dns-prefetch",
+  "canonical",
+  "next",
+  "prev",
+  "alternate",
+  "stylesheet",
+  "icon",
+  "modulepreload"
+];
+var _LINK_REL_INFO = {
+  preload: "Tells the browser to fetch this resource early, before the parser would otherwise discover it, without blocking rendering. Requires an `as` attribute so the browser applies the right request priority and Content-Security-Policy check; omitting it commonly causes the resource to be fetched twice.",
+  preconnect: "Tells the browser to start the connection handshake (DNS, TCP, TLS) to this origin early, before any real request to it is made, so the first actual request lands faster.",
+  prefetch: "Tells the browser to fetch this resource at low priority for a likely future navigation and cache it. Unlike preload, it does not affect the current page load.",
+  prerender: "Tells the browser to fetch and render this page in the background so navigating to it feels instant, at a real bandwidth and CPU cost if the user never navigates there.",
+  "dns-prefetch": "Tells the browser to resolve this origin's DNS early, a lighter-weight version of preconnect that skips the TCP/TLS handshake.",
+  canonical: "Tells search engines which URL is the authoritative version of this page, used to consolidate duplicate-content signals across query-string or protocol variants.",
+  next: "Marks the next page in a paginated sequence, a hint search engines and some browsers use for pagination.",
+  prev: "Marks the previous page in a paginated sequence.",
+  alternate: "Points to an alternate version of this resource, such as a different language or an RSS feed.",
+  stylesheet: 'Loads an external stylesheet, the same effect as a `<link rel="stylesheet">` tag but delivered as a response header instead.',
+  icon: 'Points to this resource\'s favicon, the same effect as a `<link rel="icon">` tag but delivered as a response header instead.',
+  modulepreload: "Tells the browser to fetch and parse this JavaScript module early, ahead of when the module graph would otherwise discover it."
+};
+function buildLinkHeader(links) {
+  if (!Array.isArray(links) || links.length === 0) {
+    return { error: "At least one link entry is required" };
+  }
+  const entries = [];
+  for (const link of links) {
+    const url = typeof link.url === "string" ? link.url.trim() : "";
+    const rel = typeof link.rel === "string" ? link.rel.trim() : "";
+    if (!url) return { error: "Each link entry requires a non-empty url" };
+    if (!rel) return { error: "Each link entry requires a non-empty rel" };
+    if (!LINK_REL_VALUES.includes(rel)) {
+      return { error: `'${rel}' is not a supported rel value. Supported values: ${LINK_REL_VALUES.join(", ")}` };
+    }
+    const as = link.as?.trim() || void 0;
+    const type = link.type?.trim() || void 0;
+    const crossorigin = link.crossorigin === true;
+    let value = `<${url}>; rel="${rel}"`;
+    if (as) value += `; as="${as}"`;
+    if (type) value += `; type="${type}"`;
+    if (crossorigin) value += "; crossorigin";
+    entries.push({ url, rel, as, type, crossorigin: crossorigin || void 0, value, explanation: _LINK_REL_INFO[rel] });
+  }
+  const warnings = [];
+  for (const entry of entries) {
+    if (entry.rel === "preload" && !entry.as) {
+      warnings.push(`preload link for "${entry.url}" is missing an \`as\` attribute \u2014 the browser may fetch it twice or apply the wrong request priority.`);
+    }
+    if ((entry.rel === "preconnect" || entry.rel === "dns-prefetch") && (entry.as || entry.type)) {
+      warnings.push(`${entry.rel} link for "${entry.url}" sets \`as\`/\`type\`, which it ignores since no specific resource is being fetched yet.`);
+    }
+  }
+  const canonicalCount = entries.filter((e) => e.rel === "canonical").length;
+  if (canonicalCount > 1) {
+    warnings.push(`${canonicalCount} canonical links present \u2014 only one canonical URL should be declared per page.`);
+  }
+  const header = entries.map((e) => e.value).join(", ");
+  const snippet = `Link: ${header}`;
+  return { header, headerName: "Link", snippet, links: entries, warnings };
+}
 function isValidIpv6HexGroup(g) {
   return /^[0-9a-fA-F]{1,4}$/.test(g);
 }

package/dist/index.d.cts

@@ -6,7 +6,7 @@ export { d as data } from './data-CFeS9kes.cjs';
 export { g as generators } from './generators-Du8cBesn.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
 export { u as units } from './units-c90DW-OZ.cjs';
-export { n as network } from './network-DfY5Ikvr.cjs';
+export { n as network } from './network-X0EfH9Xq.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-BK-x8hVx.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { d as data } from './data-CFeS9kes.js';
 export { g as generators } from './generators-Du8cBesn.js';
 export { t as time } from './time-KqJjdqII.js';
 export { u as units } from './units-c90DW-OZ.js';
-export { n as network } from './network-DfY5Ikvr.js';
+export { n as network } from './network-X0EfH9Xq.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-BK-x8hVx.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-7AJRK57W.js';
-export { network_exports as network } from './chunk-3YUKLV5N.js';
+export { network_exports as network } from './chunk-UTHAHRQ7.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-UUT5HNST.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';

package/dist/{network-DfY5Ikvr.d.cts → network-X0EfH9Xq.d.cts}

@@ -14,6 +14,7 @@
  *   - cache-control-builder: buildCacheControl
  *   - referrer-policy-builder: buildReferrerPolicy
  *   - ipv6-compressor: parseIpv6Address
+ *   - link-header-builder: buildLinkHeader
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -319,6 +320,41 @@ declare const REFERRER_POLICY_VALUES: ReferrerPolicyValue[];
 declare function buildReferrerPolicy(policies: string | string[]): ReferrerPolicyResult | {
     error: string;
 };
+type LinkRel = 'preload' | 'preconnect' | 'prefetch' | 'prerender' | 'dns-prefetch' | 'canonical' | 'next' | 'prev' | 'alternate' | 'stylesheet' | 'icon' | 'modulepreload';
+interface LinkHeaderEntryInput {
+    url: string;
+    rel: string;
+    as?: string;
+    type?: string;
+    crossorigin?: boolean;
+}
+interface LinkHeaderEntry {
+    url: string;
+    rel: string;
+    as?: string;
+    type?: string;
+    crossorigin?: boolean;
+    value: string;
+    explanation: string;
+}
+interface LinkHeaderResult {
+    header: string;
+    headerName: 'Link';
+    snippet: string;
+    links: LinkHeaderEntry[];
+    warnings: string[];
+}
+declare const LINK_REL_VALUES: LinkRel[];
+/**
+ * Build an HTTP `Link` response header from a list of URL/rel pairs (preload,
+ * preconnect, prefetch, canonical, pagination, etc.), including the `as`/
+ * `type`/`crossorigin` attributes preload needs, plus a plain-English
+ * explanation of each entry's effect. Pure string assembly and lookup; it
+ * never fetches or validates that a URL actually exists.
+ */
+declare function buildLinkHeader(links: LinkHeaderEntryInput[]): LinkHeaderResult | {
+    error: string;
+};
 type Ipv6AddressType = 'unspecified' | 'loopback' | 'link-local' | 'unique-local' | 'multicast' | 'ipv4-mapped' | 'documentation' | 'global-unicast';
 interface Ipv6ParseResult {
     expanded: string;
@@ -353,6 +389,11 @@ type network_HeaderCategory = HeaderCategory;
 type network_HttpHeader = HttpHeader;
 type network_Ipv6AddressType = Ipv6AddressType;
 type network_Ipv6ParseResult = Ipv6ParseResult;
+declare const network_LINK_REL_VALUES: typeof LINK_REL_VALUES;
+type network_LinkHeaderEntry = LinkHeaderEntry;
+type network_LinkHeaderEntryInput = LinkHeaderEntryInput;
+type network_LinkHeaderResult = LinkHeaderResult;
+type network_LinkRel = LinkRel;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
 declare const network_REFERRER_POLICY_VALUES: typeof REFERRER_POLICY_VALUES;
@@ -374,6 +415,7 @@ type network_UserAgentInfo = UserAgentInfo;
 declare const network_buildCacheControl: typeof buildCacheControl;
 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_buildReferrerPolicy: typeof buildReferrerPolicy;
 declare const network_countryCodeToFlag: typeof countryCodeToFlag;
@@ -405,7 +447,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_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, 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_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, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, 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_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_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, 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_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_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, 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_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_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_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_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, 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_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 { isValidIpv6 as $, buildCacheControl as A, buildDnsQueryUrl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, buildGeoUrl as E, buildMapUrl as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, buildReferrerPolicy as J, countryCodeToFlag as K, formatCoordinates as L, formatTtl as M, getByCategory as N, getHeader as O, type ParsedDnsResult as P, getHeadersByCategory as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, getStatusByCategory as T, type UaDeviceType as U, getStatusCode as V, isClientError as W, isServerError as X, isSuccess as Y, isValidIp as Z, isValidIpv4 as _, type CacheControlOptions as a, parseDnsResponse as a0, parseGeoResponse as a1, parseHar as a2, parseIpv6Address as a3, parseUserAgent as a4, searchHeaders as a5, searchStatusCodes as a6, statusCodeToText as a7, typeNumberToLabel as a8, validateDomain as a9, validateHeaderName as aa, validateHeaderValue as ab, validateRobotsTxt as ac, validateSitemap as ad, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type Ipv6ParseResult as k, type ParsedGeoResult as l, type ReferrerPolicyEntry as m, network as n, type ReferrerPolicyResult as o, type ReferrerPolicyValue as p, type RobotsGroup as q, type RobotsIssue as r, type RobotsRule as s, type RobotsValidationResult as t, type SitemapIndexEntry as u, type SitemapIssue as v, type SitemapUrlEntry as w, type SitemapValidationResult as x, type StatusCode as y, type UserAgentInfo as z };
+export { getStatusCode as $, type SitemapUrlEntry as A, type SitemapValidationResult as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type StatusCode as E, type UserAgentInfo as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, buildCacheControl as J, buildDnsQueryUrl as K, LINK_REL_VALUES as L, buildGeoUrl as M, buildLinkHeader as N, buildMapUrl as O, type ParsedDnsResult as P, buildReferrerPolicy as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, countryCodeToFlag as T, type UaDeviceType as U, formatCoordinates as V, formatTtl as W, getByCategory as X, getHeader as Y, getHeadersByCategory as Z, getStatusByCategory as _, type CacheControlOptions as a, isClientError as a0, isServerError as a1, isSuccess as a2, isValidIp as a3, isValidIpv4 as a4, isValidIpv6 as a5, parseDnsResponse as a6, parseGeoResponse as a7, parseHar as a8, parseIpv6Address as a9, parseUserAgent as aa, searchHeaders as ab, searchStatusCodes as ac, statusCodeToText as ad, typeNumberToLabel as ae, validateDomain as af, validateHeaderName as ag, validateHeaderValue as ah, validateRobotsTxt as ai, validateSitemap as aj, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type Ipv6ParseResult as k, type LinkHeaderEntry as l, type LinkHeaderEntryInput as m, network as n, type LinkHeaderResult as o, type LinkRel as p, type ParsedGeoResult as q, type ReferrerPolicyEntry as r, type ReferrerPolicyResult as s, type ReferrerPolicyValue as t, type RobotsGroup as u, type RobotsIssue as v, type RobotsRule as w, type RobotsValidationResult as x, type SitemapIndexEntry as y, type SitemapIssue as z };

package/dist/{network-DfY5Ikvr.d.ts → network-X0EfH9Xq.d.ts}

@@ -14,6 +14,7 @@
  *   - cache-control-builder: buildCacheControl
  *   - referrer-policy-builder: buildReferrerPolicy
  *   - ipv6-compressor: parseIpv6Address
+ *   - link-header-builder: buildLinkHeader
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -319,6 +320,41 @@ declare const REFERRER_POLICY_VALUES: ReferrerPolicyValue[];
 declare function buildReferrerPolicy(policies: string | string[]): ReferrerPolicyResult | {
     error: string;
 };
+type LinkRel = 'preload' | 'preconnect' | 'prefetch' | 'prerender' | 'dns-prefetch' | 'canonical' | 'next' | 'prev' | 'alternate' | 'stylesheet' | 'icon' | 'modulepreload';
+interface LinkHeaderEntryInput {
+    url: string;
+    rel: string;
+    as?: string;
+    type?: string;
+    crossorigin?: boolean;
+}
+interface LinkHeaderEntry {
+    url: string;
+    rel: string;
+    as?: string;
+    type?: string;
+    crossorigin?: boolean;
+    value: string;
+    explanation: string;
+}
+interface LinkHeaderResult {
+    header: string;
+    headerName: 'Link';
+    snippet: string;
+    links: LinkHeaderEntry[];
+    warnings: string[];
+}
+declare const LINK_REL_VALUES: LinkRel[];
+/**
+ * Build an HTTP `Link` response header from a list of URL/rel pairs (preload,
+ * preconnect, prefetch, canonical, pagination, etc.), including the `as`/
+ * `type`/`crossorigin` attributes preload needs, plus a plain-English
+ * explanation of each entry's effect. Pure string assembly and lookup; it
+ * never fetches or validates that a URL actually exists.
+ */
+declare function buildLinkHeader(links: LinkHeaderEntryInput[]): LinkHeaderResult | {
+    error: string;
+};
 type Ipv6AddressType = 'unspecified' | 'loopback' | 'link-local' | 'unique-local' | 'multicast' | 'ipv4-mapped' | 'documentation' | 'global-unicast';
 interface Ipv6ParseResult {
     expanded: string;
@@ -353,6 +389,11 @@ type network_HeaderCategory = HeaderCategory;
 type network_HttpHeader = HttpHeader;
 type network_Ipv6AddressType = Ipv6AddressType;
 type network_Ipv6ParseResult = Ipv6ParseResult;
+declare const network_LINK_REL_VALUES: typeof LINK_REL_VALUES;
+type network_LinkHeaderEntry = LinkHeaderEntry;
+type network_LinkHeaderEntryInput = LinkHeaderEntryInput;
+type network_LinkHeaderResult = LinkHeaderResult;
+type network_LinkRel = LinkRel;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
 declare const network_REFERRER_POLICY_VALUES: typeof REFERRER_POLICY_VALUES;
@@ -374,6 +415,7 @@ type network_UserAgentInfo = UserAgentInfo;
 declare const network_buildCacheControl: typeof buildCacheControl;
 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_buildReferrerPolicy: typeof buildReferrerPolicy;
 declare const network_countryCodeToFlag: typeof countryCodeToFlag;
@@ -405,7 +447,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_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, 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_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, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, 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_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_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, 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_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_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, 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_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_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_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_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, 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_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 { isValidIpv6 as $, buildCacheControl as A, buildDnsQueryUrl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, buildGeoUrl as E, buildMapUrl as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, buildReferrerPolicy as J, countryCodeToFlag as K, formatCoordinates as L, formatTtl as M, getByCategory as N, getHeader as O, type ParsedDnsResult as P, getHeadersByCategory as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, getStatusByCategory as T, type UaDeviceType as U, getStatusCode as V, isClientError as W, isServerError as X, isSuccess as Y, isValidIp as Z, isValidIpv4 as _, type CacheControlOptions as a, parseDnsResponse as a0, parseGeoResponse as a1, parseHar as a2, parseIpv6Address as a3, parseUserAgent as a4, searchHeaders as a5, searchStatusCodes as a6, statusCodeToText as a7, typeNumberToLabel as a8, validateDomain as a9, validateHeaderName as aa, validateHeaderValue as ab, validateRobotsTxt as ac, validateSitemap as ad, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type Ipv6ParseResult as k, type ParsedGeoResult as l, type ReferrerPolicyEntry as m, network as n, type ReferrerPolicyResult as o, type ReferrerPolicyValue as p, type RobotsGroup as q, type RobotsIssue as r, type RobotsRule as s, type RobotsValidationResult as t, type SitemapIndexEntry as u, type SitemapIssue as v, type SitemapUrlEntry as w, type SitemapValidationResult as x, type StatusCode as y, type UserAgentInfo as z };
+export { getStatusCode as $, type SitemapUrlEntry as A, type SitemapValidationResult as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type StatusCode as E, type UserAgentInfo as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, buildCacheControl as J, buildDnsQueryUrl as K, LINK_REL_VALUES as L, buildGeoUrl as M, buildLinkHeader as N, buildMapUrl as O, type ParsedDnsResult as P, buildReferrerPolicy as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, countryCodeToFlag as T, type UaDeviceType as U, formatCoordinates as V, formatTtl as W, getByCategory as X, getHeader as Y, getHeadersByCategory as Z, getStatusByCategory as _, type CacheControlOptions as a, isClientError as a0, isServerError as a1, isSuccess as a2, isValidIp as a3, isValidIpv4 as a4, isValidIpv6 as a5, parseDnsResponse as a6, parseGeoResponse as a7, parseHar as a8, parseIpv6Address as a9, parseUserAgent as aa, searchHeaders as ab, searchStatusCodes as ac, statusCodeToText as ad, typeNumberToLabel as ae, validateDomain as af, validateHeaderName as ag, validateHeaderValue as ah, validateRobotsTxt as ai, validateSitemap as aj, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type Ipv6ParseResult as k, type LinkHeaderEntry as l, type LinkHeaderEntryInput as m, network as n, type LinkHeaderResult as o, type LinkRel as p, type ParsedGeoResult as q, type ReferrerPolicyEntry as r, type ReferrerPolicyResult as s, type ReferrerPolicyValue as t, type RobotsGroup as u, type RobotsIssue as v, type RobotsRule as w, type RobotsValidationResult as x, type SitemapIndexEntry as y, type SitemapIssue as z };

package/dist/tools/network.cjs

@@ -1855,6 +1855,73 @@ function buildReferrerPolicy(policies) {
   const metaTag = `<meta name="referrer" content="${last.value}">`;
   return { header, headerName: "Referrer-Policy", snippet, metaTag, policies: entries, warnings };
 }
+var LINK_REL_VALUES = [
+  "preload",
+  "preconnect",
+  "prefetch",
+  "prerender",
+  "dns-prefetch",
+  "canonical",
+  "next",
+  "prev",
+  "alternate",
+  "stylesheet",
+  "icon",
+  "modulepreload"
+];
+var _LINK_REL_INFO = {
+  preload: "Tells the browser to fetch this resource early, before the parser would otherwise discover it, without blocking rendering. Requires an `as` attribute so the browser applies the right request priority and Content-Security-Policy check; omitting it commonly causes the resource to be fetched twice.",
+  preconnect: "Tells the browser to start the connection handshake (DNS, TCP, TLS) to this origin early, before any real request to it is made, so the first actual request lands faster.",
+  prefetch: "Tells the browser to fetch this resource at low priority for a likely future navigation and cache it. Unlike preload, it does not affect the current page load.",
+  prerender: "Tells the browser to fetch and render this page in the background so navigating to it feels instant, at a real bandwidth and CPU cost if the user never navigates there.",
+  "dns-prefetch": "Tells the browser to resolve this origin's DNS early, a lighter-weight version of preconnect that skips the TCP/TLS handshake.",
+  canonical: "Tells search engines which URL is the authoritative version of this page, used to consolidate duplicate-content signals across query-string or protocol variants.",
+  next: "Marks the next page in a paginated sequence, a hint search engines and some browsers use for pagination.",
+  prev: "Marks the previous page in a paginated sequence.",
+  alternate: "Points to an alternate version of this resource, such as a different language or an RSS feed.",
+  stylesheet: 'Loads an external stylesheet, the same effect as a `<link rel="stylesheet">` tag but delivered as a response header instead.',
+  icon: 'Points to this resource\'s favicon, the same effect as a `<link rel="icon">` tag but delivered as a response header instead.',
+  modulepreload: "Tells the browser to fetch and parse this JavaScript module early, ahead of when the module graph would otherwise discover it."
+};
+function buildLinkHeader(links) {
+  if (!Array.isArray(links) || links.length === 0) {
+    return { error: "At least one link entry is required" };
+  }
+  const entries = [];
+  for (const link of links) {
+    const url = typeof link.url === "string" ? link.url.trim() : "";
+    const rel = typeof link.rel === "string" ? link.rel.trim() : "";
+    if (!url) return { error: "Each link entry requires a non-empty url" };
+    if (!rel) return { error: "Each link entry requires a non-empty rel" };
+    if (!LINK_REL_VALUES.includes(rel)) {
+      return { error: `'${rel}' is not a supported rel value. Supported values: ${LINK_REL_VALUES.join(", ")}` };
+    }
+    const as = link.as?.trim() || void 0;
+    const type = link.type?.trim() || void 0;
+    const crossorigin = link.crossorigin === true;
+    let value = `<${url}>; rel="${rel}"`;
+    if (as) value += `; as="${as}"`;
+    if (type) value += `; type="${type}"`;
+    if (crossorigin) value += "; crossorigin";
+    entries.push({ url, rel, as, type, crossorigin: crossorigin || void 0, value, explanation: _LINK_REL_INFO[rel] });
+  }
+  const warnings = [];
+  for (const entry of entries) {
+    if (entry.rel === "preload" && !entry.as) {
+      warnings.push(`preload link for "${entry.url}" is missing an \`as\` attribute \u2014 the browser may fetch it twice or apply the wrong request priority.`);
+    }
+    if ((entry.rel === "preconnect" || entry.rel === "dns-prefetch") && (entry.as || entry.type)) {
+      warnings.push(`${entry.rel} link for "${entry.url}" sets \`as\`/\`type\`, which it ignores since no specific resource is being fetched yet.`);
+    }
+  }
+  const canonicalCount = entries.filter((e) => e.rel === "canonical").length;
+  if (canonicalCount > 1) {
+    warnings.push(`${canonicalCount} canonical links present \u2014 only one canonical URL should be declared per page.`);
+  }
+  const header = entries.map((e) => e.value).join(", ");
+  const snippet = `Link: ${header}`;
+  return { header, headerName: "Link", snippet, links: entries, warnings };
+}
 function isValidIpv6HexGroup(g) {
   return /^[0-9a-fA-F]{1,4}$/.test(g);
 }
@@ -1946,11 +2013,13 @@ function parseIpv6Address(input) {
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
+exports.LINK_REL_VALUES = LINK_REL_VALUES;
 exports.REFERRER_POLICY_VALUES = REFERRER_POLICY_VALUES;
 exports.STATUS_CODES = STATUS_CODES;
 exports.buildCacheControl = buildCacheControl;
 exports.buildDnsQueryUrl = buildDnsQueryUrl;
 exports.buildGeoUrl = buildGeoUrl;
+exports.buildLinkHeader = buildLinkHeader;
 exports.buildMapUrl = buildMapUrl;
 exports.buildReferrerPolicy = buildReferrerPolicy;
 exports.countryCodeToFlag = countryCodeToFlag;

package/dist/tools/network.d.cts

@@ -1 +1 @@
-export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, I as Ipv6AddressType, k as Ipv6ParseResult, P as ParsedDnsResult, l as ParsedGeoResult, R as REFERRER_POLICY_VALUES, m as ReferrerPolicyEntry, o as ReferrerPolicyResult, p as ReferrerPolicyValue, q as RobotsGroup, r as RobotsIssue, s as RobotsRule, t as RobotsValidationResult, S as STATUS_CODES, u as SitemapIndexEntry, v as SitemapIssue, w as SitemapUrlEntry, x as SitemapValidationResult, y as StatusCode, U as UaDeviceType, z as UserAgentInfo, A as buildCacheControl, B as buildDnsQueryUrl, E as buildGeoUrl, F as buildMapUrl, J as buildReferrerPolicy, K as countryCodeToFlag, L as formatCoordinates, M as formatTtl, N as getByCategory, O as getHeader, Q as getHeadersByCategory, T as getStatusByCategory, V as getStatusCode, W as isClientError, X as isServerError, Y as isSuccess, Z as isValidIp, _ as isValidIpv4, $ as isValidIpv6, a0 as parseDnsResponse, a1 as parseGeoResponse, a2 as parseHar, a3 as parseIpv6Address, a4 as parseUserAgent, a5 as searchHeaders, a6 as searchStatusCodes, a7 as statusCodeToText, a8 as typeNumberToLabel, a9 as validateDomain, aa as validateHeaderName, ab as validateHeaderValue, ac as validateRobotsTxt, ad as validateSitemap } from '../network-DfY5Ikvr.cjs';
+export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, I as Ipv6AddressType, k as Ipv6ParseResult, L as LINK_REL_VALUES, l as LinkHeaderEntry, m as LinkHeaderEntryInput, o as LinkHeaderResult, p as LinkRel, P as ParsedDnsResult, q as ParsedGeoResult, R as REFERRER_POLICY_VALUES, r as ReferrerPolicyEntry, s as ReferrerPolicyResult, t as ReferrerPolicyValue, u as RobotsGroup, v as RobotsIssue, w as RobotsRule, x as RobotsValidationResult, S as STATUS_CODES, y as SitemapIndexEntry, z as SitemapIssue, A as SitemapUrlEntry, B as SitemapValidationResult, E as StatusCode, U as UaDeviceType, F as UserAgentInfo, J as buildCacheControl, K as buildDnsQueryUrl, M as buildGeoUrl, N as buildLinkHeader, O as buildMapUrl, Q as buildReferrerPolicy, T as countryCodeToFlag, V as formatCoordinates, W as formatTtl, X as getByCategory, Y as getHeader, Z as getHeadersByCategory, _ as getStatusByCategory, $ as getStatusCode, a0 as isClientError, a1 as isServerError, a2 as isSuccess, a3 as isValidIp, a4 as isValidIpv4, a5 as isValidIpv6, a6 as parseDnsResponse, a7 as parseGeoResponse, a8 as parseHar, a9 as parseIpv6Address, aa as parseUserAgent, ab as searchHeaders, ac as searchStatusCodes, ad as statusCodeToText, ae as typeNumberToLabel, af as validateDomain, ag as validateHeaderName, ah as validateHeaderValue, ai as validateRobotsTxt, aj as validateSitemap } from '../network-X0EfH9Xq.cjs';

package/dist/tools/network.d.ts

@@ -1 +1 @@
-export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, I as Ipv6AddressType, k as Ipv6ParseResult, P as ParsedDnsResult, l as ParsedGeoResult, R as REFERRER_POLICY_VALUES, m as ReferrerPolicyEntry, o as ReferrerPolicyResult, p as ReferrerPolicyValue, q as RobotsGroup, r as RobotsIssue, s as RobotsRule, t as RobotsValidationResult, S as STATUS_CODES, u as SitemapIndexEntry, v as SitemapIssue, w as SitemapUrlEntry, x as SitemapValidationResult, y as StatusCode, U as UaDeviceType, z as UserAgentInfo, A as buildCacheControl, B as buildDnsQueryUrl, E as buildGeoUrl, F as buildMapUrl, J as buildReferrerPolicy, K as countryCodeToFlag, L as formatCoordinates, M as formatTtl, N as getByCategory, O as getHeader, Q as getHeadersByCategory, T as getStatusByCategory, V as getStatusCode, W as isClientError, X as isServerError, Y as isSuccess, Z as isValidIp, _ as isValidIpv4, $ as isValidIpv6, a0 as parseDnsResponse, a1 as parseGeoResponse, a2 as parseHar, a3 as parseIpv6Address, a4 as parseUserAgent, a5 as searchHeaders, a6 as searchStatusCodes, a7 as statusCodeToText, a8 as typeNumberToLabel, a9 as validateDomain, aa as validateHeaderName, ab as validateHeaderValue, ac as validateRobotsTxt, ad as validateSitemap } from '../network-DfY5Ikvr.js';
+export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, I as Ipv6AddressType, k as Ipv6ParseResult, L as LINK_REL_VALUES, l as LinkHeaderEntry, m as LinkHeaderEntryInput, o as LinkHeaderResult, p as LinkRel, P as ParsedDnsResult, q as ParsedGeoResult, R as REFERRER_POLICY_VALUES, r as ReferrerPolicyEntry, s as ReferrerPolicyResult, t as ReferrerPolicyValue, u as RobotsGroup, v as RobotsIssue, w as RobotsRule, x as RobotsValidationResult, S as STATUS_CODES, y as SitemapIndexEntry, z as SitemapIssue, A as SitemapUrlEntry, B as SitemapValidationResult, E as StatusCode, U as UaDeviceType, F as UserAgentInfo, J as buildCacheControl, K as buildDnsQueryUrl, M as buildGeoUrl, N as buildLinkHeader, O as buildMapUrl, Q as buildReferrerPolicy, T as countryCodeToFlag, V as formatCoordinates, W as formatTtl, X as getByCategory, Y as getHeader, Z as getHeadersByCategory, _ as getStatusByCategory, $ as getStatusCode, a0 as isClientError, a1 as isServerError, a2 as isSuccess, a3 as isValidIp, a4 as isValidIpv4, a5 as isValidIpv6, a6 as parseDnsResponse, a7 as parseGeoResponse, a8 as parseHar, a9 as parseIpv6Address, aa as parseUserAgent, ab as searchHeaders, ac as searchStatusCodes, ad as statusCodeToText, ae as typeNumberToLabel, af as validateDomain, ag as validateHeaderName, ah as validateHeaderValue, ai as validateRobotsTxt, aj as validateSitemap } from '../network-X0EfH9Xq.js';

package/dist/tools/network.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.35.0",
+  "version": "0.36.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",