@fuzdev/fuz_util 0.53.0 → 0.53.1

package/README.md

@@ -9,9 +9,10 @@
 design:
 
 - kitchen-sink utilities library - sorry, I wish it weren't so, JS made me do it
-- two optional runtime dependencies on [`zod`](https://github.com/colinhacks/zod)
-  and [`esm-env`](https://github.com/benmccann/esm-env),
-  one optional type dependency on `@types/node`
+- all dependencies are optional ([`zod`](https://github.com/colinhacks/zod),
+  [`svelte`](https://github.com/sveltejs/svelte),
+  [`@fuzdev/blake3_wasm`](https://github.com/fuzdev/blake3),
+  [`esm-env`](https://github.com/benmccann/esm-env), `@types/node`, `@types/estree`)
 - mix of JS module environments - browser-only, Node-only, universal
 - mostly small pure functions
 - all TypeScript, for styles and Svelte and SvelteKit

package/dist/hash.d.ts

@@ -1,11 +1,19 @@
 /**
- * Hash utilities for content comparison and cache invalidation.
+ * Hash utilities using Web Crypto API and DJB2.
  *
- * Provides `hash_sha256` (Web Crypto, async) and `hash_insecure` (DJB2, fast non-cryptographic).
+ * Provides `hash_sha256`, `hash_sha384`, `hash_sha512`, `hash_sha1` (Web Crypto, async)
+ * and `hash_insecure` (DJB2, fast non-cryptographic).
  * For BLAKE3, see `hash_blake3` in `hash_blake3.ts`.
  *
  * @module
  */
+/**
+ * Computes a SHA-1 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 40-character hexadecimal hash string.
+ */
+export declare const hash_sha1: (data: BufferSource | string) => Promise<string>;
 /**
  * Computes a SHA-256 hash using Web Crypto API.
  *
@@ -13,6 +21,20 @@
  * @returns 64-character hexadecimal hash string.
  */
 export declare const hash_sha256: (data: BufferSource | string) => Promise<string>;
+/**
+ * Computes a SHA-384 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 96-character hexadecimal hash string.
+ */
+export declare const hash_sha384: (data: BufferSource | string) => Promise<string>;
+/**
+ * Computes a SHA-512 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 128-character hexadecimal hash string.
+ */
+export declare const hash_sha512: (data: BufferSource | string) => Promise<string>;
 /**
  * Computes a fast non-cryptographic hash using DJB2 algorithm.
  * Use for content comparison and cache keys, not security.

package/dist/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAU,MAAM,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,MAAM,CAI7E,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,MAkB3D,CAAC"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,MAAM,CACxC,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,MAAM,CACxC,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,MAAM,CACxC,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,MAAM,CACxC,CAAC;AAEjC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,MAkB3D,CAAC"}

package/dist/hash.js

@@ -1,7 +1,8 @@
 /**
- * Hash utilities for content comparison and cache invalidation.
+ * Hash utilities using Web Crypto API and DJB2.
  *
- * Provides `hash_sha256` (Web Crypto, async) and `hash_insecure` (DJB2, fast non-cryptographic).
+ * Provides `hash_sha256`, `hash_sha384`, `hash_sha512`, `hash_sha1` (Web Crypto, async)
+ * and `hash_insecure` (DJB2, fast non-cryptographic).
  * For BLAKE3, see `hash_blake3` in `hash_blake3.ts`.
  *
  * @module
@@ -9,16 +10,45 @@
 import { to_hex } from './hex.js';
 const encoder = new TextEncoder();
 /**
- * Computes a SHA-256 hash using Web Crypto API.
+ * Computes a hash using Web Crypto API.
  *
+ * @param algorithm - Web Crypto algorithm name (e.g. `'SHA-256'`).
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string.
+ * @returns hexadecimal hash string.
  */
-export const hash_sha256 = async (data) => {
+const hash_webcrypto = async (algorithm, data) => {
     const buffer = typeof data === 'string' ? encoder.encode(data) : data;
-    const digested = await crypto.subtle.digest('SHA-256', buffer);
+    const digested = await crypto.subtle.digest(algorithm, buffer);
     return to_hex(new Uint8Array(digested));
 };
+/**
+ * Computes a SHA-1 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 40-character hexadecimal hash string.
+ */
+export const hash_sha1 = (data) => hash_webcrypto('SHA-1', data);
+/**
+ * Computes a SHA-256 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 64-character hexadecimal hash string.
+ */
+export const hash_sha256 = (data) => hash_webcrypto('SHA-256', data);
+/**
+ * Computes a SHA-384 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 96-character hexadecimal hash string.
+ */
+export const hash_sha384 = (data) => hash_webcrypto('SHA-384', data);
+/**
+ * Computes a SHA-512 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 128-character hexadecimal hash string.
+ */
+export const hash_sha512 = (data) => hash_webcrypto('SHA-512', data);
 /**
  * Computes a fast non-cryptographic hash using DJB2 algorithm.
  * Use for content comparison and cache keys, not security.

package/dist/hex.d.ts

@@ -1,5 +1,5 @@
 /**
- * Hex encoding helpers.
+ * Hex encoding and decoding helpers.
  *
  * @module
  */
@@ -10,4 +10,12 @@
  * @returns Hex string with two characters per byte.
  */
 export declare const to_hex: (bytes: Uint8Array) => string;
+/**
+ * Decodes a hex string to a `Uint8Array`.
+ * Whitespace is stripped before parsing. Returns `null` for invalid hex.
+ *
+ * @param hex - Hex string to decode (case-insensitive, whitespace allowed).
+ * @returns Decoded bytes, or `null` if the input is not valid hex.
+ */
+export declare const from_hex: (hex: string) => Uint8Array | null;
 //# sourceMappingURL=hex.d.ts.map

package/dist/hex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,UAAU,KAAG,MAO1C,CAAC"}
+{"version":3,"file":"hex.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,UAAU,KAAG,MAO1C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,UAAU,GAAG,IAQnD,CAAC"}

package/dist/hex.js

@@ -1,5 +1,5 @@
 /**
- * Hex encoding helpers.
+ * Hex encoding and decoding helpers.
  *
  * @module
  */
@@ -17,6 +17,23 @@ export const to_hex = (bytes) => {
     }
     return hex;
 };
+/**
+ * Decodes a hex string to a `Uint8Array`.
+ * Whitespace is stripped before parsing. Returns `null` for invalid hex.
+ *
+ * @param hex - Hex string to decode (case-insensitive, whitespace allowed).
+ * @returns Decoded bytes, or `null` if the input is not valid hex.
+ */
+export const from_hex = (hex) => {
+    const clean = hex.replace(/\s/g, '');
+    if (clean.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(clean))
+        return null;
+    const bytes = new Uint8Array(clean.length / 2);
+    for (let i = 0; i < clean.length; i += 2) {
+        bytes[i / 2] = parseInt(clean.substring(i, i + 2), 16);
+    }
+    return bytes;
+};
 // Lazily computed lookup table for byte to hex conversion
 let byte_to_hex;
 const get_byte_to_hex = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_util",
-  "version": "0.53.0",
+  "version": "0.53.1",
   "description": "utility belt for JS",
   "glyph": "🦕",
   "logo": "logo.svg",
@@ -77,11 +77,11 @@
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/blake3_wasm": "^0.1.0",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.54.0",
+    "@fuzdev/fuz_css": "^0.55.0",
     "@fuzdev/fuz_ui": "^0.185.2",
-    "@fuzdev/gro": "^0.196.0",
+    "@fuzdev/gro": "^0.197.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.9.0",
+    "@ryanatkn/eslint-config": "^0.10.0",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.50.1",
     "@sveltejs/package": "^2.5.7",

package/src/lib/hash.ts

@@ -1,7 +1,8 @@
 /**
- * Hash utilities for content comparison and cache invalidation.
+ * Hash utilities using Web Crypto API and DJB2.
  *
- * Provides `hash_sha256` (Web Crypto, async) and `hash_insecure` (DJB2, fast non-cryptographic).
+ * Provides `hash_sha256`, `hash_sha384`, `hash_sha512`, `hash_sha1` (Web Crypto, async)
+ * and `hash_insecure` (DJB2, fast non-cryptographic).
  * For BLAKE3, see `hash_blake3` in `hash_blake3.ts`.
  *
  * @module
@@ -12,17 +13,54 @@ import {to_hex} from './hex.js';
 const encoder = new TextEncoder();
 
 /**
- * Computes a SHA-256 hash using Web Crypto API.
+ * Computes a hash using Web Crypto API.
  *
+ * @param algorithm - Web Crypto algorithm name (e.g. `'SHA-256'`).
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string.
+ * @returns hexadecimal hash string.
  */
-export const hash_sha256 = async (data: BufferSource | string): Promise<string> => {
+const hash_webcrypto = async (algorithm: string, data: BufferSource | string): Promise<string> => {
 	const buffer = typeof data === 'string' ? encoder.encode(data) : data;
-	const digested = await crypto.subtle.digest('SHA-256', buffer);
+	const digested = await crypto.subtle.digest(algorithm, buffer);
 	return to_hex(new Uint8Array(digested));
 };
 
+/**
+ * Computes a SHA-1 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 40-character hexadecimal hash string.
+ */
+export const hash_sha1 = (data: BufferSource | string): Promise<string> =>
+	hash_webcrypto('SHA-1', data);
+
+/**
+ * Computes a SHA-256 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 64-character hexadecimal hash string.
+ */
+export const hash_sha256 = (data: BufferSource | string): Promise<string> =>
+	hash_webcrypto('SHA-256', data);
+
+/**
+ * Computes a SHA-384 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 96-character hexadecimal hash string.
+ */
+export const hash_sha384 = (data: BufferSource | string): Promise<string> =>
+	hash_webcrypto('SHA-384', data);
+
+/**
+ * Computes a SHA-512 hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @returns 128-character hexadecimal hash string.
+ */
+export const hash_sha512 = (data: BufferSource | string): Promise<string> =>
+	hash_webcrypto('SHA-512', data);
+
 /**
  * Computes a fast non-cryptographic hash using DJB2 algorithm.
  * Use for content comparison and cache keys, not security.

package/src/lib/hex.ts

@@ -1,5 +1,5 @@
 /**
- * Hex encoding helpers.
+ * Hex encoding and decoding helpers.
  *
  * @module
  */
@@ -19,6 +19,23 @@ export const to_hex = (bytes: Uint8Array): string => {
 	return hex;
 };
 
+/**
+ * Decodes a hex string to a `Uint8Array`.
+ * Whitespace is stripped before parsing. Returns `null` for invalid hex.
+ *
+ * @param hex - Hex string to decode (case-insensitive, whitespace allowed).
+ * @returns Decoded bytes, or `null` if the input is not valid hex.
+ */
+export const from_hex = (hex: string): Uint8Array | null => {
+	const clean = hex.replace(/\s/g, '');
+	if (clean.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(clean)) return null;
+	const bytes = new Uint8Array(clean.length / 2);
+	for (let i = 0; i < clean.length; i += 2) {
+		bytes[i / 2] = parseInt(clean.substring(i, i + 2), 16);
+	}
+	return bytes;
+};
+
 // Lazily computed lookup table for byte to hex conversion
 let byte_to_hex: Array<string> | undefined;
 const get_byte_to_hex = (): Array<string> => {