@utilix-tech/sdk 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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.10.0
+- Added robots.txt Validator and Credit Card Number Validator.
+
+## 0.9.0
+- Added Sitemap.xml Validator.
+
 ## 0.8.0
 - Added ID3 Tag Reader and .env.example Diff Checker.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**526 developer utility functions for Node.js: runs locally, no API key required.**
+**531 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)
@@ -242,7 +242,7 @@ getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -260,6 +260,10 @@ convert("11111111", 2, 10); // "255"
 // Currency / locale formatting
 formatValue(1234567.89, { locale: "en-US", currency: "USD" });
 // "$1,234,567.89"
+
+// Credit card Luhn checksum + network detection
+validateCardNumber("4111 1111 1111 1111");
+// { valid: true, network: "Visa", length: 16, formatted: "4111 1111 1111 1111" }
 ```
 
 ---
@@ -269,7 +273,7 @@ formatValue(1234567.89, { locale: "en-US", currency: "USD" });
 ```ts
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
-         parseHar } from "@utilix-tech/sdk/network";
+         parseHar, validateSitemap, validateRobotsTxt } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -286,6 +290,14 @@ countryCodeToFlag("US");       // "🇺🇸"
 const har = await fs.promises.readFile("network.har", "utf-8");
 parseHar(har);
 // { version: "1.2", entries: [...], summary: { totalRequests, totalSize, failedRequests, ... } }
+
+// Validate a sitemap.xml (or sitemap index) against the sitemaps.org protocol
+validateSitemap('<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://example.com/</loc></url></urlset>');
+// { type: "urlset", urlCount: 1, entries: [...], issues: [...], valid: true }
+
+// Validate a robots.txt file: User-agent groups, rules, and syntax mistakes
+validateRobotsTxt("User-agent: *\nDisallow: /admin\nSitemap: https://example.com/sitemap.xml");
+// { groups: [...], sitemaps: [...], issues: [...], valid: true }
 ```
 
 ---

package/dist/{chunk-V5JKVDBA.js → chunk-OB56VNKJ.js}

@@ -32,7 +32,9 @@ __export(network_exports, {
   typeNumberToLabel: () => typeNumberToLabel,
   validateDomain: () => validateDomain,
   validateHeaderName: () => validateHeaderName,
-  validateHeaderValue: () => validateHeaderValue
+  validateHeaderValue: () => validateHeaderValue,
+  validateRobotsTxt: () => validateRobotsTxt,
+  validateSitemap: () => validateSitemap
 });
 var DNS_RECORD_TYPES = ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 function buildDnsQueryUrl(domain, type) {
@@ -1440,5 +1442,178 @@ function parseHar(input) {
     summary: { totalRequests, totalSize, totalTime, avgTime, failedRequests, methods, statusCodes }
   };
 }
+var VALID_CHANGEFREQ = /* @__PURE__ */ new Set(["always", "hourly", "daily", "weekly", "monthly", "yearly", "never"]);
+function sitemapLineNumber(xml, index) {
+  let line = 1;
+  for (let i = 0; i < index; i++) {
+    if (xml[i] === "\n") line++;
+  }
+  return line;
+}
+function extractSitemapTag(block, tag) {
+  const m = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i"));
+  return m ? m[1].trim() : void 0;
+}
+function isValidW3CDatetime(s) {
+  return /^\d{4}(-\d{2}(-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2}))?)?)?$/.test(s);
+}
+function isAbsoluteHttpUrl(s) {
+  return /^https?:\/\//i.test(s);
+}
+function validateSitemap(xml) {
+  if (!xml || !xml.trim()) return { error: "Input is empty" };
+  const trimmed = xml.trim();
+  const issues = [];
+  if (!/^\s*<\?xml/i.test(trimmed)) {
+    issues.push({ severity: "warning", line: 1, message: 'Missing XML declaration (<?xml version="1.0" encoding="UTF-8"?>)' });
+  }
+  const isUrlset = /<urlset[\s>]/i.test(trimmed);
+  const isSitemapIndex = /<sitemapindex[\s>]/i.test(trimmed);
+  if (!isUrlset && !isSitemapIndex) {
+    return { error: "Not a valid sitemap: root element must be <urlset> or <sitemapindex>" };
+  }
+  if (isUrlset && isSitemapIndex) {
+    return { error: "Ambiguous file: contains both <urlset> and <sitemapindex> root elements" };
+  }
+  const type = isUrlset ? "urlset" : "sitemapindex";
+  if (isUrlset && !/xmlns\s*=\s*["']http:\/\/www\.sitemaps\.org\/schemas\/sitemap\/0\.9["']/i.test(trimmed)) {
+    issues.push({ severity: "warning", line: 1, message: "Missing or non-standard xmlns namespace (expected http://www.sitemaps.org/schemas/sitemap/0.9)" });
+  }
+  const blockTag = isUrlset ? "url" : "sitemap";
+  const blockRe = new RegExp(`<${blockTag}>([\\s\\S]*?)</${blockTag}>`, "gi");
+  const seenLocs = /* @__PURE__ */ new Set();
+  const entries = [];
+  let match;
+  while ((match = blockRe.exec(trimmed)) !== null) {
+    const block = match[1];
+    const line = sitemapLineNumber(trimmed, match.index);
+    const loc = extractSitemapTag(block, "loc");
+    if (!loc) {
+      issues.push({ severity: "error", line, message: `<${blockTag}> entry is missing required <loc>` });
+      continue;
+    }
+    if (!isAbsoluteHttpUrl(loc)) {
+      issues.push({ severity: "error", line, message: `<loc>${loc}</loc> must be an absolute URL starting with http:// or https://` });
+    }
+    if (/&(?!amp;|lt;|gt;|apos;|quot;|#\d+;)/.test(loc)) {
+      issues.push({ severity: "error", line, message: `<loc>${loc}</loc> contains an unescaped '&' (use &amp; instead)` });
+    }
+    if (seenLocs.has(loc)) {
+      issues.push({ severity: "warning", line, message: `Duplicate <loc>${loc}</loc>` });
+    }
+    seenLocs.add(loc);
+    const lastmod = extractSitemapTag(block, "lastmod");
+    if (lastmod !== void 0 && !isValidW3CDatetime(lastmod)) {
+      issues.push({ severity: "warning", line, message: `<lastmod>${lastmod}</lastmod> is not a valid W3C datetime` });
+    }
+    if (type === "urlset") {
+      const changefreq = extractSitemapTag(block, "changefreq");
+      if (changefreq !== void 0 && !VALID_CHANGEFREQ.has(changefreq.toLowerCase())) {
+        issues.push({ severity: "error", line, message: `<changefreq>${changefreq}</changefreq> must be one of: ${[...VALID_CHANGEFREQ].join(", ")}` });
+      }
+      const priority = extractSitemapTag(block, "priority");
+      if (priority !== void 0) {
+        const p = Number(priority);
+        if (Number.isNaN(p) || p < 0 || p > 1) {
+          issues.push({ severity: "error", line, message: `<priority>${priority}</priority> must be a number between 0.0 and 1.0` });
+        }
+      }
+      entries.push({ loc, lastmod, changefreq, priority, line });
+    } else {
+      entries.push({ loc, lastmod, line });
+    }
+  }
+  if (entries.length === 0) {
+    issues.push({ severity: "error", line: 1, message: `No <${blockTag}> entries found` });
+  }
+  if (type === "urlset" && entries.length > 5e4) {
+    issues.push({ severity: "error", line: 1, message: `Sitemap contains ${entries.length} URLs, exceeding the 50,000 URL limit per the sitemaps.org spec` });
+  }
+  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 };
+}
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue };
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/{chunk-QJE743LY.js → chunk-YVFM5WYI.js}

