@utilix-tech/sdk 0.38.0 → 0.39.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.39.0
+- Add `generateSri`, `generateSriAll` (sri-hash-generator): compute SHA-256/384/512 Subresource Integrity hashes for a script or stylesheet's content, formatted as the `<algorithm>-<base64>` string an HTML `integrity` attribute expects.
+- Add `analyzeEmailHeaders` (email-header-analyzer): parse a raw email header block into structured From/To/Subject fields, the Received hop chain in order, and SPF/DKIM/DMARC results from an Authentication-Results header.
+
 ## 0.38.0
 - Add `compareUnitPrices` (unit-price-comparator): compare two or more package options by price and quantity to find the true cost per unit, flag the cheapest, and report how much more expensive each other option is by percentage.
 - Add `csvToSqlInsert` (csv-to-sql-insert-generator): convert CSV data with a header row into parameterless SQL INSERT statements, with basic type inference (numbers/booleans unquoted, empty cells NULL) and ANSI/MySQL identifier quoting.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**606 developer utility functions for Node.js: runs locally, no API key required.**
+**610 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)
@@ -119,7 +119,7 @@ base62Encode("hello world");      // "AAwf93rvy4aWQVw"
 ### `/hashing`: Hash & Password
 
 ```ts
-import { hashAll, hashOne, hashPassword, verifyPassword, generateHtpasswdFile } from "@utilix-tech/sdk/hashing";
+import { hashAll, hashOne, hashPassword, verifyPassword, generateHtpasswdFile, generateSriAll } from "@utilix-tech/sdk/hashing";
 
 // Hash with MD5, SHA-1, SHA-256, SHA-512 in one call
 const hashes = await hashAll("my-string");
@@ -131,6 +131,10 @@ const valid = await verifyPassword("my-password", hash);
 
 // Generate .htpasswd file
 generateHtpasswdFile([{ username: "alice", password: "secret" }]);
+
+// Subresource Integrity hashes for a script/stylesheet's content (SHA-256/384/512)
+generateSriAll("console.log(1)");
+// [{ algorithm: "SHA-256", base64: "...", integrity: "sha256-..." }, ...]
 ```
 
 ---
