@fgv/ts-web-extras 5.1.0-16 → 5.1.0-18

package/temp/coverage/lcov.info

@@ -1,18 +1,21 @@
 TN:
 SF:src/packlets/crypto-utils/browserCryptoProvider.ts
-FN:34,toArrayBuffer
-FN:57,BrowserCryptoProvider
-FN:75,encrypt
-FN:134,decrypt
-FN:191,generateKey
-FN:207,deriveKey
-FN:253,sha256
-FN:278,generateRandomBytes
-FN:295,toBase64
-FN:309,fromBase64
-FN:329,createBrowserCryptoProvider
-FNF:11
-FNH:11
+FN:30,toArrayBuffer
+FN:53,BrowserCryptoProvider
+FN:71,encrypt
+FN:130,decrypt
+FN:187,generateKey
+FN:205,deriveKey
+FN:251,sha256
+FN:276,generateRandomBytes
+FN:293,toBase64
+FN:307,fromBase64
+FN:330,generateKeyPair
+FN:351,exportPublicKeyJwk
+FN:365,importPublicKeyJwk
+FN:383,createBrowserCryptoProvider
+FNF:14
+FNH:14
 FNDA:1,toArrayBuffer
 FNDA:1,BrowserCryptoProvider
 FNDA:1,encrypt
@@ -23,6 +26,9 @@ FNDA:1,sha256
 FNDA:1,generateRandomBytes
 FNDA:1,toBase64
 FNDA:1,fromBase64
+FNDA:1,generateKeyPair
+FNDA:1,exportPublicKeyJwk
+FNDA:1,importPublicKeyJwk
 FNDA:1,createBrowserCryptoProvider
 DA:1,1
 DA:2,1
@@ -356,8 +362,62 @@ DA:329,1
 DA:330,1
 DA:331,1
 DA:332,1
-LF:332
-LH:332
+DA:333,1
+DA:334,1
+DA:335,1
+DA:336,1
+DA:337,1
+DA:338,1
+DA:339,1
+DA:340,1
+DA:341,1
+DA:342,1
+DA:343,1
+DA:344,1
+DA:345,1
+DA:346,1
+DA:347,1
+DA:348,1
+DA:349,1
+DA:350,1
+DA:351,1
+DA:352,1
+DA:353,1
+DA:354,1
+DA:355,1
+DA:356,1
+DA:357,1
+DA:358,1
+DA:359,1
+DA:360,1
+DA:361,1
+DA:362,1
+DA:363,1
+DA:364,1
+DA:365,1
+DA:366,1
+DA:367,1
+DA:368,1
+DA:369,1
+DA:370,1
+DA:371,1
+DA:372,1
+DA:373,1
+DA:374,1
+DA:375,1
+DA:376,1
+DA:377,1
+DA:378,1
+DA:379,1
+DA:380,1
+DA:381,1
+DA:382,1
+DA:383,1
+DA:384,1
+DA:385,1
+DA:386,1
+LF:386
+LH:386
 BRF:0
 BRH:0
 end_of_record

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-04-13T15:34:45.550Z
+                at 2026-04-27T05:38:37.182Z
             </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-04-13T15:34:45.550Z
+                at 2026-04-27T05:38:37.182Z
             </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,1814],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTreeAccessors.test.js":[1,2274],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/httpTreeAccessors.test.js":[1,2153],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileSystemAccessTreeAccessors.test.js":[1,1485],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTypes.test.js":[1,1202],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileTreeHelpers.test.js":[1,1774],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/urlParams.test.js":[1,1439],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/directoryHandleStore.test.js":[1,1320],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/browserHashProvider.test.js":[1,1501]}
+{"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/localStorageTreeAccessors.test.js":[1,2975],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/httpTreeAccessors.test.js":[1,3203],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTreeAccessors.test.js":[1,3464],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileSystemAccessTreeAccessors.test.js":[1,1300],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileTreeHelpers.test.js":[1,1819],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/fileApiTypes.test.js":[1,1579],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/urlParams.test.js":[1,1586],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/directoryHandleStore.test.js":[1,1282],"/home/runner/work/fgv/fgv/libraries/ts-web-extras/lib/test/unit/browserHashProvider.test.js":[1,1520]}

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

@@ -209,8 +209,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "ICryptoProvider",
-                  "canonicalReference": "@fgv/ts-web-extras!~ICryptoProvider:type"
+                  "text": "CryptoUtils.ICryptoProvider",
+                  "canonicalReference": "@fgv/ts-extras!ICryptoProvider:interface"
                 },
                 {
                   "kind": "Content",
@@ -520,8 +520,8 @@
                     },
                     {
                       "kind": "Reference",
-                      "text": "IEncryptionResult",
-                      "canonicalReference": "@fgv/ts-web-extras!~IEncryptionResult:type"
+                      "text": "CryptoUtils.IEncryptionResult",
+                      "canonicalReference": "@fgv/ts-extras!IEncryptionResult:interface"
                     },
                     {
                       "kind": "Content",
@@ -562,6 +562,78 @@
                   "isAbstract": false,
                   "name": "encrypt"
                 },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#exportPublicKeyJwk:member(1)",
