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

package/temp/coverage/url-utils/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-03-25T10:37:38.182Z
+                at 2026-03-26T23:17:06.797Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/temp/coverage/url-utils/urlParams.ts.html

@@ -805,7 +805,7 @@ export function isFilePath(path: string): boolean {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-03-25T10:37:38.182Z
+                at 2026-03-26T23:17:06.797Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/temp/test/jest/perf-cache-7492f1b44480e0cdd1f220078fb3afd8-da39a3ee5e6b4b0d3255bfef95601890

@@ -1 +1 @@
-{"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/localStorageTreeAccessors.test.js":[1,1749],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTreeAccessors.test.js":[1,2021],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/httpTreeAccessors.test.js":[1,2316],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileSystemAccessTreeAccessors.test.js":[1,1352],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileTreeHelpers.test.js":[1,1538],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTypes.test.js":[1,1440],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/urlParams.test.js":[1,1637],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/directoryHandleStore.test.js":[1,1412],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/browserHashProvider.test.js":[1,1586]}
+{"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/localStorageTreeAccessors.test.js":[1,1899],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTreeAccessors.test.js":[1,2144],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/httpTreeAccessors.test.js":[1,2546],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileSystemAccessTreeAccessors.test.js":[1,1489],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileTreeHelpers.test.js":[1,1864],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTypes.test.js":[1,1590],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/urlParams.test.js":[1,1224],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/directoryHandleStore.test.js":[1,1391],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/browserHashProvider.test.js":[1,1278]}

package/temp/ts-web-extras.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.57.6",
+    "toolVersion": "7.57.7",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {

package/docs/@fgv/namespaces/CryptoUtils/README.md

@@ -1,18 +0,0 @@
-[**@fgv/ts-web-extras**](../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../README.md) / CryptoUtils
-
-# CryptoUtils
-
-Browser-compatible cryptographic utilities using the Web Crypto API.
-
-## Classes
-
-- [BrowserCryptoProvider](classes/BrowserCryptoProvider.md)
-- [BrowserHashProvider](classes/BrowserHashProvider.md)
-
-## Functions
-
-- [createBrowserCryptoProvider](functions/createBrowserCryptoProvider.md)

package/docs/@fgv/namespaces/CryptoUtils/classes/BrowserCryptoProvider.md

@@ -1,203 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [CryptoUtils](../README.md) / BrowserCryptoProvider
-
-# Class: BrowserCryptoProvider
-
-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.
-
-## Implements
-
-- [`ICryptoProvider`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-web-extras/docs)
-
-## Constructors
-
-### Constructor
-
-> **new BrowserCryptoProvider**(`cryptoApi?`): `BrowserCryptoProvider`
-
-Creates a new BrowserCryptoProvider.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `cryptoApi?` | `Crypto` | Optional Crypto instance (defaults to globalThis.crypto) |
-
-#### Returns
-
-`BrowserCryptoProvider`
-
-## Methods
-
-### decrypt()
-
-> **decrypt**(`encryptedData`, `key`, `iv`, `authTag`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`string`\>\>
-
-Decrypts ciphertext using AES-256-GCM.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `encryptedData` | `Uint8Array` | Encrypted bytes |
-| `key` | `Uint8Array` | 32-byte decryption key |
-| `iv` | `Uint8Array` | Initialization vector (12 bytes) |
-| `authTag` | `Uint8Array` | GCM authentication tag (16 bytes) |
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`string`\>\>
-
-`Success` with decrypted UTF-8 string, or `Failure` with an error.
-
-#### Implementation of
-
-`ICryptoProvider.decrypt`
-
-***
-
-### deriveKey()
-
-> **deriveKey**(`password`, `salt`, `iterations`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>\>
-
-Derives a key from a password using PBKDF2.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `password` | `string` | Password string |
-| `salt` | `Uint8Array` | Salt bytes (should be at least 16 bytes) |
-| `iterations` | `number` | Number of iterations (recommend 100000+) |
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>\>
-
-Success with derived 32-byte key, or Failure with error
-
-#### Implementation of
-
-`ICryptoProvider.deriveKey`
-
-***
-
-### encrypt()
-
-> **encrypt**(`plaintext`, `key`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`IEncryptionResult`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-extras/docs)\>\>
-
-Encrypts plaintext using AES-256-GCM.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `plaintext` | `string` | UTF-8 string to encrypt |
-| `key` | `Uint8Array` | 32-byte encryption key |
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`IEncryptionResult`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-extras/docs)\>\>
-
-`Success` with encryption result, or `Failure` with an error.
-
-#### Implementation of
-
-`ICryptoProvider.encrypt`
-
-***
-
-### fromBase64()
-
-> **fromBase64**(`base64`): [`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>
-
-Decodes base64 string to binary data.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `base64` | `string` | Base64-encoded string |
-
-#### Returns
-
-[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>
-
-Success with decoded bytes, or Failure if invalid base64
-
-#### Implementation of
-
-`ICryptoProvider.fromBase64`
-
-***
-
-### generateKey()
-
-> **generateKey**(): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>\>
-
-Generates a random 32-byte key suitable for AES-256.
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>\>
-
-Success with generated key, or Failure with error
-
-#### Implementation of
-
-`ICryptoProvider.generateKey`
-
-***
-
-### generateRandomBytes()
-
-> **generateRandomBytes**(`length`): [`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>
-
-Generates cryptographically secure random bytes.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `length` | `number` | Number of bytes to generate |
-
-#### Returns
-
-[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`Uint8Array`\<`ArrayBufferLike`\>\>
-
-Success with random bytes, or Failure with error
-
-#### Implementation of
-
-`ICryptoProvider.generateRandomBytes`
-
-***
-
-### toBase64()
-
-> **toBase64**(`data`): `string`
-
-Encodes binary data to base64 string.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `data` | `Uint8Array` | Binary data to encode |
-
-#### Returns
-
-`string`
-
-Base64-encoded string
-
-#### Implementation of
-
-`ICryptoProvider.toBase64`

package/docs/@fgv/namespaces/CryptoUtils/classes/BrowserHashProvider.md

@@ -1,63 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [CryptoUtils](../README.md) / BrowserHashProvider
-
-# Class: BrowserHashProvider
-
-Browser-compatible hash provider using the Web Crypto API.
-Supports common hash algorithms available in browsers.
-
-## Constructors
-
-### Constructor
-
-> **new BrowserHashProvider**(): `BrowserHashProvider`
-
-#### Returns
-
-`BrowserHashProvider`
-
-## Methods
-
-### hashParts()
-
-> `static` **hashParts**(`parts`, `algorithm`, `separator`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`string`\>\>
-
-Hash multiple strings concatenated with a separator.
-
-#### Parameters
-
-| Parameter | Type | Default value | Description |
-| ------ | ------ | ------ | ------ |
-| `parts` | `string`[] | `undefined` | Array of strings to concatenate and hash |
-| `algorithm` | `string` | `'SHA-256'` | The hash algorithm to use |
-| `separator` | `string` | '\|' | Separator to use between parts (default: '|') |
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`string`\>\>
-
-Promise resolving to the hex-encoded hash
-
-***
-
-### hashString()
-
-> `static` **hashString**(`data`, `algorithm`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`string`\>\>
-
-Hash a string using the specified algorithm.
-
-#### Parameters
-
-| Parameter | Type | Default value | Description |
-| ------ | ------ | ------ | ------ |
-| `data` | `string` | `undefined` | The string to hash |
-| `algorithm` | `string` | `'SHA-256'` | The hash algorithm to use |
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`string`\>\>
-
-Promise resolving to the hex-encoded hash

package/docs/@fgv/namespaces/CryptoUtils/functions/createBrowserCryptoProvider.md

@@ -1,18 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [CryptoUtils](../README.md) / createBrowserCryptoProvider
-
-# Function: createBrowserCryptoProvider()
-
-> **createBrowserCryptoProvider**(): [`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`BrowserCryptoProvider`](../classes/BrowserCryptoProvider.md)\>
-
-Creates a [BrowserCryptoProvider](../classes/BrowserCryptoProvider.md) if Web
-Crypto API is available.
-
-## Returns
-
-[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`BrowserCryptoProvider`](../classes/BrowserCryptoProvider.md)\>
-
-`Success` with provider, or `Failure` if not available

package/docs/@fgv/namespaces/FileTreeHelpers/README.md

@@ -1,19 +0,0 @@
-[**@fgv/ts-web-extras**](../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../README.md) / FileTreeHelpers
-
-# FileTreeHelpers
-
-## Variables
-
-- [defaultFileApiTreeInitParams](variables/defaultFileApiTreeInitParams.md)
-
-## Functions
-
-- [extractFileListMetadata](functions/extractFileListMetadata.md)
-- [extractFileMetadata](functions/extractFileMetadata.md)
-- [fromDirectoryUpload](functions/fromDirectoryUpload.md)
-- [fromFileList](functions/fromFileList.md)
-- [getOriginalFile](functions/getOriginalFile.md)

package/docs/@fgv/namespaces/FileTreeHelpers/functions/extractFileListMetadata.md

@@ -1,23 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [FileTreeHelpers](../README.md) / extractFileListMetadata
-
-# Function: extractFileListMetadata()
-
-> **extractFileListMetadata**(`fileList`): [`IFileMetadata`](../../../../interfaces/IFileMetadata.md)[]
-
-Helper function to extract metadata from a `FileList`.
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | The `FileList` to extract metadata from |
-
-## Returns
-
-[`IFileMetadata`](../../../../interfaces/IFileMetadata.md)[]
-
-Array of [file metadata](../../../../interfaces/IFileMetadata.md) objects

package/docs/@fgv/namespaces/FileTreeHelpers/functions/extractFileMetadata.md

@@ -1,23 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [FileTreeHelpers](../README.md) / extractFileMetadata
-
-# Function: extractFileMetadata()
-
-> **extractFileMetadata**(`file`): [`IFileMetadata`](../../../../interfaces/IFileMetadata.md)
-
-Helper function to extract metadata from a `File`.
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `file` | `File` | The File to extract metadata from |
-
-## Returns
-
-[`IFileMetadata`](../../../../interfaces/IFileMetadata.md)
-
-[file metadata](../../../../interfaces/IFileMetadata.md) object

package/docs/@fgv/namespaces/FileTreeHelpers/functions/fromDirectoryUpload.md

@@ -1,33 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [FileTreeHelpers](../README.md) / fromDirectoryUpload
-
-# Function: fromDirectoryUpload()
-
-> **fromDirectoryUpload**(`fileList`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\>\>\>
-
-Helper function to create a new FileTree instance
-from a directory upload with webkitRelativePath support.
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | FileList from a directory upload (input with webkitdirectory) |
-| `params?` | [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\> | Optional `IFileTreeInitParams` for the file tree. |
-
-## Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\>\>\>
-
-Promise resolving to a successful Result with the new FileTree instance
-if successful, or a failed Result with an error message otherwise
-
-## Remarks
-
-The content type of the files is always `string` and the default
-accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is
-is used, so content type is derived from the mime type of the file, when
-available.

package/docs/@fgv/namespaces/FileTreeHelpers/functions/fromFileList.md

@@ -1,33 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [FileTreeHelpers](../README.md) / fromFileList
-
-# Function: fromFileList()
-
-> **fromFileList**(`fileList`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\>\>\>
-
-Helper function to create a new FileTree instance
-from a browser FileList (e.g., from input[type="file"]).
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | FileList from a file input element |
-| `params?` | [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\> | Optional `IFileTreeInitParams` for the file tree. |
-
-## Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\>\>\>
-
-Promise resolving to a successful Result with the new FileTree instance
-if successful, or a failed Result with an error message otherwise
-
-## Remarks
-
-The content type of the files is always `string` and the default
-accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is
-used, so content type is derived from the mime type of the file, when
-available.

package/docs/@fgv/namespaces/FileTreeHelpers/functions/getOriginalFile.md

@@ -1,25 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [FileTreeHelpers](../README.md) / getOriginalFile
-
-# Function: getOriginalFile()
-
-> **getOriginalFile**(`fileList`, `path`): [`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`File`\>
-
-Helper function to get the original File object from a FileList by path.
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | The original FileList |
-| `path` | `string` | The path to the file |
-
-## Returns
-
-[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`File`\>
-
-A successful Result with the File object if found,
-or a failed Result with an error message otherwise

package/docs/@fgv/namespaces/FileTreeHelpers/variables/defaultFileApiTreeInitParams.md

@@ -1,11 +0,0 @@
-[**@fgv/ts-web-extras**](../../../../README.md)
-
-***
-
-[@fgv/ts-web-extras](../../../../README.md) / [FileTreeHelpers](../README.md) / defaultFileApiTreeInitParams
-
-# Variable: defaultFileApiTreeInitParams
-
-> `const` **defaultFileApiTreeInitParams**: [`FileTree.IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`string`\>
-
-Default initialization parameters for a `FileTree` using [FileApiTreeAccessors](../../../../classes/FileApiTreeAccessors.md).