@@ -60,6 +60,7 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateCardNumber: () => validateCardNumber,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -892,5 +893,65 @@ 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 };
+}
 
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateCardNumber, viewportToPx };

package/dist/index.cjs

@@ -6665,6 +6665,7 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateCardNumber: () => validateCardNumber,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -7497,6 +7498,66 @@ 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 };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -7530,7 +7591,9 @@ __export(network_exports, {
   typeNumberToLabel: () => typeNumberToLabel,
   validateDomain: () => validateDomain,
   validateHeaderName: () => validateHeaderName,
-  validateHeaderValue: () => validateHeaderValue
+  validateHeaderValue: () => validateHeaderValue,
+  validateRobotsTxt: () => validateRobotsTxt,
+  validateSitemap: () => validateSitemap
 });
 var DNS_RECORD_TYPES = ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 function buildDnsQueryUrl(domain, type) {
@@ -8938,6 +9001,179 @@ function parseHar(input) {
     summary: { totalRequests, totalSize, totalTime, avgTime, failedRequests, methods, statusCodes }
   };
 }
+var VALID_CHANGEFREQ = /* @__PURE__ */ new Set(["always", "hourly", "daily", "weekly", "monthly", "yearly", "never"]);
+function sitemapLineNumber(xml, index) {
+  let line = 1;
+  for (let i = 0; i < index; i++) {
+    if (xml[i] === "\n") line++;
+  }
+  return line;
+}
+function extractSitemapTag(block, tag) {
+  const m = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i"));
+  return m ? m[1].trim() : void 0;
+}
+function isValidW3CDatetime(s) {
+  return /^\d{4}(-\d{2}(-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2}))?)?)?$/.test(s);
+}
+function isAbsoluteHttpUrl(s) {
+  return /^https?:\/\//i.test(s);
+}
+function validateSitemap(xml) {
+  if (!xml || !xml.trim()) return { error: "Input is empty" };
+  const trimmed = xml.trim();
+  const issues = [];
+  if (!/^\s*<\?xml/i.test(trimmed)) {
+    issues.push({ severity: "warning", line: 1, message: 'Missing XML declaration (<?xml version="1.0" encoding="UTF-8"?>)' });
+  }
+  const isUrlset = /<urlset[\s>]/i.test(trimmed);
+  const isSitemapIndex = /<sitemapindex[\s>]/i.test(trimmed);
+  if (!isUrlset && !isSitemapIndex) {
+    return { error: "Not a valid sitemap: root element must be <urlset> or <sitemapindex>" };
+  }
+  if (isUrlset && isSitemapIndex) {
+    return { error: "Ambiguous file: contains both <urlset> and <sitemapindex> root elements" };
+  }
+  const type = isUrlset ? "urlset" : "sitemapindex";
+  if (isUrlset && !/xmlns\s*=\s*["']http:\/\/www\.sitemaps\.org\/schemas\/sitemap\/0\.9["']/i.test(trimmed)) {
+    issues.push({ severity: "warning", line: 1, message: "Missing or non-standard xmlns namespace (expected http://www.sitemaps.org/schemas/sitemap/0.9)" });
+  }
+  const blockTag = isUrlset ? "url" : "sitemap";
+  const blockRe = new RegExp(`<${blockTag}>([\\s\\S]*?)</${blockTag}>`, "gi");
+  const seenLocs = /* @__PURE__ */ new Set();
+  const entries = [];
+  let match;
+  while ((match = blockRe.exec(trimmed)) !== null) {
+    const block = match[1];
+    const line = sitemapLineNumber(trimmed, match.index);
+    const loc = extractSitemapTag(block, "loc");
+    if (!loc) {
+      issues.push({ severity: "error", line, message: `<${blockTag}> entry is missing required <loc>` });
+      continue;
+    }
+    if (!isAbsoluteHttpUrl(loc)) {
+      issues.push({ severity: "error", line, message: `<loc>${loc}</loc> must be an absolute URL starting with http:// or https://` });
+    }
+    if (/&(?!amp;|lt;|gt;|apos;|quot;|#\d+;)/.test(loc)) {
+      issues.push({ severity: "error", line, message: `<loc>${loc}</loc> contains an unescaped '&' (use &amp; instead)` });
+    }
+    if (seenLocs.has(loc)) {
+      issues.push({ severity: "warning", line, message: `Duplicate <loc>${loc}</loc>` });
+    }
+    seenLocs.add(loc);
+    const lastmod = extractSitemapTag(block, "lastmod");
+    if (lastmod !== void 0 && !isValidW3CDatetime(lastmod)) {
+      issues.push({ severity: "warning", line, message: `<lastmod>${lastmod}</lastmod> is not a valid W3C datetime` });
+    }
+    if (type === "urlset") {
+      const changefreq = extractSitemapTag(block, "changefreq");
+      if (changefreq !== void 0 && !VALID_CHANGEFREQ.has(changefreq.toLowerCase())) {
+        issues.push({ severity: "error", line, message: `<changefreq>${changefreq}</changefreq> must be one of: ${[...VALID_CHANGEFREQ].join(", ")}` });
+      }
+      const priority = extractSitemapTag(block, "priority");
+      if (priority !== void 0) {
+        const p = Number(priority);
+        if (Number.isNaN(p) || p < 0 || p > 1) {
+          issues.push({ severity: "error", line, message: `<priority>${priority}</priority> must be a number between 0.0 and 1.0` });
+        }
+      }
+      entries.push({ loc, lastmod, changefreq, priority, line });
+    } else {
+      entries.push({ loc, lastmod, line });
+    }
+  }
+  if (entries.length === 0) {
+    issues.push({ severity: "error", line: 1, message: `No <${blockTag}> entries found` });
+  }
+  if (type === "urlset" && entries.length > 5e4) {
+    issues.push({ severity: "error", line: 1, message: `Sitemap contains ${entries.length} URLs, exceeding the 50,000 URL limit per the sitemaps.org spec` });
+  }
+  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 = {};

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-DwyAjwJS.cjs';
+export { u as units } from './units-DRT6W-vu.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-DwyAjwJS.js';
+export { u as units } from './units-DRT6W-vu.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-V5JKVDBA.js';
+export { units_exports as units } from './chunk-YVFM5WYI.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';