@utilix-tech/sdk 0.28.0 → 0.30.0

package/dist/tools/json.cjs

@@ -1293,6 +1293,105 @@ function resolveJsonPointer(json, pointer) {
   }
   return { pointer, found: true, value: current, tokens };
 }
+function _schemaRefName(ref) {
+  const parts = ref.split("/");
+  return _capitalize(parts[parts.length - 1] || "Ref");
+}
+function _schemaLiteralType(value) {
+  if (typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (value === null) return "null";
+  return JSON.stringify(value);
+}
+function _safePropertyKey(key) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+}
+function _schemaToTsType(schema, name, interfaces) {
+  if (schema.$ref) return _schemaRefName(schema.$ref);
+  if (schema.const !== void 0) return _schemaLiteralType(schema.const);
+  if (schema.enum) return schema.enum.map(_schemaLiteralType).join(" | ");
+  if (schema.oneOf) return schema.oneOf.map((s, i) => _schemaToTsType(s, `${name}Variant${i}`, interfaces)).join(" | ");
+  if (schema.anyOf) return schema.anyOf.map((s, i) => _schemaToTsType(s, `${name}Variant${i}`, interfaces)).join(" | ");
+  if (schema.allOf) return schema.allOf.map((s, i) => _schemaToTsType(s, `${name}Part${i}`, interfaces)).join(" & ");
+  const types = Array.isArray(schema.type) ? schema.type : schema.type ? [schema.type] : [];
+  const nullable = types.includes("null");
+  const nonNullTypes = types.filter((t) => t !== "null");
+  const primaryType = nonNullTypes[0] ?? (schema.properties || schema.additionalProperties !== void 0 ? "object" : void 0);
+  let result;
+  switch (primaryType) {
+    case "string":
+      result = "string";
+      break;
+    case "number":
+    case "integer":
+      result = "number";
+      break;
+    case "boolean":
+      result = "boolean";
+      break;
+    case "array": {
+      const itemsSchema = Array.isArray(schema.items) ? schema.items[0] : schema.items;
+      const itemType = itemsSchema ? _schemaToTsType(itemsSchema, `${name}Item`, interfaces) : "unknown";
+      result = `${itemType}[]`;
+      break;
+    }
+    case "object": {
+      _buildSchemaInterface(schema, name, interfaces);
+      result = name;
+      break;
+    }
+    default:
+      result = "unknown";
+  }
+  return nullable ? `${result} | null` : result;
+}
+function _buildSchemaInterface(schema, name, interfaces) {
+  if (interfaces.has(name)) return;
+  const required = new Set(schema.required ?? []);
+  const lines = [`interface ${name} {`];
+  for (const [key, propSchema] of Object.entries(schema.properties ?? {})) {
+    if (propSchema.description) lines.push(`  /** ${propSchema.description} */`);
+    const optional = required.has(key) ? "" : "?";
+    const propType = _schemaToTsType(propSchema, _capitalize(key), interfaces);
+    lines.push(`  ${_safePropertyKey(key)}${optional}: ${propType};`);
+  }
+  if (schema.additionalProperties === true) {
+    lines.push("  [key: string]: unknown;");
+  } else if (schema.additionalProperties && typeof schema.additionalProperties === "object") {
+    const addType = _schemaToTsType(schema.additionalProperties, `${name}Value`, interfaces);
+    lines.push(`  [key: string]: ${addType};`);
+  }
+  lines.push("}");
+  interfaces.set(name, lines.join("\n"));
+}
+function jsonSchemaToTypescript(schemaJson, options) {
+  let schema;
+  try {
+    schema = JSON.parse(schemaJson);
+  } catch {
+    return { error: "Invalid JSON input" };
+  }
+  if (typeof schema !== "object" || schema === null || Array.isArray(schema)) {
+    return { error: "Schema must be a JSON object" };
+  }
+  const rootName = options?.rootName ?? "Root";
+  const typedSchema = schema;
+  const interfaces = /* @__PURE__ */ new Map();
+  const defs = { ...typedSchema.$defs ?? {}, ...typedSchema.definitions ?? {} };
+  for (const [defName, defSchema] of Object.entries(defs)) {
+    const defTypeName = _capitalize(defName);
+    const defType = _schemaToTsType(defSchema, defTypeName, interfaces);
+    if (!interfaces.has(defTypeName)) {
+      interfaces.set(defTypeName, `type ${defTypeName} = ${defType};`);
+    }
+  }
+  const rootType = _schemaToTsType(typedSchema, rootName, interfaces);
+  const parts = [...interfaces.values()];
+  if (!interfaces.has(rootName)) {
+    parts.push(`type ${rootName} = ${rootType};`);
+  }
+  return parts.join("\n\n");
+}
 
 exports.csvToJson = csvToJson;
 exports.detectFormat = detectFormat;
