@utilix-tech/sdk 0.35.0 → 0.37.0

package/dist/index.cjs

@@ -9676,13 +9676,16 @@ 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,
+  checkSetCookieHeader: () => checkSetCookieHeader,
   countryCodeToFlag: () => countryCodeToFlag,
   formatCoordinates: () => formatCoordinates,
   formatTtl: () => formatTtl,
@@ -11566,6 +11569,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);
 }
@@ -11654,6 +11724,83 @@ function parseIpv6Address(input) {
     addressType: classifyIpv6(expandedGroups)
   };
 }
+var MAX_COOKIE_AGE_SECONDS = 400 * 24 * 60 * 60;
+function checkSetCookieHeader(header) {
+  if (typeof header !== "string" || !header.trim()) {
+    return { error: "A Set-Cookie header value is required" };
+  }
+  const parts = header.split(";").map((p) => p.trim()).filter(Boolean);
+  const [nameValue, ...attrParts] = parts;
+  const eqIdx = nameValue.indexOf("=");
+  if (eqIdx === -1) return { error: "Missing name=value pair" };
+  const name = nameValue.slice(0, eqIdx).trim();
+  const value = nameValue.slice(eqIdx + 1).trim();
+  if (!name) return { error: "Cookie name cannot be empty" };
+  const cookie = {
+    name,
+    value,
+    domain: null,
+    path: null,
+    expires: null,
+    maxAge: null,
+    secure: false,
+    httpOnly: false,
+    sameSite: null
+  };
+  for (const attr of attrParts) {
+    const idx = attr.indexOf("=");
+    const key = (idx === -1 ? attr : attr.slice(0, idx)).trim().toLowerCase();
+    const val = idx === -1 ? "" : attr.slice(idx + 1).trim();
+    switch (key) {
+      case "domain":
+        cookie.domain = val || null;
+        break;
+      case "path":
+        cookie.path = val || null;
+        break;
+      case "expires":
+        cookie.expires = val || null;
+        break;
+      case "max-age": {
+        const n = Number(val);
+        cookie.maxAge = Number.isFinite(n) ? n : null;
+        break;
+      }
+      case "secure":
+        cookie.secure = true;
+        break;
+      case "httponly":
+        cookie.httpOnly = true;
+        break;
+      case "samesite": {
+        const normalized = val.toLowerCase();
+        if (normalized === "strict") cookie.sameSite = "Strict";
+        else if (normalized === "lax") cookie.sameSite = "Lax";
+        else if (normalized === "none") cookie.sameSite = "None";
+        break;
+      }
+    }
+  }
+  const issues = [];
+  const warnings = [];
+  if (cookie.sameSite === "None" && !cookie.secure) {
+    issues.push("SameSite=None requires the Secure attribute \u2014 modern browsers reject this cookie without it.");
+  }
+  if (name.startsWith("__Host-")) {
+    if (!cookie.secure) issues.push("__Host- prefixed cookies require the Secure attribute.");
+    if (cookie.domain) issues.push("__Host- prefixed cookies must not set a Domain attribute.");
+    if (cookie.path !== "/") issues.push("__Host- prefixed cookies must set Path=/.");
+  } else if (name.startsWith("__Secure-")) {
+    if (!cookie.secure) issues.push("__Secure- prefixed cookies require the Secure attribute.");
+  }
+  if (!cookie.secure) {
+    warnings.push("Missing Secure attribute \u2014 the cookie can be sent over a plain HTTP connection.");
+  }
+  if (cookie.maxAge !== null && cookie.maxAge > MAX_COOKIE_AGE_SECONDS) {
+    warnings.push(`Max-Age (${cookie.maxAge}s) exceeds 400 days \u2014 Chromium-based browsers clamp cookie expiry to 400 days from when it's set, so this will be shortened.`);
+  }
+  return { cookie, issues, warnings, valid: issues.length === 0 };
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -13014,6 +13161,7 @@ __export(code_exports, {
   searchCheatsheet: () => searchCheatsheet,
   searchEndpoints: () => searchEndpoints,
   splitStatements: () => splitStatements,
+  testGitignorePatterns: () => testGitignorePatterns,
   testPattern: () => testPattern,
   testRegex: () => testRegex,
   validateEnvKey: () => validateEnvKey2
@@ -15822,6 +15970,85 @@ function lintConventionalCommit(message, options = {}) {
   const valid = !findings.some((f) => f.severity === "error");
   return { message, valid, parsed, findings };
 }
+function globSegmentToRegexSource(segment) {
+  let out = "";
+  for (let i = 0; i < segment.length; i++) {
+    const c = segment[i];
+    if (c === "*") {
+      out += "[^/]*";
+    } else if (c === "?") {
+      out += "[^/]";
+    } else if (c === "[") {
+      const close = segment.indexOf("]", i + 1);
+      if (close === -1) {
+        out += "\\[";
+      } else {
+        let cls = segment.slice(i + 1, close);
+        if (cls.startsWith("!")) cls = "^" + cls.slice(1);
+        out += `[${cls}]`;
+        i = close;
+      }
+    } else {
+      out += c.replace(/[.+^${}()|\\]/g, "\\$&");
+    }
+  }
+  return out;
+}
+function compileGitignorePattern(raw, line) {
+  let pattern = raw.replace(/\s+$/, "");
+  if (!pattern || pattern.startsWith("#")) return null;
+  let negate = false;
+  if (pattern.startsWith("!")) {
+    negate = true;
+    pattern = pattern.slice(1);
+  }
+  pattern = pattern.replace(/\\(.)/g, "$1");
+  if (!pattern) return null;
+  const dirOnly = pattern.endsWith("/") && !pattern.endsWith("\\/");
+  if (dirOnly) pattern = pattern.slice(0, -1);
+  const hasLeadingSlash = pattern.startsWith("/");
+  if (hasLeadingSlash) pattern = pattern.slice(1);
+  const anchored = hasLeadingSlash || pattern.includes("/");
+  const segments = pattern.split("/");
+  const regexParts = segments.map((seg) => {
+    if (seg === "**") return "(?:.*)";
+    return globSegmentToRegexSource(seg);
+  });
+  let body = regexParts.join("/");
+  body = body.replace(/\(\?:\.\*\)\//g, "(?:.*/)?").replace(/\/\(\?:\.\*\)/g, "(?:/.*)?");
+  const prefix = anchored ? "^" : "^(?:.*/)?";
+  const suffix = "(?:/.*)?$";
+  const regex = new RegExp(prefix + body + suffix);
+  return { raw, line, negate, regex };
+}
+function testGitignorePatterns(gitignoreContent, paths) {
+  if (typeof gitignoreContent !== "string" || !gitignoreContent.trim()) {
+    return { error: "gitignore content is required" };
+  }
+  if (!Array.isArray(paths) || paths.length === 0) {
+    return { error: "At least one path is required" };
+  }
+  const lines = gitignoreContent.split("\n");
+  const patterns = [];
+  lines.forEach((line, idx) => {
+    const compiled = compileGitignorePattern(line, idx + 1);
+    if (compiled) patterns.push(compiled);
+  });
+  return paths.map((rawPath) => {
+    const path = rawPath.trim().replace(/^\.\//, "");
+    let ignored = false;
+    let matchedPattern = null;
+    let matchedLine = null;
+    for (const p of patterns) {
+      if (p.regex.test(path)) {
+        ignored = !p.negate;
+        matchedPattern = p.raw.trim();
+        matchedLine = p.line;
+      }
+    }
+    return { path, ignored, matchedPattern, matchedLine };
+  });
+}
 
 // src/tools/color.ts
 var color_exports = {};

package/dist/index.d.cts

@@ -6,9 +6,9 @@ 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-CnKUQT4g.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
-export { c as code } from './code-BK-x8hVx.cjs';
+export { c as code } from './code-KXoRsHtl.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';
 export { c as css } from './css-Cf7AMGM-.cjs';
 export { m as misc } from './misc-CA3N198T.cjs';

package/dist/index.d.ts

@@ -6,9 +6,9 @@ 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-CnKUQT4g.js';
 export { a as api } from './api-DmTNE4c1.js';
-export { c as code } from './code-BK-x8hVx.js';
+export { c as code } from './code-KXoRsHtl.js';
 export { c as color } from './color-tPwZCr9H.js';
 export { c as css } from './css-Cf7AMGM-.js';
 export { m as misc } from './misc-CA3N198T.js';

package/dist/index.js

@@ -1,8 +1,8 @@
 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-DBNTO3YO.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
-export { code_exports as code } from './chunk-UUT5HNST.js';
+export { code_exports as code } from './chunk-JL7YTXRB.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
 export { css_exports as css } from './chunk-6YPV2AB5.js';
 export { misc_exports as misc } from './chunk-GX7H6TAX.js';

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

@@ -14,6 +14,8 @@
  *   - cache-control-builder: buildCacheControl
  *   - referrer-policy-builder: buildReferrerPolicy
  *   - ipv6-compressor: parseIpv6Address
+ *   - link-header-builder: buildLinkHeader
+ *   - same-site-cookie-checker: checkSetCookieHeader
  */
 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 +321,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;
@@ -336,10 +373,41 @@ interface Ipv6ParseResult {
 declare function parseIpv6Address(input: string): Ipv6ParseResult | {
     error: string;
 };
+type SameSiteValue = 'Strict' | 'Lax' | 'None';
+interface CookieAttributes {
+    name: string;
+    value: string;
+    domain: string | null;
+    path: string | null;
+    expires: string | null;
+    maxAge: number | null;
+    secure: boolean;
+    httpOnly: boolean;
+    sameSite: SameSiteValue | null;
+}
+interface CookieCheckResult {
+    cookie: CookieAttributes;
+    issues: string[];
+    warnings: string[];
+    valid: boolean;
+}
+/**
+ * Parse a `Set-Cookie` header value and validate its attribute combination:
+ * `SameSite=None` requires `Secure`, the `__Host-`/`__Secure-` name prefixes
+ * each require their own attributes (`__Host-` additionally forbids `Domain`
+ * and requires `Path=/`), a missing `Secure` attribute is flagged, and a
+ * `Max-Age` beyond 400 days is flagged since Chromium-based browsers clamp
+ * it to that cap regardless of what was sent.
+ */
+declare function checkSetCookieHeader(header: string): CookieCheckResult | {
+    error: string;
+};
 
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
 type network_CacheControlResult = CacheControlResult;
+type network_CookieAttributes = CookieAttributes;
+type network_CookieCheckResult = CookieCheckResult;
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
@@ -353,6 +421,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;
@@ -364,6 +437,7 @@ type network_RobotsIssue = RobotsIssue;
 type network_RobotsRule = RobotsRule;
 type network_RobotsValidationResult = RobotsValidationResult;
 declare const network_STATUS_CODES: typeof STATUS_CODES;
+type network_SameSiteValue = SameSiteValue;
 type network_SitemapIndexEntry = SitemapIndexEntry;
 type network_SitemapIssue = SitemapIssue;
 type network_SitemapUrlEntry = SitemapUrlEntry;
@@ -374,8 +448,10 @@ 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_checkSetCookieHeader: typeof checkSetCookieHeader;
 declare const network_countryCodeToFlag: typeof countryCodeToFlag;
 declare const network_formatCoordinates: typeof formatCoordinates;
 declare const network_formatTtl: typeof formatTtl;
@@ -405,7 +481,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, 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_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_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_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, 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_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 { getByCategory as $, type SameSiteValue as A, type SitemapIndexEntry as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type SitemapIssue as E, type SitemapUrlEntry as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type SitemapValidationResult as J, type StatusCode as K, LINK_REL_VALUES as L, type UserAgentInfo as M, buildCacheControl as N, buildDnsQueryUrl as O, type ParsedDnsResult as P, buildGeoUrl as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, buildLinkHeader as T, type UaDeviceType as U, buildMapUrl as V, buildReferrerPolicy as W, checkSetCookieHeader as X, countryCodeToFlag as Y, formatCoordinates as Z, formatTtl as _, type CacheControlOptions as a, getHeader as a0, getHeadersByCategory as a1, getStatusByCategory as a2, getStatusCode as a3, isClientError as a4, isServerError as a5, isSuccess as a6, isValidIp as a7, isValidIpv4 as a8, isValidIpv6 as a9, parseDnsResponse as aa, parseGeoResponse as ab, parseHar as ac, parseIpv6Address as ad, parseUserAgent as ae, searchHeaders as af, searchStatusCodes as ag, statusCodeToText as ah, typeNumberToLabel as ai, validateDomain as aj, validateHeaderName as ak, validateHeaderValue as al, validateRobotsTxt as am, validateSitemap as an, type CacheControlResult as b, type CookieAttributes as c, type CookieCheckResult as d, type DnsRecord as e, type DnsRecordType as f, type DnsResponse as g, type HarEntry as h, type HarParseResult as i, type HarSummary as j, type HeaderCategory as k, type HttpHeader as l, type Ipv6ParseResult as m, network as n, type LinkHeaderEntry as o, type LinkHeaderEntryInput as p, type LinkHeaderResult as q, type LinkRel as r, type ParsedGeoResult as s, type ReferrerPolicyEntry as t, type ReferrerPolicyResult as u, type ReferrerPolicyValue as v, type RobotsGroup as w, type RobotsIssue as x, type RobotsRule as y, type RobotsValidationResult as z };

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

@@ -14,6 +14,8 @@
  *   - cache-control-builder: buildCacheControl
  *   - referrer-policy-builder: buildReferrerPolicy
  *   - ipv6-compressor: parseIpv6Address
+ *   - link-header-builder: buildLinkHeader
+ *   - same-site-cookie-checker: checkSetCookieHeader
  */
 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 +321,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;
@@ -336,10 +373,41 @@ interface Ipv6ParseResult {
 declare function parseIpv6Address(input: string): Ipv6ParseResult | {
     error: string;
 };
+type SameSiteValue = 'Strict' | 'Lax' | 'None';
+interface CookieAttributes {
+    name: string;
+    value: string;
+    domain: string | null;
+    path: string | null;
+    expires: string | null;
+    maxAge: number | null;
+    secure: boolean;
+    httpOnly: boolean;
+    sameSite: SameSiteValue | null;
+}
+interface CookieCheckResult {
+    cookie: CookieAttributes;
+    issues: string[];
+    warnings: string[];
+    valid: boolean;
+}
+/**
+ * Parse a `Set-Cookie` header value and validate its attribute combination:
+ * `SameSite=None` requires `Secure`, the `__Host-`/`__Secure-` name prefixes
+ * each require their own attributes (`__Host-` additionally forbids `Domain`
+ * and requires `Path=/`), a missing `Secure` attribute is flagged, and a
+ * `Max-Age` beyond 400 days is flagged since Chromium-based browsers clamp
+ * it to that cap regardless of what was sent.
+ */
+declare function checkSetCookieHeader(header: string): CookieCheckResult | {
+    error: string;
+};
 
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
 type network_CacheControlResult = CacheControlResult;
+type network_CookieAttributes = CookieAttributes;
+type network_CookieCheckResult = CookieCheckResult;
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
@@ -353,6 +421,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;
@@ -364,6 +437,7 @@ type network_RobotsIssue = RobotsIssue;
 type network_RobotsRule = RobotsRule;
 type network_RobotsValidationResult = RobotsValidationResult;
 declare const network_STATUS_CODES: typeof STATUS_CODES;
+type network_SameSiteValue = SameSiteValue;
 type network_SitemapIndexEntry = SitemapIndexEntry;
 type network_SitemapIssue = SitemapIssue;
 type network_SitemapUrlEntry = SitemapUrlEntry;
@@ -374,8 +448,10 @@ 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_checkSetCookieHeader: typeof checkSetCookieHeader;
 declare const network_countryCodeToFlag: typeof countryCodeToFlag;
 declare const network_formatCoordinates: typeof formatCoordinates;
 declare const network_formatTtl: typeof formatTtl;
@@ -405,7 +481,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, 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_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_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_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, 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_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 { getByCategory as $, type SameSiteValue as A, type SitemapIndexEntry as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type SitemapIssue as E, type SitemapUrlEntry as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type SitemapValidationResult as J, type StatusCode as K, LINK_REL_VALUES as L, type UserAgentInfo as M, buildCacheControl as N, buildDnsQueryUrl as O, type ParsedDnsResult as P, buildGeoUrl as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, buildLinkHeader as T, type UaDeviceType as U, buildMapUrl as V, buildReferrerPolicy as W, checkSetCookieHeader as X, countryCodeToFlag as Y, formatCoordinates as Z, formatTtl as _, type CacheControlOptions as a, getHeader as a0, getHeadersByCategory as a1, getStatusByCategory as a2, getStatusCode as a3, isClientError as a4, isServerError as a5, isSuccess as a6, isValidIp as a7, isValidIpv4 as a8, isValidIpv6 as a9, parseDnsResponse as aa, parseGeoResponse as ab, parseHar as ac, parseIpv6Address as ad, parseUserAgent as ae, searchHeaders as af, searchStatusCodes as ag, statusCodeToText as ah, typeNumberToLabel as ai, validateDomain as aj, validateHeaderName as ak, validateHeaderValue as al, validateRobotsTxt as am, validateSitemap as an, type CacheControlResult as b, type CookieAttributes as c, type CookieCheckResult as d, type DnsRecord as e, type DnsRecordType as f, type DnsResponse as g, type HarEntry as h, type HarParseResult as i, type HarSummary as j, type HeaderCategory as k, type HttpHeader as l, type Ipv6ParseResult as m, network as n, type LinkHeaderEntry as o, type LinkHeaderEntryInput as p, type LinkHeaderResult as q, type LinkRel as r, type ParsedGeoResult as s, type ReferrerPolicyEntry as t, type ReferrerPolicyResult as u, type ReferrerPolicyValue as v, type RobotsGroup as w, type RobotsIssue as x, type RobotsRule as y, type RobotsValidationResult as z };