+                  "docComment": "/**\n * Exports a public `CryptoKey` as a JSON Web Key.\n *\n * @remarks\n *\n * Rejects non-public keys at runtime. WebCrypto's `exportKey('jwk', ...)` does not enforce public-vs-private; without this guard a caller that passed an extractable private key would receive its private fields (`d`, `p`, `q`, ...) as JWK, defeating the method's name.\n *\n * @param publicKey - Extractable public key to export.\n *\n * @returns `Success` with the JWK, or `Failure` if not a public key or if export fails.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "exportPublicKeyJwk(publicKey: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "CryptoKey",
+                      "canonicalReference": "!CryptoKey:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "JsonWebKey",
+                      "canonicalReference": "!JsonWebKey:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 9
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "publicKey",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "exportPublicKeyJwk"
+                },
                 {
                   "kind": "Method",
                   "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#fromBase64:member(1)",
@@ -678,6 +750,94 @@
                   "isAbstract": false,
                   "name": "generateKey"
                 },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#generateKeyPair:member(1)",
+                  "docComment": "/**\n * Generates a new asymmetric keypair via Web Crypto.\n *\n * @param algorithm - The algorithm to use.\n *\n * @param extractable - Whether the resulting keys may be exported.\n *\n * @returns `Success` with the generated `CryptoKeyPair`, or `Failure` with an error.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "generateKeyPair(algorithm: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "CryptoUtils.KeyPairAlgorithm",
+                      "canonicalReference": "@fgv/ts-extras!KeyPairAlgorithm:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", extractable: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "boolean"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "CryptoKeyPair",
+                      "canonicalReference": "!CryptoKeyPair:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 11
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "algorithm",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "extractable",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "generateKeyPair"
+                },
                 {
                   "kind": "Method",
                   "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#generateRandomBytes:member(1)",
@@ -740,6 +900,95 @@
                   "isAbstract": false,
                   "name": "generateRandomBytes"
                 },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#importPublicKeyJwk:member(1)",
+                  "docComment": "/**\n * Imports a public-key JWK as a `CryptoKey` for the requested algorithm.\n *\n * @param jwk - The JSON Web Key produced by a prior export.\n *\n * @param algorithm - The algorithm the key was generated for.\n *\n * @returns `Success` with the imported public `CryptoKey`, or `Failure` with an error.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "importPublicKeyJwk(jwk: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "JsonWebKey",
+                      "canonicalReference": "!JsonWebKey:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", algorithm: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "CryptoUtils.KeyPairAlgorithm",
+                      "canonicalReference": "@fgv/ts-extras!KeyPairAlgorithm:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "CryptoKey",
+                      "canonicalReference": "!CryptoKey:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 11
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "jwk",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "algorithm",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "importPublicKeyJwk"
+                },
                 {
                   "kind": "Method",
                   "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#sha256:member(1)",
@@ -2359,7 +2608,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.extractFileMetadata:member(1)",
-              "docComment": "/**\n * Extract file metadata from a File.\n *\n * @param fileList - The File to extract metadata from\n *\n * @returns The {@link IFileMetadata | file metadata}\n */\n",
+              "docComment": "/**\n * Extract file metadata from a File.\n *\n * @param file - The File to extract metadata from\n *\n * @returns The {@link IFileMetadata | file metadata}\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",

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

@@ -10,19 +10,19 @@ 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
-//
 // @public
-class BrowserCryptoProvider implements ICryptoProvider {
+class BrowserCryptoProvider implements CryptoUtils_2.ICryptoProvider {
     // Warning: (ae-unresolved-link) The @link reference could not be resolved: This type of declaration is not supported yet by the resolver
     constructor(cryptoApi?: Crypto);
     decrypt(encryptedData: Uint8Array, key: Uint8Array, iv: Uint8Array, authTag: Uint8Array): Promise<Result<string>>;
     deriveKey(password: string, salt: Uint8Array, iterations: number): Promise<Result<Uint8Array>>;
-    // Warning: (ae-forgotten-export) The symbol "IEncryptionResult" needs to be exported by the entry point index.d.ts
-    encrypt(plaintext: string, key: Uint8Array): Promise<Result<IEncryptionResult>>;
+    encrypt(plaintext: string, key: Uint8Array): Promise<Result<CryptoUtils_2.IEncryptionResult>>;
+    exportPublicKeyJwk(publicKey: CryptoKey): Promise<Result<JsonWebKey>>;
     fromBase64(base64: string): Result<Uint8Array>;
     generateKey(): Promise<Result<Uint8Array>>;
+    generateKeyPair(algorithm: CryptoUtils_2.KeyPairAlgorithm, extractable: boolean): Promise<Result<CryptoKeyPair>>;
     generateRandomBytes(length: number): Result<Uint8Array>;
+    importPublicKeyJwk(jwk: JsonWebKey, algorithm: CryptoUtils_2.KeyPairAlgorithm): Promise<Result<CryptoKey>>;
     sha256(data: string): Promise<Result<string>>;
     toBase64(data: Uint8Array): string;
 }