@utilix-tech/sdk 0.46.0 → 0.48.0

package/dist/tools/network.cjs

@@ -1497,6 +1497,53 @@ function validateSitemap(xml) {
   const valid = !issues.some((i) => i.severity === "error");
   return { type, urlCount: entries.length, entries, issues, valid };
 }
+var SITEMAP_SPLITTER_MAX_URLS_PER_FILE = 5e4;
+function escapeXmlUrl(url) {
+  return url.replace(/&(?!amp;|lt;|gt;|apos;|quot;|#\d+;)/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function splitSitemap(urlsText, options) {
+  const urls = (urlsText ?? "").split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+  if (urls.length === 0) return { error: "No URLs provided" };
+  for (let i = 0; i < urls.length; i++) {
+    if (!/^https?:\/\//i.test(urls[i])) {
+      return { error: `Line ${i + 1}: "${urls[i]}" is not an absolute URL starting with http:// or https://` };
+    }
+  }
+  if (!options || !/^https?:\/\//i.test(options.baseUrl ?? "")) {
+    return { error: "baseUrl must be an absolute URL starting with http:// or https://" };
+  }
+  const baseUrl = options.baseUrl.replace(/\/+$/, "") + "/";
+  let urlsPerFile = options.urlsPerFile ?? SITEMAP_SPLITTER_MAX_URLS_PER_FILE;
+  if (urlsPerFile <= 0) urlsPerFile = SITEMAP_SPLITTER_MAX_URLS_PER_FILE;
+  if (urlsPerFile > SITEMAP_SPLITTER_MAX_URLS_PER_FILE) urlsPerFile = SITEMAP_SPLITTER_MAX_URLS_PER_FILE;
+  const filePrefix = (options.filePrefix || "sitemap").replace(/[^A-Za-z0-9_-]/g, "");
+  const files = [];
+  for (let i = 0; i < urls.length; i += urlsPerFile) {
+    const chunk = urls.slice(i, i + urlsPerFile);
+    const fileIndex = files.length + 1;
+    const filename = `${filePrefix}-${fileIndex}.xml`;
+    const urlLines = chunk.map((url) => `  <url>
+    <loc>${escapeXmlUrl(url)}</loc>
+  </url>`).join("\n");
+    const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlLines}
+</urlset>
+`;
+    files.push({ filename, urlCount: chunk.length, xml });
+  }
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const indexEntries = files.map((f) => `  <sitemap>
+    <loc>${escapeXmlUrl(baseUrl + f.filename)}</loc>
+    <lastmod>${today}</lastmod>
+  </sitemap>`).join("\n");
+  const indexXml = `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${indexEntries}
+</sitemapindex>
+`;
+  return { files, indexXml, totalUrls: urls.length };
+}
 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" };
@@ -2623,6 +2670,53 @@ function parseClientHintHeaders(rawHeaders) {
   }
   return { hints, unrecognized };
 }
+function encodeRFC5987ValueChars(value) {
+  return encodeURIComponent(value).replace(/[!'()*]/g, (c) => "%" + c.charCodeAt(0).toString(16).toUpperCase());
+}
+function buildContentDisposition(options = {}) {
+  const type = options.type ?? "attachment";
+  if (type !== "inline" && type !== "attachment") return { error: 'type must be "inline" or "attachment"' };
+  if (!options.filename) return { header: type, type, filenameEncoded: false };
+  const filename = options.filename;
+  if (filename.includes("/") || filename.includes("\\")) return { error: "filename must not contain path separators" };
+  const isAscii = /^[\x20-\x7e]*$/.test(filename);
+  const asciiFallback = filename.replace(/[^\x20-\x7e]/g, "_").replace(/(["\\])/g, "\\$1");
+  let header = `${type}; filename="${asciiFallback}"`;
+  let filenameEncoded = false;
+  if (!isAscii) {
+    header += `; filename*=UTF-8''${encodeRFC5987ValueChars(filename)}`;
+    filenameEncoded = true;
+  }
+  return { header, type, filename, filenameEncoded };
+}
+function parseContentDisposition(header) {
+  if (typeof header !== "string" || header.trim() === "") return { error: "header is required" };
+  const parts = header.split(";").map((p) => p.trim()).filter(Boolean);
+  const type = parts[0]?.toLowerCase();
+  if (!type) return { error: "Could not parse a disposition type from the header" };
+  const params = {};
+  for (let i = 1; i < parts.length; i++) {
+    const eq = parts[i].indexOf("=");
+    if (eq === -1) continue;
+    const key = parts[i].slice(0, eq).trim().toLowerCase();
+    let value = parts[i].slice(eq + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"')) value = value.slice(1, -1).replace(/\\(.)/g, "$1");
+    params[key] = value;
+  }
+  let filename = params.filename;
+  let filenameIsExtended = false;
+  if (params["filename*"]) {
+    const match = params["filename*"].match(/^([^']*)'([^']*)'(.*)$/);
+    if (match) {
+      try {
+        filename = decodeURIComponent(match[3]);
+        filenameIsExtended = true;
+      } catch {
+      }
+    }
+  }
+  return { type, filename, filenameIsExtended, params };
+}
 
 exports.CLIENT_HINTS = CLIENT_HINTS;
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
@@ -2634,6 +2728,7 @@ exports.STATUS_CODES = STATUS_CODES;
 exports.analyzeEmailHeaders = analyzeEmailHeaders;
 exports.buildCacheControl = buildCacheControl;
 exports.buildClientHints = buildClientHints;
+exports.buildContentDisposition = buildContentDisposition;
 exports.buildDnsQueryUrl = buildDnsQueryUrl;
 exports.buildGeoUrl = buildGeoUrl;
 exports.buildLinkHeader = buildLinkHeader;
@@ -2658,6 +2753,7 @@ exports.isValidIp = isValidIp;
 exports.isValidIpv4 = isValidIpv4;
 exports.isValidIpv6 = isValidIpv6;
 exports.parseClientHintHeaders = parseClientHintHeaders;
+exports.parseContentDisposition = parseContentDisposition;
 exports.parseContentRangeHeader = parseContentRangeHeader;
 exports.parseDnsResponse = parseDnsResponse;
 exports.parseGeoResponse = parseGeoResponse;
@@ -2668,6 +2764,7 @@ exports.parseUserAgent = parseUserAgent;
 exports.parseVaryHeader = parseVaryHeader;
 exports.searchHeaders = searchHeaders;
 exports.searchStatusCodes = searchStatusCodes;
+exports.splitSitemap = splitSitemap;
 exports.statusCodeToText = statusCodeToText;
 exports.typeNumberToLabel = typeNumberToLabel;
 exports.validateDomain = validateDomain;

package/dist/tools/network.d.cts

@@ -1 +1 @@
-export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CLIENT_HINTS, a as CacheControlDirective, b as CacheControlOptions, c as CacheControlResult, d as ClientHintDef, e as ClientHintValueType, f as ClientHintsBuildResult, g as ClientHintsParseResult, h as ContentRangeResult, i as CookieAttributes, j as CookieCheckResult, D as DNS_RECORD_TYPES, k as DnsRecord, l as DnsRecordType, m as DnsResponse, E as EmailHeaderAnalysis, o as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, p as HarEntry, q as HarParseResult, r as HarSummary, s as HeaderCategory, t as HttpHeader, I as Ipv6AddressType, u as Ipv6ParseResult, L as LINK_REL_VALUES, v as LinkHeaderEntry, w as LinkHeaderEntryInput, x as LinkHeaderResult, y as LinkRel, M as ManifestIconInfo, z as ManifestIssue, F as ManifestValidationResult, P as PERMISSIONS_POLICY_FEATURES, J as ParsedClientHint, K as ParsedDnsResult, N as ParsedGeoResult, O as PermissionsPolicyDirective, Q as PermissionsPolicyFeatureInput, R as PermissionsPolicyResult, S as REFERRER_POLICY_VALUES, T as RangeEntry, U as RangeEntryInput, V as RangeHeaderResult, W as ReceivedHop, X as ReferrerPolicyEntry, Y as ReferrerPolicyResult, Z as ReferrerPolicyValue, _ as RobotsGroup, $ as RobotsIssue, a0 as RobotsRule, a1 as RobotsValidationResult, a2 as STATUS_CODES, a3 as SameSiteValue, a4 as SitemapIndexEntry, a5 as SitemapIssue, a6 as SitemapUrlEntry, a7 as SitemapValidationResult, a8 as StatusCode, a9 as UaDeviceType, aa as UserAgentInfo, ab as VaryHeaderEntry, ac as VaryHeaderResult, ad as analyzeEmailHeaders, ae as buildCacheControl, af as buildClientHints, ag as buildDnsQueryUrl, ah as buildGeoUrl, ai as buildLinkHeader, aj as buildMapUrl, ak as buildPermissionsPolicy, al as buildRangeHeader, am as buildReferrerPolicy, an as buildVaryHeader, ao as checkSetCookieHeader, ap as countryCodeToFlag, aq as formatCoordinates, ar as formatTtl, as as getByCategory, at as getHeader, au as getHeadersByCategory, av as getStatusByCategory, aw as getStatusCode, ax as isClientError, ay as isServerError, az as isSuccess, aA as isValidIp, aB as isValidIpv4, aC as isValidIpv6, aD as parseClientHintHeaders, aE as parseContentRangeHeader, aF as parseDnsResponse, aG as parseGeoResponse, aH as parseHar, aI as parseIpv6Address, aJ as parsePermissionsPolicy, aK as parseUserAgent, aL as parseVaryHeader, aM as searchHeaders, aN as searchStatusCodes, aO as statusCodeToText, aP as typeNumberToLabel, aQ as validateDomain, aR as validateHeaderName, aS as validateHeaderValue, aT as validateManifest, aU as validateRobotsTxt, aV as validateSitemap } from '../network-Bzm1tjMA.cjs';
+export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CLIENT_HINTS, a as CacheControlDirective, b as CacheControlOptions, c as CacheControlResult, d as ClientHintDef, e as ClientHintValueType, f as ClientHintsBuildResult, g as ClientHintsParseResult, h as ContentDispositionBuildOptions, i as ContentDispositionBuildResult, j as ContentDispositionParseResult, k as ContentRangeResult, l as CookieAttributes, m as CookieCheckResult, D as DNS_RECORD_TYPES, o as DnsRecord, p as DnsRecordType, q as DnsResponse, E as EmailHeaderAnalysis, r as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, s as HarEntry, t as HarParseResult, u as HarSummary, v as HeaderCategory, w as HttpHeader, I as Ipv6AddressType, x as Ipv6ParseResult, L as LINK_REL_VALUES, y as LinkHeaderEntry, z as LinkHeaderEntryInput, F as LinkHeaderResult, J as LinkRel, M as ManifestIconInfo, K as ManifestIssue, N as ManifestValidationResult, P as PERMISSIONS_POLICY_FEATURES, O as ParsedClientHint, Q as ParsedDnsResult, R as ParsedGeoResult, S as PermissionsPolicyDirective, T as PermissionsPolicyFeatureInput, U as PermissionsPolicyResult, V as REFERRER_POLICY_VALUES, W as RangeEntry, X as RangeEntryInput, Y as RangeHeaderResult, Z as ReceivedHop, _ as ReferrerPolicyEntry, $ as ReferrerPolicyResult, a0 as ReferrerPolicyValue, a1 as RobotsGroup, a2 as RobotsIssue, a3 as RobotsRule, a4 as RobotsValidationResult, a5 as STATUS_CODES, a6 as SameSiteValue, a7 as SitemapIndexEntry, a8 as SitemapIssue, a9 as SitemapSplitFile, aa as SitemapUrlEntry, ab as SitemapValidationResult, ac as SplitSitemapOptions, ad as SplitSitemapResult, ae as StatusCode, af as UaDeviceType, ag as UserAgentInfo, ah as VaryHeaderEntry, ai as VaryHeaderResult, aj as analyzeEmailHeaders, ak as buildCacheControl, al as buildClientHints, am as buildContentDisposition, an as buildDnsQueryUrl, ao as buildGeoUrl, ap as buildLinkHeader, aq as buildMapUrl, ar as buildPermissionsPolicy, as as buildRangeHeader, at as buildReferrerPolicy, au as buildVaryHeader, av as checkSetCookieHeader, aw as countryCodeToFlag, ax as formatCoordinates, ay as formatTtl, az as getByCategory, aA as getHeader, aB as getHeadersByCategory, aC as getStatusByCategory, aD as getStatusCode, aE as isClientError, aF as isServerError, aG as isSuccess, aH as isValidIp, aI as isValidIpv4, aJ as isValidIpv6, aK as parseClientHintHeaders, aL as parseContentDisposition, aM as parseContentRangeHeader, aN as parseDnsResponse, aO as parseGeoResponse, aP as parseHar, aQ as parseIpv6Address, aR as parsePermissionsPolicy, aS as parseUserAgent, aT as parseVaryHeader, aU as searchHeaders, aV as searchStatusCodes, aW as splitSitemap, aX as statusCodeToText, aY as typeNumberToLabel, aZ as validateDomain, a_ as validateHeaderName, a$ as validateHeaderValue, b0 as validateManifest, b1 as validateRobotsTxt, b2 as validateSitemap } from '../network-DelcJeJa.cjs';

package/dist/tools/network.d.ts

@@ -1 +1 @@
-export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CLIENT_HINTS, a as CacheControlDirective, b as CacheControlOptions, c as CacheControlResult, d as ClientHintDef, e as ClientHintValueType, f as ClientHintsBuildResult, g as ClientHintsParseResult, h as ContentRangeResult, i as CookieAttributes, j as CookieCheckResult, D as DNS_RECORD_TYPES, k as DnsRecord, l as DnsRecordType, m as DnsResponse, E as EmailHeaderAnalysis, o as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, p as HarEntry, q as HarParseResult, r as HarSummary, s as HeaderCategory, t as HttpHeader, I as Ipv6AddressType, u as Ipv6ParseResult, L as LINK_REL_VALUES, v as LinkHeaderEntry, w as LinkHeaderEntryInput, x as LinkHeaderResult, y as LinkRel, M as ManifestIconInfo, z as ManifestIssue, F as ManifestValidationResult, P as PERMISSIONS_POLICY_FEATURES, J as ParsedClientHint, K as ParsedDnsResult, N as ParsedGeoResult, O as PermissionsPolicyDirective, Q as PermissionsPolicyFeatureInput, R as PermissionsPolicyResult, S as REFERRER_POLICY_VALUES, T as RangeEntry, U as RangeEntryInput, V as RangeHeaderResult, W as ReceivedHop, X as ReferrerPolicyEntry, Y as ReferrerPolicyResult, Z as ReferrerPolicyValue, _ as RobotsGroup, $ as RobotsIssue, a0 as RobotsRule, a1 as RobotsValidationResult, a2 as STATUS_CODES, a3 as SameSiteValue, a4 as SitemapIndexEntry, a5 as SitemapIssue, a6 as SitemapUrlEntry, a7 as SitemapValidationResult, a8 as StatusCode, a9 as UaDeviceType, aa as UserAgentInfo, ab as VaryHeaderEntry, ac as VaryHeaderResult, ad as analyzeEmailHeaders, ae as buildCacheControl, af as buildClientHints, ag as buildDnsQueryUrl, ah as buildGeoUrl, ai as buildLinkHeader, aj as buildMapUrl, ak as buildPermissionsPolicy, al as buildRangeHeader, am as buildReferrerPolicy, an as buildVaryHeader, ao as checkSetCookieHeader, ap as countryCodeToFlag, aq as formatCoordinates, ar as formatTtl, as as getByCategory, at as getHeader, au as getHeadersByCategory, av as getStatusByCategory, aw as getStatusCode, ax as isClientError, ay as isServerError, az as isSuccess, aA as isValidIp, aB as isValidIpv4, aC as isValidIpv6, aD as parseClientHintHeaders, aE as parseContentRangeHeader, aF as parseDnsResponse, aG as parseGeoResponse, aH as parseHar, aI as parseIpv6Address, aJ as parsePermissionsPolicy, aK as parseUserAgent, aL as parseVaryHeader, aM as searchHeaders, aN as searchStatusCodes, aO as statusCodeToText, aP as typeNumberToLabel, aQ as validateDomain, aR as validateHeaderName, aS as validateHeaderValue, aT as validateManifest, aU as validateRobotsTxt, aV as validateSitemap } from '../network-Bzm1tjMA.js';
+export { A as AuthResultEntry, B as BuildRangeHeaderOptions, C as CLIENT_HINTS, a as CacheControlDirective, b as CacheControlOptions, c as CacheControlResult, d as ClientHintDef, e as ClientHintValueType, f as ClientHintsBuildResult, g as ClientHintsParseResult, h as ContentDispositionBuildOptions, i as ContentDispositionBuildResult, j as ContentDispositionParseResult, k as ContentRangeResult, l as CookieAttributes, m as CookieCheckResult, D as DNS_RECORD_TYPES, o as DnsRecord, p as DnsRecordType, q as DnsResponse, E as EmailHeaderAnalysis, r as EmailHeaderField, G as GeoResult, H as HTTP_HEADERS, s as HarEntry, t as HarParseResult, u as HarSummary, v as HeaderCategory, w as HttpHeader, I as Ipv6AddressType, x as Ipv6ParseResult, L as LINK_REL_VALUES, y as LinkHeaderEntry, z as LinkHeaderEntryInput, F as LinkHeaderResult, J as LinkRel, M as ManifestIconInfo, K as ManifestIssue, N as ManifestValidationResult, P as PERMISSIONS_POLICY_FEATURES, O as ParsedClientHint, Q as ParsedDnsResult, R as ParsedGeoResult, S as PermissionsPolicyDirective, T as PermissionsPolicyFeatureInput, U as PermissionsPolicyResult, V as REFERRER_POLICY_VALUES, W as RangeEntry, X as RangeEntryInput, Y as RangeHeaderResult, Z as ReceivedHop, _ as ReferrerPolicyEntry, $ as ReferrerPolicyResult, a0 as ReferrerPolicyValue, a1 as RobotsGroup, a2 as RobotsIssue, a3 as RobotsRule, a4 as RobotsValidationResult, a5 as STATUS_CODES, a6 as SameSiteValue, a7 as SitemapIndexEntry, a8 as SitemapIssue, a9 as SitemapSplitFile, aa as SitemapUrlEntry, ab as SitemapValidationResult, ac as SplitSitemapOptions, ad as SplitSitemapResult, ae as StatusCode, af as UaDeviceType, ag as UserAgentInfo, ah as VaryHeaderEntry, ai as VaryHeaderResult, aj as analyzeEmailHeaders, ak as buildCacheControl, al as buildClientHints, am as buildContentDisposition, an as buildDnsQueryUrl, ao as buildGeoUrl, ap as buildLinkHeader, aq as buildMapUrl, ar as buildPermissionsPolicy, as as buildRangeHeader, at as buildReferrerPolicy, au as buildVaryHeader, av as checkSetCookieHeader, aw as countryCodeToFlag, ax as formatCoordinates, ay as formatTtl, az as getByCategory, aA as getHeader, aB as getHeadersByCategory, aC as getStatusByCategory, aD as getStatusCode, aE as isClientError, aF as isServerError, aG as isSuccess, aH as isValidIp, aI as isValidIpv4, aJ as isValidIpv6, aK as parseClientHintHeaders, aL as parseContentDisposition, aM as parseContentRangeHeader, aN as parseDnsResponse, aO as parseGeoResponse, aP as parseHar, aQ as parseIpv6Address, aR as parsePermissionsPolicy, aS as parseUserAgent, aT as parseVaryHeader, aU as searchHeaders, aV as searchStatusCodes, aW as splitSitemap, aX as statusCodeToText, aY as typeNumberToLabel, aZ as validateDomain, a_ as validateHeaderName, a$ as validateHeaderValue, b0 as validateManifest, b1 as validateRobotsTxt, b2 as validateSitemap } from '../network-DelcJeJa.js';

package/dist/tools/network.js

@@ -1,2 +1,2 @@
-export { CLIENT_HINTS, DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, PERMISSIONS_POLICY_FEATURES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildClientHints, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildRangeHeader, buildReferrerPolicy, buildVaryHeader, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseClientHintHeaders, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parsePermissionsPolicy, parseUserAgent, parseVaryHeader, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap } from '../chunk-7PEKYLRB.js';
+export { CLIENT_HINTS, DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, PERMISSIONS_POLICY_FEATURES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildRangeHeader, buildReferrerPolicy, buildVaryHeader, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parsePermissionsPolicy, parseUserAgent, parseVaryHeader, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap } from '../chunk-Y7YY733Z.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",