@fgv/ts-web-extras 5.1.0-3 → 5.1.0-31

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

@@ -1 +0,0 @@
-{"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/rush-logs/ts-web-extras.build.cache.log

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

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

@@ -1,55 +0,0 @@
-Invoking: heft test --clean 
- ---- build started ---- 
-[build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.
-[build:typescript] Using TypeScript version 5.9.3
-[build:api-extractor] Using API Extractor version 7.57.6
-[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2
-[build:api-extractor] *** The target project appears to use TypeScript 5.9.3 which is newer than the bundled compiler engine; consider upgrading API Extractor.
- ---- build finished (24.830s) ---- 
- ---- test started ---- 
-[test:jest] Using Jest version 29.5.0
-[test:jest] 
-[test:jest] Run start. 9 test suites
-[test:jest] START lib/test/unit/fileApiTreeAccessors.test.js
-[test:jest] START lib/test/unit/httpTreeAccessors.test.js
-[test:jest] START lib/test/unit/localStorageTreeAccessors.test.js
-[test:jest] START lib/test/unit/fileSystemAccessTreeAccessors.test.js
-[test:jest] PASS lib/test/unit/localStorageTreeAccessors.test.js (duration: 1.749s, 44 passed, 0 failed)
-[test:jest] START lib/test/unit/fileTreeHelpers.test.js
-[test:jest] PASS lib/test/unit/fileApiTreeAccessors.test.js (duration: 2.021s, 65 passed, 0 failed)
-[test:jest] START lib/test/unit/fileApiTypes.test.js
-[test:jest] PASS lib/test/unit/httpTreeAccessors.test.js (duration: 2.316s, 57 passed, 0 failed)
-[test:jest] START lib/test/unit/urlParams.test.js
-[test:jest] PASS lib/test/unit/fileSystemAccessTreeAccessors.test.js (duration: 1.352s, 44 passed, 0 failed)
-[test:jest] START lib/test/unit/directoryHandleStore.test.js
-[test:jest] PASS lib/test/unit/fileTreeHelpers.test.js (duration: 1.538s, 35 passed, 0 failed)
-[test:jest] START lib/test/unit/browserHashProvider.test.js
-[test:jest] PASS lib/test/unit/fileApiTypes.test.js (duration: 1.440s, 36 passed, 0 failed)
-[test:jest] PASS lib/test/unit/urlParams.test.js (duration: 1.637s, 60 passed, 0 failed)
-[test:jest] PASS lib/test/unit/directoryHandleStore.test.js (duration: 1.412s, 19 passed, 0 failed)
-[test:jest] PASS lib/test/unit/browserHashProvider.test.js (duration: 1.586s, 15 passed, 0 failed)
-[test:jest] 
-[test:jest] Tests finished:
-[test:jest]   Successes: 375
-[test:jest]   Failures: 0
-[test:jest]   Total: 376
------------------------------------|---------|----------|---------|---------|-------------------
-File                               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
------------------------------------|---------|----------|---------|---------|-------------------
-All files                          |     100 |    99.62 |     100 |     100 |                   
- crypto-utils                      |     100 |      100 |     100 |     100 |                   
-  browserCryptoProvider.ts         |     100 |      100 |     100 |     100 |                   
-  browserHashProvider.ts           |     100 |      100 |     100 |     100 |                   
- file-tree                         |     100 |    99.57 |     100 |     100 |                   
-  directoryHandleStore.ts          |     100 |      100 |     100 |     100 |                   
-  fileApiTreeAccessors.ts          |     100 |      100 |     100 |     100 |                   
-  fileSystemAccessTreeAccessors.ts |     100 |      100 |     100 |     100 |                   
-  httpTreeAccessors.ts             |     100 |    98.41 |     100 |     100 | 339               
-  localStorageTreeAccessors.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 (8.132s) ---- 
--------------------- Finished (32.975s) --------------------

package/src/index.browser.ts

@@ -1,24 +0,0 @@
-/*
- * 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 entry point - re-exports everything from main index
-export * from './index';

package/src/index.ts

@@ -1,47 +0,0 @@
-/*
- * 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
- */
-
-import * as CryptoUtils from './packlets/crypto-utils';
-export { CryptoUtils };
-
-// 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-utils/browserCryptoProvider.ts

@@ -1,311 +0,0 @@
-// Copyright (c) 2024 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.
-
-/* c8 ignore start - Browser-only implementation cannot be tested in Node.js environment */
-import { captureResult, Failure, Result, Success } from '@fgv/ts-utils';
-import { CryptoUtils } from '@fgv/ts-extras';
-
-type ICryptoProvider = CryptoUtils.ICryptoProvider;
-type IEncryptionResult = CryptoUtils.IEncryptionResult;
-const CryptoConstants = CryptoUtils.Constants;
-
-/**
- * Extracts an `ArrayBuffer` from a Uint8Array, handling the potential SharedArrayBuffer case.
- * @param arr - The Uint8Array to extract from
- * @returns An `ArrayBuffer` containing a copy of the data.
- */
-function toArrayBuffer(arr: Uint8Array): ArrayBuffer {
-  // Create a new ArrayBuffer and copy the data - this handles both ArrayBuffer and SharedArrayBuffer
-  const buffer = new ArrayBuffer(arr.byteLength);
-  new Uint8Array(buffer).set(arr);
-  return buffer;
-}
-
-/**
- * Browser implementation of `ICryptoProvider` using the Web Crypto API.
- * Uses AES-256-GCM for authenticated encryption.
- *
- * Note: This provider requires a browser environment with Web Crypto API support.
- * In Node.js 15+, Web Crypto is available via globalThis.crypto or require('crypto').webcrypto.
- *
- * @public
- */
-export class BrowserCryptoProvider implements ICryptoProvider {
-  private readonly _crypto: Crypto;
-
-  /**
-   * Creates a new {@link CryptoUtils.BrowserCryptoProvider | BrowserCryptoProvider}.
-   * @param cryptoApi - Optional Crypto instance (defaults to globalThis.crypto)
-   */
-  public constructor(cryptoApi?: Crypto) {
-    if (cryptoApi) {
-      this._crypto = cryptoApi;
-    } else if (typeof globalThis !== 'undefined' && globalThis.crypto) {
-      this._crypto = globalThis.crypto;
-    } else if (typeof window !== 'undefined' && window.crypto) {
-      this._crypto = window.crypto;
-    } else {
-      throw new Error('Web Crypto API not available');
-    }
-  }
-
-  /**
-   * Encrypts plaintext using AES-256-GCM.
-   * @param plaintext - UTF-8 string to encrypt
-   * @param key - 32-byte encryption key
-   * @returns `Success` with encryption result, or `Failure` with an error.
-   */
-  public async encrypt(plaintext: string, key: Uint8Array): Promise<Result<IEncryptionResult>> {
-    if (key.length !== CryptoConstants.AES_256_KEY_SIZE) {
-      return Failure.with(`Key must be ${CryptoConstants.AES_256_KEY_SIZE} bytes, got ${key.length}`);
-    }
-
-    try {
-      // Generate random IV
-      const iv = this._crypto.getRandomValues(new Uint8Array(CryptoConstants.GCM_IV_SIZE));
-
-      // Import the key
-      const cryptoKey = await this._crypto.subtle.importKey(
-        'raw',
-        toArrayBuffer(key),
-        { name: 'AES-GCM' },
-        false,
-        ['encrypt']
-      );
-
-      // Encode plaintext to bytes
-      const encoder = new TextEncoder();
-      const plaintextBytes = encoder.encode(plaintext);
-
-      // Encrypt (Web Crypto appends auth tag to ciphertext)
-      const encryptedWithTag = await this._crypto.subtle.encrypt(
-        {
-          name: 'AES-GCM',
-          iv: iv,
-          tagLength: CryptoConstants.GCM_AUTH_TAG_SIZE * 8 // bits
-        },
-        cryptoKey,
-        plaintextBytes
-      );
-
-      // Split ciphertext and auth tag (auth tag is last 16 bytes)
-      const encryptedArray = new Uint8Array(encryptedWithTag);
-      const encryptedData = encryptedArray.slice(
-        0,
-        encryptedArray.length - CryptoConstants.GCM_AUTH_TAG_SIZE
-      );
-      const authTag = encryptedArray.slice(encryptedArray.length - CryptoConstants.GCM_AUTH_TAG_SIZE);
-      return Success.with({
-        iv,
-        authTag,
-        encryptedData
-      });
-    } catch (e) {
-      const message = e instanceof Error ? e.message : String(e);
-      return Failure.with(`Encryption failed: ${message}`);
-    }
-  }
-
-  /**
-   * Decrypts ciphertext using AES-256-GCM.
-   * @param encryptedData - Encrypted bytes
-   * @param key - 32-byte decryption key
-   * @param iv - Initialization vector (12 bytes)
-   * @param authTag - GCM authentication tag (16 bytes)
-   * @returns `Success` with decrypted UTF-8 string, or `Failure` with an error.
-   */
-  public async decrypt(
-    encryptedData: Uint8Array,
-    key: Uint8Array,
-    iv: Uint8Array,
-    authTag: Uint8Array
-  ): Promise<Result<string>> {
-    if (key.length !== CryptoConstants.AES_256_KEY_SIZE) {
-      return Failure.with(`Key must be ${CryptoConstants.AES_256_KEY_SIZE} bytes, got ${key.length}`);
-    }
-    if (iv.length !== CryptoConstants.GCM_IV_SIZE) {
-      return Failure.with(`IV must be ${CryptoConstants.GCM_IV_SIZE} bytes, got ${iv.length}`);
-    }
-    if (authTag.length !== CryptoConstants.GCM_AUTH_TAG_SIZE) {
-      return Failure.with(
-        `Auth tag must be ${CryptoConstants.GCM_AUTH_TAG_SIZE} bytes, got ${authTag.length}`
-      );
-    }
-
-    try {
-      // Import the key
-      const cryptoKey = await this._crypto.subtle.importKey(
-        'raw',
-        toArrayBuffer(key),
-        { name: 'AES-GCM' },
-        false,
-        ['decrypt']
-      );
-
-      // Web Crypto expects ciphertext + auth tag concatenated
-      const encryptedWithTag = new Uint8Array(encryptedData.length + authTag.length);
-      encryptedWithTag.set(encryptedData);
-      encryptedWithTag.set(authTag, encryptedData.length);
-
-      // Decrypt
-      const decrypted = await this._crypto.subtle.decrypt(
-        {
-          name: 'AES-GCM',
-          iv: toArrayBuffer(iv),
-          tagLength: CryptoConstants.GCM_AUTH_TAG_SIZE * 8 // bits
-        },
-        cryptoKey,
-        encryptedWithTag
-      );
-
-      // Decode to string
-      const decoder = new TextDecoder();
-      return Success.with(decoder.decode(decrypted));
-    } catch (e) {
-      const message = e instanceof Error ? e.message : String(e);
-      return Failure.with(`Decryption failed: ${message}`);
-    }
-  }
-
-  /**
-   * Generates a random 32-byte key suitable for AES-256.
-   * @returns Success with generated key, or Failure with error
-   */
-  public async generateKey(): Promise<Result<Uint8Array>> {
-    try {
-      return Success.with(this._crypto.getRandomValues(new Uint8Array(CryptoConstants.AES_256_KEY_SIZE)));
-    } catch (e) {
-      const message = e instanceof Error ? e.message : String(e);
-      return Failure.with(`Key generation failed: ${message}`);
-    }
-  }
-
-  /**
-   * Derives a key from a password using PBKDF2.
-   * @param password - Password string
-   * @param salt - Salt bytes (should be at least 16 bytes)
-   * @param iterations - Number of iterations (recommend 100000+)
-   * @returns Success with derived 32-byte key, or Failure with error
-   */
-  public async deriveKey(
-    password: string,
-    salt: Uint8Array,
-    iterations: number
-  ): Promise<Result<Uint8Array>> {
-    if (iterations < 1) {
-      return Failure.with('Iterations must be at least 1');
-    }
-    if (salt.length < 8) {
-      return Failure.with('Salt should be at least 8 bytes');
-    }
-
-    try {
-      // Encode password
-      const encoder = new TextEncoder();
-      const passwordBytes = encoder.encode(password);
-
-      // Import password as key material
-      const keyMaterial = await this._crypto.subtle.importKey('raw', passwordBytes, 'PBKDF2', false, [
-        'deriveBits'
-      ]);
-
-      // Derive key bits
-      const derivedBits = await this._crypto.subtle.deriveBits(
-        {
-          name: 'PBKDF2',
-          salt: toArrayBuffer(salt),
-          iterations: iterations,
-          hash: 'SHA-256'
-        },
-        keyMaterial,
-        CryptoConstants.AES_256_KEY_SIZE * 8 // bits
-      );
-
-      return Success.with(new Uint8Array(derivedBits));
-    } catch (e) {
-      const message = e instanceof Error ? e.message : String(e);
-      return Failure.with(`Key derivation failed: ${message}`);
-    }
-  }
-
-  // ============================================================================
-  // Platform Utility Methods
-  // ============================================================================
-
-  /**
-   * Generates cryptographically secure random bytes.
-   * @param length - Number of bytes to generate
-   * @returns Success with random bytes, or Failure with error
-   */
-  public generateRandomBytes(length: number): Result<Uint8Array> {
-    if (length < 1) {
-      return Failure.with('Length must be at least 1');
-    }
-    try {
-      return Success.with(this._crypto.getRandomValues(new Uint8Array(length)));
-    } catch (e) {
-      const message = e instanceof Error ? e.message : String(e);
-      return Failure.with(`Random bytes generation failed: ${message}`);
-    }
-  }
-
-  /**
-   * Encodes binary data to base64 string.
-   * @param data - Binary data to encode
-   * @returns Base64-encoded string
-   */
-  public toBase64(data: Uint8Array): string {
-    // Convert Uint8Array to binary string, then to base64
-    let binary = '';
-    for (let i = 0; i < data.length; i++) {
-      binary += String.fromCharCode(data[i]);
-    }
-    return btoa(binary);
-  }
-
-  /**
-   * Decodes base64 string to binary data.
-   * @param base64 - Base64-encoded string
-   * @returns Success with decoded bytes, or Failure if invalid base64
-   */
-  public fromBase64(base64: string): Result<Uint8Array> {
-    try {
-      const binary = atob(base64);
-      const bytes = new Uint8Array(binary.length);
-      for (let i = 0; i < binary.length; i++) {
-        bytes[i] = binary.charCodeAt(i);
-      }
-      return Success.with(bytes);
-    } catch (e) {
-      return Failure.with('Invalid base64 string');
-    }
-  }
-}
-
-/**
- * Creates a {@link CryptoUtils.BrowserCryptoProvider | BrowserCryptoProvider} if Web
- * Crypto API is available.
- * @returns `Success` with provider, or `Failure` if not available
- * @public
- */
-export function createBrowserCryptoProvider(): Result<BrowserCryptoProvider> {
-  return captureResult(() => new BrowserCryptoProvider());
-}
-/* c8 ignore stop */

package/src/packlets/crypto-utils/browserHashProvider.ts

@@ -1,73 +0,0 @@
-/*
- * 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-utils/index.ts

@@ -1,29 +0,0 @@
-/*
- * 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';
-export * from './browserCryptoProvider';