@utilix-tech/sdk 0.9.0 → 0.11.0

package/dist/index.cjs

@@ -6621,6 +6621,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateLoan: () => calculateLoan,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertBytes: () => convertBytes,
@@ -6665,6 +6666,8 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateCardNumber: () => validateCardNumber,
+  validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -7497,6 +7500,226 @@ function sortVersions(versions, order = "asc") {
     return order === "asc" ? cmp : -cmp;
   });
 }
+var CARD_NETWORK_RULES = [
+  { name: "American Express", lengths: [15], test: (d) => /^3[47]/.test(d) },
+  { name: "Diners Club", lengths: [14], test: (d) => /^3(?:0[0-5]|[68])/.test(d) },
+  {
+    name: "Discover",
+    lengths: [16, 19],
+    test: (d) => /^(?:6011|65|64[4-9])/.test(d) || /^622(?:12[6-9]|1[3-9]\d|[2-8]\d{2}|9[01]\d|92[0-5])/.test(d)
+  },
+  { name: "JCB", lengths: [16], test: (d) => /^35(?:2[89]|[3-8]\d)/.test(d) },
+  {
+    name: "Mastercard",
+    lengths: [16],
+    test: (d) => {
+      const two = parseInt(d.slice(0, 2), 10);
+      const four = parseInt(d.slice(0, 4), 10);
+      return two >= 51 && two <= 55 || four >= 2221 && four <= 2720;
+    }
+  },
+  { name: "Maestro", lengths: [12, 13, 14, 15, 16, 17, 18, 19], test: (d) => /^(?:50|5[6-8]|6304|6390|67)/.test(d) },
+  { name: "UnionPay", lengths: [16, 17, 18, 19], test: (d) => /^62/.test(d) },
+  { name: "Visa", lengths: [13, 16, 19], test: (d) => /^4/.test(d) }
+];
+function luhnCheck(digits) {
+  let sum = 0;
+  let shouldDouble = false;
+  for (let i = digits.length - 1; i >= 0; i--) {
+    let d = parseInt(digits[i], 10);
+    if (shouldDouble) {
+      d *= 2;
+      if (d > 9) d -= 9;
+    }
+    sum += d;
+    shouldDouble = !shouldDouble;
+  }
+  return sum % 10 === 0;
+}
+function detectCardNetwork(digits) {
+  for (const rule of CARD_NETWORK_RULES) {
+    if (rule.lengths.includes(digits.length) && rule.test(digits)) return rule.name;
+  }
+  return null;
+}
+function formatCardNumber(digits, network) {
+  if (network === "American Express") {
+    return `${digits.slice(0, 4)} ${digits.slice(4, 10)} ${digits.slice(10)}`.trim();
+  }
+  return digits.match(/.{1,4}/g)?.join(" ") ?? digits;
+}
+function validateCardNumber(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const digits = input.replace(/[\s-]/g, "");
+  if (!/^\d+$/.test(digits)) return { error: "Card number must contain only digits, spaces, or hyphens" };
+  if (digits.length < 12 || digits.length > 19) {
+    return { error: `Card number length (${digits.length}) is outside the valid range of 12-19 digits` };
+  }
+  const valid = luhnCheck(digits);
+  const network = detectCardNetwork(digits);
+  const formatted = formatCardNumber(digits, network);
+  return { valid, network, length: digits.length, formatted };
+}
+var IBAN_COUNTRY_LENGTHS = {
+  AD: 24,
+  AE: 23,
+  AL: 28,
+  AT: 20,
+  AZ: 28,
+  BA: 20,
+  BE: 16,
+  BG: 22,
+  BH: 22,
+  BR: 29,
+  BY: 28,
+  CH: 21,
+  CR: 22,
+  CY: 28,
+  CZ: 24,
+  DE: 22,
+  DK: 18,
+  DO: 28,
+  EE: 20,
+  EG: 29,
+  ES: 24,
+  FI: 18,
+  FO: 18,
+  FR: 27,
+  GB: 22,
+  GE: 22,
+  GI: 23,
+  GL: 18,
+  GR: 27,
+  GT: 28,
+  HR: 21,
+  HU: 28,
+  IE: 22,
+  IL: 23,
+  IQ: 23,
+  IS: 26,
+  IT: 27,
+  JO: 30,
+  KW: 30,
+  KZ: 20,
+  LB: 28,
+  LC: 32,
+  LI: 21,
+  LT: 20,
+  LU: 20,
+  LV: 21,
+  LY: 25,
+  MC: 27,
+  MD: 24,
+  ME: 22,
+  MK: 19,
+  MR: 27,
+  MT: 31,
+  MU: 30,
+  NL: 18,
+  NO: 15,
+  PK: 24,
+  PL: 28,
+  PS: 29,
+  PT: 25,
+  QA: 29,
+  RO: 24,
+  RS: 22,
+  SA: 24,
+  SC: 31,
+  SE: 24,
+  SI: 19,
+  SK: 24,
+  SM: 27,
+  ST: 25,
+  SV: 28,
+  TL: 23,
+  TN: 24,
+  TR: 26,
+  UA: 29,
+  VA: 22,
+  VG: 24,
+  XK: 20
+};
+function ibanMod97(numeric) {
+  let remainder = 0;
+  for (let i = 0; i < numeric.length; i += 7) {
+    remainder = parseInt(String(remainder) + numeric.substr(i, 7), 10) % 97;
+  }
+  return remainder;
+}
+function formatIban(cleaned) {
+  return cleaned.match(/.{1,4}/g)?.join(" ") ?? cleaned;
+}
+function validateIban(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/\s/g, "").toUpperCase();
+  if (!/^[A-Z0-9]+$/.test(cleaned)) return { error: "IBAN must contain only letters and digits" };
+  if (cleaned.length < 4 || cleaned.length > 34) {
+    return { error: `IBAN length (${cleaned.length}) is outside the valid range of 4-34 characters` };
+  }
+  if (!/^[A-Z]{2}\d{2}/.test(cleaned)) {
+    return { error: "IBAN must start with a 2-letter country code followed by 2 check digits" };
+  }
+  const countryCode = cleaned.slice(0, 2);
+  const checkDigits = cleaned.slice(2, 4);
+  const bban = cleaned.slice(4);
+  const rearranged = cleaned.slice(4) + cleaned.slice(0, 4);
+  const numeric = rearranged.split("").map((ch) => /[A-Z]/.test(ch) ? String(ch.charCodeAt(0) - 55) : ch).join("");
+  const checksumValid = ibanMod97(numeric) === 1;
+  const expectedLength = IBAN_COUNTRY_LENGTHS[countryCode] ?? null;
+  const lengthValid = expectedLength === null ? null : cleaned.length === expectedLength;
+  const valid = checksumValid && lengthValid !== false;
+  return {
+    valid,
+    formatted: formatIban(cleaned),
+    countryCode,
+    checkDigits,
+    bban,
+    length: cleaned.length,
+    expectedLength,
+    checksumValid,
+    lengthValid
+  };
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function calculateLoan(principal, annualRatePercent, termMonths) {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(termMonths) || termMonths <= 0) {
+    return { error: "Term must be a positive whole number of months" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let monthlyPayment;
+  if (monthlyRate === 0) {
+    monthlyPayment = principal / termMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, termMonths);
+    monthlyPayment = principal * monthlyRate * factor / (factor - 1);
+  }
+  const schedule = [];
+  let balance = round2(principal);
+  let totalPayment = 0;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = round2(monthlyPayment) - interest;
+    if (month === termMonths || principalPortion > balance) principalPortion = balance;
+    const payment = round2(principalPortion + interest);
+    balance = round2(balance - principalPortion);
+    totalPayment += payment;
+    schedule.push({ month, payment, principal: round2(principalPortion), interest, balance: Math.max(balance, 0) });
+  }
+  return {
+    monthlyPayment: round2(monthlyPayment),
+    totalPayment: round2(totalPayment),
+    totalInterest: round2(totalPayment - principal),
+    termMonths,
+    schedule
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -7531,6 +7754,7 @@ __export(network_exports, {
   validateDomain: () => validateDomain,
   validateHeaderName: () => validateHeaderName,
   validateHeaderValue: () => validateHeaderValue,
+  validateRobotsTxt: () => validateRobotsTxt,
   validateSitemap: () => validateSitemap
 });
 var DNS_RECORD_TYPES = ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
@@ -9029,6 +9253,89 @@ function validateSitemap(xml) {
   const valid = !issues.some((i) => i.severity === "error");
   return { type, urlCount: entries.length, entries, issues, valid };
 }
+var KNOWN_ROBOTS_DIRECTIVES = /* @__PURE__ */ new Set(["user-agent", "disallow", "allow", "sitemap", "crawl-delay", "host"]);
+function validateRobotsTxt(text) {
+  if (!text || !text.trim()) return { error: "Input is empty" };
+  const lines = text.split("\n");
+  const issues = [];
+  const groups = [];
+  const sitemaps = [];
+  let currentGroup = null;
+  for (let i = 0; i < lines.length; i++) {
+    const rawLine = lines[i];
+    const lineNum = i + 1;
+    const commentIdx = rawLine.indexOf("#");
+    const line = (commentIdx >= 0 ? rawLine.slice(0, commentIdx) : rawLine).trim();
+    if (!line) continue;
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) {
+      issues.push({ severity: "error", line: lineNum, message: `Malformed line (missing ':'): "${line}"` });
+      continue;
+    }
+    const directive = line.slice(0, colonIdx).trim().toLowerCase();
+    const value = line.slice(colonIdx + 1).trim();
+    if (!KNOWN_ROBOTS_DIRECTIVES.has(directive)) {
+      issues.push({ severity: "warning", line: lineNum, message: `Unknown directive "${directive}"` });
+      continue;
+    }
+    if (directive === "sitemap") {
+      if (!/^https?:\/\//i.test(value)) {
+        issues.push({ severity: "error", line: lineNum, message: `Sitemap URL "${value}" must be absolute (start with http:// or https://)` });
+      }
+      sitemaps.push(value);
+      continue;
+    }
+    if (directive === "user-agent") {
+      if (!value) {
+        issues.push({ severity: "error", line: lineNum, message: "User-agent directive is missing a value" });
+      }
+      if (currentGroup && currentGroup.rules.length === 0 && currentGroup.crawlDelay === void 0) {
+        currentGroup.userAgents.push(value);
+      } else {
+        currentGroup = { userAgents: [value], rules: [], line: lineNum };
+        groups.push(currentGroup);
+      }
+      continue;
+    }
+    if (!currentGroup) {
+      issues.push({ severity: "error", line: lineNum, message: `"${directive}" directive found before any User-agent line` });
+      continue;
+    }
+    if (directive === "disallow" || directive === "allow") {
+      if (value !== "" && !value.startsWith("/") && !value.startsWith("*")) {
+        issues.push({ severity: "warning", line: lineNum, message: `${directive === "disallow" ? "Disallow" : "Allow"} value "${value}" should start with "/" (or be empty)` });
+      }
+      if (currentGroup.rules.some((r) => r.type === directive && r.value === value)) {
+        issues.push({ severity: "warning", line: lineNum, message: `Duplicate ${directive} rule for "${value}" in this group` });
+      }
+      currentGroup.rules.push({ type: directive, value, line: lineNum });
+    } else if (directive === "crawl-delay") {
+      const n = Number(value);
+      if (Number.isNaN(n) || n < 0) {
+        issues.push({ severity: "error", line: lineNum, message: `Crawl-delay "${value}" must be a non-negative number` });
+      } else {
+        currentGroup.crawlDelay = n;
+      }
+    }
+  }
+  if (groups.length === 0) {
+    issues.push({ severity: "error", line: 1, message: "No User-agent groups found" });
+  }
+  const seenUA = /* @__PURE__ */ new Map();
+  for (const g of groups) {
+    for (const ua of g.userAgents) {
+      const key = ua.toLowerCase();
+      const firstLine = seenUA.get(key);
+      if (firstLine !== void 0) {
+        issues.push({ severity: "warning", line: g.line, message: `Duplicate User-agent "${ua}" (first seen on line ${firstLine})` });
+      } else {
+        seenUA.set(key, g.line);
+      }
+    }
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return { groups, sitemaps, issues, valid };
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -17307,12 +17614,12 @@ function readGpsCoordinate(r, entries, valueTag, refTag) {
 function gcd2(a, b) {
   return b === 0 ? a : gcd2(b, a % b);
 }
-function round2(n) {
+function round22(n) {
   return Math.round(n * 100) / 100;
 }
 function formatExposureTime(num, den) {
   if (num === 0) return "0s";
-  if (num >= den) return `${round2(num / den)}s`;
+  if (num >= den) return `${round22(num / den)}s`;
   const divisor = gcd2(num, den) || 1;
   const n = num / divisor;
   const d = den / divisor;
@@ -17401,14 +17708,14 @@ function readExifData(bytes) {
       const fEntry = findEntry(sub.entries, 33437);
       if (fEntry) {
         const rat = readRational(r, fEntry);
-        if (rat && rat.den !== 0) result.fNumber = round2(rat.num / rat.den);
+        if (rat && rat.den !== 0) result.fNumber = round22(rat.num / rat.den);
       }
       const isoEntry = findEntry(sub.entries, 34855);
       if (isoEntry) result.isoSpeed = tu16(r, isoEntry.valueOffsetField);
       const focalEntry = findEntry(sub.entries, 37386);
       if (focalEntry) {
         const rat = readRational(r, focalEntry);
-        if (rat && rat.den !== 0) result.focalLength = round2(rat.num / rat.den);
+        if (rat && rat.den !== 0) result.focalLength = round22(rat.num / rat.den);
       }
     }
   }

package/dist/index.d.cts

@@ -5,8 +5,8 @@ export { t as text } from './text-Bbx-tZ43.cjs';
 export { d as data } from './data-D8XTI7Du.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
-export { u as units } from './units-6lwDYBvX.cjs';
-export { n as network } from './network-Cy02-FIO.cjs';
+export { u as units } from './units-BG387sch.cjs';
+export { n as network } from './network-DaNoZ5ER.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-BUqyaofO.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { t as text } from './text-Bbx-tZ43.js';
 export { d as data } from './data-D8XTI7Du.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
-export { u as units } from './units-6lwDYBvX.js';
-export { n as network } from './network-Cy02-FIO.js';
+export { u as units } from './units-BG387sch.js';
+export { n as network } from './network-DaNoZ5ER.js';
 export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-BUqyaofO.js';
 export { c as color } from './color-tPwZCr9H.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { media_exports as media } from './chunk-GUUYEIU6.js';
-export { units_exports as units } from './chunk-QJE743LY.js';
-export { network_exports as network } from './chunk-LI5AME5R.js';
+export { units_exports as units } from './chunk-GGDDCTFM.js';
+export { network_exports as network } from './chunk-OB56VNKJ.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-V5S6OJ4A.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';

package/dist/{network-Cy02-FIO.d.cts → network-DaNoZ5ER.d.cts}

@@ -9,6 +9,7 @@
  *   - http-headers  : HTTP header reference lookup and validation
  *   - har-viewer    : parseHar
  *   - sitemap-validator: validateSitemap
+ *   - robots-txt-validator: validateRobotsTxt
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -190,6 +191,37 @@ interface SitemapValidationResult {
 declare function validateSitemap(xml: string): SitemapValidationResult | {
     error: string;
 };
+interface RobotsRule {
+    type: 'allow' | 'disallow';
+    value: string;
+    line: number;
+}
+interface RobotsGroup {
+    userAgents: string[];
+    rules: RobotsRule[];
+    crawlDelay?: number;
+    line: number;
+}
+interface RobotsIssue {
+    severity: 'error' | 'warning';
+    line: number;
+    message: string;
+}
+interface RobotsValidationResult {
+    groups: RobotsGroup[];
+    sitemaps: string[];
+    issues: RobotsIssue[];
+    valid: boolean;
+}
+/**
+ * Validate a robots.txt file: parse it into User-agent groups and flag
+ * structural mistakes against the de facto robots.txt convention — directives
+ * before any User-agent, unknown directives, non-absolute Sitemap URLs,
+ * malformed Crawl-delay values, missing leading slashes, and duplicate rules.
+ */
+declare function validateRobotsTxt(text: string): RobotsValidationResult | {
+    error: string;
+};
 
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
@@ -204,6 +236,10 @@ type network_HeaderCategory = HeaderCategory;
 type network_HttpHeader = HttpHeader;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
+type network_RobotsGroup = RobotsGroup;
+type network_RobotsIssue = RobotsIssue;
+type network_RobotsRule = RobotsRule;
+type network_RobotsValidationResult = RobotsValidationResult;
 declare const network_STATUS_CODES: typeof STATUS_CODES;
 type network_SitemapIndexEntry = SitemapIndexEntry;
 type network_SitemapIssue = SitemapIssue;
@@ -237,9 +273,10 @@ declare const network_typeNumberToLabel: typeof typeNumberToLabel;
 declare const network_validateDomain: typeof validateDomain;
 declare const network_validateHeaderName: typeof validateHeaderName;
 declare const network_validateHeaderValue: typeof validateHeaderValue;
+declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { 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_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, 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, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, 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_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_validateSitemap as validateSitemap };
+  export { 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_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, 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, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, 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_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 { isClientError as A, isServerError as B, isSuccess as C, DNS_RECORD_TYPES as D, isValidIp as E, isValidIpv4 as F, type GeoResult as G, HTTP_HEADERS as H, isValidIpv6 as I, parseDnsResponse as J, parseGeoResponse as K, parseHar as L, searchHeaders as M, searchStatusCodes as N, statusCodeToText as O, type ParsedDnsResult as P, typeNumberToLabel as Q, validateDomain as R, STATUS_CODES as S, validateHeaderName as T, validateHeaderValue as U, validateSitemap as V, type DnsRecord as a, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type SitemapIndexEntry as j, type SitemapIssue as k, type SitemapUrlEntry as l, type SitemapValidationResult as m, network as n, type StatusCode as o, buildDnsQueryUrl as p, buildGeoUrl as q, buildMapUrl as r, countryCodeToFlag as s, formatCoordinates as t, formatTtl as u, getByCategory as v, getHeader as w, getHeadersByCategory as x, getStatusByCategory as y, getStatusCode as z };
+export { getHeadersByCategory as A, getStatusByCategory as B, getStatusCode as C, DNS_RECORD_TYPES as D, isClientError as E, isServerError as F, type GeoResult as G, HTTP_HEADERS as H, isSuccess as I, isValidIp as J, isValidIpv4 as K, isValidIpv6 as L, parseDnsResponse as M, parseGeoResponse as N, parseHar as O, type ParsedDnsResult as P, searchHeaders as Q, type RobotsGroup as R, STATUS_CODES as S, searchStatusCodes as T, statusCodeToText as U, typeNumberToLabel as V, validateDomain as W, validateHeaderName as X, validateHeaderValue as Y, validateRobotsTxt as Z, validateSitemap as _, type DnsRecord as a, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, buildDnsQueryUrl as s, buildGeoUrl as t, buildMapUrl as u, countryCodeToFlag as v, formatCoordinates as w, formatTtl as x, getByCategory as y, getHeader as z };

package/dist/{network-Cy02-FIO.d.ts → network-DaNoZ5ER.d.ts}

@@ -9,6 +9,7 @@
  *   - http-headers  : HTTP header reference lookup and validation
  *   - har-viewer    : parseHar
  *   - sitemap-validator: validateSitemap
+ *   - robots-txt-validator: validateRobotsTxt
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -190,6 +191,37 @@ interface SitemapValidationResult {
 declare function validateSitemap(xml: string): SitemapValidationResult | {
     error: string;
 };
+interface RobotsRule {
+    type: 'allow' | 'disallow';
+    value: string;
+    line: number;
+}
+interface RobotsGroup {
+    userAgents: string[];
+    rules: RobotsRule[];
+    crawlDelay?: number;
+    line: number;
+}
+interface RobotsIssue {
+    severity: 'error' | 'warning';
+    line: number;
+    message: string;
+}
+interface RobotsValidationResult {
+    groups: RobotsGroup[];
+    sitemaps: string[];
+    issues: RobotsIssue[];
+    valid: boolean;
+}
+/**
+ * Validate a robots.txt file: parse it into User-agent groups and flag
+ * structural mistakes against the de facto robots.txt convention — directives
+ * before any User-agent, unknown directives, non-absolute Sitemap URLs,
+ * malformed Crawl-delay values, missing leading slashes, and duplicate rules.
+ */
+declare function validateRobotsTxt(text: string): RobotsValidationResult | {
+    error: string;
+};
 
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
@@ -204,6 +236,10 @@ type network_HeaderCategory = HeaderCategory;
 type network_HttpHeader = HttpHeader;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
+type network_RobotsGroup = RobotsGroup;
+type network_RobotsIssue = RobotsIssue;
+type network_RobotsRule = RobotsRule;
+type network_RobotsValidationResult = RobotsValidationResult;
 declare const network_STATUS_CODES: typeof STATUS_CODES;
 type network_SitemapIndexEntry = SitemapIndexEntry;
 type network_SitemapIssue = SitemapIssue;
@@ -237,9 +273,10 @@ declare const network_typeNumberToLabel: typeof typeNumberToLabel;
 declare const network_validateDomain: typeof validateDomain;
 declare const network_validateHeaderName: typeof validateHeaderName;
 declare const network_validateHeaderValue: typeof validateHeaderValue;
+declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { 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_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, 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, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, 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_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_validateSitemap as validateSitemap };
+  export { 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_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, 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, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, 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_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 { isClientError as A, isServerError as B, isSuccess as C, DNS_RECORD_TYPES as D, isValidIp as E, isValidIpv4 as F, type GeoResult as G, HTTP_HEADERS as H, isValidIpv6 as I, parseDnsResponse as J, parseGeoResponse as K, parseHar as L, searchHeaders as M, searchStatusCodes as N, statusCodeToText as O, type ParsedDnsResult as P, typeNumberToLabel as Q, validateDomain as R, STATUS_CODES as S, validateHeaderName as T, validateHeaderValue as U, validateSitemap as V, type DnsRecord as a, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type SitemapIndexEntry as j, type SitemapIssue as k, type SitemapUrlEntry as l, type SitemapValidationResult as m, network as n, type StatusCode as o, buildDnsQueryUrl as p, buildGeoUrl as q, buildMapUrl as r, countryCodeToFlag as s, formatCoordinates as t, formatTtl as u, getByCategory as v, getHeader as w, getHeadersByCategory as x, getStatusByCategory as y, getStatusCode as z };
+export { getHeadersByCategory as A, getStatusByCategory as B, getStatusCode as C, DNS_RECORD_TYPES as D, isClientError as E, isServerError as F, type GeoResult as G, HTTP_HEADERS as H, isSuccess as I, isValidIp as J, isValidIpv4 as K, isValidIpv6 as L, parseDnsResponse as M, parseGeoResponse as N, parseHar as O, type ParsedDnsResult as P, searchHeaders as Q, type RobotsGroup as R, STATUS_CODES as S, searchStatusCodes as T, statusCodeToText as U, typeNumberToLabel as V, validateDomain as W, validateHeaderName as X, validateHeaderValue as Y, validateRobotsTxt as Z, validateSitemap as _, type DnsRecord as a, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, buildDnsQueryUrl as s, buildGeoUrl as t, buildMapUrl as u, countryCodeToFlag as v, formatCoordinates as w, formatTtl as x, getByCategory as y, getHeader as z };

package/dist/tools/network.cjs

@@ -1497,6 +1497,89 @@ function validateSitemap(xml) {
   const valid = !issues.some((i) => i.severity === "error");
   return { type, urlCount: entries.length, entries, issues, valid };
 }
+var KNOWN_ROBOTS_DIRECTIVES = /* @__PURE__ */ new Set(["user-agent", "disallow", "allow", "sitemap", "crawl-delay", "host"]);
+function validateRobotsTxt(text) {
+  if (!text || !text.trim()) return { error: "Input is empty" };
+  const lines = text.split("\n");
+  const issues = [];
+  const groups = [];
+  const sitemaps = [];
+  let currentGroup = null;
+  for (let i = 0; i < lines.length; i++) {
+    const rawLine = lines[i];
+    const lineNum = i + 1;
+    const commentIdx = rawLine.indexOf("#");
+    const line = (commentIdx >= 0 ? rawLine.slice(0, commentIdx) : rawLine).trim();
+    if (!line) continue;
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) {
+      issues.push({ severity: "error", line: lineNum, message: `Malformed line (missing ':'): "${line}"` });
+      continue;
+    }
+    const directive = line.slice(0, colonIdx).trim().toLowerCase();
+    const value = line.slice(colonIdx + 1).trim();
+    if (!KNOWN_ROBOTS_DIRECTIVES.has(directive)) {
+      issues.push({ severity: "warning", line: lineNum, message: `Unknown directive "${directive}"` });
+      continue;
+    }
+    if (directive === "sitemap") {
+      if (!/^https?:\/\//i.test(value)) {
+        issues.push({ severity: "error", line: lineNum, message: `Sitemap URL "${value}" must be absolute (start with http:// or https://)` });
+      }
+      sitemaps.push(value);
+      continue;
+    }
+    if (directive === "user-agent") {
+      if (!value) {
+        issues.push({ severity: "error", line: lineNum, message: "User-agent directive is missing a value" });
+      }
+      if (currentGroup && currentGroup.rules.length === 0 && currentGroup.crawlDelay === void 0) {
+        currentGroup.userAgents.push(value);
+      } else {
+        currentGroup = { userAgents: [value], rules: [], line: lineNum };
+        groups.push(currentGroup);
+      }
+      continue;
+    }
+    if (!currentGroup) {
+      issues.push({ severity: "error", line: lineNum, message: `"${directive}" directive found before any User-agent line` });
+      continue;
+    }
+    if (directive === "disallow" || directive === "allow") {
+      if (value !== "" && !value.startsWith("/") && !value.startsWith("*")) {
+        issues.push({ severity: "warning", line: lineNum, message: `${directive === "disallow" ? "Disallow" : "Allow"} value "${value}" should start with "/" (or be empty)` });
+      }
+      if (currentGroup.rules.some((r) => r.type === directive && r.value === value)) {
+        issues.push({ severity: "warning", line: lineNum, message: `Duplicate ${directive} rule for "${value}" in this group` });
+      }
+      currentGroup.rules.push({ type: directive, value, line: lineNum });
+    } else if (directive === "crawl-delay") {
+      const n = Number(value);
+      if (Number.isNaN(n) || n < 0) {
+        issues.push({ severity: "error", line: lineNum, message: `Crawl-delay "${value}" must be a non-negative number` });
+      } else {
+        currentGroup.crawlDelay = n;
+      }
+    }
+  }
+  if (groups.length === 0) {
+    issues.push({ severity: "error", line: 1, message: "No User-agent groups found" });
+  }
+  const seenUA = /* @__PURE__ */ new Map();
+  for (const g of groups) {
+    for (const ua of g.userAgents) {
+      const key = ua.toLowerCase();
+      const firstLine = seenUA.get(key);
+      if (firstLine !== void 0) {
+        issues.push({ severity: "warning", line: g.line, message: `Duplicate User-agent "${ua}" (first seen on line ${firstLine})` });
+      } else {
+        seenUA.set(key, g.line);
+      }
+    }
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return { groups, sitemaps, issues, valid };
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
@@ -1528,4 +1611,5 @@ exports.typeNumberToLabel = typeNumberToLabel;
 exports.validateDomain = validateDomain;
 exports.validateHeaderName = validateHeaderName;
 exports.validateHeaderValue = validateHeaderValue;
+exports.validateRobotsTxt = validateRobotsTxt;
 exports.validateSitemap = validateSitemap;

package/dist/tools/network.d.cts

@@ -1 +1 @@
-export { D as DNS_RECORD_TYPES, a as DnsRecord, b as DnsRecordType, c as DnsResponse, G as GeoResult, H as HTTP_HEADERS, d as HarEntry, e as HarParseResult, f as HarSummary, g as HeaderCategory, h as HttpHeader, P as ParsedDnsResult, i as ParsedGeoResult, S as STATUS_CODES, j as SitemapIndexEntry, k as SitemapIssue, l as SitemapUrlEntry, m as SitemapValidationResult, o as StatusCode, p as buildDnsQueryUrl, q as buildGeoUrl, r as buildMapUrl, s as countryCodeToFlag, t as formatCoordinates, u as formatTtl, v as getByCategory, w as getHeader, x as getHeadersByCategory, y as getStatusByCategory, z as getStatusCode, A as isClientError, B as isServerError, C as isSuccess, E as isValidIp, F as isValidIpv4, I as isValidIpv6, J as parseDnsResponse, K as parseGeoResponse, L as parseHar, M as searchHeaders, N as searchStatusCodes, O as statusCodeToText, Q as typeNumberToLabel, R as validateDomain, T as validateHeaderName, U as validateHeaderValue, V as validateSitemap } from '../network-Cy02-FIO.cjs';
+export { D as DNS_RECORD_TYPES, a as DnsRecord, b as DnsRecordType, c as DnsResponse, G as GeoResult, H as HTTP_HEADERS, d as HarEntry, e as HarParseResult, f as HarSummary, g as HeaderCategory, h as HttpHeader, P as ParsedDnsResult, i as ParsedGeoResult, R as RobotsGroup, j as RobotsIssue, k as RobotsRule, l as RobotsValidationResult, S as STATUS_CODES, m as SitemapIndexEntry, o as SitemapIssue, p as SitemapUrlEntry, q as SitemapValidationResult, r as StatusCode, s as buildDnsQueryUrl, t as buildGeoUrl, u as buildMapUrl, v as countryCodeToFlag, w as formatCoordinates, x as formatTtl, y as getByCategory, z as getHeader, A as getHeadersByCategory, B as getStatusByCategory, C as getStatusCode, E as isClientError, F as isServerError, I as isSuccess, J as isValidIp, K as isValidIpv4, L as isValidIpv6, M as parseDnsResponse, N as parseGeoResponse, O as parseHar, Q as searchHeaders, T as searchStatusCodes, U as statusCodeToText, V as typeNumberToLabel, W as validateDomain, X as validateHeaderName, Y as validateHeaderValue, Z as validateRobotsTxt, _ as validateSitemap } from '../network-DaNoZ5ER.cjs';