@utilix-tech/sdk 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+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.3.1
+- Metadata fixes: corrected repository/bug tracker links, updated tool count in the package description.
+
+## 0.3.0
+- Added the `media` module.
+
+## 0.2.0
+- 400+ functions across 14 modules, including the `ai_agent` module for LLM/RAG pipelines.
+
+## 0.1.0
+- Initial release.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**100+ developer utility functions for Node.js — runs locally, no API key required.**
+**140+ 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)
@@ -62,7 +62,7 @@ const { formatJson } = require("@utilix-tech/sdk/json");
 
 ## Modules
 
-### `/json` — JSON Tools
+### `/json`: JSON Tools
 
 ```ts
 import { formatJson, minifyJson, diffJson, jsonToTypescript, validateJson,
@@ -71,7 +71,7 @@ import { formatJson, minifyJson, diffJson, jsonToTypescript, validateJson,
 // Format with 2-space indent
 formatJson('{"name":"alice","age":30}', { indent: 2 });
 
-// Diff two JSON strings — returns line-by-line diff
+// Diff two JSON strings: returns line-by-line diff
 diffJson(jsonA, jsonB);
 
 // Generate TypeScript interface from JSON
@@ -89,7 +89,7 @@ validateJson(data, schema);
 
 ---
 
-### `/encoding` — Encode & Decode
+### `/encoding`: Encode & Decode
 
 ```ts
 import { encodeBase64, decodeBase64, encodeUrl, decodeUrl,
@@ -104,7 +104,7 @@ base32Encode("hello");            // "NBSWY3DPEB3W64TMMQ======"
 
 ---
 
-### `/hashing` — Hash & Password
+### `/hashing`: Hash & Password
 
 ```ts
 import { hashAll, hashOne, hashPassword, verifyPassword, generateHtpasswdFile } from "@utilix-tech/sdk/hashing";
@@ -123,7 +123,7 @@ generateHtpasswdFile([{ username: "alice", password: "secret" }]);
 
 ---
 
-### `/text` — String & Text
+### `/text`: String & Text
 
 ```ts
 import { convertCase, slugify, countWords, generateWords, generateParagraphs,
@@ -152,11 +152,12 @@ detectPassiveVoice("The report was reviewed by the committee. They approved it."
 
 ---
 
-### `/data` — CSV / YAML / TOML / XML / INI
+### `/data`: CSV / YAML / TOML / XML / INI / NDJSON
 
 ```ts
 import { parseCsv, csvToJson, validateYaml, tomlToJson, jsonToToml,
-         formatXml, xmlToJson, jsonToXml, parseIni } from "@utilix-tech/sdk/data";
+         formatXml, xmlToJson, jsonToXml, parseIni,
+         validateNdjson, formatNdjson, ndjsonToJsonArray } from "@utilix-tech/sdk/data";
 
 // CSV
 const rows = parseCsv("name,age\nalice,30\nbob,25");
@@ -175,11 +176,16 @@ xmlToJson("<root><item>hello</item></root>");
 
 // INI
 parseIni("[db]\nhost=localhost\nport=5432");
+
+// NDJSON (JSON Lines): one JSON value per line
+validateNdjson('{"id":1}\n{"id":2}');       // { valid: true, totalLines: 2, ... }
+formatNdjson('{"id":1}');                    // '{\n  "id": 1\n}'
+ndjsonToJsonArray('{"id":1}\n{"id":2}');     // '[\n  { "id": 1 },\n  { "id": 2 }\n]'
 ```
 
 ---
 
-### `/generators` — UUID, Passwords, Fake Data
+### `/generators`: UUID, Passwords, Fake Data
 
 ```ts
 import { generateUuid, generateV4, generateV7, generateUlid,
@@ -202,7 +208,7 @@ generateData([
 
 ---
 
-### `/time` — Dates, Timezones, Cron
+### `/time`: Dates, Timezones, Cron
 
 ```ts
 import { diffDates, parseCron, convertTime, formatRelative,
@@ -225,7 +231,7 @@ getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
 
 ---
 
-### `/units` — Conversions
+### `/units`: Conversions
 
 ```ts
 import { convertBytes, pxToAll, convert, formatValue } from "@utilix-tech/sdk/units";
@@ -250,11 +256,12 @@ formatValue(1234567.89, { locale: "en-US", currency: "USD" });
 
 ---
 
-### `/network` — URLs, IPs, HTTP
+### `/network`: URLs, IPs, HTTP, HAR
 
 ```ts
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
-         searchStatusCodes, buildGeoUrl, countryCodeToFlag } from "@utilix-tech/sdk/network";
+         searchStatusCodes, buildGeoUrl, countryCodeToFlag,
+         parseHar } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -266,11 +273,16 @@ isValidIpv6("::1");            // true
 isValidIp("256.0.0.1");       // false
 
 countryCodeToFlag("US");       // "🇺🇸"
+
+// Parse a DevTools .har network export into entries + summary stats
+const har = await fs.promises.readFile("network.har", "utf-8");
+parseHar(har);
+// { version: "1.2", entries: [...], summary: { totalRequests, totalSize, failedRequests, ... } }
 ```
 
 ---
 
-### `/api` — cURL, JWT, CORS, HTTP
+### `/api`: cURL, JWT, CORS, HTTP
 
 ```ts
 import { buildCurl, parseCurlCommand, decodeJwt, signJwt,
@@ -289,7 +301,7 @@ buildCurl({
 // Parse a curl command back into its parts
 parseCurlCommand('curl -X GET https://api.example.com -H "Authorization: Bearer token"');
 
-// JWT — decode without verification
+// JWT: decode without verification
 decodeJwt("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
 // { header: {...}, payload: {...}, isExpired: false, expiresIn: "2h" }
 
@@ -302,7 +314,7 @@ generateCspHeader({ "default-src": ["'self'"], "script-src": ["'self'", "cdn.exa
 
 ---
 
-### `/code` — SQL, HTML, RegEx, GQL
+### `/code`: SQL, HTML, RegEx, GQL
 
 ```ts
 import { formatSql, minifySql, testRegex, formatHtml, formatGql,
@@ -334,7 +346,7 @@ formatGql("query { user(id: 1) { name email } }");
 
 ---
 
-### `/color` — Color Conversion & Palettes
+### `/color`: Color Conversion & Palettes
 
 ```ts
 import { parseColor, convertColor, generatePalette, checkContrast } from "@utilix-tech/sdk/color";
@@ -354,7 +366,7 @@ checkContrast("#ffffff", "#000000");
 
 ---
 
-### `/css` — CSS Generators
+### `/css`: CSS Generators
 
 ```ts
 import { generateGradient, generateBoxShadow, generateBorderRadius,
@@ -376,7 +388,7 @@ generateBorderRadius({ tl: 8, tr: 8, br: 0, bl: 0 });
 
 ---
 
-### `/misc` — SVG, QR, Unicode
+### `/misc`: SVG, QR, Unicode
 
 ```ts
 import { optimizeSvg, sanitizeSvg, analyzeString, toUnicodeEscape,
@@ -400,13 +412,13 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media` — Image Header Parsing
+### `/media`: Image Header Parsing
 
 ```ts
 import { readImageInfo } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
-// file bytes — no decoding, no canvas, no image library.
+// file bytes: no decoding, no canvas, no image library.
 const bytes = await fs.promises.readFile("photo.png");
 readImageInfo(new Uint8Array(bytes));
 // { format: "png", width: 1920, height: 1080, bitDepth: 8, colorType: "rgba", hasAlpha: true }
@@ -424,24 +436,24 @@ Supports PNG, JPEG, GIF, WebP, and BMP.
 | `@utilix-tech/sdk/encoding` | Base64, URL, HTML entities, Base32 encode/decode |
 | `@utilix-tech/sdk/hashing` | MD5, SHA-1/256/512, bcrypt, HMAC, .htpasswd |
 | `@utilix-tech/sdk/text` | Case convert, slugify, word count, lorem ipsum, line ops, HTML→Markdown |
-| `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI parse and convert |
+| `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert |
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, fake data |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
 | `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format |
-| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs |
+| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, CORS headers, CSP header |
 | `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
 | `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect |
-| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes — PNG, JPEG, GIF, WebP, BMP |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes: PNG, JPEG, GIF, WebP, BMP |
 
 ---
 
 ## Python SDK
 
-`@utilix-tech/sdk` has a Python companion — [`utilix-sdk`](https://pypi.org/project/utilix-sdk/) on PyPI — with the same 100+ tools and identical return shapes.
+`@utilix-tech/sdk` has a Python companion, [`utilix-sdk`](https://pypi.org/project/utilix-sdk/) on PyPI, with the same 140+ tools and identical return shapes.
 
 ```bash
 pip install utilix-sdk
@@ -453,9 +465,9 @@ Both SDKs return plain JSON-serializable objects so you can share test fixtures
 
 ## REST API
 
-**This package is Surface A** — everything runs in-process in your Node.js runtime. No outbound requests, no API key, no rate limits.
+**This package is Surface A**: everything runs in-process in your Node.js runtime. No outbound requests, no API key, no rate limits.
 
-The same 100+ tools are also available as a hosted **REST API** at `https://api.utilix.tech/v1` for environments where you can't ship a Node.js runtime, or for cross-language teams.
+The same 140+ tools are also available as a hosted **REST API** at `https://api.utilix.tech/v1` for environments where you can't ship a Node.js runtime, or for cross-language teams.
 
 ```bash
 curl -X POST https://api.utilix.tech/v1/tools/hash \
@@ -464,17 +476,17 @@ curl -X POST https://api.utilix.tech/v1/tools/hash \
   -d '{"input": "hello world", "algorithm": "sha256"}'
 ```
 
-- **Free**: 1,000 requests/day — no credit card required
-- **Pro**: 10,000 requests/day — $9/month
-- Try it live at **[utilix.tech/api](https://utilix.tech/api)** — no signup needed for the first 10 endpoints
+- **Free**: 1,000 requests/day: no credit card required
+- **Pro**: 10,000 requests/day: $9/month
+- Try it live at **[utilix.tech/api](https://utilix.tech/api)**: no signup needed for the first 10 endpoints
 - Get your API key at **[utilix.tech/dashboard](https://utilix.tech/dashboard)**
 
 ---
 
 ## Publishing (maintainers)
 
-CI publishes automatically via npm Trusted Publishing (OIDC) on every push to `main` that bumps `version`. Requires npm **>=11.5.1** — older versions (e.g. the npm bundled with Node 20) sign provenance but skip the OIDC auth exchange, so `npm publish` fails with a 404 as if unauthenticated.
+CI publishes automatically via npm Trusted Publishing (OIDC) on every push to `main` that bumps `version`. Requires npm **>=11.5.1**: older versions (e.g. the npm bundled with Node 20) sign provenance but skip the OIDC auth exchange, so `npm publish` fails with a 404 as if unauthenticated.
 
 ## License
 
-MIT — see [LICENSE](./LICENSE) for details.
+MIT: see [LICENSE](./LICENSE) for details.

package/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in this package, please report it privately rather than opening a public issue.
+
+Email **hello@utilix.tech** with the subject line "Security report" and include:
+- A description of the vulnerability and its potential impact
+- Steps to reproduce, if possible
+- Any suggested fix
+
+We aim to acknowledge reports within 3 business days. Please give us a reasonable window to release a fix before disclosing publicly.
+
+## Supported Versions
+
+Only the latest published version of `@utilix-tech/sdk` receives security fixes. We recommend always running the latest release.

package/dist/{chunk-UC656APA.js → chunk-DNCOIO5N.js}

@@ -9,6 +9,7 @@ __export(data_exports, {
   detectDelimiter: () => detectDelimiter,
   envToExport: () => envToExport,
   envToJson: () => envToJson,
+  formatNdjson: () => formatNdjson,
   formatToml: () => formatToml,
   formatXml: () => formatXml,
   getSection: () => getSection,
@@ -17,11 +18,14 @@ __export(data_exports, {
   getXmlStats: () => getXmlStats,
   getYamlStats: () => getYamlStats,
   iniToJson: () => iniToJson,
+  jsonArrayToNdjson: () => jsonArrayToNdjson,
   jsonToIni: () => jsonToIni,
   jsonToToml: () => jsonToToml,
   jsonToXml: () => jsonToXml,
+  minifyNdjson: () => minifyNdjson,
   minifyToml: () => minifyToml,
   minifyXml: () => minifyXml,
+  ndjsonToJsonArray: () => ndjsonToJsonArray,
   parseCsv: () => parseCsv,
   parseEnv: () => parseEnv,
   parseIni: () => parseIni,
@@ -31,6 +35,7 @@ __export(data_exports, {
   tomlToJson: () => tomlToJson,
   validateEnvKey: () => validateEnvKey,
   validateIni: () => validateIni,
+  validateNdjson: () => validateNdjson,
   validateToml: () => validateToml,
   validateXml: () => validateXml,
   validateYaml: () => validateYaml,
@@ -1076,5 +1081,63 @@ function envToExport(input) {
 function validateEnvKey(key) {
   return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key);
 }
+function validateNdjson(input) {
+  const rawLines = input.split("\n");
+  const lines = [];
+  let validCount = 0;
+  rawLines.forEach((raw, idx) => {
+    if (raw.trim() === "") return;
+    const lineNum = idx + 1;
+    try {
+      JSON.parse(raw);
+      lines.push({ line: lineNum, raw, valid: true });
+      validCount++;
+    } catch (e) {
+      lines.push({
+        line: lineNum,
+        raw,
+        valid: false,
+        error: e instanceof Error ? e.message : String(e)
+      });
+    }
+  });
+  return {
+    valid: lines.length > 0 && validCount === lines.length,
+    totalLines: lines.length,
+    validLines: validCount,
+    invalidLines: lines.length - validCount,
+    lines
+  };
+}
+function _firstNdjsonError(result) {
+  const firstError = result.lines.find((l) => !l.valid);
+  return firstError ? `Line ${firstError.line}: ${firstError.error}` : "Invalid NDJSON";
+}
+function minifyNdjson(input) {
+  const result = validateNdjson(input);
+  if (!result.valid) return { error: _firstNdjsonError(result) };
+  return result.lines.map((l) => JSON.stringify(JSON.parse(l.raw))).join("\n");
+}
+function formatNdjson(input, indent = 2) {
+  const result = validateNdjson(input);
+  if (!result.valid) return { error: _firstNdjsonError(result) };
+  return result.lines.map((l) => JSON.stringify(JSON.parse(l.raw), null, indent)).join("\n");
+}
+function ndjsonToJsonArray(input) {
+  const result = validateNdjson(input);
+  if (!result.valid) return { error: _firstNdjsonError(result) };
+  const values = result.lines.map((l) => JSON.parse(l.raw));
+  return JSON.stringify(values, null, 2);
+}
+function jsonArrayToNdjson(input) {
+  let parsed;
+  try {
+    parsed = JSON.parse(input);
+  } catch (e) {
+    return { error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  if (!Array.isArray(parsed)) return { error: "Input must be a JSON array" };
+  return parsed.map((item) => JSON.stringify(item)).join("\n");
+}
 
-export { csvToJson, data_exports, detectDelimiter, envToExport, envToJson, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonToIni, jsonToToml, jsonToXml, minifyToml, minifyXml, parseCsv, parseEnv, parseIni, parseXmlToObject, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateToml, validateXml, validateYaml, xmlToJson };
+export { csvToJson, data_exports, detectDelimiter, envToExport, envToJson, formatNdjson, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseIni, parseXmlToObject, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };

package/dist/{chunk-OKSWDVOM.js → chunk-GX7H6TAX.js}

@@ -570,7 +570,7 @@ function getConversionWarnings(from, to) {
     warnings.push("Transparency will be lost if the WebP image has an alpha channel");
   }
   if (to === "image/jpeg") {
-    warnings.push("JPEG uses lossy compression \u2014 some quality may be reduced");
+    warnings.push("JPEG uses lossy compression: some quality may be reduced");
   }
   return warnings;
 }

package/dist/{chunk-W4UBLYFU.js → chunk-HFRTZE7T.js}

@@ -451,13 +451,13 @@ function decodeJwt(token) {
   try {
     header = decodeSegment(rawHeader);
   } catch {
-    return { ok: false, error: "Failed to decode header \u2014 not valid base64url JSON" };
+    return { ok: false, error: "Failed to decode header: not valid base64url JSON" };
   }
   let payload;
   try {
     payload = decodeSegment(rawPayload);
   } catch {
-    return { ok: false, error: "Failed to decode payload \u2014 not valid base64url JSON" };
+    return { ok: false, error: "Failed to decode payload: not valid base64url JSON" };
   }
   const algorithm = typeof header.alg === "string" ? header.alg : "unknown";
   const now = Math.floor(Date.now() / 1e3);

package/dist/{chunk-ROTPLW7T.js → chunk-IPR7FSX4.js}

@@ -45,7 +45,7 @@ function decodeBase64(input, variant = "standard") {
     const output = bytes.toString("utf8");
     return { ok: true, output, outputBytes: bytes.length };
   } catch {
-    return { ok: false, error: "Invalid Base64 \u2014 check the input and variant setting" };
+    return { ok: false, error: "Invalid Base64: check the input and variant setting" };
   }
 }
 function encodeUrl(input, mode = "component") {
@@ -64,7 +64,7 @@ function decodeUrl(input, mode = "component") {
     const output = mode === "component" ? decodeURIComponent(trimmed) : decodeURI(trimmed);
     return { ok: true, output, changed: output !== trimmed };
   } catch {
-    return { ok: false, error: "Invalid percent-encoding \u2014 check the input" };
+    return { ok: false, error: "Invalid percent-encoding: check the input" };
   }
 }
 function diffSegments(original, encoded) {

package/dist/{chunk-T3JTY2M5.js → chunk-N7C52YGL.js}

@@ -128,7 +128,7 @@ function readImageInfo(bytes) {
   if (bytes[0] === 255 && bytes[1] === 216) {
     return readJpeg(bytes);
   }
-  return { error: "Unrecognized image format \u2014 supported: PNG, JPEG, GIF, WebP, BMP" };
+  return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
 }
 
 export { media_exports, readImageInfo };

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

@@ -82,16 +82,16 @@ function formatValue(value, unit, decimals = 4) {
   return `${value.toFixed(decimals)}${unit}`;
 }
 var COMMON_SIZES = [
-  { px: 8, label: "8px \u2014 Extra small spacing / icon size" },
-  { px: 12, label: "12px \u2014 Small text / caption" },
-  { px: 14, label: "14px \u2014 Body small / secondary text" },
-  { px: 16, label: "16px \u2014 Base font size / body text" },
-  { px: 18, label: "18px \u2014 Body large / lead text" },
-  { px: 20, label: "20px \u2014 Subheading / large body" },
-  { px: 24, label: "24px \u2014 H4 / section title" },
-  { px: 32, label: "32px \u2014 H3 / card heading" },
-  { px: 48, label: "48px \u2014 H2 / page section heading" },
-  { px: 64, label: "64px \u2014 H1 / hero heading" }
+  { px: 8, label: "8px: Extra small spacing / icon size" },
+  { px: 12, label: "12px: Small text / caption" },
+  { px: 14, label: "14px: Body small / secondary text" },
+  { px: 16, label: "16px: Base font size / body text" },
+  { px: 18, label: "18px: Body large / lead text" },
+  { px: 20, label: "20px: Subheading / large body" },
+  { px: 24, label: "24px: H4 / section title" },
+  { px: 32, label: "32px: H3 / card heading" },
+  { px: 48, label: "48px: H2 / page section heading" },
+  { px: 64, label: "64px: H1 / hero heading" }
 ];
 function pxToViewport(px, viewportWidth = 1440, viewportHeight = 900) {
   const vw = parseFloat((px / viewportWidth * 100).toFixed(4));

package/dist/{chunk-3BAHSW4C.js → chunk-V5JKVDBA.js}

@@ -25,6 +25,7 @@ __export(network_exports, {
   isValidIpv6: () => isValidIpv6,
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
+  parseHar: () => parseHar,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
   statusCodeToText: () => statusCodeToText,
@@ -1381,5 +1382,63 @@ function validateHeaderValue(name, value) {
   }
   return { valid: true };
 }
+function parseHar(input) {
+  if (!input || !input.trim()) {
+    return { error: "Input is empty" };
+  }
+  let data;
+  try {
+    data = JSON.parse(input);
+  } catch (e) {
+    return { error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  if (typeof data !== "object" || data === null || !("log" in data)) {
+    return { error: 'Not a valid HAR file: missing "log" property' };
+  }
+  const log = data.log;
+  if (typeof log !== "object" || log === null || !Array.isArray(log.entries)) {
+    return { error: 'Not a valid HAR file: "log.entries" must be an array' };
+  }
+  const logObj = log;
+  const entries = [];
+  const methods = {};
+  const statusCodes = {};
+  let totalSize = 0;
+  let totalTime = 0;
+  let failedRequests = 0;
+  for (const raw of logObj.entries) {
+    if (typeof raw !== "object" || raw === null) continue;
+    const e = raw;
+    const request = e.request ?? {};
+    const response = e.response ?? {};
+    const content = response.content ?? {};
+    const method = typeof request.method === "string" ? request.method : "GET";
+    const url = typeof request.url === "string" ? request.url : "";
+    const status = typeof response.status === "number" ? response.status : 0;
+    const statusText = typeof response.statusText === "string" ? response.statusText : "";
+    const httpVersion = typeof response.httpVersion === "string" ? response.httpVersion : "";
+    const mimeType = typeof content.mimeType === "string" ? content.mimeType : "";
+    const size = typeof content.size === "number" && content.size > 0 ? content.size : 0;
+    const time = typeof e.time === "number" ? e.time : 0;
+    const startedDateTime = typeof e.startedDateTime === "string" ? e.startedDateTime : "";
+    entries.push({ method, url, status, statusText, httpVersion, mimeType, size, time, startedDateTime });
+    methods[method] = (methods[method] ?? 0) + 1;
+    if (status > 0) statusCodes[String(status)] = (statusCodes[String(status)] ?? 0) + 1;
+    totalSize += size;
+    totalTime += time;
+    if (status === 0 || status >= 400) failedRequests++;
+  }
+  const totalRequests = entries.length;
+  const avgTime = totalRequests > 0 ? Math.round(totalTime / totalRequests * 100) / 100 : 0;
+  return {
+    version: typeof logObj.version === "string" ? logObj.version : "",
+    creator: {
+      name: typeof logObj.creator?.name === "string" ? logObj.creator.name : "",
+      version: typeof logObj.creator?.version === "string" ? logObj.creator.version : ""
+    },
+    entries,
+    summary: { totalRequests, totalSize, totalTime, avgTime, failedRequests, methods, statusCodes }
+  };
+}
 
-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, 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 };

package/dist/{chunk-NSOARQCM.js → chunk-V5S6OJ4A.js}

@@ -134,24 +134,24 @@ var CHEATSHEET = [
   { pattern: "{n}", description: "Matches exactly n repetitions", example: "\\d{3} matches exactly 3 digits", category: "Quantifiers" },
   { pattern: "{n,}", description: "Matches n or more repetitions", example: "\\d{2,} matches 2 or more digits", category: "Quantifiers" },
   { pattern: "{n,m}", description: "Matches between n and m repetitions", example: "\\d{2,4} matches 2 to 4 digits", category: "Quantifiers" },
-  { pattern: "*?", description: "Lazy match \u2014 matches as few characters as possible", example: "<.*?> matches the shortest possible HTML tag", category: "Quantifiers" },
+  { pattern: "*?", description: "Lazy match: matches as few characters as possible", example: "<.*?> matches the shortest possible HTML tag", category: "Quantifiers" },
   { pattern: "+?", description: "Lazy version of +", example: "a+? matches as few 'a's as possible", category: "Quantifiers" },
-  { pattern: "(abc)", description: "Capturing group \u2014 captures the matched substring", example: "(\\d+) captures digit sequences", category: "Groups" },
-  { pattern: "(?:abc)", description: "Non-capturing group \u2014 groups without capturing", example: "(?:foo|bar)baz matches 'foobaz' or 'barbaz'", category: "Groups" },
+  { pattern: "(abc)", description: "Capturing group: captures the matched substring", example: "(\\d+) captures digit sequences", category: "Groups" },
+  { pattern: "(?:abc)", description: "Non-capturing group: groups without capturing", example: "(?:foo|bar)baz matches 'foobaz' or 'barbaz'", category: "Groups" },
   { pattern: "(?<name>abc)", description: "Named capturing group", example: "(?<year>\\d{4}) captures year by name", category: "Groups" },
-  { pattern: "a|b", description: "Alternation \u2014 matches either a or b", example: "cat|dog matches 'cat' or 'dog'", category: "Groups" },
+  { pattern: "a|b", description: "Alternation: matches either a or b", example: "cat|dog matches 'cat' or 'dog'", category: "Groups" },
   { pattern: "\\1", description: "Backreference to the first capturing group", example: "(\\w+) \\1 matches repeated words like 'the the'", category: "Groups" },
   { pattern: "\\k<name>", description: "Backreference to a named capturing group", example: "(?<word>\\w+) \\k<word> matches repeated named group", category: "Groups" },
-  { pattern: "(?=abc)", description: "Positive lookahead \u2014 asserts what follows matches", example: "\\d+(?= dollars) matches digits followed by ' dollars'", category: "Lookahead/Lookbehind" },
-  { pattern: "(?!abc)", description: "Negative lookahead \u2014 asserts what follows does not match", example: "\\d+(?! dollars) matches digits not followed by ' dollars'", category: "Lookahead/Lookbehind" },
-  { pattern: "(?<=abc)", description: "Positive lookbehind \u2014 asserts what precedes matches", example: "(?<=\\$)\\d+ matches digits preceded by '$'", category: "Lookahead/Lookbehind" },
-  { pattern: "(?<!abc)", description: "Negative lookbehind \u2014 asserts what precedes does not match", example: "(?<!\\$)\\d+ matches digits not preceded by '$'", category: "Lookahead/Lookbehind" },
-  { pattern: "g", description: "Global flag \u2014 finds all matches rather than stopping at the first", example: "/\\d+/g finds all numbers in a string", category: "Flags" },
-  { pattern: "i", description: "Case-insensitive flag \u2014 ignores letter case", example: "/hello/i matches 'Hello', 'HELLO', 'hello'", category: "Flags" },
-  { pattern: "m", description: "Multiline flag \u2014 ^ and $ match start/end of each line", example: "/^\\w+/m matches the first word of each line", category: "Flags" },
-  { pattern: "s", description: "Dotall flag \u2014 makes . match newline characters too", example: "/a.b/s matches 'a\\nb'", category: "Flags" },
-  { pattern: "u", description: "Unicode flag \u2014 enables full Unicode matching", example: "/\\u{1F600}/u matches a Unicode emoji", category: "Flags" },
-  { pattern: "y", description: "Sticky flag \u2014 matches only from the lastIndex position", example: "/\\d+/y matches digits starting at the current position", category: "Flags" },
+  { pattern: "(?=abc)", description: "Positive lookahead: asserts what follows matches", example: "\\d+(?= dollars) matches digits followed by ' dollars'", category: "Lookahead/Lookbehind" },
+  { pattern: "(?!abc)", description: "Negative lookahead: asserts what follows does not match", example: "\\d+(?! dollars) matches digits not followed by ' dollars'", category: "Lookahead/Lookbehind" },
+  { pattern: "(?<=abc)", description: "Positive lookbehind: asserts what precedes matches", example: "(?<=\\$)\\d+ matches digits preceded by '$'", category: "Lookahead/Lookbehind" },
+  { pattern: "(?<!abc)", description: "Negative lookbehind: asserts what precedes does not match", example: "(?<!\\$)\\d+ matches digits not preceded by '$'", category: "Lookahead/Lookbehind" },
+  { pattern: "g", description: "Global flag: finds all matches rather than stopping at the first", example: "/\\d+/g finds all numbers in a string", category: "Flags" },
+  { pattern: "i", description: "Case-insensitive flag: ignores letter case", example: "/hello/i matches 'Hello', 'HELLO', 'hello'", category: "Flags" },
+  { pattern: "m", description: "Multiline flag: ^ and $ match start/end of each line", example: "/^\\w+/m matches the first word of each line", category: "Flags" },
+  { pattern: "s", description: "Dotall flag: makes . match newline characters too", example: "/a.b/s matches 'a\\nb'", category: "Flags" },
+  { pattern: "u", description: "Unicode flag: enables full Unicode matching", example: "/\\u{1F600}/u matches a Unicode emoji", category: "Flags" },
+  { pattern: "y", description: "Sticky flag: matches only from the lastIndex position", example: "/\\d+/y matches digits starting at the current position", category: "Flags" },
   { pattern: "[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}", description: "Matches a basic email address", example: "user@example.com", category: "Common Patterns" },
   { pattern: "https?://[\\w\\-]+(\\.[\\w\\-]+)+([\\w.,@?^=%&:/~+#\\-]*[\\w@?^=%&/~+#\\-])?", description: "Matches an HTTP or HTTPS URL", example: "https://www.example.com/path?query=value", category: "Common Patterns" },
   { pattern: "^(?:\\+1)?[-.\\s]?\\(?\\d{3}\\)?[-.\\s]?\\d{3}[-.\\s]?\\d{4}$", description: "Matches a North American phone number in various formats", example: "(555) 123-4567 or 555-123-4567", category: "Common Patterns" },