@fuzdev/fuz_util 0.48.1 → 0.48.3

package/dist/hash.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hash utilities for content comparison and cache invalidation.
+ *
+ * Provides both secure (cryptographic) and insecure (fast) hash functions.
+ *
+ * @module
+ */
+/**
+ * Computes a cryptographic hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @param algorithm - Hash algorithm. Defaults to SHA-256.
+ * @returns Hexadecimal hash string.
+ */
+export declare const hash_secure: (data: BufferSource | string, algorithm?: "SHA-256" | "SHA-384" | "SHA-512") => Promise<string>;
+/**
+ * Computes a fast non-cryptographic hash using DJB2 algorithm.
+ * Use for content comparison and cache keys, not security.
+ *
+ * Note: Strings use UTF-16 code units, buffers use raw bytes.
+ * For non-ASCII, `hash_insecure(str) !== hash_insecure(encoder.encode(str))`.
+ *
+ * @param data - String or binary data to hash.
+ * @returns 8-character hex-encoded unsigned 32-bit hash.
+ */
+export declare const hash_insecure: (data: BufferSource | string) => string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACvB,MAAM,YAAY,GAAG,MAAM,EAC3B,YAAW,SAAS,GAAG,SAAS,GAAG,SAAqB,KACtD,OAAO,CAAC,MAAM,CAUhB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,MAkB3D,CAAC"}

package/dist/hash.js

