@fgv/ts-web-extras 5.0.0

package/lib/test/utils/testHelpers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Test utilities for mocking browser APIs
+ */
+/**
+ * Mock file data structure
+ */
+export interface MockFileData {
+    name: string;
+    content: string;
+    type?: string;
+    lastModified?: number;
+    webkitRelativePath?: string;
+}
+/**
+ * Create a mock File object with all necessary properties and methods
+ */
+export declare function createMockFile(data: MockFileData): File;
+/**
+ * Create a mock FileList using DataTransfer API
+ * This is the most reliable method for creating FileList objects in tests
+ */
+export declare function createMockFileList(files: MockFileData[]): FileList;
+/**
+ * Create a mock FileList for directory upload simulation
+ * Includes webkitRelativePath for each file
+ */
+export declare function createMockDirectoryFileList(directoryStructure: Array<{
+    path: string;
+    content: string;
+    type?: string;
+}>): FileList;
+/**
+ * Helper to create a promise that resolves after a delay
+ * Useful for testing async operations
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Helper to verify File API text() method works correctly
+ * Since we're using Blob/File polyfills, this ensures they have the right methods
+ */
+export declare function verifyFileAPI(file: File): Promise<boolean>;
+/**
+ * Mock Web Crypto digest result for testing
+ * Creates a deterministic hash-like ArrayBuffer
+ */
+export declare function createMockDigest(input: string, algorithm?: string): ArrayBuffer;
+/**
+ * Convert ArrayBuffer to hex string for comparison in tests
+ */
+export declare function arrayBufferToHex(buffer: ArrayBuffer): string;
+//# sourceMappingURL=testHelpers.d.ts.map

package/lib/test/utils/testHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHelpers.d.ts","sourceRoot":"","sources":["../../../src/test/utils/testHelpers.ts"],"names":[],"mappings":"AAsBA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA0BvD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,QAAQ,CAUlE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1E,QAAQ,CASV;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAYhE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,WAAW,CAa1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAK5D"}

package/lib/test/utils/testHelpers.js