@@ -1305,6 +1404,7 @@ exports.getJsonStats = getJsonStats;
 exports.inferGoType = inferGoType;
 exports.inferPythonType = inferPythonType;
 exports.inferType = inferType;
+exports.jsonSchemaToTypescript = jsonSchemaToTypescript;
 exports.jsonToCsv = jsonToCsv;
 exports.jsonToGo = jsonToGo;
 exports.jsonToPython = jsonToPython;

package/dist/tools/json.d.cts

@@ -1 +1 @@
-export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, P as ParseStatus, g as PythonClass, h as PythonField, i as PythonMode, V as ValidationError, k as ValidationResult, Z as ZodOptions, l as csvToJson, m as detectFormat, n as diffJson, o as evaluateJsonPath, p as formatDiffLine, q as formatJson, r as generateExample, s as getJsonStats, t as inferGoType, u as inferPythonType, v as inferType, w as jsonToCsv, x as jsonToGo, y as jsonToPython, z as jsonToTypescript, A as jsonToYaml, B as jsonToZod, E as minifyJson, F as parseJson, H as parseStructs, I as resolveJsonPointer, K as toPascalCase, L as toSnakeCase, M as validateJson, N as validateJsonPath, O as validateJsonString, Q as yamlToJson } from '../json-DEVFIpsC.cjs';
+export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, g as JsonSchemaLike, h as JsonSchemaToTsOptions, P as ParseStatus, i as PythonClass, k as PythonField, l as PythonMode, V as ValidationError, m as ValidationResult, Z as ZodOptions, n as csvToJson, o as detectFormat, p as diffJson, q as evaluateJsonPath, r as formatDiffLine, s as formatJson, t as generateExample, u as getJsonStats, v as inferGoType, w as inferPythonType, x as inferType, y as jsonSchemaToTypescript, z as jsonToCsv, A as jsonToGo, B as jsonToPython, E as jsonToTypescript, F as jsonToYaml, H as jsonToZod, I as minifyJson, K as parseJson, L as parseStructs, M as resolveJsonPointer, N as toPascalCase, O as toSnakeCase, Q as validateJson, R as validateJsonPath, S as validateJsonString, T as yamlToJson } from '../json-Ta9JykSB.cjs';

package/dist/tools/json.d.ts

@@ -1 +1 @@
-export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, P as ParseStatus, g as PythonClass, h as PythonField, i as PythonMode, V as ValidationError, k as ValidationResult, Z as ZodOptions, l as csvToJson, m as detectFormat, n as diffJson, o as evaluateJsonPath, p as formatDiffLine, q as formatJson, r as generateExample, s as getJsonStats, t as inferGoType, u as inferPythonType, v as inferType, w as jsonToCsv, x as jsonToGo, y as jsonToPython, z as jsonToTypescript, A as jsonToYaml, B as jsonToZod, E as minifyJson, F as parseJson, H as parseStructs, I as resolveJsonPointer, K as toPascalCase, L as toSnakeCase, M as validateJson, N as validateJsonPath, O as validateJsonString, Q as yamlToJson } from '../json-DEVFIpsC.js';
+export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, g as JsonSchemaLike, h as JsonSchemaToTsOptions, P as ParseStatus, i as PythonClass, k as PythonField, l as PythonMode, V as ValidationError, m as ValidationResult, Z as ZodOptions, n as csvToJson, o as detectFormat, p as diffJson, q as evaluateJsonPath, r as formatDiffLine, s as formatJson, t as generateExample, u as getJsonStats, v as inferGoType, w as inferPythonType, x as inferType, y as jsonSchemaToTypescript, z as jsonToCsv, A as jsonToGo, B as jsonToPython, E as jsonToTypescript, F as jsonToYaml, H as jsonToZod, I as minifyJson, K as parseJson, L as parseStructs, M as resolveJsonPointer, N as toPascalCase, O as toSnakeCase, Q as validateJson, R as validateJsonPath, S as validateJsonString, T as yamlToJson } from '../json-Ta9JykSB.js';