@@ -412,7 +416,7 @@ compareUnitPrices([{ label: "12-pack", price: 6, quantity: 12 }, { label: "24-pa
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
          parseHar, validateSitemap, validateRobotsTxt,
-         parseUserAgent, buildCacheControl, buildReferrerPolicy, parseIpv6Address, buildLinkHeader, checkSetCookieHeader } from "@utilix-tech/sdk/network";
+         parseUserAgent, buildCacheControl, buildReferrerPolicy, parseIpv6Address, buildLinkHeader, checkSetCookieHeader, analyzeEmailHeaders } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -463,6 +467,10 @@ buildLinkHeader([{ url: "/fonts/inter.woff2", rel: "preload", as: "font", type:
 // Parse and validate a Set-Cookie header's attribute combination
 checkSetCookieHeader("session=abc123; SameSite=None");
 // { cookie: {...}, issues: ["SameSite=None requires the Secure attribute..."], warnings: [...], valid: false }
+
+// Parse a raw email header block: fields, Received hop chain, SPF/DKIM/DMARC results
+analyzeEmailHeaders(rawHeaderText);
+// { from: "...", to: "...", receivedHops: [...], hopCount: 2, spf: "pass", dkim: "pass", dmarc: "pass", warnings: [] }
 ```
 
 ---

package/dist/{chunk-GEFVMGZR.js → chunk-VEVNIGJ6.js}

@@ -9,12 +9,15 @@ __export(hashing_exports, {
   HASH_ALGORITHMS: () => HASH_ALGORITHMS,
   HASH_BITS: () => HASH_BITS,
   ROUND_OPTIONS: () => ROUND_OPTIONS,
+  SRI_ALGORITHMS: () => SRI_ALGORITHMS,
   createEntry: () => createEntry,
   generateBcryptHash: () => generateBcryptHash,
   generateHtpasswdFile: () => generateHtpasswdFile,
   generateMd5Hash: () => generateMd5Hash,
   generatePlain: () => generatePlain,
   generateSha1Hash: () => generateSha1Hash,
+  generateSri: () => generateSri,
+  generateSriAll: () => generateSriAll,
   hashAll: () => hashAll,
   hashOne: () => hashOne,
   hashPassword: () => hashPassword,
@@ -247,5 +250,27 @@ function generateHtpasswdFile(entries) {
 function validateUsername(username) {
   return /^[^\s:]{1,255}$/.test(username);
 }
+var SRI_ALGORITHMS = ["SHA-256", "SHA-384", "SHA-512"];
+var SRI_NODE_ALG_MAP = {
+  "SHA-256": "sha256",
+  "SHA-384": "sha384",
+  "SHA-512": "sha512"
+};
+function generateSri(content, algorithm = "SHA-384") {
+  if (typeof content !== "string" || content.length === 0) {
+    return { error: "Content is required" };
+  }
+  if (!SRI_ALGORITHMS.includes(algorithm)) {
+    return { error: `Unknown algorithm: ${algorithm}. Must be one of ${SRI_ALGORITHMS.join(", ")}` };
+  }
+  const base64 = createHash(SRI_NODE_ALG_MAP[algorithm]).update(content, "utf8").digest("base64");
+  return { algorithm, base64, integrity: `${SRI_NODE_ALG_MAP[algorithm]}-${base64}` };
+}
+function generateSriAll(content) {
+  if (typeof content !== "string" || content.length === 0) {
+    return { error: "Content is required" };
+  }
+  return SRI_ALGORITHMS.map((alg) => generateSri(content, alg));
+}
 
-export { HASH_ALGORITHMS, HASH_BITS, ROUND_OPTIONS, createEntry, generateBcryptHash, generateHtpasswdFile, generateMd5Hash, generatePlain, generateSha1Hash, hashAll, hashOne, hashPassword, hashWithTiming, hashing_exports, parseHtpasswdFile, validateRounds, validateUsername, verifyPassword };
+export { HASH_ALGORITHMS, HASH_BITS, ROUND_OPTIONS, SRI_ALGORITHMS, createEntry, generateBcryptHash, generateHtpasswdFile, generateMd5Hash, generatePlain, generateSha1Hash, generateSri, generateSriAll, hashAll, hashOne, hashPassword, hashWithTiming, hashing_exports, parseHtpasswdFile, validateRounds, validateUsername, verifyPassword };

package/dist/{chunk-DBNTO3YO.js → chunk-Y4BVU76A.js}

@@ -8,6 +8,7 @@ __export(network_exports, {
   LINK_REL_VALUES: () => LINK_REL_VALUES,
   REFERRER_POLICY_VALUES: () => REFERRER_POLICY_VALUES,
   STATUS_CODES: () => STATUS_CODES,
+  analyzeEmailHeaders: () => analyzeEmailHeaders,
   buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
@@ -2130,5 +2131,83 @@ function checkSetCookieHeader(header) {
   }
   return { cookie, issues, warnings, valid: issues.length === 0 };
 }
+function analyzeEmailHeaders(raw) {
+  if (typeof raw !== "string" || !raw.trim()) {
+    return { error: "Raw email header text is required" };
+  }
+  const normalized = raw.replace(/\r\n/g, "\n");
+  const blockEnd = normalized.indexOf("\n\n");
+  const headerBlock = blockEnd === -1 ? normalized : normalized.slice(0, blockEnd);
+  const rawLines = headerBlock.split("\n");
+  const unfolded = [];
+  for (const line of rawLines) {
+    if (/^[ \t]/.test(line) && unfolded.length > 0) {
+      unfolded[unfolded.length - 1] += " " + line.trim();
+    } else if (line.trim() !== "") {
+      unfolded.push(line);
+    }
+  }
+  const headers = [];
+  for (const line of unfolded) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const name = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (!name) continue;
+    headers.push({ name, value });
+  }
+  if (headers.length === 0) {
+    return { error: 'No parseable headers found \u2014 expected lines like "From: ..." or "Received: ..."' };
+  }
+  const findFirst = (name) => headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? null;
+  const findAll = (name) => headers.filter((h) => h.name.toLowerCase() === name.toLowerCase());
+  const receivedHops = findAll("received").map((h, i) => {
+    const fromMatch = h.value.match(/from\s+([^\s;]+(?:\s*\([^)]*\))?)/i);
+    const byMatch = h.value.match(/\bby\s+([^\s;]+)/i);
+    const segments = h.value.split(";");
+    const date = segments.length > 1 ? segments[segments.length - 1].trim() : null;
+    return {
+      index: i + 1,
+      raw: h.value,
+      from: fromMatch ? fromMatch[1].trim() : null,
+      by: byMatch ? byMatch[1].trim() : null,
+      date: date || null
+    };
+  });
+  const authResultsHeader = findFirst("authentication-results");
+  const authResults = [];
+  if (authResultsHeader) {
+    const re = /\b(spf|dkim|dmarc)=(\w+)/gi;
+    let m;
+    while ((m = re.exec(authResultsHeader)) !== null) {
+      authResults.push({ mechanism: m[1].toLowerCase(), result: m[2].toLowerCase() });
+    }
+  }
+  const findAuth = (mechanism) => authResults.find((a) => a.mechanism === mechanism)?.result ?? null;
+  const warnings = [];
+  if (receivedHops.length === 0) {
+    warnings.push("No Received headers found \u2014 this may be a partial header block rather than a full raw source.");
+  }
+  if (!authResultsHeader) {
+    warnings.push("No Authentication-Results header found \u2014 SPF/DKIM/DMARC cannot be determined from this header block alone.");
+  }
+  return {
+    headers,
+    from: findFirst("from"),
+    to: findFirst("to"),
+    subject: findFirst("subject"),
+    date: findFirst("date"),
+    messageId: findFirst("message-id"),
+    returnPath: findFirst("return-path"),
+    replyTo: findFirst("reply-to"),
+    receivedHops,
+    hopCount: receivedHops.length,
+    authResults,
+    spf: findAuth("spf"),
+    dkim: findAuth("dkim"),
+    dmarc: findAuth("dmarc"),
+    warnings
+  };
+}
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildReferrerPolicy, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };
+export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildReferrerPolicy, checkSetCookieHeader, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/{hashing-CnetQFD_.d.cts → hashing-Dnj0IAZf.d.cts}

@@ -7,6 +7,7 @@
  *   - htpasswd        : generateSha1Hash, generateMd5Hash, generateBcryptHash,
  *                       generatePlain, createEntry, parseHtpasswdFile,
  *                       generateHtpasswdFile, validateUsername
+ *   - sri-hash-generator: generateSri, generateSriAll (SHA-256/384/512 Subresource Integrity hashes)
  */
 type HashAlgorithm = 'MD5' | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
 declare const HASH_ALGORITHMS: HashAlgorithm[];
@@ -46,6 +47,25 @@ declare function createEntry(username: string, password: string, algorithm?: Htp
 declare function parseHtpasswdFile(content: string): HtpasswdEntry[];
 declare function generateHtpasswdFile(entries: HtpasswdEntry[]): string;
 declare function validateUsername(username: string): boolean;
+type SriAlgorithm = 'SHA-256' | 'SHA-384' | 'SHA-512';
+declare const SRI_ALGORITHMS: SriAlgorithm[];
+interface SriResult {
+    algorithm: SriAlgorithm;
+    base64: string;
+    integrity: string;
+}
+/**
+ * Compute a Subresource Integrity hash for the given file/script content:
+ * digest it with the chosen algorithm and base64-encode it into the
+ * `<algorithm>-<base64>` form used by an HTML `integrity` attribute.
+ */
+declare function generateSri(content: string, algorithm?: SriAlgorithm): SriResult | {
+    error: string;
+};
+/** Compute SRI hashes for all three algorithms SRI supports (SHA-256/384/512). */
+declare function generateSriAll(content: string): SriResult[] | {
+    error: string;
+};
 
 type hashing_BcryptResult = BcryptResult;
 declare const hashing_HASH_ALGORITHMS: typeof HASH_ALGORITHMS;
@@ -55,12 +75,17 @@ type hashing_HashResult = HashResult;
 type hashing_HtpasswdAlgorithm = HtpasswdAlgorithm;
 type hashing_HtpasswdEntry = HtpasswdEntry;
 declare const hashing_ROUND_OPTIONS: typeof ROUND_OPTIONS;
+declare const hashing_SRI_ALGORITHMS: typeof SRI_ALGORITHMS;
+type hashing_SriAlgorithm = SriAlgorithm;
+type hashing_SriResult = SriResult;
 declare const hashing_createEntry: typeof createEntry;
 declare const hashing_generateBcryptHash: typeof generateBcryptHash;
 declare const hashing_generateHtpasswdFile: typeof generateHtpasswdFile;
 declare const hashing_generateMd5Hash: typeof generateMd5Hash;
 declare const hashing_generatePlain: typeof generatePlain;
 declare const hashing_generateSha1Hash: typeof generateSha1Hash;
+declare const hashing_generateSri: typeof generateSri;
+declare const hashing_generateSriAll: typeof generateSriAll;
 declare const hashing_hashAll: typeof hashAll;
 declare const hashing_hashOne: typeof hashOne;
 declare const hashing_hashPassword: typeof hashPassword;
@@ -70,7 +95,7 @@ declare const hashing_validateRounds: typeof validateRounds;
 declare const hashing_validateUsername: typeof validateUsername;
 declare const hashing_verifyPassword: typeof verifyPassword;
 declare namespace hashing {
-  export { type hashing_BcryptResult as BcryptResult, hashing_HASH_ALGORITHMS as HASH_ALGORITHMS, hashing_HASH_BITS as HASH_BITS, type hashing_HashAlgorithm as HashAlgorithm, type hashing_HashResult as HashResult, type hashing_HtpasswdAlgorithm as HtpasswdAlgorithm, type hashing_HtpasswdEntry as HtpasswdEntry, hashing_ROUND_OPTIONS as ROUND_OPTIONS, hashing_createEntry as createEntry, hashing_generateBcryptHash as generateBcryptHash, hashing_generateHtpasswdFile as generateHtpasswdFile, hashing_generateMd5Hash as generateMd5Hash, hashing_generatePlain as generatePlain, hashing_generateSha1Hash as generateSha1Hash, hashing_hashAll as hashAll, hashing_hashOne as hashOne, hashing_hashPassword as hashPassword, hashing_hashWithTiming as hashWithTiming, hashing_parseHtpasswdFile as parseHtpasswdFile, hashing_validateRounds as validateRounds, hashing_validateUsername as validateUsername, hashing_verifyPassword as verifyPassword };
+  export { type hashing_BcryptResult as BcryptResult, hashing_HASH_ALGORITHMS as HASH_ALGORITHMS, hashing_HASH_BITS as HASH_BITS, type hashing_HashAlgorithm as HashAlgorithm, type hashing_HashResult as HashResult, type hashing_HtpasswdAlgorithm as HtpasswdAlgorithm, type hashing_HtpasswdEntry as HtpasswdEntry, hashing_ROUND_OPTIONS as ROUND_OPTIONS, hashing_SRI_ALGORITHMS as SRI_ALGORITHMS, type hashing_SriAlgorithm as SriAlgorithm, type hashing_SriResult as SriResult, hashing_createEntry as createEntry, hashing_generateBcryptHash as generateBcryptHash, hashing_generateHtpasswdFile as generateHtpasswdFile, hashing_generateMd5Hash as generateMd5Hash, hashing_generatePlain as generatePlain, hashing_generateSha1Hash as generateSha1Hash, hashing_generateSri as generateSri, hashing_generateSriAll as generateSriAll, hashing_hashAll as hashAll, hashing_hashOne as hashOne, hashing_hashPassword as hashPassword, hashing_hashWithTiming as hashWithTiming, hashing_parseHtpasswdFile as parseHtpasswdFile, hashing_validateRounds as validateRounds, hashing_validateUsername as validateUsername, hashing_verifyPassword as verifyPassword };
 }
 
-export { type BcryptResult as B, HASH_ALGORITHMS as H, ROUND_OPTIONS as R, HASH_BITS as a, type HashAlgorithm as b, type HashResult as c, type HtpasswdAlgorithm as d, type HtpasswdEntry as e, createEntry as f, generateBcryptHash as g, hashing as h, generateHtpasswdFile as i, generateMd5Hash as j, generatePlain as k, generateSha1Hash as l, hashAll as m, hashOne as n, hashPassword as o, hashWithTiming as p, parseHtpasswdFile as q, validateUsername as r, verifyPassword as s, validateRounds as v };
+export { type BcryptResult as B, HASH_ALGORITHMS as H, ROUND_OPTIONS as R, SRI_ALGORITHMS as S, HASH_BITS as a, type HashAlgorithm as b, type HashResult as c, type HtpasswdAlgorithm as d, type HtpasswdEntry as e, type SriAlgorithm as f, type SriResult as g, hashing as h, createEntry as i, generateBcryptHash as j, generateHtpasswdFile as k, generateMd5Hash as l, generatePlain as m, generateSha1Hash as n, generateSri as o, generateSriAll as p, hashAll as q, hashOne as r, hashPassword as s, hashWithTiming as t, parseHtpasswdFile as u, validateRounds as v, validateUsername as w, verifyPassword as x };

package/dist/{hashing-CnetQFD_.d.ts → hashing-Dnj0IAZf.d.ts}

@@ -7,6 +7,7 @@
  *   - htpasswd        : generateSha1Hash, generateMd5Hash, generateBcryptHash,
  *                       generatePlain, createEntry, parseHtpasswdFile,
  *                       generateHtpasswdFile, validateUsername
+ *   - sri-hash-generator: generateSri, generateSriAll (SHA-256/384/512 Subresource Integrity hashes)
  */
 type HashAlgorithm = 'MD5' | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
 declare const HASH_ALGORITHMS: HashAlgorithm[];
@@ -46,6 +47,25 @@ declare function createEntry(username: string, password: string, algorithm?: Htp
 declare function parseHtpasswdFile(content: string): HtpasswdEntry[];
 declare function generateHtpasswdFile(entries: HtpasswdEntry[]): string;
 declare function validateUsername(username: string): boolean;
+type SriAlgorithm = 'SHA-256' | 'SHA-384' | 'SHA-512';
+declare const SRI_ALGORITHMS: SriAlgorithm[];
+interface SriResult {
+    algorithm: SriAlgorithm;
+    base64: string;
+    integrity: string;
+}
+/**
+ * Compute a Subresource Integrity hash for the given file/script content:
+ * digest it with the chosen algorithm and base64-encode it into the
+ * `<algorithm>-<base64>` form used by an HTML `integrity` attribute.
+ */
+declare function generateSri(content: string, algorithm?: SriAlgorithm): SriResult | {
+    error: string;
+};
+/** Compute SRI hashes for all three algorithms SRI supports (SHA-256/384/512). */
+declare function generateSriAll(content: string): SriResult[] | {
+    error: string;
+};
 
 type hashing_BcryptResult = BcryptResult;
 declare const hashing_HASH_ALGORITHMS: typeof HASH_ALGORITHMS;
@@ -55,12 +75,17 @@ type hashing_HashResult = HashResult;
 type hashing_HtpasswdAlgorithm = HtpasswdAlgorithm;
 type hashing_HtpasswdEntry = HtpasswdEntry;
 declare const hashing_ROUND_OPTIONS: typeof ROUND_OPTIONS;
+declare const hashing_SRI_ALGORITHMS: typeof SRI_ALGORITHMS;
+type hashing_SriAlgorithm = SriAlgorithm;
+type hashing_SriResult = SriResult;
 declare const hashing_createEntry: typeof createEntry;
 declare const hashing_generateBcryptHash: typeof generateBcryptHash;
 declare const hashing_generateHtpasswdFile: typeof generateHtpasswdFile;
 declare const hashing_generateMd5Hash: typeof generateMd5Hash;
 declare const hashing_generatePlain: typeof generatePlain;
 declare const hashing_generateSha1Hash: typeof generateSha1Hash;
+declare const hashing_generateSri: typeof generateSri;
+declare const hashing_generateSriAll: typeof generateSriAll;
 declare const hashing_hashAll: typeof hashAll;
 declare const hashing_hashOne: typeof hashOne;
 declare const hashing_hashPassword: typeof hashPassword;
@@ -70,7 +95,7 @@ declare const hashing_validateRounds: typeof validateRounds;
 declare const hashing_validateUsername: typeof validateUsername;
 declare const hashing_verifyPassword: typeof verifyPassword;
 declare namespace hashing {
-  export { type hashing_BcryptResult as BcryptResult, hashing_HASH_ALGORITHMS as HASH_ALGORITHMS, hashing_HASH_BITS as HASH_BITS, type hashing_HashAlgorithm as HashAlgorithm, type hashing_HashResult as HashResult, type hashing_HtpasswdAlgorithm as HtpasswdAlgorithm, type hashing_HtpasswdEntry as HtpasswdEntry, hashing_ROUND_OPTIONS as ROUND_OPTIONS, hashing_createEntry as createEntry, hashing_generateBcryptHash as generateBcryptHash, hashing_generateHtpasswdFile as generateHtpasswdFile, hashing_generateMd5Hash as generateMd5Hash, hashing_generatePlain as generatePlain, hashing_generateSha1Hash as generateSha1Hash, hashing_hashAll as hashAll, hashing_hashOne as hashOne, hashing_hashPassword as hashPassword, hashing_hashWithTiming as hashWithTiming, hashing_parseHtpasswdFile as parseHtpasswdFile, hashing_validateRounds as validateRounds, hashing_validateUsername as validateUsername, hashing_verifyPassword as verifyPassword };
+  export { type hashing_BcryptResult as BcryptResult, hashing_HASH_ALGORITHMS as HASH_ALGORITHMS, hashing_HASH_BITS as HASH_BITS, type hashing_HashAlgorithm as HashAlgorithm, type hashing_HashResult as HashResult, type hashing_HtpasswdAlgorithm as HtpasswdAlgorithm, type hashing_HtpasswdEntry as HtpasswdEntry, hashing_ROUND_OPTIONS as ROUND_OPTIONS, hashing_SRI_ALGORITHMS as SRI_ALGORITHMS, type hashing_SriAlgorithm as SriAlgorithm, type hashing_SriResult as SriResult, hashing_createEntry as createEntry, hashing_generateBcryptHash as generateBcryptHash, hashing_generateHtpasswdFile as generateHtpasswdFile, hashing_generateMd5Hash as generateMd5Hash, hashing_generatePlain as generatePlain, hashing_generateSha1Hash as generateSha1Hash, hashing_generateSri as generateSri, hashing_generateSriAll as generateSriAll, hashing_hashAll as hashAll, hashing_hashOne as hashOne, hashing_hashPassword as hashPassword, hashing_hashWithTiming as hashWithTiming, hashing_parseHtpasswdFile as parseHtpasswdFile, hashing_validateRounds as validateRounds, hashing_validateUsername as validateUsername, hashing_verifyPassword as verifyPassword };
 }
 
-export { type BcryptResult as B, HASH_ALGORITHMS as H, ROUND_OPTIONS as R, HASH_BITS as a, type HashAlgorithm as b, type HashResult as c, type HtpasswdAlgorithm as d, type HtpasswdEntry as e, createEntry as f, generateBcryptHash as g, hashing as h, generateHtpasswdFile as i, generateMd5Hash as j, generatePlain as k, generateSha1Hash as l, hashAll as m, hashOne as n, hashPassword as o, hashWithTiming as p, parseHtpasswdFile as q, validateUsername as r, verifyPassword as s, validateRounds as v };
+export { type BcryptResult as B, HASH_ALGORITHMS as H, ROUND_OPTIONS as R, SRI_ALGORITHMS as S, HASH_BITS as a, type HashAlgorithm as b, type HashResult as c, type HtpasswdAlgorithm as d, type HtpasswdEntry as e, type SriAlgorithm as f, type SriResult as g, hashing as h, createEntry as i, generateBcryptHash as j, generateHtpasswdFile as k, generateMd5Hash as l, generatePlain as m, generateSha1Hash as n, generateSri as o, generateSriAll as p, hashAll as q, hashOne as r, hashPassword as s, hashWithTiming as t, parseHtpasswdFile as u, validateRounds as v, validateUsername as w, verifyPassword as x };

package/dist/index.cjs

@@ -1769,12 +1769,15 @@ __export(hashing_exports, {
   HASH_ALGORITHMS: () => HASH_ALGORITHMS,
   HASH_BITS: () => HASH_BITS,
   ROUND_OPTIONS: () => ROUND_OPTIONS,
+  SRI_ALGORITHMS: () => SRI_ALGORITHMS,
   createEntry: () => createEntry,
   generateBcryptHash: () => generateBcryptHash,
   generateHtpasswdFile: () => generateHtpasswdFile,
   generateMd5Hash: () => generateMd5Hash,
   generatePlain: () => generatePlain,
   generateSha1Hash: () => generateSha1Hash,
+  generateSri: () => generateSri,
+  generateSriAll: () => generateSriAll,
   hashAll: () => hashAll,
   hashOne: () => hashOne,
   hashPassword: () => hashPassword,
@@ -2007,6 +2010,28 @@ function generateHtpasswdFile(entries) {
 function validateUsername(username) {
   return /^[^\s:]{1,255}$/.test(username);
 }
+var SRI_ALGORITHMS = ["SHA-256", "SHA-384", "SHA-512"];
+var SRI_NODE_ALG_MAP = {
+  "SHA-256": "sha256",
+  "SHA-384": "sha384",
+  "SHA-512": "sha512"
+};
+function generateSri(content, algorithm = "SHA-384") {
+  if (typeof content !== "string" || content.length === 0) {
+    return { error: "Content is required" };
+  }
+  if (!SRI_ALGORITHMS.includes(algorithm)) {
+    return { error: `Unknown algorithm: ${algorithm}. Must be one of ${SRI_ALGORITHMS.join(", ")}` };
+  }
+  const base64 = crypto.createHash(SRI_NODE_ALG_MAP[algorithm]).update(content, "utf8").digest("base64");
+  return { algorithm, base64, integrity: `${SRI_NODE_ALG_MAP[algorithm]}-${base64}` };
+}
+function generateSriAll(content) {
+  if (typeof content !== "string" || content.length === 0) {
+    return { error: "Content is required" };
+  }
+  return SRI_ALGORITHMS.map((alg) => generateSri(content, alg));
+}
 
 // src/tools/text.ts
 var text_exports = {};
@@ -9748,6 +9773,7 @@ __export(network_exports, {
   LINK_REL_VALUES: () => LINK_REL_VALUES,
   REFERRER_POLICY_VALUES: () => REFERRER_POLICY_VALUES,
   STATUS_CODES: () => STATUS_CODES,
+  analyzeEmailHeaders: () => analyzeEmailHeaders,
   buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
@@ -11870,6 +11896,84 @@ function checkSetCookieHeader(header) {
   }
   return { cookie, issues, warnings, valid: issues.length === 0 };
 }
+function analyzeEmailHeaders(raw) {
+  if (typeof raw !== "string" || !raw.trim()) {
+    return { error: "Raw email header text is required" };
+  }
+  const normalized = raw.replace(/\r\n/g, "\n");
+  const blockEnd = normalized.indexOf("\n\n");
+  const headerBlock = blockEnd === -1 ? normalized : normalized.slice(0, blockEnd);
+  const rawLines = headerBlock.split("\n");
+  const unfolded = [];
+  for (const line of rawLines) {
+    if (/^[ \t]/.test(line) && unfolded.length > 0) {
+      unfolded[unfolded.length - 1] += " " + line.trim();
+    } else if (line.trim() !== "") {
+      unfolded.push(line);
+    }
+  }
+  const headers = [];
+  for (const line of unfolded) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const name = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (!name) continue;
+    headers.push({ name, value });
+  }
+  if (headers.length === 0) {
+    return { error: 'No parseable headers found \u2014 expected lines like "From: ..." or "Received: ..."' };
+  }
+  const findFirst = (name) => headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? null;
+  const findAll = (name) => headers.filter((h) => h.name.toLowerCase() === name.toLowerCase());
+  const receivedHops = findAll("received").map((h, i) => {
+    const fromMatch = h.value.match(/from\s+([^\s;]+(?:\s*\([^)]*\))?)/i);
+    const byMatch = h.value.match(/\bby\s+([^\s;]+)/i);
+    const segments = h.value.split(";");
+    const date = segments.length > 1 ? segments[segments.length - 1].trim() : null;
+    return {
+      index: i + 1,
+      raw: h.value,
+      from: fromMatch ? fromMatch[1].trim() : null,
+      by: byMatch ? byMatch[1].trim() : null,
+      date: date || null
+    };
+  });
+  const authResultsHeader = findFirst("authentication-results");
+  const authResults = [];
+  if (authResultsHeader) {
+    const re = /\b(spf|dkim|dmarc)=(\w+)/gi;
+    let m;
+    while ((m = re.exec(authResultsHeader)) !== null) {
+      authResults.push({ mechanism: m[1].toLowerCase(), result: m[2].toLowerCase() });
+    }
+  }
+  const findAuth = (mechanism) => authResults.find((a) => a.mechanism === mechanism)?.result ?? null;
+  const warnings = [];
+  if (receivedHops.length === 0) {
+    warnings.push("No Received headers found \u2014 this may be a partial header block rather than a full raw source.");
+  }
+  if (!authResultsHeader) {
+    warnings.push("No Authentication-Results header found \u2014 SPF/DKIM/DMARC cannot be determined from this header block alone.");
+  }
+  return {
+    headers,
+    from: findFirst("from"),
+    to: findFirst("to"),
+    subject: findFirst("subject"),
+    date: findFirst("date"),
+    messageId: findFirst("message-id"),
+    returnPath: findFirst("return-path"),
+    replyTo: findFirst("reply-to"),
+    receivedHops,
+    hopCount: receivedHops.length,
+    authResults,
+    spf: findAuth("spf"),
+    dkim: findAuth("dkim"),
+    dmarc: findAuth("dmarc"),
+    warnings
+  };
+}
 
 // src/tools/api.ts
 var api_exports = {};

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 export { j as json } from './json-Ta9JykSB.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
-export { h as hashing } from './hashing-CnetQFD_.cjs';
+export { h as hashing } from './hashing-Dnj0IAZf.cjs';
 export { t as text } from './text-kHkT9VtT.cjs';
 export { d as data } from './data-BCf3dm-E.cjs';
 export { g as generators } from './generators-Du8cBesn.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
 export { u as units } from './units-HQrMCiNM.cjs';
-export { n as network } from './network-CnKUQT4g.cjs';
+export { n as network } from './network-CKPoesdD.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-KXoRsHtl.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { j as json } from './json-Ta9JykSB.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
-export { h as hashing } from './hashing-CnetQFD_.js';
+export { h as hashing } from './hashing-Dnj0IAZf.js';
 export { t as text } from './text-kHkT9VtT.js';
 export { d as data } from './data-BCf3dm-E.js';
 export { g as generators } from './generators-Du8cBesn.js';
 export { t as time } from './time-KqJjdqII.js';
 export { u as units } from './units-HQrMCiNM.js';
-export { n as network } from './network-CnKUQT4g.js';
+export { n as network } from './network-CKPoesdD.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-KXoRsHtl.js';
 export { c as color } from './color-tPwZCr9H.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { media_exports as media } from './chunk-L6V4W4SU.js';
 export { units_exports as units } from './chunk-47RI5V3B.js';
-export { network_exports as network } from './chunk-DBNTO3YO.js';
+export { network_exports as network } from './chunk-Y4BVU76A.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-JL7YTXRB.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
@@ -9,7 +9,7 @@ export { misc_exports as misc } from './chunk-GX7H6TAX.js';
 export { ai_agent_exports as ai_agent } from './chunk-W3J7GZVQ.js';
 export { json_exports as json } from './chunk-WVEKRKGU.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
-export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
+export { hashing_exports as hashing } from './chunk-VEVNIGJ6.js';
 export { text_exports as text } from './chunk-F2CEN226.js';
 export { data_exports as data } from './chunk-RZUNTYEH.js';
 export { generators_exports as generators } from './chunk-3TYWIX3B.js';

package/dist/{network-CnKUQT4g.d.cts → network-CKPoesdD.d.cts}

@@ -16,6 +16,7 @@
  *   - ipv6-compressor: parseIpv6Address
  *   - link-header-builder: buildLinkHeader
  *   - same-site-cookie-checker: checkSetCookieHeader
+ *   - email-header-analyzer: analyzeEmailHeaders
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -402,7 +403,52 @@ interface CookieCheckResult {
 declare function checkSetCookieHeader(header: string): CookieCheckResult | {
     error: string;
 };
+interface EmailHeaderField {
+    name: string;
+    value: string;
+}
+interface ReceivedHop {
+    index: number;
+    raw: string;
+    from: string | null;
+    by: string | null;
+    date: string | null;
+}
+interface AuthResultEntry {
+    mechanism: string;
+    result: string;
+}
+interface EmailHeaderAnalysis {
+    headers: EmailHeaderField[];
+    from: string | null;
+    to: string | null;
+    subject: string | null;
+    date: string | null;
+    messageId: string | null;
+    returnPath: string | null;
+    replyTo: string | null;
+    receivedHops: ReceivedHop[];
+    hopCount: number;
+    authResults: AuthResultEntry[];
+    spf: string | null;
+    dkim: string | null;
+    dmarc: string | null;
+    warnings: string[];
+}
+/**
+ * Parse a raw email header block (e.g. Gmail's "Show original", or the
+ * headers from a .eml file) into structured fields, the Received hop chain
+ * in the order they appear (top = most recently added, i.e. closest to the
+ * final destination), and any SPF/DKIM/DMARC verdicts found in an
+ * Authentication-Results header. Header folding (continuation lines starting
+ * with whitespace) is unfolded before parsing. This never performs a live
+ * DNS/SPF/DKIM check — it only reports what the headers already claim.
+ */
+declare function analyzeEmailHeaders(raw: string): EmailHeaderAnalysis | {
+    error: string;
+};
 
+type network_AuthResultEntry = AuthResultEntry;
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
 type network_CacheControlResult = CacheControlResult;
@@ -412,6 +458,8 @@ declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
 type network_DnsResponse = DnsResponse;
+type network_EmailHeaderAnalysis = EmailHeaderAnalysis;
+type network_EmailHeaderField = EmailHeaderField;
 type network_GeoResult = GeoResult;
 declare const network_HTTP_HEADERS: typeof HTTP_HEADERS;
 type network_HarEntry = HarEntry;
@@ -429,6 +477,7 @@ type network_LinkRel = LinkRel;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
 declare const network_REFERRER_POLICY_VALUES: typeof REFERRER_POLICY_VALUES;
+type network_ReceivedHop = ReceivedHop;
 type network_ReferrerPolicyEntry = ReferrerPolicyEntry;
 type network_ReferrerPolicyResult = ReferrerPolicyResult;
 type network_ReferrerPolicyValue = ReferrerPolicyValue;
@@ -445,6 +494,7 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+declare const network_analyzeEmailHeaders: typeof analyzeEmailHeaders;
 declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
@@ -481,7 +531,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, type network_CookieAttributes as CookieAttributes, type network_CookieCheckResult as CookieCheckResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, network_LINK_REL_VALUES as LINK_REL_VALUES, type network_LinkHeaderEntry as LinkHeaderEntry, type network_LinkHeaderEntryInput as LinkHeaderEntryInput, type network_LinkHeaderResult as LinkHeaderResult, type network_LinkRel as LinkRel, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, type network_ReferrerPolicyEntry as ReferrerPolicyEntry, type network_ReferrerPolicyResult as ReferrerPolicyResult, type network_ReferrerPolicyValue as ReferrerPolicyValue, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SameSiteValue as SameSiteValue, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, network_checkSetCookieHeader as checkSetCookieHeader, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_AuthResultEntry as AuthResultEntry, type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, type network_CookieAttributes as CookieAttributes, type network_CookieCheckResult as CookieCheckResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_EmailHeaderAnalysis as EmailHeaderAnalysis, type network_EmailHeaderField as EmailHeaderField, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, network_LINK_REL_VALUES as LINK_REL_VALUES, type network_LinkHeaderEntry as LinkHeaderEntry, type network_LinkHeaderEntryInput as LinkHeaderEntryInput, type network_LinkHeaderResult as LinkHeaderResult, type network_LinkRel as LinkRel, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, type network_ReceivedHop as ReceivedHop, type network_ReferrerPolicyEntry as ReferrerPolicyEntry, type network_ReferrerPolicyResult as ReferrerPolicyResult, type network_ReferrerPolicyValue as ReferrerPolicyValue, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SameSiteValue as SameSiteValue, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_analyzeEmailHeaders as analyzeEmailHeaders, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, network_checkSetCookieHeader as checkSetCookieHeader, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { getByCategory as $, type SameSiteValue as A, type SitemapIndexEntry as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type SitemapIssue as E, type SitemapUrlEntry as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type SitemapValidationResult as J, type StatusCode as K, LINK_REL_VALUES as L, type UserAgentInfo as M, buildCacheControl as N, buildDnsQueryUrl as O, type ParsedDnsResult as P, buildGeoUrl as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, buildLinkHeader as T, type UaDeviceType as U, buildMapUrl as V, buildReferrerPolicy as W, checkSetCookieHeader as X, countryCodeToFlag as Y, formatCoordinates as Z, formatTtl as _, type CacheControlOptions as a, getHeader as a0, getHeadersByCategory as a1, getStatusByCategory as a2, getStatusCode as a3, isClientError as a4, isServerError as a5, isSuccess as a6, isValidIp as a7, isValidIpv4 as a8, isValidIpv6 as a9, parseDnsResponse as aa, parseGeoResponse as ab, parseHar as ac, parseIpv6Address as ad, parseUserAgent as ae, searchHeaders as af, searchStatusCodes as ag, statusCodeToText as ah, typeNumberToLabel as ai, validateDomain as aj, validateHeaderName as ak, validateHeaderValue as al, validateRobotsTxt as am, validateSitemap as an, type CacheControlResult as b, type CookieAttributes as c, type CookieCheckResult as d, type DnsRecord as e, type DnsRecordType as f, type DnsResponse as g, type HarEntry as h, type HarParseResult as i, type HarSummary as j, type HeaderCategory as k, type HttpHeader as l, type Ipv6ParseResult as m, network as n, type LinkHeaderEntry as o, type LinkHeaderEntryInput as p, type LinkHeaderResult as q, type LinkRel as r, type ParsedGeoResult as s, type ReferrerPolicyEntry as t, type ReferrerPolicyResult as u, type ReferrerPolicyValue as v, type RobotsGroup as w, type RobotsIssue as x, type RobotsRule as y, type RobotsValidationResult as z };
+export { buildReferrerPolicy as $, type AuthResultEntry as A, type RobotsRule as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type RobotsValidationResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type SameSiteValue as J, type SitemapIndexEntry as K, LINK_REL_VALUES as L, type SitemapIssue as M, type SitemapUrlEntry as N, type SitemapValidationResult as O, type ParsedDnsResult as P, type StatusCode as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, type UserAgentInfo as T, type UaDeviceType as U, analyzeEmailHeaders as V, buildCacheControl as W, buildDnsQueryUrl as X, buildGeoUrl as Y, buildLinkHeader as Z, buildMapUrl as _, type CacheControlOptions as a, checkSetCookieHeader as a0, countryCodeToFlag as a1, formatCoordinates as a2, formatTtl as a3, getByCategory as a4, getHeader as a5, getHeadersByCategory as a6, getStatusByCategory as a7, getStatusCode as a8, isClientError as a9, isServerError as aa, isSuccess as ab, isValidIp as ac, isValidIpv4 as ad, isValidIpv6 as ae, parseDnsResponse as af, parseGeoResponse as ag, parseHar as ah, parseIpv6Address as ai, parseUserAgent as aj, searchHeaders as ak, searchStatusCodes as al, statusCodeToText as am, typeNumberToLabel as an, validateDomain as ao, validateHeaderName as ap, validateHeaderValue as aq, validateRobotsTxt as ar, validateSitemap as as, type CacheControlResult as b, type CookieAttributes as c, type CookieCheckResult as d, type DnsRecord as e, type DnsRecordType as f, type DnsResponse as g, type EmailHeaderField as h, type HarEntry as i, type HarParseResult as j, type HarSummary as k, type HeaderCategory as l, type HttpHeader as m, network as n, type Ipv6ParseResult as o, type LinkHeaderEntry as p, type LinkHeaderEntryInput as q, type LinkHeaderResult as r, type LinkRel as s, type ParsedGeoResult as t, type ReceivedHop as u, type ReferrerPolicyEntry as v, type ReferrerPolicyResult as w, type ReferrerPolicyValue as x, type RobotsGroup as y, type RobotsIssue as z };

package/dist/{network-CnKUQT4g.d.ts → network-CKPoesdD.d.ts}

@@ -16,6 +16,7 @@
  *   - ipv6-compressor: parseIpv6Address
  *   - link-header-builder: buildLinkHeader
  *   - same-site-cookie-checker: checkSetCookieHeader
+ *   - email-header-analyzer: analyzeEmailHeaders
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -402,7 +403,52 @@ interface CookieCheckResult {
 declare function checkSetCookieHeader(header: string): CookieCheckResult | {
     error: string;
 };
+interface EmailHeaderField {
+    name: string;
+    value: string;
+}
+interface ReceivedHop {
+    index: number;
+    raw: string;
+    from: string | null;
+    by: string | null;
+    date: string | null;
+}
+interface AuthResultEntry {
+    mechanism: string;
+    result: string;
+}
+interface EmailHeaderAnalysis {
+    headers: EmailHeaderField[];
+    from: string | null;
+    to: string | null;
+    subject: string | null;
+    date: string | null;
+    messageId: string | null;
+    returnPath: string | null;
+    replyTo: string | null;
+    receivedHops: ReceivedHop[];
+    hopCount: number;
+    authResults: AuthResultEntry[];
+    spf: string | null;
+    dkim: string | null;
+    dmarc: string | null;
+    warnings: string[];
+}
+/**
+ * Parse a raw email header block (e.g. Gmail's "Show original", or the
+ * headers from a .eml file) into structured fields, the Received hop chain
+ * in the order they appear (top = most recently added, i.e. closest to the
+ * final destination), and any SPF/DKIM/DMARC verdicts found in an
+ * Authentication-Results header. Header folding (continuation lines starting
+ * with whitespace) is unfolded before parsing. This never performs a live
+ * DNS/SPF/DKIM check — it only reports what the headers already claim.
+ */
+declare function analyzeEmailHeaders(raw: string): EmailHeaderAnalysis | {
+    error: string;
+};
 
+type network_AuthResultEntry = AuthResultEntry;
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
 type network_CacheControlResult = CacheControlResult;
@@ -412,6 +458,8 @@ declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
 type network_DnsResponse = DnsResponse;
+type network_EmailHeaderAnalysis = EmailHeaderAnalysis;
+type network_EmailHeaderField = EmailHeaderField;
 type network_GeoResult = GeoResult;
 declare const network_HTTP_HEADERS: typeof HTTP_HEADERS;
 type network_HarEntry = HarEntry;
@@ -429,6 +477,7 @@ type network_LinkRel = LinkRel;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
 declare const network_REFERRER_POLICY_VALUES: typeof REFERRER_POLICY_VALUES;
+type network_ReceivedHop = ReceivedHop;
 type network_ReferrerPolicyEntry = ReferrerPolicyEntry;
 type network_ReferrerPolicyResult = ReferrerPolicyResult;
 type network_ReferrerPolicyValue = ReferrerPolicyValue;
@@ -445,6 +494,7 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+declare const network_analyzeEmailHeaders: typeof analyzeEmailHeaders;
 declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
@@ -481,7 +531,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, type network_CookieAttributes as CookieAttributes, type network_CookieCheckResult as CookieCheckResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, network_LINK_REL_VALUES as LINK_REL_VALUES, type network_LinkHeaderEntry as LinkHeaderEntry, type network_LinkHeaderEntryInput as LinkHeaderEntryInput, type network_LinkHeaderResult as LinkHeaderResult, type network_LinkRel as LinkRel, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, type network_ReferrerPolicyEntry as ReferrerPolicyEntry, type network_ReferrerPolicyResult as ReferrerPolicyResult, type network_ReferrerPolicyValue as ReferrerPolicyValue, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SameSiteValue as SameSiteValue, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, network_checkSetCookieHeader as checkSetCookieHeader, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_AuthResultEntry as AuthResultEntry, type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, type network_CookieAttributes as CookieAttributes, type network_CookieCheckResult as CookieCheckResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_EmailHeaderAnalysis as EmailHeaderAnalysis, type network_EmailHeaderField as EmailHeaderField, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, network_LINK_REL_VALUES as LINK_REL_VALUES, type network_LinkHeaderEntry as LinkHeaderEntry, type network_LinkHeaderEntryInput as LinkHeaderEntryInput, type network_LinkHeaderResult as LinkHeaderResult, type network_LinkRel as LinkRel, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, network_REFERRER_POLICY_VALUES as REFERRER_POLICY_VALUES, type network_ReceivedHop as ReceivedHop, type network_ReferrerPolicyEntry as ReferrerPolicyEntry, type network_ReferrerPolicyResult as ReferrerPolicyResult, type network_ReferrerPolicyValue as ReferrerPolicyValue, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SameSiteValue as SameSiteValue, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_analyzeEmailHeaders as analyzeEmailHeaders, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildLinkHeader as buildLinkHeader, network_buildMapUrl as buildMapUrl, network_buildReferrerPolicy as buildReferrerPolicy, network_checkSetCookieHeader as checkSetCookieHeader, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { getByCategory as $, type SameSiteValue as A, type SitemapIndexEntry as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type SitemapIssue as E, type SitemapUrlEntry as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type SitemapValidationResult as J, type StatusCode as K, LINK_REL_VALUES as L, type UserAgentInfo as M, buildCacheControl as N, buildDnsQueryUrl as O, type ParsedDnsResult as P, buildGeoUrl as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, buildLinkHeader as T, type UaDeviceType as U, buildMapUrl as V, buildReferrerPolicy as W, checkSetCookieHeader as X, countryCodeToFlag as Y, formatCoordinates as Z, formatTtl as _, type CacheControlOptions as a, getHeader as a0, getHeadersByCategory as a1, getStatusByCategory as a2, getStatusCode as a3, isClientError as a4, isServerError as a5, isSuccess as a6, isValidIp as a7, isValidIpv4 as a8, isValidIpv6 as a9, parseDnsResponse as aa, parseGeoResponse as ab, parseHar as ac, parseIpv6Address as ad, parseUserAgent as ae, searchHeaders as af, searchStatusCodes as ag, statusCodeToText as ah, typeNumberToLabel as ai, validateDomain as aj, validateHeaderName as ak, validateHeaderValue as al, validateRobotsTxt as am, validateSitemap as an, type CacheControlResult as b, type CookieAttributes as c, type CookieCheckResult as d, type DnsRecord as e, type DnsRecordType as f, type DnsResponse as g, type HarEntry as h, type HarParseResult as i, type HarSummary as j, type HeaderCategory as k, type HttpHeader as l, type Ipv6ParseResult as m, network as n, type LinkHeaderEntry as o, type LinkHeaderEntryInput as p, type LinkHeaderResult as q, type LinkRel as r, type ParsedGeoResult as s, type ReferrerPolicyEntry as t, type ReferrerPolicyResult as u, type ReferrerPolicyValue as v, type RobotsGroup as w, type RobotsIssue as x, type RobotsRule as y, type RobotsValidationResult as z };
+export { buildReferrerPolicy as $, type AuthResultEntry as A, type RobotsRule as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, type EmailHeaderAnalysis as E, type RobotsValidationResult as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, type SameSiteValue as J, type SitemapIndexEntry as K, LINK_REL_VALUES as L, type SitemapIssue as M, type SitemapUrlEntry as N, type SitemapValidationResult as O, type ParsedDnsResult as P, type StatusCode as Q, REFERRER_POLICY_VALUES as R, STATUS_CODES as S, type UserAgentInfo as T, type UaDeviceType as U, analyzeEmailHeaders as V, buildCacheControl as W, buildDnsQueryUrl as X, buildGeoUrl as Y, buildLinkHeader as Z, buildMapUrl as _, type CacheControlOptions as a, checkSetCookieHeader as a0, countryCodeToFlag as a1, formatCoordinates as a2, formatTtl as a3, getByCategory as a4, getHeader as a5, getHeadersByCategory as a6, getStatusByCategory as a7, getStatusCode as a8, isClientError as a9, isServerError as aa, isSuccess as ab, isValidIp as ac, isValidIpv4 as ad, isValidIpv6 as ae, parseDnsResponse as af, parseGeoResponse as ag, parseHar as ah, parseIpv6Address as ai, parseUserAgent as aj, searchHeaders as ak, searchStatusCodes as al, statusCodeToText as am, typeNumberToLabel as an, validateDomain as ao, validateHeaderName as ap, validateHeaderValue as aq, validateRobotsTxt as ar, validateSitemap as as, type CacheControlResult as b, type CookieAttributes as c, type CookieCheckResult as d, type DnsRecord as e, type DnsRecordType as f, type DnsResponse as g, type EmailHeaderField as h, type HarEntry as i, type HarParseResult as j, type HarSummary as k, type HeaderCategory as l, type HttpHeader as m, network as n, type Ipv6ParseResult as o, type LinkHeaderEntry as p, type LinkHeaderEntryInput as q, type LinkHeaderResult as r, type LinkRel as s, type ParsedGeoResult as t, type ReceivedHop as u, type ReferrerPolicyEntry as v, type ReferrerPolicyResult as w, type ReferrerPolicyValue as x, type RobotsGroup as y, type RobotsIssue as z };

package/dist/tools/hashing.cjs

@@ -233,16 +233,41 @@ function generateHtpasswdFile(entries) {
 function validateUsername(username) {
   return /^[^\s:]{1,255}$/.test(username);
 }
+var SRI_ALGORITHMS = ["SHA-256", "SHA-384", "SHA-512"];
+var SRI_NODE_ALG_MAP = {
+  "SHA-256": "sha256",
+  "SHA-384": "sha384",
+  "SHA-512": "sha512"
+};
+function generateSri(content, algorithm = "SHA-384") {
+  if (typeof content !== "string" || content.length === 0) {
+    return { error: "Content is required" };
+  }
+  if (!SRI_ALGORITHMS.includes(algorithm)) {
+    return { error: `Unknown algorithm: ${algorithm}. Must be one of ${SRI_ALGORITHMS.join(", ")}` };
+  }
+  const base64 = crypto.createHash(SRI_NODE_ALG_MAP[algorithm]).update(content, "utf8").digest("base64");
+  return { algorithm, base64, integrity: `${SRI_NODE_ALG_MAP[algorithm]}-${base64}` };
+}
+function generateSriAll(content) {
+  if (typeof content !== "string" || content.length === 0) {
+    return { error: "Content is required" };
+  }
+  return SRI_ALGORITHMS.map((alg) => generateSri(content, alg));
+}
 
 exports.HASH_ALGORITHMS = HASH_ALGORITHMS;
 exports.HASH_BITS = HASH_BITS;
 exports.ROUND_OPTIONS = ROUND_OPTIONS;
+exports.SRI_ALGORITHMS = SRI_ALGORITHMS;
 exports.createEntry = createEntry;
 exports.generateBcryptHash = generateBcryptHash;
 exports.generateHtpasswdFile = generateHtpasswdFile;
 exports.generateMd5Hash = generateMd5Hash;
 exports.generatePlain = generatePlain;
 exports.generateSha1Hash = generateSha1Hash;
+exports.generateSri = generateSri;
+exports.generateSriAll = generateSriAll;
 exports.hashAll = hashAll;
 exports.hashOne = hashOne;
 exports.hashPassword = hashPassword;

package/dist/tools/hashing.d.cts

@@ -1 +1 @@
-export { B as BcryptResult, H as HASH_ALGORITHMS, a as HASH_BITS, b as HashAlgorithm, c as HashResult, d as HtpasswdAlgorithm, e as HtpasswdEntry, R as ROUND_OPTIONS, f as createEntry, g as generateBcryptHash, i as generateHtpasswdFile, j as generateMd5Hash, k as generatePlain, l as generateSha1Hash, m as hashAll, n as hashOne, o as hashPassword, p as hashWithTiming, q as parseHtpasswdFile, v as validateRounds, r as validateUsername, s as verifyPassword } from '../hashing-CnetQFD_.cjs';
+export { B as BcryptResult, H as HASH_ALGORITHMS, a as HASH_BITS, b as HashAlgorithm, c as HashResult, d as HtpasswdAlgorithm, e as HtpasswdEntry, R as ROUND_OPTIONS, S as SRI_ALGORITHMS, f as SriAlgorithm, g as SriResult, i as createEntry, j as generateBcryptHash, k as generateHtpasswdFile, l as generateMd5Hash, m as generatePlain, n as generateSha1Hash, o as generateSri, p as generateSriAll, q as hashAll, r as hashOne, s as hashPassword, t as hashWithTiming, u as parseHtpasswdFile, v as validateRounds, w as validateUsername, x as verifyPassword } from '../hashing-Dnj0IAZf.cjs';

package/dist/tools/hashing.d.ts

@@ -1 +1 @@
-export { B as BcryptResult, H as HASH_ALGORITHMS, a as HASH_BITS, b as HashAlgorithm, c as HashResult, d as HtpasswdAlgorithm, e as HtpasswdEntry, R as ROUND_OPTIONS, f as createEntry, g as generateBcryptHash, i as generateHtpasswdFile, j as generateMd5Hash, k as generatePlain, l as generateSha1Hash, m as hashAll, n as hashOne, o as hashPassword, p as hashWithTiming, q as parseHtpasswdFile, v as validateRounds, r as validateUsername, s as verifyPassword } from '../hashing-CnetQFD_.js';
+export { B as BcryptResult, H as HASH_ALGORITHMS, a as HASH_BITS, b as HashAlgorithm, c as HashResult, d as HtpasswdAlgorithm, e as HtpasswdEntry, R as ROUND_OPTIONS, S as SRI_ALGORITHMS, f as SriAlgorithm, g as SriResult, i as createEntry, j as generateBcryptHash, k as generateHtpasswdFile, l as generateMd5Hash, m as generatePlain, n as generateSha1Hash, o as generateSri, p as generateSriAll, q as hashAll, r as hashOne, s as hashPassword, t as hashWithTiming, u as parseHtpasswdFile, v as validateRounds, w as validateUsername, x as verifyPassword } from '../hashing-Dnj0IAZf.js';

package/dist/tools/hashing.js

@@ -1,2 +1,2 @@
-export { HASH_ALGORITHMS, HASH_BITS, ROUND_OPTIONS, createEntry, generateBcryptHash, generateHtpasswdFile, generateMd5Hash, generatePlain, generateSha1Hash, hashAll, hashOne, hashPassword, hashWithTiming, parseHtpasswdFile, validateRounds, validateUsername, verifyPassword } from '../chunk-GEFVMGZR.js';
+export { HASH_ALGORITHMS, HASH_BITS, ROUND_OPTIONS, SRI_ALGORITHMS, createEntry, generateBcryptHash, generateHtpasswdFile, generateMd5Hash, generatePlain, generateSha1Hash, generateSri, generateSriAll, hashAll, hashOne, hashPassword, hashWithTiming, parseHtpasswdFile, validateRounds, validateUsername, verifyPassword } from '../chunk-VEVNIGJ6.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/network.cjs

@@ -2087,12 +2087,91 @@ function checkSetCookieHeader(header) {
   }
   return { cookie, issues, warnings, valid: issues.length === 0 };
 }
+function analyzeEmailHeaders(raw) {
+  if (typeof raw !== "string" || !raw.trim()) {
+    return { error: "Raw email header text is required" };
+  }
+  const normalized = raw.replace(/\r\n/g, "\n");
+  const blockEnd = normalized.indexOf("\n\n");
+  const headerBlock = blockEnd === -1 ? normalized : normalized.slice(0, blockEnd);
+  const rawLines = headerBlock.split("\n");
+  const unfolded = [];
+  for (const line of rawLines) {
+    if (/^[ \t]/.test(line) && unfolded.length > 0) {
+      unfolded[unfolded.length - 1] += " " + line.trim();
+    } else if (line.trim() !== "") {
+      unfolded.push(line);
+    }
+  }
+  const headers = [];
+  for (const line of unfolded) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const name = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (!name) continue;
+    headers.push({ name, value });
+  }
+  if (headers.length === 0) {
+    return { error: 'No parseable headers found \u2014 expected lines like "From: ..." or "Received: ..."' };
+  }
+  const findFirst = (name) => headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? null;
+  const findAll = (name) => headers.filter((h) => h.name.toLowerCase() === name.toLowerCase());
+  const receivedHops = findAll("received").map((h, i) => {
+    const fromMatch = h.value.match(/from\s+([^\s;]+(?:\s*\([^)]*\))?)/i);
+    const byMatch = h.value.match(/\bby\s+([^\s;]+)/i);
+    const segments = h.value.split(";");
+    const date = segments.length > 1 ? segments[segments.length - 1].trim() : null;
+    return {
+      index: i + 1,
+      raw: h.value,
+      from: fromMatch ? fromMatch[1].trim() : null,
+      by: byMatch ? byMatch[1].trim() : null,
+      date: date || null
+    };
+  });
+  const authResultsHeader = findFirst("authentication-results");
+  const authResults = [];
+  if (authResultsHeader) {
+    const re = /\b(spf|dkim|dmarc)=(\w+)/gi;
+    let m;
+    while ((m = re.exec(authResultsHeader)) !== null) {
+      authResults.push({ mechanism: m[1].toLowerCase(), result: m[2].toLowerCase() });
+    }
+  }
+  const findAuth = (mechanism) => authResults.find((a) => a.mechanism === mechanism)?.result ?? null;
+  const warnings = [];
+  if (receivedHops.length === 0) {
+    warnings.push("No Received headers found \u2014 this may be a partial header block rather than a full raw source.");
+  }
+  if (!authResultsHeader) {
+    warnings.push("No Authentication-Results header found \u2014 SPF/DKIM/DMARC cannot be determined from this header block alone.");
+  }
+  return {
+    headers,
+    from: findFirst("from"),
+    to: findFirst("to"),
+    subject: findFirst("subject"),
+    date: findFirst("date"),
+    messageId: findFirst("message-id"),
+    returnPath: findFirst("return-path"),
+    replyTo: findFirst("reply-to"),
+    receivedHops,
+    hopCount: receivedHops.length,
+    authResults,
+    spf: findAuth("spf"),
+    dkim: findAuth("dkim"),
+    dmarc: findAuth("dmarc"),
+    warnings
+  };
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
 exports.LINK_REL_VALUES = LINK_REL_VALUES;
 exports.REFERRER_POLICY_VALUES = REFERRER_POLICY_VALUES;
 exports.STATUS_CODES = STATUS_CODES;
+exports.analyzeEmailHeaders = analyzeEmailHeaders;
 exports.buildCacheControl = buildCacheControl;
 exports.buildDnsQueryUrl = buildDnsQueryUrl;
 exports.buildGeoUrl = buildGeoUrl;

package/dist/tools/network.d.cts

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

package/dist/tools/network.d.ts

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

package/dist/tools/network.js

@@ -1,2 +1,2 @@
-export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildReferrerPolicy, checkSetCookieHeader, 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-DBNTO3YO.js';
+export { DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, REFERRER_POLICY_VALUES, STATUS_CODES, analyzeEmailHeaders, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildLinkHeader, buildMapUrl, buildReferrerPolicy, checkSetCookieHeader, 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-Y4BVU76A.js';
 import '../chunk-MLKGABMK.js';

package/package.json

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