@fgv/ts-web-extras 5.1.0-0 → 5.1.0-1

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

@@ -7,6 +7,7 @@
 import { CryptoUtils as CryptoUtils_2 } from '@fgv/ts-extras';
 import { DetailedResult } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
+import { Logging } from '@fgv/ts-utils';
 import { Result } from '@fgv/ts-utils';
 
 // Warning: (ae-forgotten-export) The symbol "ICryptoProvider" needs to be exported by the entry point index.d.ts
@@ -85,6 +86,7 @@ function extractFileMetadata(file: File): IFileMetadata;
 // @public
 export class FileApiTreeAccessors<TCT extends string = string> {
     static create<TCT extends string = string>(initializers: TreeInitializer[], params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    static createFromHttp<TCT extends string = string>(params: IHttpTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
     static createFromLocalStorage<TCT extends string = string>(params: ILocalStorageTreeParams<TCT>): Result<FileTree.FileTree<TCT>>;
     static createPersistent<TCT extends string = string>(dirHandle: FileSystemDirectoryHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
     static createPersistentFromFile<TCT extends string = string>(fileHandle: FileSystemFileHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
@@ -105,6 +107,7 @@ export interface FilePickerAcceptType {
 // @public
 export class FileSystemAccessTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
     protected constructor(files: FileTree.IInMemoryFile<TCT>[], rootDir: FileSystemDirectoryHandle_2, handles: Map<string, FileSystemFileHandle_2>, params: IFileSystemAccessTreeParams<TCT> | undefined, hasWritePermission: boolean);
+    deleteFile(path: string): Result<boolean>;
     fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
     static fromDirectoryHandle<TCT extends string = string>(dirHandle: FileSystemDirectoryHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileSystemAccessTreeAccessors<TCT>>>;
     static fromFileHandle<TCT extends string = string>(fileHandle: FileSystemFileHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileSystemAccessTreeAccessors<TCT>>>;
@@ -228,6 +231,18 @@ function fromFileList(fileList: FileList, params?: FileTree.IFileTreeInitParams<
 // @public
 function getOriginalFile(fileList: FileList, path: string): Result<File>;
 
+// @public
+export class HttpTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
+    // (undocumented)
+    deleteFile(path: string): Result<boolean>;
+    fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
+    static fromHttp<TCT extends string = string>(params: IHttpTreeParams<TCT>): Promise<Result<HttpTreeAccessors<TCT>>>;
+    getDirtyPaths(): string[];
+    isDirty(): boolean;
+    saveFileContents(path: string, contents: string): Result<string>;
+    syncToDisk(): Promise<Result<void>>;
+}
+
 // @public
 export interface IDirectoryHandleTreeInitializer {
     // (undocumented)
@@ -270,6 +285,7 @@ export interface IFileMetadata {
 export interface IFileSystemAccessTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
     autoSync?: boolean;
     filePath?: string;
+    logger?: Logging.LogReporter<unknown>;
     requireWritePermission?: boolean;
 }
 
@@ -283,6 +299,22 @@ export interface IFsAccessApis {
     showSaveFilePicker(options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle_2>;
 }
 
+// @public
+export interface IHttpTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
+    // (undocumented)
+    readonly autoSync?: boolean;
+    // (undocumented)
+    readonly baseUrl: string;
+    // (undocumented)
+    readonly fetchImpl?: typeof fetch;
+    // (undocumented)
+    readonly logger?: Logging.LogReporter<unknown>;
+    // (undocumented)
+    readonly namespace?: string;
+    // (undocumented)
+    readonly userId?: string;
+}
+
 // @public
 export interface ILocalStorageTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
     autoSync?: boolean;
@@ -318,6 +350,7 @@ export interface IUrlConfigOptions {
 
 // @public
 export class LocalStorageTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
+    deleteFile(path: string): Result<boolean>;
     fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
     static fromStorage<TCT extends string = string>(params: ILocalStorageTreeParams<TCT>): Result<LocalStorageTreeAccessors<TCT>>;
     getDirtyPaths(): string[];

package/.rush/temp/81e0881271ff236956b2f52e8ca99da6574c6e1e.tar.log

@@ -1,223 +0,0 @@
-Start time: Mon Mar 09 2026 21:03:54 GMT+0000 (Coordinated Universal Time)
-Invoking "/usr/bin/tar -c -f /home/runner/work/fgv/fgv/common/temp/build-cache/81e0881271ff236956b2f52e8ca99da6574c6e1e-fbd3261a958cbdc5.temp -z --files-from=-"
-
-======= BEGIN PROCESS INPUT ======
-.rush/temp/operation/build/all.log
-.rush/temp/operation/build/log-chunks.jsonl
-.rush/temp/operation/build/state.json
-dist/index.browser.js
-dist/index.browser.js.map
-dist/index.js
-dist/index.js.map
-dist/packlets/crypto-utils/browserCryptoProvider.js
-dist/packlets/crypto-utils/browserCryptoProvider.js.map
-dist/packlets/crypto-utils/browserHashProvider.js
-dist/packlets/crypto-utils/browserHashProvider.js.map
-dist/packlets/crypto-utils/index.js
-dist/packlets/crypto-utils/index.js.map
-dist/packlets/file-api-types/index.js
-dist/packlets/file-api-types/index.js.map
-dist/packlets/file-tree/directoryHandleStore.js
-dist/packlets/file-tree/directoryHandleStore.js.map
-dist/packlets/file-tree/fileApiTreeAccessors.js
-dist/packlets/file-tree/fileApiTreeAccessors.js.map
-dist/packlets/file-tree/fileSystemAccessTreeAccessors.js
-dist/packlets/file-tree/fileSystemAccessTreeAccessors.js.map
-dist/packlets/file-tree/index.js
-dist/packlets/file-tree/index.js.map
-dist/packlets/file-tree/localStorageTreeAccessors.js
-dist/packlets/file-tree/localStorageTreeAccessors.js.map
-dist/packlets/helpers/fileTreeHelpers.js
-dist/packlets/helpers/fileTreeHelpers.js.map
-dist/packlets/helpers/index.js
-dist/packlets/helpers/index.js.map
-dist/packlets/url-utils/index.js
-dist/packlets/url-utils/index.js.map
-dist/packlets/url-utils/urlParams.js
-dist/packlets/url-utils/urlParams.js.map
-dist/test/mocks/idb-keyval.js
-dist/test/mocks/idb-keyval.js.map
-dist/test/setupTests.js
-dist/test/setupTests.js.map
-dist/test/unit/browserHashProvider.test.js
-dist/test/unit/browserHashProvider.test.js.map
-dist/test/unit/directoryHandleStore.test.js
-dist/test/unit/directoryHandleStore.test.js.map
-dist/test/unit/fileApiTreeAccessors.test.js
-dist/test/unit/fileApiTreeAccessors.test.js.map
-dist/test/unit/fileApiTypes.test.js
-dist/test/unit/fileApiTypes.test.js.map
-dist/test/unit/fileSystemAccessTreeAccessors.test.js
-dist/test/unit/fileSystemAccessTreeAccessors.test.js.map
-dist/test/unit/fileTreeHelpers.test.js
-dist/test/unit/fileTreeHelpers.test.js.map
-dist/test/unit/localStorageTreeAccessors.test.js
-dist/test/unit/localStorageTreeAccessors.test.js.map
-dist/test/unit/urlParams.test.js
-dist/test/unit/urlParams.test.js.map
-dist/test/utils/fileSystemAccessMocks.js
-dist/test/utils/fileSystemAccessMocks.js.map
-dist/test/utils/testHelpers.js
-dist/test/utils/testHelpers.js.map
-dist/ts-web-extras.d.ts
-dist/tsdoc-metadata.json
-lib/index.browser.d.ts
-lib/index.browser.d.ts.map
-lib/index.browser.js
-lib/index.browser.js.map
-lib/index.d.ts
-lib/index.d.ts.map
-lib/index.js
-lib/index.js.map
-lib/packlets/crypto-utils/browserCryptoProvider.d.ts
-lib/packlets/crypto-utils/browserCryptoProvider.d.ts.map
-lib/packlets/crypto-utils/browserCryptoProvider.js
-lib/packlets/crypto-utils/browserCryptoProvider.js.map
-lib/packlets/crypto-utils/browserHashProvider.d.ts
-lib/packlets/crypto-utils/browserHashProvider.d.ts.map
-lib/packlets/crypto-utils/browserHashProvider.js
-lib/packlets/crypto-utils/browserHashProvider.js.map
-lib/packlets/crypto-utils/index.d.ts
-lib/packlets/crypto-utils/index.d.ts.map
-lib/packlets/crypto-utils/index.js
-lib/packlets/crypto-utils/index.js.map
-lib/packlets/file-api-types/index.d.ts
-lib/packlets/file-api-types/index.d.ts.map
-lib/packlets/file-api-types/index.js
-lib/packlets/file-api-types/index.js.map
-lib/packlets/file-tree/directoryHandleStore.d.ts
-lib/packlets/file-tree/directoryHandleStore.d.ts.map
-lib/packlets/file-tree/directoryHandleStore.js
-lib/packlets/file-tree/directoryHandleStore.js.map
-lib/packlets/file-tree/fileApiTreeAccessors.d.ts
-lib/packlets/file-tree/fileApiTreeAccessors.d.ts.map
-lib/packlets/file-tree/fileApiTreeAccessors.js
-lib/packlets/file-tree/fileApiTreeAccessors.js.map
-lib/packlets/file-tree/fileSystemAccessTreeAccessors.d.ts
-lib/packlets/file-tree/fileSystemAccessTreeAccessors.d.ts.map
-lib/packlets/file-tree/fileSystemAccessTreeAccessors.js
-lib/packlets/file-tree/fileSystemAccessTreeAccessors.js.map
-lib/packlets/file-tree/index.d.ts
-lib/packlets/file-tree/index.d.ts.map
-lib/packlets/file-tree/index.js
-lib/packlets/file-tree/index.js.map
-lib/packlets/file-tree/localStorageTreeAccessors.d.ts
-lib/packlets/file-tree/localStorageTreeAccessors.d.ts.map
-lib/packlets/file-tree/localStorageTreeAccessors.js
-lib/packlets/file-tree/localStorageTreeAccessors.js.map
-lib/packlets/helpers/fileTreeHelpers.d.ts
-lib/packlets/helpers/fileTreeHelpers.d.ts.map
-lib/packlets/helpers/fileTreeHelpers.js
-lib/packlets/helpers/fileTreeHelpers.js.map
-lib/packlets/helpers/index.d.ts
-lib/packlets/helpers/index.d.ts.map
-lib/packlets/helpers/index.js
-lib/packlets/helpers/index.js.map
-lib/packlets/url-utils/index.d.ts
-lib/packlets/url-utils/index.d.ts.map
-lib/packlets/url-utils/index.js
-lib/packlets/url-utils/index.js.map
-lib/packlets/url-utils/urlParams.d.ts
-lib/packlets/url-utils/urlParams.d.ts.map
-lib/packlets/url-utils/urlParams.js
-lib/packlets/url-utils/urlParams.js.map
-lib/test/mocks/idb-keyval.d.ts
-lib/test/mocks/idb-keyval.d.ts.map
-lib/test/mocks/idb-keyval.js
-lib/test/mocks/idb-keyval.js.map
-lib/test/setupTests.d.ts
-lib/test/setupTests.d.ts.map
-lib/test/setupTests.js
-lib/test/setupTests.js.map
-lib/test/unit/browserHashProvider.test.d.ts
-lib/test/unit/browserHashProvider.test.d.ts.map
-lib/test/unit/browserHashProvider.test.js
-lib/test/unit/browserHashProvider.test.js.map
-lib/test/unit/directoryHandleStore.test.d.ts
-lib/test/unit/directoryHandleStore.test.d.ts.map
-lib/test/unit/directoryHandleStore.test.js
-lib/test/unit/directoryHandleStore.test.js.map
-lib/test/unit/fileApiTreeAccessors.test.d.ts
-lib/test/unit/fileApiTreeAccessors.test.d.ts.map
-lib/test/unit/fileApiTreeAccessors.test.js
-lib/test/unit/fileApiTreeAccessors.test.js.map
-lib/test/unit/fileApiTypes.test.d.ts
-lib/test/unit/fileApiTypes.test.d.ts.map
-lib/test/unit/fileApiTypes.test.js
-lib/test/unit/fileApiTypes.test.js.map
-lib/test/unit/fileSystemAccessTreeAccessors.test.d.ts
-lib/test/unit/fileSystemAccessTreeAccessors.test.d.ts.map
-lib/test/unit/fileSystemAccessTreeAccessors.test.js
-lib/test/unit/fileSystemAccessTreeAccessors.test.js.map
-lib/test/unit/fileTreeHelpers.test.d.ts
-lib/test/unit/fileTreeHelpers.test.d.ts.map
-lib/test/unit/fileTreeHelpers.test.js
-lib/test/unit/fileTreeHelpers.test.js.map
-lib/test/unit/localStorageTreeAccessors.test.d.ts
-lib/test/unit/localStorageTreeAccessors.test.d.ts.map
-lib/test/unit/localStorageTreeAccessors.test.js
-lib/test/unit/localStorageTreeAccessors.test.js.map
-lib/test/unit/urlParams.test.d.ts
-lib/test/unit/urlParams.test.d.ts.map
-lib/test/unit/urlParams.test.js
-lib/test/unit/urlParams.test.js.map
-lib/test/utils/fileSystemAccessMocks.d.ts
-lib/test/utils/fileSystemAccessMocks.d.ts.map
-lib/test/utils/fileSystemAccessMocks.js
-lib/test/utils/fileSystemAccessMocks.js.map
-lib/test/utils/testHelpers.d.ts
-lib/test/utils/testHelpers.d.ts.map
-lib/test/utils/testHelpers.js
-lib/test/utils/testHelpers.js.map
-temp/build/typescript/ts_8nwakTlr.json
-temp/coverage/base.css
-temp/coverage/block-navigation.js
-temp/coverage/crypto-utils/browserCryptoProvider.ts.html
-temp/coverage/crypto-utils/browserHashProvider.ts.html
-temp/coverage/crypto-utils/index.html
-temp/coverage/favicon.png
-temp/coverage/file-tree/directoryHandleStore.ts.html
-temp/coverage/file-tree/fileApiTreeAccessors.ts.html
-temp/coverage/file-tree/fileSystemAccessTreeAccessors.ts.html
-temp/coverage/file-tree/index.html
-temp/coverage/file-tree/localStorageTreeAccessors.ts.html
-temp/coverage/helpers/fileTreeHelpers.ts.html
-temp/coverage/helpers/index.html
-temp/coverage/index.html
-temp/coverage/lcov-report/base.css
-temp/coverage/lcov-report/block-navigation.js
-temp/coverage/lcov-report/crypto-utils/browserCryptoProvider.ts.html
-temp/coverage/lcov-report/crypto-utils/browserHashProvider.ts.html
-temp/coverage/lcov-report/crypto-utils/index.html
-temp/coverage/lcov-report/favicon.png
-temp/coverage/lcov-report/file-tree/directoryHandleStore.ts.html
-temp/coverage/lcov-report/file-tree/fileApiTreeAccessors.ts.html
-temp/coverage/lcov-report/file-tree/fileSystemAccessTreeAccessors.ts.html
-temp/coverage/lcov-report/file-tree/index.html
-temp/coverage/lcov-report/file-tree/localStorageTreeAccessors.ts.html
-temp/coverage/lcov-report/helpers/fileTreeHelpers.ts.html
-temp/coverage/lcov-report/helpers/index.html
-temp/coverage/lcov-report/index.html
-temp/coverage/lcov-report/prettify.css
-temp/coverage/lcov-report/prettify.js
-temp/coverage/lcov-report/sort-arrow-sprite.png
-temp/coverage/lcov-report/sorter.js
-temp/coverage/lcov-report/url-utils/index.html
-temp/coverage/lcov-report/url-utils/urlParams.ts.html
-temp/coverage/lcov.info
-temp/coverage/prettify.css
-temp/coverage/prettify.js
-temp/coverage/sort-arrow-sprite.png
-temp/coverage/sorter.js
-temp/coverage/url-utils/index.html
-temp/coverage/url-utils/urlParams.ts.html
-temp/test/jest/haste-map-7492f1b44480e0cdd1f220078fb3afd8-c8dd6c3430605adeb2f1cadf4f75e791-8c9336785555d572065b28c111982ba4
-temp/test/jest/jest-transform-cache-7492f1b44480e0cdd1f220078fb3afd8-79ef2876fae7ca75eedb2aa53dc48338/8d/package_8dcbedef69e4299f0f51fcda8f4f1c8e
-temp/test/jest/perf-cache-7492f1b44480e0cdd1f220078fb3afd8-da39a3ee5e6b4b0d3255bfef95601890
-temp/ts-web-extras.api.json
-temp/ts-web-extras.api.md
-======== END PROCESS INPUT =======
-======= BEGIN PROCESS OUTPUT =======
-======== END PROCESS OUTPUT ========
-
-Exited with code "0"

package/docs/index.md

@@ -1,34 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md)
-
-## API Reference
-
-## Packages
-
-<table><thead><tr><th>
-
-Package
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[@fgv/ts-web-extras](./ts-web-extras.md)
-
-
-</td><td>
-
-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.
-
-
-</td></tr>
-</tbody></table>
-

package/docs/ts-web-extras.cryptoutils.browsercryptoprovider._constructor_.md

@@ -1,50 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@fgv/ts-web-extras](./ts-web-extras.md) &gt; [CryptoUtils](./ts-web-extras.cryptoutils.md) &gt; [BrowserCryptoProvider](./ts-web-extras.cryptoutils.browsercryptoprovider.md) &gt; [(constructor)](./ts-web-extras.cryptoutils.browsercryptoprovider._constructor_.md)
-
-## CryptoUtils.BrowserCryptoProvider.(constructor)
-
-Creates a new [BrowserCryptoProvider](./ts-web-extras.cryptoutils.browsercryptoprovider.md)<!-- -->.
-
-**Signature:**
-
-```typescript
-constructor(cryptoApi?: Crypto);
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-cryptoApi
-
-
-</td><td>
-
-Crypto
-
-
-</td><td>
-
-_(Optional)_ Optional Crypto instance (defaults to globalThis.crypto)
-
-
-</td></tr>
-</tbody></table>
-

package/docs/ts-web-extras.cryptoutils.browsercryptoprovider.decrypt.md

@@ -1,104 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@fgv/ts-web-extras](./ts-web-extras.md) &gt; [CryptoUtils](./ts-web-extras.cryptoutils.md) &gt; [BrowserCryptoProvider](./ts-web-extras.cryptoutils.browsercryptoprovider.md) &gt; [decrypt](./ts-web-extras.cryptoutils.browsercryptoprovider.decrypt.md)
-
-## CryptoUtils.BrowserCryptoProvider.decrypt() method
-
-Decrypts ciphertext using AES-256-GCM.
-
-**Signature:**
-
-```typescript
-decrypt(encryptedData: Uint8Array, key: Uint8Array, iv: Uint8Array, authTag: Uint8Array): Promise<Result<string>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-encryptedData
-
-
-</td><td>
-
-Uint8Array
-
-
-</td><td>
-
-Encrypted bytes
-
-
-</td></tr>
-<tr><td>
-
-key
-
-
-</td><td>
-
-Uint8Array
-
-
-</td><td>
-
-32-byte decryption key
-
-
-</td></tr>
-<tr><td>
-
-iv
-
-
-</td><td>
-
-Uint8Array
-
-
-</td><td>
-
-Initialization vector (12 bytes)
-
-
-</td></tr>
-<tr><td>
-
-authTag
-
-
-</td><td>
-
-Uint8Array
-
-
-</td><td>
-
-GCM authentication tag (16 bytes)
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;Result&lt;string&gt;&gt;
-
-`Success` with decrypted UTF-8 string, or `Failure` with an error.
-

package/docs/ts-web-extras.cryptoutils.browsercryptoprovider.derivekey.md

@@ -1,88 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@fgv/ts-web-extras](./ts-web-extras.md) &gt; [CryptoUtils](./ts-web-extras.cryptoutils.md) &gt; [BrowserCryptoProvider](./ts-web-extras.cryptoutils.browsercryptoprovider.md) &gt; [deriveKey](./ts-web-extras.cryptoutils.browsercryptoprovider.derivekey.md)
-
-## CryptoUtils.BrowserCryptoProvider.deriveKey() method
-
-Derives a key from a password using PBKDF2.
-
-**Signature:**
-
-```typescript
-deriveKey(password: string, salt: Uint8Array, iterations: number): Promise<Result<Uint8Array>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-password
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-Password string
-
-
-</td></tr>
-<tr><td>
-
-salt
-
-
-</td><td>
-
-Uint8Array
-
-
-</td><td>
-
-Salt bytes (should be at least 16 bytes)
-
-
-</td></tr>
-<tr><td>
-
-iterations
-
-
-</td><td>
-
-number
-
-
-</td><td>
-
-Number of iterations (recommend 100000+)
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;Result&lt;Uint8Array&gt;&gt;
-
-Success with derived 32-byte key, or Failure with error
-

package/docs/ts-web-extras.cryptoutils.browsercryptoprovider.encrypt.md

@@ -1,72 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@fgv/ts-web-extras](./ts-web-extras.md) &gt; [CryptoUtils](./ts-web-extras.cryptoutils.md) &gt; [BrowserCryptoProvider](./ts-web-extras.cryptoutils.browsercryptoprovider.md) &gt; [encrypt](./ts-web-extras.cryptoutils.browsercryptoprovider.encrypt.md)
-
-## CryptoUtils.BrowserCryptoProvider.encrypt() method
-
-Encrypts plaintext using AES-256-GCM.
-
-**Signature:**
-
-```typescript
-encrypt(plaintext: string, key: Uint8Array): Promise<Result<IEncryptionResult>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-plaintext
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-UTF-8 string to encrypt
-
-
-</td></tr>
-<tr><td>
-
-key
-
-
-</td><td>
-
-Uint8Array
-
-
-</td><td>
-
-32-byte encryption key
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;Result&lt;IEncryptionResult&gt;&gt;
-
-`Success` with encryption result, or `Failure` with an error.
-