package/dist/tools/json.js

@@ -1,2 +1,2 @@
-export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson } from '../chunk-WO3LJMVV.js';
+export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonSchemaToTypescript, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson } from '../chunk-WVEKRKGU.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/media.cjs

@@ -457,6 +457,116 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var PDF_COMMON_PAPER_SIZES = [
+  { name: "Letter", widthPt: 612, heightPt: 792 },
+  { name: "Legal", widthPt: 612, heightPt: 1008 },
+  { name: "Tabloid", widthPt: 792, heightPt: 1224 },
+  { name: "A3", widthPt: 842, heightPt: 1191 },
+  { name: "A4", widthPt: 595, heightPt: 842 },
+  { name: "A5", widthPt: 420, heightPt: 595 },
+  { name: "B5", widthPt: 499, heightPt: 709 }
+];
+function matchPaperSize(widthPt, heightPt) {
+  for (const size of PDF_COMMON_PAPER_SIZES) {
+    const w = Math.abs(widthPt - size.widthPt) <= 1;
+    const h = Math.abs(heightPt - size.heightPt) <= 1;
+    const wSwapped = Math.abs(widthPt - size.heightPt) <= 1;
+    const hSwapped = Math.abs(heightPt - size.widthPt) <= 1;
+    if (w && h || wSwapped && hSwapped) return size.name;
+  }
+  return null;
+}
+function parsePdfMediaBox(dict) {
+  const m = dict.match(/\/MediaBox\s*\[\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s*\]/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+function parsePdfRotate(dict) {
+  const m = dict.match(/\/Rotate\s+(-?\d+)/);
+  return m ? Number(m[1]) : null;
+}
+function buildPdfPageDimension(pageNumber, mediaBox, rotate) {
+  const rotation = (rotate % 360 + 360) % 360;
+  if (!mediaBox) {
+    return { pageNumber, widthPt: null, heightPt: null, widthIn: null, heightIn: null, rotation, orientation: null, paperSize: null };
+  }
+  const [llx, lly, urx, ury] = mediaBox;
+  let widthPt = Math.abs(urx - llx);
+  let heightPt = Math.abs(ury - lly);
+  if (rotation === 90 || rotation === 270) [widthPt, heightPt] = [heightPt, widthPt];
+  const orientation = widthPt === heightPt ? "square" : widthPt > heightPt ? "landscape" : "portrait";
+  return {
+    pageNumber,
+    widthPt: round2(widthPt),
+    heightPt: round2(heightPt),
+    widthIn: round2(widthPt / 72),
+    heightIn: round2(heightPt / 72),
+    rotation,
+    orientation,
+    paperSize: matchPaperSize(widthPt, heightPt)
+  };
+}
+function walkPdfPageTree(objMap, nodeBody, inherited, visited, nodeKey, out) {
+  if (visited.has(nodeKey)) return;
+  visited.add(nodeKey);
+  const mediaBox = parsePdfMediaBox(nodeBody) ?? inherited.mediaBox;
+  const rotateMatch = parsePdfRotate(nodeBody);
+  const rotate = rotateMatch !== null ? rotateMatch : inherited.rotate;
+  if (/\/Type\s*\/Page(?!s)\b/.test(nodeBody)) {
+    out.push(buildPdfPageDimension(out.length + 1, mediaBox, rotate));
+    return;
+  }
+  const kidsMatch = nodeBody.match(/\/Kids\s*\[([^\]]*)\]/);
+  if (!kidsMatch) return;
+  const kidRefs = [...kidsMatch[1].matchAll(/(\d+)\s+(\d+)\s+R/g)];
+  for (const ref of kidRefs) {
+    const key = `${ref[1]} ${ref[2]}`;
+    const body = objMap.get(key);
+    if (body) walkPdfPageTree(objMap, body, { mediaBox, rotate }, visited, key, out);
+  }
+}
+function readPdfPageDimensions(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  const objMap = /* @__PURE__ */ new Map();
+  for (const b of objBlocks) objMap.set(`${b[1]} ${b[2]}`, b[3]);
+  const out = [];
+  const visited = /* @__PURE__ */ new Set();
+  let pagesRootBody = null;
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    const rootRef = trailer.match(/\/Root\s+(\d+)\s+(\d+)\s+R/);
+    if (rootRef) {
+      const catalogBody = objMap.get(`${rootRef[1]} ${rootRef[2]}`);
+      const pagesRef = catalogBody?.match(/\/Pages\s+(\d+)\s+(\d+)\s+R/);
+      if (pagesRef) pagesRootBody = objMap.get(`${pagesRef[1]} ${pagesRef[2]}`) ?? null;
+    }
+  }
+  if (!pagesRootBody) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Pages\b/.test(b[3]) && !/\/Parent\s+\d+\s+\d+\s+R/.test(b[3])) {
+        pagesRootBody = b[3];
+        break;
+      }
+    }
+  }
+  if (pagesRootBody) walkPdfPageTree(objMap, pagesRootBody, { mediaBox: null, rotate: 0 }, visited, "root", out);
+  if (out.length === 0) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Page(?!s)\b/.test(b[3])) {
+        out.push(buildPdfPageDimension(out.length + 1, parsePdfMediaBox(b[3]), parsePdfRotate(b[3]) ?? 0));
+      }
+    }
+  }
+  if (out.length === 0) return { error: "Could not locate any page objects in this PDF" };
+  return { version, pageCount: out.length, pages: out };
+}
 var AUDIO_FORMAT_LABELS = {
   1: "PCM",
   3: "IEEE float",
@@ -1105,5 +1215,6 @@ exports.readIcoInfo = readIcoInfo;
 exports.readId3Tags = readId3Tags;
 exports.readImageInfo = readImageInfo;
 exports.readPdfMetadata = readPdfMetadata;
+exports.readPdfPageDimensions = readPdfPageDimensions;
 exports.readVideoInfo = readVideoInfo;
 exports.readWavInfo = readWavInfo;

package/dist/tools/media.d.cts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, V as VideoInfo, k as VideoInfoError, W as WavInfo, l as WavInfoError, r as readExifData, n as readFlacInfo, o as readIcoInfo, p as readId3Tags, q as readImageInfo, s as readPdfMetadata, t as readVideoInfo, u as readWavInfo } from '../media-cuxfzXxw.cjs';
+export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, k as PdfPageDimension, l as PdfPageDimensionsResult, n as PdfPageOrientation, V as VideoInfo, o as VideoInfoError, W as WavInfo, p as WavInfoError, r as readExifData, q as readFlacInfo, s as readIcoInfo, t as readId3Tags, u as readImageInfo, v as readPdfMetadata, w as readPdfPageDimensions, x as readVideoInfo, y as readWavInfo } from '../media-fD8dJ5qR.cjs';