@@ -0,0 +1,66 @@
+/**
+ * Hash utilities for content comparison and cache invalidation.
+ *
+ * Provides both secure (cryptographic) and insecure (fast) hash functions.
+ *
+ * @module
+ */
+const encoder = new TextEncoder();
+// Lazily computed lookup table for byte to hex conversion
+let byte_to_hex;
+const get_byte_to_hex = () => {
+    if (byte_to_hex === undefined) {
+        byte_to_hex = new Array(256); // 256 possible byte values (0x00-0xff)
+        for (let i = 0; i < 256; i++) {
+            byte_to_hex[i] = i.toString(16).padStart(2, '0');
+        }
+    }
+    return byte_to_hex;
+};
+/**
+ * Computes a cryptographic hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @param algorithm - Hash algorithm. Defaults to SHA-256.
+ * @returns Hexadecimal hash string.
+ */
+export const hash_secure = async (data, algorithm = 'SHA-256') => {
+    const buffer = typeof data === 'string' ? encoder.encode(data) : data;
+    const digested = await crypto.subtle.digest(algorithm, buffer);
+    const bytes = new Uint8Array(digested);
+    const lookup = get_byte_to_hex();
+    let hex = '';
+    for (const byte of bytes) {
+        hex += lookup[byte];
+    }
+    return hex;
+};
+/**
+ * Computes a fast non-cryptographic hash using DJB2 algorithm.
+ * Use for content comparison and cache keys, not security.
+ *
+ * Note: Strings use UTF-16 code units, buffers use raw bytes.
+ * For non-ASCII, `hash_insecure(str) !== hash_insecure(encoder.encode(str))`.
+ *
+ * @param data - String or binary data to hash.
+ * @returns 8-character hex-encoded unsigned 32-bit hash.
+ */
+export const hash_insecure = (data) => {
+    let hash = 5381; // DJB2 initial value, chosen empirically for good distribution
+    if (typeof data === 'string') {
+        for (let i = 0; i < data.length; i++) {
+            hash = (hash << 5) - hash + data.charCodeAt(i);
+        }
+    }
+    else {
+        const bytes = data instanceof Uint8Array
+            ? data
+            : data instanceof ArrayBuffer
+                ? new Uint8Array(data)
+                : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+        for (const byte of bytes) {
+            hash = (hash << 5) - hash + byte;
+        }
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+};

package/dist/process.d.ts

@@ -84,6 +84,16 @@ export interface DespawnOptions {
      */
     timeout_ms?: number;
 }
+/**
+ * Result of spawning a detached process.
+ */
+export type SpawnDetachedResult = {
+    ok: true;
+    child: ChildProcess;
+} | {
+    ok: false;
+    message: string;
+};
 /**
  * Handle for a spawned process with access to the child and completion promise.
  */
@@ -249,6 +259,33 @@ export declare const despawn_all: (options?: DespawnOptions) => Promise<Array<Sp
  * @see ProcessRegistry.attach_error_handler
  */
 export declare const attach_process_error_handler: (options?: Parameters<ProcessRegistry["attach_error_handler"]>[0]) => (() => void);
+/**
+ * Spawns a detached process that continues after parent exits.
+ *
+ * Unlike other spawn functions, this is NOT tracked in any ProcessRegistry.
+ * The spawned process is meant to outlive the parent (e.g., daemon processes).
+ *
+ * @param command - The command to run
+ * @param args - Arguments to pass to the command
+ * @param options - Spawn options (use `stdio` to redirect output to file descriptors)
+ * @returns Result with pid on success, or error message on failure
+ *
+ * @example
+ * ```ts
+ * // Simple detached process
+ * const result = spawn_detached('node', ['daemon.js'], {cwd: '/app'});
+ *
+ * // With log file (caller handles file opening)
+ * import {openSync, closeSync} from 'node:fs';
+ * const log_fd = openSync('/var/log/daemon.log', 'a');
+ * const result = spawn_detached('node', ['daemon.js'], {
+ *   cwd: '/app',
+ *   stdio: ['ignore', log_fd, log_fd],
+ * });
+ * closeSync(log_fd);
+ * ```
+ */
+export declare const spawn_detached: (command: string, args?: ReadonlyArray<string>, options?: SpawnOptions) => SpawnDetachedResult;
 /**
  * Formats a child process for display.
  *

package/dist/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/process.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/process.ts"],"names":[],"mappings":"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"}

package/dist/process.js

@@ -351,6 +351,50 @@ export const despawn_all = (options) => process_registry_default.despawn_all(opt
  * @see ProcessRegistry.attach_error_handler
  */
 export const attach_process_error_handler = (options) => process_registry_default.attach_error_handler(options);
+/**
+ * Spawns a detached process that continues after parent exits.
+ *
+ * Unlike other spawn functions, this is NOT tracked in any ProcessRegistry.
+ * The spawned process is meant to outlive the parent (e.g., daemon processes).
+ *
+ * @param command - The command to run
+ * @param args - Arguments to pass to the command
+ * @param options - Spawn options (use `stdio` to redirect output to file descriptors)
+ * @returns Result with pid on success, or error message on failure
+ *
+ * @example
+ * ```ts
+ * // Simple detached process
+ * const result = spawn_detached('node', ['daemon.js'], {cwd: '/app'});
+ *
+ * // With log file (caller handles file opening)
+ * import {openSync, closeSync} from 'node:fs';
+ * const log_fd = openSync('/var/log/daemon.log', 'a');
+ * const result = spawn_detached('node', ['daemon.js'], {
+ *   cwd: '/app',
+ *   stdio: ['ignore', log_fd, log_fd],
+ * });
+ * closeSync(log_fd);
+ * ```
+ */
+export const spawn_detached = (command, args = [], options) => {
+    try {
+        const child = node_spawn_child_process(command, args, {
+            stdio: 'ignore',
+            ...options,
+            detached: true,
+        });
+        // Allow parent to exit independently
+        child.unref();
+        if (child.pid === undefined) {
+            return { ok: false, message: 'Failed to get child PID' };
+        }
+        return { ok: true, child };
+    }
+    catch (error) {
+        return { ok: false, message: error instanceof Error ? error.message : String(error) };
+    }
+};
 //
 // Formatting Utilities
 //

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_util",
-  "version": "0.48.1",
+  "version": "0.48.3",
   "description": "utility belt for JS",
   "glyph": "🦕",
   "logo": "logo.svg",
@@ -61,11 +61,11 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/fuz_code": "^0.40.0",
-    "@fuzdev/fuz_css": "^0.44.1",
-    "@fuzdev/fuz_ui": "^0.179.0",
+    "@fuzdev/fuz_code": "^0.41.0",
+    "@fuzdev/fuz_css": "^0.45.0",
+    "@fuzdev/fuz_ui": "^0.180.0",
     "@ryanatkn/eslint-config": "^0.9.0",
-    "@ryanatkn/gro": "^0.189.0",
+    "@ryanatkn/gro": "^0.189.3",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.50.1",
     "@sveltejs/package": "^2.5.7",
@@ -79,8 +79,8 @@
     "fast-deep-equal": "^3.1.3",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.4.1",
-    "svelte": "^5.48.2",
-    "svelte-check": "^4.3.4",
+    "svelte": "^5.48.5",
+    "svelte-check": "^4.3.5",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",

package/src/lib/hash.ts

@@ -0,0 +1,73 @@
+/**
+ * Hash utilities for content comparison and cache invalidation.
+ *
+ * Provides both secure (cryptographic) and insecure (fast) hash functions.
+ *
+ * @module
+ */
+
+const encoder = new TextEncoder();
+
+// Lazily computed lookup table for byte to hex conversion
+let byte_to_hex: Array<string> | undefined;
+const get_byte_to_hex = (): Array<string> => {
+	if (byte_to_hex === undefined) {
+		byte_to_hex = new Array(256); // 256 possible byte values (0x00-0xff)
+		for (let i = 0; i < 256; i++) {
+			byte_to_hex[i] = i.toString(16).padStart(2, '0');
+		}
+	}
+	return byte_to_hex;
+};
+
+/**
+ * Computes a cryptographic hash using Web Crypto API.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded.
+ * @param algorithm - Hash algorithm. Defaults to SHA-256.
+ * @returns Hexadecimal hash string.
+ */
+export const hash_secure = async (
+	data: BufferSource | string,
+	algorithm: 'SHA-256' | 'SHA-384' | 'SHA-512' = 'SHA-256',
+): Promise<string> => {
+	const buffer = typeof data === 'string' ? encoder.encode(data) : data;
+	const digested = await crypto.subtle.digest(algorithm, buffer);
+	const bytes = new Uint8Array(digested);
+	const lookup = get_byte_to_hex();
+	let hex = '';
+	for (const byte of bytes) {
+		hex += lookup[byte];
+	}
+	return hex;
+};
+
+/**
+ * Computes a fast non-cryptographic hash using DJB2 algorithm.
+ * Use for content comparison and cache keys, not security.
+ *
+ * Note: Strings use UTF-16 code units, buffers use raw bytes.
+ * For non-ASCII, `hash_insecure(str) !== hash_insecure(encoder.encode(str))`.
+ *
+ * @param data - String or binary data to hash.
+ * @returns 8-character hex-encoded unsigned 32-bit hash.
+ */
+export const hash_insecure = (data: BufferSource | string): string => {
+	let hash = 5381; // DJB2 initial value, chosen empirically for good distribution
+	if (typeof data === 'string') {
+		for (let i = 0; i < data.length; i++) {
+			hash = (hash << 5) - hash + data.charCodeAt(i);
+		}
+	} else {
+		const bytes: Uint8Array =
+			data instanceof Uint8Array
+				? data
+				: data instanceof ArrayBuffer
+					? new Uint8Array(data)
+					: new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+		for (const byte of bytes) {
+			hash = (hash << 5) - hash + byte;
+		}
+	}
+	return (hash >>> 0).toString(16).padStart(8, '0');
+};

package/src/lib/process.ts

@@ -120,6 +120,11 @@ export interface DespawnOptions {
 	timeout_ms?: number;
 }
 
+/**
+ * Result of spawning a detached process.
+ */
+export type SpawnDetachedResult = {ok: true; child: ChildProcess} | {ok: false; message: string};
+
 //
 // Process Handle Types
 //
@@ -553,6 +558,57 @@ export const attach_process_error_handler = (
 	options?: Parameters<ProcessRegistry['attach_error_handler']>[0],
 ): (() => void) => process_registry_default.attach_error_handler(options);
 
+/**
+ * Spawns a detached process that continues after parent exits.
+ *
+ * Unlike other spawn functions, this is NOT tracked in any ProcessRegistry.
+ * The spawned process is meant to outlive the parent (e.g., daemon processes).
+ *
+ * @param command - The command to run
+ * @param args - Arguments to pass to the command
+ * @param options - Spawn options (use `stdio` to redirect output to file descriptors)
+ * @returns Result with pid on success, or error message on failure
+ *
+ * @example
+ * ```ts
+ * // Simple detached process
+ * const result = spawn_detached('node', ['daemon.js'], {cwd: '/app'});
+ *
+ * // With log file (caller handles file opening)
+ * import {openSync, closeSync} from 'node:fs';
+ * const log_fd = openSync('/var/log/daemon.log', 'a');
+ * const result = spawn_detached('node', ['daemon.js'], {
+ *   cwd: '/app',
+ *   stdio: ['ignore', log_fd, log_fd],
+ * });
+ * closeSync(log_fd);
+ * ```
+ */
+export const spawn_detached = (
+	command: string,
+	args: ReadonlyArray<string> = [],
+	options?: SpawnOptions,
+): SpawnDetachedResult => {
+	try {
+		const child = node_spawn_child_process(command, args, {
+			stdio: 'ignore',
+			...options,
+			detached: true,
+		});
+
+		// Allow parent to exit independently
+		child.unref();
+
+		if (child.pid === undefined) {
+			return {ok: false, message: 'Failed to get child PID'};
+		}
+
+		return {ok: true, child};
+	} catch (error) {
+		return {ok: false, message: error instanceof Error ? error.message : String(error)};
+	}
+};
+
 //
 // Formatting Utilities
 //