@utilix-tech/sdk 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.11.0
+- Added IBAN Validator / Formatter (`validateIban`) and Loan / Mortgage Calculator (`calculateLoan`).
+- (npm publish for this version was retried after fixing a CI pin: `npm install -g npm@latest` started pulling npm 12, which requires Node >=22 and broke on this job's pinned Node 20 — now pinned to the npm 11 line.)
+
+## 0.10.0
+- Added robots.txt Validator and Credit Card Number Validator.
+
 ## 0.9.0
 - Added Sitemap.xml Validator.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**526 developer utility functions for Node.js: runs locally, no API key required.**
+**533 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, validateIban, calculateLoan } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -260,6 +260,18 @@ 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" }
+
+// IBAN mod-97 checksum + formatting
+validateIban("DE89 3704 0044 0532 0130 00");
+// { valid: true, countryCode: "DE", checksumValid: true, formatted: "DE89 3704 0044 0532 0130 00", ... }
+
+// Loan / mortgage amortization
+calculateLoan(200000, 6.5, 360);
+// { monthlyPayment: 1264.14, totalInterest: 255085.82, termMonths: 360, schedule: [...] }
 ```
 
 ---
@@ -269,7 +281,7 @@ formatValue(1234567.89, { locale: "en-US", currency: "USD" });
 ```ts
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
-         parseHar, validateSitemap } from "@utilix-tech/sdk/network";
+         parseHar, validateSitemap, validateRobotsTxt } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -290,6 +302,10 @@ parseHar(har);
 // 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-QJE743LY.js → chunk-GGDDCTFM.js}

@@ -16,6 +16,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateLoan: () => calculateLoan,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertBytes: () => convertBytes,
@@ -60,6 +61,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) {
@@ -892,5 +895,225 @@ 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
+  };
+}
 
-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, calculateLoan, 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, validateIban, viewportToPx };

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

@@ -33,6 +33,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"];
@@ -1531,5 +1532,88 @@ 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 };
+}
 
-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, validateSitemap };
+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 };