@@ -0,0 +1,133 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMockFile = createMockFile;
+exports.createMockFileList = createMockFileList;
+exports.createMockDirectoryFileList = createMockDirectoryFileList;
+exports.delay = delay;
+exports.verifyFileAPI = verifyFileAPI;
+exports.createMockDigest = createMockDigest;
+exports.arrayBufferToHex = arrayBufferToHex;
+/**
+ * Create a mock File object with all necessary properties and methods
+ */
+function createMockFile(data) {
+    const blob = new Blob([data.content], { type: data.type || 'text/plain' });
+    const file = new File([blob], data.name, {
+        type: data.type || 'text/plain',
+        lastModified: data.lastModified || Date.now()
+    });
+    // Add webkitRelativePath if provided (for directory uploads)
+    if (data.webkitRelativePath) {
+        Object.defineProperty(file, 'webkitRelativePath', {
+            value: data.webkitRelativePath,
+            writable: false,
+            configurable: true
+        });
+    }
+    // Ensure text() method works properly
+    if (!file.text || typeof file.text !== 'function') {
+        Object.defineProperty(file, 'text', {
+            value: () => Promise.resolve(data.content),
+            writable: false,
+            configurable: true
+        });
+    }
+    return file;
+}
+/**
+ * Create a mock FileList using DataTransfer API
+ * This is the most reliable method for creating FileList objects in tests
+ */
+function createMockFileList(files) {
+    // Use DataTransfer to create a proper FileList
+    const dt = new DataTransfer();
+    files.forEach((fileData) => {
+        const file = createMockFile(fileData);
+        dt.items.add(file);
+    });
+    return dt.files;
+}
+/**
+ * Create a mock FileList for directory upload simulation
+ * Includes webkitRelativePath for each file
+ */
+function createMockDirectoryFileList(directoryStructure) {
+    const files = directoryStructure.map((item) => ({
+        name: item.path.split('/').pop() || '',
+        content: item.content,
+        type: item.type,
+        webkitRelativePath: item.path
+    }));
+    return createMockFileList(files);
+}
+/**
+ * Helper to create a promise that resolves after a delay
+ * Useful for testing async operations
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Helper to verify File API text() method works correctly
+ * Since we're using Blob/File polyfills, this ensures they have the right methods
+ */
+async function verifyFileAPI(file) {
+    try {
+        // Check if text() method exists and works
+        if (typeof file.text !== 'function') {
+            throw new Error('File.text() method not available');
+        }
+        const text = await file.text();
+        return typeof text === 'string';
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Mock Web Crypto digest result for testing
+ * Creates a deterministic hash-like ArrayBuffer
+ */
+function createMockDigest(input, algorithm = 'SHA-256') {
+    // Create a deterministic "hash" based on input for testing
+    // This is not a real hash but good enough for testing
+    const hashLength = algorithm.includes('256') ? 32 : algorithm.includes('512') ? 64 : 20;
+    const buffer = new ArrayBuffer(hashLength);
+    const view = new Uint8Array(buffer);
+    // Fill with deterministic values based on input
+    for (let i = 0; i < hashLength; i++) {
+        view[i] = (input.charCodeAt(i % input.length) + i) % 256;
+    }
+    return buffer;
+}
+/**
+ * Convert ArrayBuffer to hex string for comparison in tests
+ */
+function arrayBufferToHex(buffer) {
+    const view = new Uint8Array(buffer);
+    return Array.from(view)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+//# sourceMappingURL=testHelpers.js.map

package/lib/test/utils/testHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHelpers.js","sourceRoot":"","sources":["../../../src/test/utils/testHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Test utilities for mocking browser APIs\n */\n\n/**\n * Mock file data structure\n */\nexport interface MockFileData {\n  name: string;\n  content: string;\n  type?: string;\n  lastModified?: number;\n  webkitRelativePath?: string;\n}\n\n/**\n * Create a mock File object with all necessary properties and methods\n */\nexport function createMockFile(data: MockFileData): File {\n  const blob = new Blob([data.content], { type: data.type || 'text/plain' });\n  const file = new File([blob], data.name, {\n    type: data.type || 'text/plain',\n    lastModified: data.lastModified || Date.now()\n  });\n\n  // Add webkitRelativePath if provided (for directory uploads)\n  if (data.webkitRelativePath) {\n    Object.defineProperty(file, 'webkitRelativePath', {\n      value: data.webkitRelativePath,\n      writable: false,\n      configurable: true\n    });\n  }\n\n  // Ensure text() method works properly\n  if (!file.text || typeof file.text !== 'function') {\n    Object.defineProperty(file, 'text', {\n      value: () => Promise.resolve(data.content),\n      writable: false,\n      configurable: true\n    });\n  }\n\n  return file;\n}\n\n/**\n * Create a mock FileList using DataTransfer API\n * This is the most reliable method for creating FileList objects in tests\n */\nexport function createMockFileList(files: MockFileData[]): FileList {\n  // Use DataTransfer to create a proper FileList\n  const dt = new DataTransfer();\n\n  files.forEach((fileData) => {\n    const file = createMockFile(fileData);\n    dt.items.add(file);\n  });\n\n  return dt.files;\n}\n\n/**\n * Create a mock FileList for directory upload simulation\n * Includes webkitRelativePath for each file\n */\nexport function createMockDirectoryFileList(\n  directoryStructure: Array<{ path: string; content: string; type?: string }>\n): FileList {\n  const files = directoryStructure.map((item) => ({\n    name: item.path.split('/').pop() || '',\n    content: item.content,\n    type: item.type,\n    webkitRelativePath: item.path\n  }));\n\n  return createMockFileList(files);\n}\n\n/**\n * Helper to create a promise that resolves after a delay\n * Useful for testing async operations\n */\nexport function delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Helper to verify File API text() method works correctly\n * Since we're using Blob/File polyfills, this ensures they have the right methods\n */\nexport async function verifyFileAPI(file: File): Promise<boolean> {\n  try {\n    // Check if text() method exists and works\n    if (typeof file.text !== 'function') {\n      throw new Error('File.text() method not available');\n    }\n\n    const text = await file.text();\n    return typeof text === 'string';\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Mock Web Crypto digest result for testing\n * Creates a deterministic hash-like ArrayBuffer\n */\nexport function createMockDigest(input: string, algorithm: string = 'SHA-256'): ArrayBuffer {\n  // Create a deterministic \"hash\" based on input for testing\n  // This is not a real hash but good enough for testing\n  const hashLength = algorithm.includes('256') ? 32 : algorithm.includes('512') ? 64 : 20;\n  const buffer = new ArrayBuffer(hashLength);\n  const view = new Uint8Array(buffer);\n\n  // Fill with deterministic values based on input\n  for (let i = 0; i < hashLength; i++) {\n    view[i] = (input.charCodeAt(i % input.length) + i) % 256;\n  }\n\n  return buffer;\n}\n\n/**\n * Convert ArrayBuffer to hex string for comparison in tests\n */\nexport function arrayBufferToHex(buffer: ArrayBuffer): string {\n  const view = new Uint8Array(buffer);\n  return Array.from(view)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n"]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@fgv/ts-web-extras",
+  "version": "5.0.0",
+  "description": "Browser-compatible utilities and FileTree implementations",
+  "main": "lib/index.js",
+  "types": "dist/ts-web-extras.d.ts",
+  "sideEffects": false,
+  "keywords": [
+    "browser",
+    "web",
+    "filetree",
+    "crypto",
+    "typescript"
+  ],
+  "author": "Erik Fortune",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ErikFortune/fgv/issues"
+  },
+  "homepage": "https://github.com/ErikFortune/fgv/tree/main/libraries/ts-web-extras#readme",
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.26.31",
+    "@microsoft/api-extractor": "^7.52.10",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.14.9",
+    "@typescript-eslint/eslint-plugin": "^8.42.0",
+    "@typescript-eslint/parser": "^8.42.0",
+    "eslint": "^9.35.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "jest": "^29.7.0",
+    "jest-extended": "^4.0.2",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.4.1",
+    "ts-node": "^10.9.2",
+    "typescript": "5.8.3",
+    "eslint-plugin-n": "^17.21.3",
+    "@rushstack/eslint-config": "4.4.0",
+    "@rushstack/heft": "0.74.4",
+    "@rushstack/heft-jest-plugin": "0.16.13",
+    "@rushstack/heft-node-rig": "2.9.5",
+    "@types/heft-jest": "1.0.6",
+    "eslint-plugin-tsdoc": "~0.4.0",
+    "@rushstack/eslint-patch": "~1.12.0",
+    "@types/react": "~19.1.10",
+    "@fgv/ts-utils": "5.0.0-31",
+    "@fgv/ts-json-base": "5.0.0-31",
+    "@fgv/ts-utils-jest": "5.0.0-31"
+  },
+  "peerDependencies": {
+    "react": "~19.1.1",
+    "@fgv/ts-utils": "5.0.0-31",
+    "@fgv/ts-json-base": "5.0.0-31"
+  },
+  "scripts": {
+    "build": "heft test --clean",
+    "clean": "heft clean",
+    "test": "heft test --clean",
+    "build-docs": "api-documenter markdown --input-folder ./temp --output-folder docs",
+    "build-all": "rushx build; rushx build-docs",
+    "test-handles": "jest --runInBand --detectOpenHandles",
+    "clean-jest": "jest --clear-cache",
+    "coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "fixlint": "eslint src --ext .ts --fix"
+  }
+}

package/rush-logs/ts-web-extras.build.cache.log

@@ -0,0 +1,3 @@
+Caching build output folders: dist, lib, temp, .rush/temp/operation/build
+Successfully set cache entry.
+Cache key: 86c9c1ad46e237e0b957c2442bf0355cf39babba

package/rush-logs/ts-web-extras.build.log

@@ -0,0 +1,40 @@
+Invoking: heft test --clean 
+ ---- build started ---- 
+[build:typescript] Using TypeScript version 5.8.3
+[build:api-extractor] Using API Extractor version 7.52.12
+[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2
+ ---- build finished (23.041s) ---- 
+ ---- test started ---- 
+[test:jest] Using Jest version 29.5.0
+[test:jest] 
+[test:jest] Run start. 5 test suites
+[test:jest] START lib/test/unit/fileApiTreeAccessors.test.js
+[test:jest] START lib/test/unit/fileTreeHelpers.test.js
+[test:jest] START lib/test/unit/fileApiTypes.test.js
+[test:jest] START lib/test/unit/urlParams.test.js
+[test:jest] PASS lib/test/unit/fileApiTreeAccessors.test.js (duration: 1.740s, 63 passed, 0 failed)
+[test:jest] START lib/test/unit/browserHashProvider.test.js
+[test:jest] PASS lib/test/unit/urlParams.test.js (duration: 0.589s, 60 passed, 0 failed)
+[test:jest] PASS lib/test/unit/fileApiTypes.test.js (duration: 1.906s, 33 passed, 0 failed)
+[test:jest] PASS lib/test/unit/fileTreeHelpers.test.js (duration: 2.165s, 35 passed, 0 failed)
+[test:jest] PASS lib/test/unit/browserHashProvider.test.js (duration: 0.609s, 15 passed, 0 failed)
+[test:jest] 
+[test:jest] Tests finished:
+[test:jest]   Successes: 206
+[test:jest]   Failures: 0
+[test:jest]   Total: 207
+--------------------------|---------|----------|---------|---------|-------------------
+File                      | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
+--------------------------|---------|----------|---------|---------|-------------------
+All files                 |     100 |      100 |     100 |     100 |                   
+ crypto                   |     100 |      100 |     100 |     100 |                   
+  browserHashProvider.ts  |     100 |      100 |     100 |     100 |                   
+ file-tree                |     100 |      100 |     100 |     100 |                   
+  fileApiTreeAccessors.ts |     100 |      100 |     100 |     100 |                   
+ helpers                  |     100 |      100 |     100 |     100 |                   
+  fileTreeHelpers.ts      |     100 |      100 |     100 |     100 |                   
+ url-utils                |     100 |      100 |     100 |     100 |                   
+  urlParams.ts            |     100 |      100 |     100 |     100 |                   
+--------------------------|---------|----------|---------|---------|-------------------
+ ---- test finished (5.486s) ---- 
+-------------------- Finished (28.542s) --------------------

package/src/index.ts

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * Browser-compatible utilities and FileTree implementations.
+ *
+ * This library provides browser-compatible alternatives to Node.js-specific functionality,
+ * including Web Crypto API-based hashing, File API-based file tree implementations,
+ * and URL parameter parsing utilities.
+ * All exports are designed to be tree-shakeable for optimal bundle size.
+ *
+ * @packageDocumentation
+ */
+
+// Export crypto functionality
+export * from './packlets/crypto';
+
+// Export file tree functionality
+export * from './packlets/file-tree';
+
+// Export helper functions
+export * from './packlets/helpers';
+
+// Export File System Access API types
+export * from './packlets/file-api-types';
+
+// Export URL utilities
+export * from './packlets/url-utils';

package/src/packlets/crypto/browserHashProvider.ts

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Result, succeed, fail } from '@fgv/ts-utils';
+
+/**
+ * Browser-compatible hash provider using the Web Crypto API.
+ * Supports common hash algorithms available in browsers.
+ * @public
+ */
+export class BrowserHashProvider {
+  /**
+   * Hash a string using the specified algorithm.
+   * @param data - The string to hash
+   * @param algorithm - The hash algorithm to use
+   * @returns Promise resolving to the hex-encoded hash
+   */
+  public static async hashString(data: string, algorithm: string = 'SHA-256'): Promise<Result<string>> {
+    try {
+      /* c8 ignore next 3 - defense in depth */
+      if (!crypto.subtle) {
+        return fail('Web Crypto API not available in this environment');
+      }
+
+      const encoder = new TextEncoder();
+      const dataBuffer = encoder.encode(data);
+      const hashBuffer = await crypto.subtle.digest(algorithm, dataBuffer);
+      const hashArray = new Uint8Array(hashBuffer);
+      const hashHex = Array.from(hashArray)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+
+      return succeed(hashHex);
+    } catch (error) {
+      return fail(`Hash computation failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  /**
+   * Hash multiple strings concatenated with a separator.
+   * @param parts - Array of strings to concatenate and hash
+   * @param algorithm - The hash algorithm to use
+   * @param separator - Separator to use between parts (default: '|')
+   * @returns Promise resolving to the hex-encoded hash
+   */
+  public static async hashParts(
+    parts: string[],
+    algorithm: string = 'SHA-256',
+    separator: string = '|'
+  ): Promise<Result<string>> {
+    const combined = parts.join(separator);
+    return this.hashString(combined, algorithm);
+  }
+}

package/src/packlets/crypto/index.ts

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * Browser-compatible cryptographic utilities using the Web Crypto API.
+ * @packageDocumentation
+ */
+
+export * from './browserHashProvider';