@utilix-tech/sdk 0.42.0 → 0.43.0

package/dist/tools/ai_agent.js

@@ -1,2 +1,2 @@
-export { MODEL_PRICING, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, formatFewShotExamples, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity } from '../chunk-W3J7GZVQ.js';
+export { MODEL_PRICING, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity } from '../chunk-EKIXOA7B.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/network.cjs

@@ -2316,6 +2316,112 @@ function parseVaryHeader(raw) {
   const headers = withoutLabel.split(",").map((h) => h.trim()).filter((h) => h.length > 0);
   return buildVaryHeader(headers);
 }
+var VALID_MANIFEST_DISPLAY = /* @__PURE__ */ new Set(["fullscreen", "standalone", "minimal-ui", "browser"]);
+function validateManifest(jsonText) {
+  if (!jsonText || !jsonText.trim()) return { error: "Input is empty" };
+  let manifest;
+  try {
+    manifest = JSON.parse(jsonText);
+  } catch (e) {
+    return { error: `Invalid JSON: ${e.message}` };
+  }
+  if (typeof manifest !== "object" || manifest === null || Array.isArray(manifest)) {
+    return { error: "Manifest must be a JSON object" };
+  }
+  const m = manifest;
+  const issues = [];
+  if (!m.name && !m.short_name) {
+    issues.push({ severity: "error", path: "name", message: 'Manifest must have at least one of "name" or "short_name"' });
+  }
+  if (m.name !== void 0 && typeof m.name !== "string") {
+    issues.push({ severity: "error", path: "name", message: '"name" must be a string' });
+  } else if (typeof m.name === "string" && m.name.length > 45) {
+    issues.push({ severity: "warning", path: "name", message: `"name" is ${m.name.length} characters; keep it under ~45 to avoid truncation in install prompts` });
+  }
+  if (m.short_name !== void 0 && typeof m.short_name !== "string") {
+    issues.push({ severity: "error", path: "short_name", message: '"short_name" must be a string' });
+  } else if (typeof m.short_name === "string" && m.short_name.length > 12) {
+    issues.push({ severity: "warning", path: "short_name", message: `"short_name" is ${m.short_name.length} characters; keep it under ~12 to avoid truncation on home screens` });
+  }
+  if (!m.start_url) {
+    issues.push({ severity: "error", path: "start_url", message: 'Manifest is missing "start_url"' });
+  } else if (typeof m.start_url !== "string") {
+    issues.push({ severity: "error", path: "start_url", message: '"start_url" must be a string' });
+  } else if (m.start_url.startsWith("//")) {
+    issues.push({ severity: "warning", path: "start_url", message: '"start_url" looks protocol-relative; use a relative path (e.g. "/") or a full absolute URL instead' });
+  }
+  if (m.display !== void 0) {
+    if (typeof m.display !== "string" || !VALID_MANIFEST_DISPLAY.has(m.display)) {
+      issues.push({ severity: "error", path: "display", message: `"display" must be one of: ${[...VALID_MANIFEST_DISPLAY].join(", ")}` });
+    }
+  } else {
+    issues.push({ severity: "warning", path: "display", message: 'Missing "display"; it defaults to "browser", which will not open the installed app in its own standalone window' });
+  }
+  const icons = [];
+  let hasMaskableIcon = false;
+  let has512Icon = false;
+  if (!Array.isArray(m.icons) || m.icons.length === 0) {
+    issues.push({ severity: "error", path: "icons", message: 'Manifest must have a non-empty "icons" array' });
+  } else {
+    m.icons.forEach((icon, i) => {
+      const path = `icons[${i}]`;
+      if (!icon || typeof icon !== "object") {
+        issues.push({ severity: "error", path, message: "Icon entry must be an object" });
+        return;
+      }
+      const iconObj = icon;
+      if (!iconObj.src || typeof iconObj.src !== "string") {
+        issues.push({ severity: "error", path, message: 'Icon entry is missing a required "src"' });
+      }
+      if (iconObj.sizes !== void 0) {
+        if (typeof iconObj.sizes !== "string" || iconObj.sizes !== "any" && !/^\d+x\d+(\s+\d+x\d+)*$/i.test(iconObj.sizes)) {
+          issues.push({ severity: "warning", path, message: `"sizes" value "${String(iconObj.sizes)}" doesn't match the expected "WIDTHxHEIGHT" format` });
+        } else if (/(^|\s)512x512(\s|$)/i.test(iconObj.sizes)) {
+          has512Icon = true;
+        }
+      }
+      if (typeof iconObj.purpose === "string" && iconObj.purpose.toLowerCase().includes("maskable")) {
+        hasMaskableIcon = true;
+      }
+      icons.push({
+        src: typeof iconObj.src === "string" ? iconObj.src : "",
+        sizes: typeof iconObj.sizes === "string" ? iconObj.sizes : void 0,
+        type: typeof iconObj.type === "string" ? iconObj.type : void 0,
+        purpose: typeof iconObj.purpose === "string" ? iconObj.purpose : void 0
+      });
+    });
+    if (icons.length > 0) {
+      if (!has512Icon) {
+        issues.push({ severity: "warning", path: "icons", message: "No icon sized 512x512 found; this size is used for splash screens and app store listings" });
+      }
+      if (!hasMaskableIcon) {
+        issues.push({ severity: "warning", path: "icons", message: 'No icon with purpose "maskable" (or "any maskable") found; without one, Android may crop your icon into its adaptive icon mask' });
+      }
+    }
+  }
+  if (m.theme_color !== void 0 && typeof m.theme_color !== "string") {
+    issues.push({ severity: "error", path: "theme_color", message: '"theme_color" must be a CSS color string' });
+  }
+  if (m.background_color !== void 0 && typeof m.background_color !== "string") {
+    issues.push({ severity: "error", path: "background_color", message: '"background_color" must be a CSS color string' });
+  } else if (m.background_color === void 0) {
+    issues.push({ severity: "warning", path: "background_color", message: 'Missing "background_color"; without it the splash screen background defaults to white' });
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return {
+    issues,
+    valid,
+    summary: {
+      name: typeof m.name === "string" ? m.name : void 0,
+      shortName: typeof m.short_name === "string" ? m.short_name : void 0,
+      startUrl: typeof m.start_url === "string" ? m.start_url : void 0,
+      display: typeof m.display === "string" ? m.display : void 0,
+      icons,
+      hasMaskableIcon,
+      has512Icon
+    }
+  };
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
@@ -2360,5 +2466,6 @@ exports.typeNumberToLabel = typeNumberToLabel;
 exports.validateDomain = validateDomain;
 exports.validateHeaderName = validateHeaderName;
 exports.validateHeaderValue = validateHeaderValue;
+exports.validateManifest = validateManifest;
 exports.validateRobotsTxt = validateRobotsTxt;
 exports.validateSitemap = validateSitemap;

package/dist/tools/network.d.cts

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

package/dist/tools/network.d.ts

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

package/dist/tools/network.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.42.0",
+  "version": "0.43.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",