package/dist/tools/media.d.ts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, V as VideoInfo, k as VideoInfoError, W as WavInfo, l as WavInfoError, r as readExifData, n as readFlacInfo, o as readIcoInfo, p as readId3Tags, q as readImageInfo, s as readPdfMetadata, t as readVideoInfo, u as readWavInfo } from '../media-cuxfzXxw.js';
+export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, k as PdfPageDimension, l as PdfPageDimensionsResult, n as PdfPageOrientation, V as VideoInfo, o as VideoInfoError, W as WavInfo, p as WavInfoError, r as readExifData, q as readFlacInfo, s as readIcoInfo, t as readId3Tags, u as readImageInfo, v as readPdfMetadata, w as readPdfPageDimensions, x as readVideoInfo, y as readWavInfo } from '../media-fD8dJ5qR.js';

package/dist/tools/media.js

@@ -1,2 +1,2 @@
-export { readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readVideoInfo, readWavInfo } from '../chunk-47DTCCQJ.js';
+export { readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readPdfPageDimensions, readVideoInfo, readWavInfo } from '../chunk-L6V4W4SU.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/network.cjs

@@ -1777,6 +1777,94 @@ function buildCacheControl(options = {}) {
   const snippet = `Cache-Control: ${header}`;
   return { header, headerName: "Cache-Control", snippet, directives, warnings };
 }
+function isValidIpv6HexGroup(g) {
+  return /^[0-9a-fA-F]{1,4}$/.test(g);
+}
+function isValidIpv6Ipv4Quad(quad) {
+  const parts = quad.split(".");
+  if (parts.length !== 4) return false;
+  return parts.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255);
+}
+function classifyIpv6(groups) {
+  const first = parseInt(groups[0], 16);
+  if (groups.every((g) => g === "0000")) return "unspecified";
+  if (groups.slice(0, 7).every((g) => g === "0000") && groups[7] === "0001") return "loopback";
+  if (groups.slice(0, 4).every((g) => g === "0000") && groups[4] === "0000" && groups[5] === "ffff") return "ipv4-mapped";
+  if (groups[0] === "2001" && groups[1] === "0db8") return "documentation";
+  if ((first & 65280) === 65280) return "multicast";
+  if ((first & 65472) === 65152) return "link-local";
+  if ((first & 65024) === 64512) return "unique-local";
+  return "global-unicast";
+}
+function compressIpv6Groups(groups) {
+  const short = groups.map((g) => g.replace(/^0+(?=.)/, ""));
+  let bestStart = -1;
+  let bestLen = 0;
+  let curStart = -1;
+  let curLen = 0;
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] === "0") {
+      if (curStart === -1) curStart = i;
+      curLen++;
+      if (curLen > bestLen) {
+        bestLen = curLen;
+        bestStart = curStart;
+      }
+    } else {
+      curStart = -1;
+      curLen = 0;
+    }
+  }
+  if (bestLen < 2) return short.join(":");
+  const before = short.slice(0, bestStart).join(":");
+  const after = short.slice(bestStart + bestLen).join(":");
+  return `${before}::${after}`;
+}
+function parseIpv6Address(input) {
+  let s = input.trim();
+  if (s.startsWith("[") && s.includes("]")) s = s.slice(1, s.indexOf("]"));
+  let zoneId = null;
+  const pctIdx = s.indexOf("%");
+  if (pctIdx !== -1) {
+    zoneId = s.slice(pctIdx + 1);
+    s = s.slice(0, pctIdx);
+  }
+  if (!s) return { error: "Empty address" };
+  const doubleColonCount = (s.match(/::/g) ?? []).length;
+  if (doubleColonCount > 1) return { error: 'Address contains more than one "::"' };
+  const ipv4Match = s.match(/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (ipv4Match) {
+    const quad = ipv4Match[1];
+    if (!isValidIpv6Ipv4Quad(quad)) return { error: `Invalid embedded IPv4 address: ${quad}` };
+    const parts = quad.split(".").map(Number);
+    const hi = (parts[0] << 8 | parts[1]).toString(16);
+    const lo = (parts[2] << 8 | parts[3]).toString(16);
+    s = s.slice(0, s.length - quad.length) + `${hi}:${lo}`;
+  }
+  let groups;
+  if (s.includes("::")) {
+    const [left, right] = s.split("::");
+    const leftGroups = left ? left.split(":") : [];
+    const rightGroups = right ? right.split(":") : [];
+    const missing = 8 - (leftGroups.length + rightGroups.length);
+    if (missing < 1) return { error: 'The "::" shorthand must represent at least one group of zeros' };
+    if (![...leftGroups, ...rightGroups].every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+    groups = [...leftGroups, ...Array(missing).fill("0"), ...rightGroups];
+  } else {
+    groups = s.split(":");
+    if (groups.length !== 8) return { error: `Expected 8 groups, got ${groups.length}` };
+    if (!groups.every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+  }
+  const expandedGroups = groups.map((g) => g.padStart(4, "0").toLowerCase());
+  const suffix = zoneId ? `%${zoneId}` : "";
+  return {
+    expanded: expandedGroups.join(":") + suffix,
+    compressed: compressIpv6Groups(expandedGroups) + suffix,
+    groups: expandedGroups,
+    zoneId,
+    addressType: classifyIpv6(expandedGroups)
+  };
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
@@ -1802,6 +1890,7 @@ exports.isValidIpv6 = isValidIpv6;
 exports.parseDnsResponse = parseDnsResponse;
 exports.parseGeoResponse = parseGeoResponse;
 exports.parseHar = parseHar;
+exports.parseIpv6Address = parseIpv6Address;
 exports.parseUserAgent = parseUserAgent;
 exports.searchHeaders = searchHeaders;
 exports.searchStatusCodes = searchStatusCodes;

package/dist/tools/network.d.cts

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

package/dist/tools/network.d.ts

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

package/dist/tools/network.js

@@ -1,2 +1,2 @@
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-Y5OOP6WN.js';
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-CSNTHZHF.js';
 import '../chunk-MLKGABMK.js';

package/package.json

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