@fgv/ts-extras 5.1.0-4 → 5.1.0-41
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.browser.js +4 -2
- package/dist/index.browser.js.map +1 -0
- package/dist/index.js.map +1 -0
- package/dist/packlets/ai-assist/apiClient.js +886 -158
- package/dist/packlets/ai-assist/apiClient.js.map +1 -0
- package/dist/packlets/ai-assist/chatRequestBuilders.js +282 -0
- package/dist/packlets/ai-assist/chatRequestBuilders.js.map +1 -0
- package/dist/packlets/ai-assist/converters.js +47 -3
- package/dist/packlets/ai-assist/converters.js.map +1 -0
- package/dist/packlets/ai-assist/embeddingClient.js +345 -0
- package/dist/packlets/ai-assist/embeddingClient.js.map +1 -0
- package/dist/packlets/ai-assist/endpoint.js +78 -0
- package/dist/packlets/ai-assist/endpoint.js.map +1 -0
- package/dist/packlets/ai-assist/http.js +75 -0
- package/dist/packlets/ai-assist/http.js.map +1 -0
- package/dist/packlets/ai-assist/imageOptionsResolver.js +193 -0
- package/dist/packlets/ai-assist/imageOptionsResolver.js.map +1 -0
- package/dist/packlets/ai-assist/index.js +10 -4
- package/dist/packlets/ai-assist/index.js.map +1 -0
- package/dist/packlets/ai-assist/jsonCompletion.js +93 -0
- package/dist/packlets/ai-assist/jsonCompletion.js.map +1 -0
- package/dist/packlets/ai-assist/jsonResponse.js +149 -0
- package/dist/packlets/ai-assist/jsonResponse.js.map +1 -0
- package/dist/packlets/ai-assist/model.js +193 -9
- package/dist/packlets/ai-assist/model.js.map +1 -0
- package/dist/packlets/ai-assist/registry.js +314 -12
- package/dist/packlets/ai-assist/registry.js.map +1 -0
- package/dist/packlets/ai-assist/sseParser.js +123 -0
- package/dist/packlets/ai-assist/sseParser.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/anthropic.js +368 -0
- package/dist/packlets/ai-assist/streamingAdapters/anthropic.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.js +687 -0
- package/dist/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/common.js +187 -0
- package/dist/packlets/ai-assist/streamingAdapters/common.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/gemini.js +204 -0
- package/dist/packlets/ai-assist/streamingAdapters/gemini.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/openaiChat.js +170 -0
- package/dist/packlets/ai-assist/streamingAdapters/openaiChat.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/openaiResponses.js +386 -0
- package/dist/packlets/ai-assist/streamingAdapters/openaiResponses.js.map +1 -0
- package/dist/packlets/ai-assist/streamingAdapters/proxy.js +173 -0
- package/dist/packlets/ai-assist/streamingAdapters/proxy.js.map +1 -0
- package/dist/packlets/ai-assist/streamingClient.js +140 -0
- package/dist/packlets/ai-assist/streamingClient.js.map +1 -0
- package/dist/packlets/ai-assist/thinkingOptionsResolver.js +288 -0
- package/dist/packlets/ai-assist/thinkingOptionsResolver.js.map +1 -0
- package/dist/packlets/ai-assist/toolFormats.js +106 -10
- package/dist/packlets/ai-assist/toolFormats.js.map +1 -0
- package/dist/packlets/conversion/converters.js +35 -1
- package/dist/packlets/conversion/converters.js.map +1 -0
- package/dist/packlets/conversion/index.js.map +1 -0
- package/dist/packlets/crypto-utils/constants.js.map +1 -0
- package/dist/packlets/crypto-utils/converters.js +42 -4
- package/dist/packlets/crypto-utils/converters.js.map +1 -0
- package/dist/packlets/crypto-utils/directEncryptionProvider.js.map +1 -0
- package/dist/packlets/crypto-utils/encryptedFile.js.map +1 -0
- package/dist/packlets/crypto-utils/hpkeProvider.js +355 -0
- package/dist/packlets/crypto-utils/hpkeProvider.js.map +1 -0
- package/dist/packlets/crypto-utils/index.browser.js +10 -2
- package/dist/packlets/crypto-utils/index.browser.js.map +1 -0
- package/dist/packlets/crypto-utils/index.js +6 -0
- package/dist/packlets/crypto-utils/index.js.map +1 -0
- package/dist/packlets/crypto-utils/keyPairAlgorithmParams.js +71 -0
- package/dist/packlets/crypto-utils/keyPairAlgorithmParams.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/converters.js +105 -14
- package/dist/packlets/crypto-utils/keystore/converters.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/encryptedFilePrivateKeyStorage.js +287 -0
- package/dist/packlets/crypto-utils/keystore/encryptedFilePrivateKeyStorage.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/index.browser.js +36 -0
- package/dist/packlets/crypto-utils/keystore/index.browser.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/index.js +3 -0
- package/dist/packlets/crypto-utils/keystore/index.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/keyStore.js +773 -119
- package/dist/packlets/crypto-utils/keystore/keyStore.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/model.js +30 -4
- package/dist/packlets/crypto-utils/keystore/model.js.map +1 -0
- package/dist/packlets/crypto-utils/keystore/privateKeyStorage.js +21 -0
- package/dist/packlets/crypto-utils/keystore/privateKeyStorage.js.map +1 -0
- package/dist/packlets/crypto-utils/model.js +32 -0
- package/dist/packlets/crypto-utils/model.js.map +1 -0
- package/dist/packlets/crypto-utils/nodeCryptoProvider.js +336 -1
- package/dist/packlets/crypto-utils/nodeCryptoProvider.js.map +1 -0
- package/dist/packlets/crypto-utils/spkiHelpers.js +240 -0
- package/dist/packlets/crypto-utils/spkiHelpers.js.map +1 -0
- package/dist/packlets/csv/csvFileHelpers.js +0 -14
- package/dist/packlets/csv/csvFileHelpers.js.map +1 -0
- package/dist/packlets/csv/csvHelpers.js +14 -0
- package/dist/packlets/csv/csvHelpers.js.map +1 -0
- package/dist/packlets/csv/index.browser.js +1 -3
- package/dist/packlets/csv/index.browser.js.map +1 -0
- package/dist/packlets/csv/index.js.map +1 -0
- package/dist/packlets/experimental/extendedArray.js.map +1 -0
- package/dist/packlets/experimental/formatter.js.map +1 -0
- package/dist/packlets/experimental/index.js.map +1 -0
- package/dist/packlets/experimental/rangeOf.js.map +1 -0
- package/dist/packlets/hash/index.browser.js.map +1 -0
- package/dist/packlets/hash/index.js.map +1 -0
- package/dist/packlets/hash/index.node.js.map +1 -0
- package/dist/packlets/hash/md5Normalizer.browser.js.map +1 -0
- package/dist/packlets/hash/md5Normalizer.js.map +1 -0
- package/dist/packlets/mustache/index.js.map +1 -0
- package/dist/packlets/mustache/interfaces.js.map +1 -0
- package/dist/packlets/mustache/mustacheTemplate.js +42 -4
- package/dist/packlets/mustache/mustacheTemplate.js.map +1 -0
- package/dist/packlets/record-jar/index.browser.js +1 -3
- package/dist/packlets/record-jar/index.browser.js.map +1 -0
- package/dist/packlets/record-jar/index.js.map +1 -0
- package/dist/packlets/record-jar/recordJarFileHelpers.js +0 -18
- package/dist/packlets/record-jar/recordJarFileHelpers.js.map +1 -0
- package/dist/packlets/record-jar/recordJarHelpers.js +18 -0
- package/dist/packlets/record-jar/recordJarHelpers.js.map +1 -0
- package/dist/packlets/yaml/converters.js.map +1 -0
- package/dist/packlets/yaml/index.js +1 -0
- package/dist/packlets/yaml/index.js.map +1 -0
- package/dist/packlets/yaml/serializers.js +48 -0
- package/dist/packlets/yaml/serializers.js.map +1 -0
- package/dist/packlets/zip-file-tree/index.js.map +1 -0
- package/dist/packlets/zip-file-tree/zipFileTreeAccessors.js +2 -2
- package/dist/packlets/zip-file-tree/zipFileTreeAccessors.js.map +1 -0
- package/dist/packlets/zip-file-tree/zipFileTreeWriter.js.map +1 -0
- package/dist/ts-extras.d.ts +4342 -285
- package/dist/tsdoc-metadata.json +1 -1
- package/lib/index.browser.d.ts +4 -2
- package/lib/index.browser.d.ts.map +1 -0
- package/lib/index.browser.js +8 -3
- package/lib/index.browser.js.map +1 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js.map +1 -0
- package/lib/packlets/ai-assist/apiClient.d.ts +115 -32
- package/lib/packlets/ai-assist/apiClient.d.ts.map +1 -0
- package/lib/packlets/ai-assist/apiClient.js +888 -156
- package/lib/packlets/ai-assist/apiClient.js.map +1 -0
- package/lib/packlets/ai-assist/chatRequestBuilders.d.ts +149 -0
- package/lib/packlets/ai-assist/chatRequestBuilders.d.ts.map +1 -0
- package/lib/packlets/ai-assist/chatRequestBuilders.js +293 -0
- package/lib/packlets/ai-assist/chatRequestBuilders.js.map +1 -0
- package/lib/packlets/ai-assist/converters.d.ts +15 -1
- package/lib/packlets/ai-assist/converters.d.ts.map +1 -0
- package/lib/packlets/ai-assist/converters.js +47 -3
- package/lib/packlets/ai-assist/converters.js.map +1 -0
- package/lib/packlets/ai-assist/embeddingClient.d.ts +69 -0
- package/lib/packlets/ai-assist/embeddingClient.d.ts.map +1 -0
- package/lib/packlets/ai-assist/embeddingClient.js +349 -0
- package/lib/packlets/ai-assist/embeddingClient.js.map +1 -0
- package/lib/packlets/ai-assist/endpoint.d.ts +28 -0
- package/lib/packlets/ai-assist/endpoint.d.ts.map +1 -0
- package/lib/packlets/ai-assist/endpoint.js +82 -0
- package/lib/packlets/ai-assist/endpoint.js.map +1 -0
- package/lib/packlets/ai-assist/http.d.ts +24 -0
- package/lib/packlets/ai-assist/http.d.ts.map +1 -0
- package/lib/packlets/ai-assist/http.js +78 -0
- package/lib/packlets/ai-assist/http.js.map +1 -0
- package/lib/packlets/ai-assist/imageOptionsResolver.d.ts +66 -0
- package/lib/packlets/ai-assist/imageOptionsResolver.d.ts.map +1 -0
- package/lib/packlets/ai-assist/imageOptionsResolver.js +197 -0
- package/lib/packlets/ai-assist/imageOptionsResolver.js.map +1 -0
- package/lib/packlets/ai-assist/index.d.ts +10 -4
- package/lib/packlets/ai-assist/index.d.ts.map +1 -0
- package/lib/packlets/ai-assist/index.js +36 -1
- package/lib/packlets/ai-assist/index.js.map +1 -0
- package/lib/packlets/ai-assist/jsonCompletion.d.ts +93 -0
- package/lib/packlets/ai-assist/jsonCompletion.d.ts.map +1 -0
- package/lib/packlets/ai-assist/jsonCompletion.js +97 -0
- package/lib/packlets/ai-assist/jsonCompletion.js.map +1 -0
- package/lib/packlets/ai-assist/jsonResponse.d.ts +91 -0
- package/lib/packlets/ai-assist/jsonResponse.d.ts.map +1 -0
- package/lib/packlets/ai-assist/jsonResponse.js +154 -0
- package/lib/packlets/ai-assist/jsonResponse.js.map +1 -0
- package/lib/packlets/ai-assist/model.d.ts +1202 -12
- package/lib/packlets/ai-assist/model.d.ts.map +1 -0
- package/lib/packlets/ai-assist/model.js +198 -10
- package/lib/packlets/ai-assist/model.js.map +1 -0
- package/lib/packlets/ai-assist/registry.d.ts +56 -1
- package/lib/packlets/ai-assist/registry.d.ts.map +1 -0
- package/lib/packlets/ai-assist/registry.js +319 -13
- package/lib/packlets/ai-assist/registry.js.map +1 -0
- package/lib/packlets/ai-assist/sseParser.d.ts +45 -0
- package/lib/packlets/ai-assist/sseParser.d.ts.map +1 -0
- package/lib/packlets/ai-assist/sseParser.js +128 -0
- package/lib/packlets/ai-assist/sseParser.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/anthropic.d.ts +72 -0
- package/lib/packlets/ai-assist/streamingAdapters/anthropic.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/anthropic.js +371 -0
- package/lib/packlets/ai-assist/streamingAdapters/anthropic.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.d.ts +260 -0
- package/lib/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.js +694 -0
- package/lib/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/common.d.ts +154 -0
- package/lib/packlets/ai-assist/streamingAdapters/common.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/common.js +193 -0
- package/lib/packlets/ai-assist/streamingAdapters/common.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/gemini.d.ts +43 -0
- package/lib/packlets/ai-assist/streamingAdapters/gemini.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/gemini.js +207 -0
- package/lib/packlets/ai-assist/streamingAdapters/gemini.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiChat.d.ts +19 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiChat.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiChat.js +173 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiChat.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiResponses.d.ts +33 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiResponses.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiResponses.js +389 -0
- package/lib/packlets/ai-assist/streamingAdapters/openaiResponses.js.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/proxy.d.ts +34 -0
- package/lib/packlets/ai-assist/streamingAdapters/proxy.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingAdapters/proxy.js +176 -0
- package/lib/packlets/ai-assist/streamingAdapters/proxy.js.map +1 -0
- package/lib/packlets/ai-assist/streamingClient.d.ts +50 -0
- package/lib/packlets/ai-assist/streamingClient.d.ts.map +1 -0
- package/lib/packlets/ai-assist/streamingClient.js +146 -0
- package/lib/packlets/ai-assist/streamingClient.js.map +1 -0
- package/lib/packlets/ai-assist/thinkingOptionsResolver.d.ts +87 -0
- package/lib/packlets/ai-assist/thinkingOptionsResolver.d.ts.map +1 -0
- package/lib/packlets/ai-assist/thinkingOptionsResolver.js +294 -0
- package/lib/packlets/ai-assist/thinkingOptionsResolver.js.map +1 -0
- package/lib/packlets/ai-assist/toolFormats.d.ts +40 -9
- package/lib/packlets/ai-assist/toolFormats.d.ts.map +1 -0
- package/lib/packlets/ai-assist/toolFormats.js +107 -10
- package/lib/packlets/ai-assist/toolFormats.js.map +1 -0
- package/lib/packlets/conversion/converters.d.ts +8 -1
- package/lib/packlets/conversion/converters.d.ts.map +1 -0
- package/lib/packlets/conversion/converters.js +36 -2
- package/lib/packlets/conversion/converters.js.map +1 -0
- package/lib/packlets/conversion/index.d.ts.map +1 -0
- package/lib/packlets/conversion/index.js.map +1 -0
- package/lib/packlets/crypto-utils/constants.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/constants.js.map +1 -0
- package/lib/packlets/crypto-utils/converters.d.ts +20 -1
- package/lib/packlets/crypto-utils/converters.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/converters.js +43 -5
- package/lib/packlets/crypto-utils/converters.js.map +1 -0
- package/lib/packlets/crypto-utils/directEncryptionProvider.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/directEncryptionProvider.js.map +1 -0
- package/lib/packlets/crypto-utils/encryptedFile.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/encryptedFile.js.map +1 -0
- package/lib/packlets/crypto-utils/hpkeProvider.d.ts +150 -0
- package/lib/packlets/crypto-utils/hpkeProvider.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/hpkeProvider.js +359 -0
- package/lib/packlets/crypto-utils/hpkeProvider.js.map +1 -0
- package/lib/packlets/crypto-utils/index.browser.d.ts +4 -1
- package/lib/packlets/crypto-utils/index.browser.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/index.browser.js +22 -3
- package/lib/packlets/crypto-utils/index.browser.js.map +1 -0
- package/lib/packlets/crypto-utils/index.d.ts +3 -0
- package/lib/packlets/crypto-utils/index.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/index.js +18 -1
- package/lib/packlets/crypto-utils/index.js.map +1 -0
- package/lib/packlets/crypto-utils/keyPairAlgorithmParams.d.ts +54 -0
- package/lib/packlets/crypto-utils/keyPairAlgorithmParams.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keyPairAlgorithmParams.js +74 -0
- package/lib/packlets/crypto-utils/keyPairAlgorithmParams.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/converters.d.ts +68 -6
- package/lib/packlets/crypto-utils/keystore/converters.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/converters.js +103 -12
- package/lib/packlets/crypto-utils/keystore/converters.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/encryptedFilePrivateKeyStorage.d.ts +148 -0
- package/lib/packlets/crypto-utils/keystore/encryptedFilePrivateKeyStorage.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/encryptedFilePrivateKeyStorage.js +324 -0
- package/lib/packlets/crypto-utils/keystore/encryptedFilePrivateKeyStorage.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/index.browser.d.ts +10 -0
- package/lib/packlets/crypto-utils/keystore/index.browser.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/index.browser.js +76 -0
- package/lib/packlets/crypto-utils/keystore/index.browser.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/index.d.ts +2 -0
- package/lib/packlets/crypto-utils/keystore/index.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/index.js +5 -1
- package/lib/packlets/crypto-utils/keystore/index.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/keyStore.d.ts +270 -13
- package/lib/packlets/crypto-utils/keystore/keyStore.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/keyStore.js +778 -124
- package/lib/packlets/crypto-utils/keystore/keyStore.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/model.d.ts +350 -21
- package/lib/packlets/crypto-utils/keystore/model.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/model.js +32 -5
- package/lib/packlets/crypto-utils/keystore/model.js.map +1 -0
- package/lib/packlets/crypto-utils/keystore/privateKeyStorage.d.ts +53 -0
- package/lib/packlets/crypto-utils/keystore/privateKeyStorage.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/keystore/privateKeyStorage.js +22 -0
- package/lib/packlets/crypto-utils/keystore/privateKeyStorage.js.map +1 -0
- package/lib/packlets/crypto-utils/model.d.ts +437 -10
- package/lib/packlets/crypto-utils/model.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/model.js +33 -1
- package/lib/packlets/crypto-utils/model.js.map +1 -0
- package/lib/packlets/crypto-utils/nodeCryptoProvider.d.ts +134 -2
- package/lib/packlets/crypto-utils/nodeCryptoProvider.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/nodeCryptoProvider.js +335 -0
- package/lib/packlets/crypto-utils/nodeCryptoProvider.js.map +1 -0
- package/lib/packlets/crypto-utils/spkiHelpers.d.ts +125 -0
- package/lib/packlets/crypto-utils/spkiHelpers.d.ts.map +1 -0
- package/lib/packlets/crypto-utils/spkiHelpers.js +251 -0
- package/lib/packlets/crypto-utils/spkiHelpers.js.map +1 -0
- package/lib/packlets/csv/csvFileHelpers.d.ts +0 -10
- package/lib/packlets/csv/csvFileHelpers.d.ts.map +1 -0
- package/lib/packlets/csv/csvFileHelpers.js +0 -15
- package/lib/packlets/csv/csvFileHelpers.js.map +1 -0
- package/lib/packlets/csv/csvHelpers.d.ts +10 -0
- package/lib/packlets/csv/csvHelpers.d.ts.map +1 -0
- package/lib/packlets/csv/csvHelpers.js +15 -0
- package/lib/packlets/csv/csvHelpers.js.map +1 -0
- package/lib/packlets/csv/index.browser.d.ts +0 -1
- package/lib/packlets/csv/index.browser.d.ts.map +1 -0
- package/lib/packlets/csv/index.browser.js +1 -5
- package/lib/packlets/csv/index.browser.js.map +1 -0
- package/lib/packlets/csv/index.d.ts.map +1 -0
- package/lib/packlets/csv/index.js.map +1 -0
- package/lib/packlets/experimental/extendedArray.d.ts.map +1 -0
- package/lib/packlets/experimental/extendedArray.js.map +1 -0
- package/lib/packlets/experimental/formatter.d.ts.map +1 -0
- package/lib/packlets/experimental/formatter.js.map +1 -0
- package/lib/packlets/experimental/index.d.ts.map +1 -0
- package/lib/packlets/experimental/index.js.map +1 -0
- package/lib/packlets/experimental/rangeOf.d.ts.map +1 -0
- package/lib/packlets/experimental/rangeOf.js.map +1 -0
- package/lib/packlets/hash/index.browser.d.ts.map +1 -0
- package/lib/packlets/hash/index.browser.js.map +1 -0
- package/lib/packlets/hash/index.d.ts.map +1 -0
- package/lib/packlets/hash/index.js.map +1 -0
- package/lib/packlets/hash/index.node.d.ts.map +1 -0
- package/lib/packlets/hash/index.node.js.map +1 -0
- package/lib/packlets/hash/md5Normalizer.browser.d.ts.map +1 -0
- package/lib/packlets/hash/md5Normalizer.browser.js.map +1 -0
- package/lib/packlets/hash/md5Normalizer.d.ts.map +1 -0
- package/lib/packlets/hash/md5Normalizer.js.map +1 -0
- package/lib/packlets/mustache/index.d.ts +1 -1
- package/lib/packlets/mustache/index.d.ts.map +1 -0
- package/lib/packlets/mustache/index.js.map +1 -0
- package/lib/packlets/mustache/interfaces.d.ts +34 -0
- package/lib/packlets/mustache/interfaces.d.ts.map +1 -0
- package/lib/packlets/mustache/interfaces.js.map +1 -0
- package/lib/packlets/mustache/mustacheTemplate.d.ts +2 -0
- package/lib/packlets/mustache/mustacheTemplate.d.ts.map +1 -0
- package/lib/packlets/mustache/mustacheTemplate.js +42 -4
- package/lib/packlets/mustache/mustacheTemplate.js.map +1 -0
- package/lib/packlets/record-jar/index.browser.d.ts +0 -1
- package/lib/packlets/record-jar/index.browser.d.ts.map +1 -0
- package/lib/packlets/record-jar/index.browser.js +1 -5
- package/lib/packlets/record-jar/index.browser.js.map +1 -0
- package/lib/packlets/record-jar/index.d.ts.map +1 -0
- package/lib/packlets/record-jar/index.js.map +1 -0
- package/lib/packlets/record-jar/recordJarFileHelpers.d.ts +0 -11
- package/lib/packlets/record-jar/recordJarFileHelpers.d.ts.map +1 -0
- package/lib/packlets/record-jar/recordJarFileHelpers.js +0 -19
- package/lib/packlets/record-jar/recordJarFileHelpers.js.map +1 -0
- package/lib/packlets/record-jar/recordJarHelpers.d.ts +11 -0
- package/lib/packlets/record-jar/recordJarHelpers.d.ts.map +1 -0
- package/lib/packlets/record-jar/recordJarHelpers.js +19 -0
- package/lib/packlets/record-jar/recordJarHelpers.js.map +1 -0
- package/lib/packlets/yaml/converters.d.ts.map +1 -0
- package/lib/packlets/yaml/converters.js.map +1 -0
- package/lib/packlets/yaml/index.d.ts +1 -0
- package/lib/packlets/yaml/index.d.ts.map +1 -0
- package/lib/packlets/yaml/index.js +1 -0
- package/lib/packlets/yaml/index.js.map +1 -0
- package/lib/packlets/yaml/serializers.d.ts +45 -0
- package/lib/packlets/yaml/serializers.d.ts.map +1 -0
- package/lib/packlets/yaml/serializers.js +84 -0
- package/lib/packlets/yaml/serializers.js.map +1 -0
- package/lib/packlets/zip-file-tree/index.d.ts.map +1 -0
- package/lib/packlets/zip-file-tree/index.js.map +1 -0
- package/lib/packlets/zip-file-tree/zipFileTreeAccessors.d.ts +2 -2
- package/lib/packlets/zip-file-tree/zipFileTreeAccessors.d.ts.map +1 -0
- package/lib/packlets/zip-file-tree/zipFileTreeAccessors.js +2 -2
- package/lib/packlets/zip-file-tree/zipFileTreeAccessors.js.map +1 -0
- package/lib/packlets/zip-file-tree/zipFileTreeWriter.d.ts.map +1 -0
- package/lib/packlets/zip-file-tree/zipFileTreeWriter.js.map +1 -0
- package/package.json +20 -15
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { JsonValue } from '@fgv/ts-json-base';
|
|
2
2
|
import { Result } from '@fgv/ts-utils';
|
|
3
|
-
import { ICryptoProvider, IEncryptedFile, IEncryptionConfig, IEncryptionProvider, SecretProvider } from '../model';
|
|
4
|
-
import { IAddSecretFromPasswordOptions, IAddSecretFromPasswordResult, IAddSecretOptions, IAddSecretResult, IImportSecretOptions, IKeyStoreCreateParams, IKeyStoreFile, IKeyStoreOpenParams,
|
|
3
|
+
import { ICryptoProvider, IEncryptedFile, IEncryptionConfig, IEncryptionProvider, IArgon2idKeyDerivationParams, IArgon2idProvider, IKeyDerivationParams, SecretProvider } from '../model';
|
|
4
|
+
import { IAddKeyPairOptions, IAddKeyPairResult, IAddSecretFromPasswordArgon2idOptions, IAddSecretFromPasswordOptions, IAddSecretFromPasswordResult, IAddSecretOptions, IAddSecretResult, IGetKeyPairOptions, IImportKeyOptions, IImportSecretOptions, IKeyStoreCreateParams, IKeyStoreEntry, IKeyStoreFile, IKeyStoreOpenParams, IRemoveSecretResult, KeyStoreLockState, KeyStoreSecretType } from './model';
|
|
5
5
|
/**
|
|
6
6
|
* Password-protected key store for managing encryption secrets.
|
|
7
7
|
*
|
|
@@ -31,10 +31,25 @@ import { IAddSecretFromPasswordOptions, IAddSecretFromPasswordResult, IAddSecret
|
|
|
31
31
|
* const encryptionConfig = keystore2.getEncryptionConfig().orThrow();
|
|
32
32
|
* ```
|
|
33
33
|
*
|
|
34
|
+
* @remarks
|
|
35
|
+
* SECURITY — private-key escrow. By default an asymmetric keypair's private
|
|
36
|
+
* key lives only in the per-device {@link CryptoUtils.KeyStore.IPrivateKeyStorage}
|
|
37
|
+
* backend; the vault carries only the public JWK, so a vault recovered on a new
|
|
38
|
+
* device reconstitutes with no private keys (a lost device is a lost identity).
|
|
39
|
+
* `addKeyPair(name, { escrow: true })` opts into carrying an encrypted private-key
|
|
40
|
+
* copy inside the vault ciphertext, so the vault file plus the master password can
|
|
41
|
+
* recover the identity on a fresh device via `getKeyPair(name, { rehydrate: true })`.
|
|
42
|
+
*
|
|
43
|
+
* When escrow is used, **the master password becomes the sole gate** protecting a
|
|
44
|
+
* private signing/decryption key that was previously unrecoverable from the vault.
|
|
45
|
+
* Configure escrow-bearing stores with a strong KDF — an Argon2id-derived master
|
|
46
|
+
* key or a high-iteration PBKDF2 count — and treat the vault file accordingly.
|
|
47
|
+
*
|
|
34
48
|
* @public
|
|
35
49
|
*/
|
|
36
50
|
export declare class KeyStore implements IEncryptionProvider {
|
|
37
51
|
private readonly _cryptoProvider;
|
|
52
|
+
private readonly _privateKeyStorage;
|
|
38
53
|
private readonly _iterations;
|
|
39
54
|
private _keystoreFile;
|
|
40
55
|
private _salt;
|
|
@@ -76,6 +91,21 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
76
91
|
* @public
|
|
77
92
|
*/
|
|
78
93
|
unlock(password: string): Promise<Result<KeyStore>>;
|
|
94
|
+
/**
|
|
95
|
+
* Unlocks an existing key store with a pre-derived key, bypassing
|
|
96
|
+
* PBKDF2 key derivation. Use this when the derived key has been
|
|
97
|
+
* stored externally (e.g., in another key store) and the original
|
|
98
|
+
* password is no longer available.
|
|
99
|
+
*
|
|
100
|
+
* The supplied key must have been derived from the correct password
|
|
101
|
+
* using the key store file's own PBKDF2 parameters (salt and
|
|
102
|
+
* iteration count).
|
|
103
|
+
*
|
|
104
|
+
* @param derivedKey - The pre-derived master key (32 bytes for AES-256)
|
|
105
|
+
* @returns Success with this instance when unlocked, Failure if key is incorrect
|
|
106
|
+
* @public
|
|
107
|
+
*/
|
|
108
|
+
unlockWithKey(derivedKey: Uint8Array): Promise<Result<KeyStore>>;
|
|
79
109
|
/**
|
|
80
110
|
* Locks the key store, clearing all secrets from memory.
|
|
81
111
|
* @param force - If true, discards unsaved changes
|
|
@@ -118,12 +148,29 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
118
148
|
*/
|
|
119
149
|
listSecrets(): Result<readonly string[]>;
|
|
120
150
|
/**
|
|
121
|
-
* Gets a secret by name.
|
|
151
|
+
* Gets a secret by name. Returns the {@link CryptoUtils.KeyStore.IKeyStoreEntry | discriminated union}
|
|
152
|
+
* — callers must check `entry.type` before accessing `key`/`id` since asymmetric
|
|
153
|
+
* entries carry no raw key material.
|
|
154
|
+
*
|
|
155
|
+
* SECURITY: for an escrow-enabled asymmetric-keypair entry the returned object
|
|
156
|
+
* carries `escrowedPrivateKeyJwk` in cleartext (same custody class as
|
|
157
|
+
* `publicKeyJwk`, gated by the same unlock) — do not log or serialize a
|
|
158
|
+
* `getSecret()` result casually.
|
|
159
|
+
*
|
|
122
160
|
* @param name - Name of the secret
|
|
123
161
|
* @returns Success with secret entry, Failure if not found or locked
|
|
124
162
|
* @public
|
|
125
163
|
*/
|
|
126
|
-
getSecret(name: string): Result<
|
|
164
|
+
getSecret(name: string): Result<IKeyStoreEntry>;
|
|
165
|
+
/**
|
|
166
|
+
* Returns the public-key JWK for an asymmetric-keypair entry.
|
|
167
|
+
* Available without {@link CryptoUtils.KeyStore.IPrivateKeyStorage} since the
|
|
168
|
+
* public key lives in the vault metadata directly.
|
|
169
|
+
* @param name - Name of the entry
|
|
170
|
+
* @returns Success with the JWK, Failure if not found, locked, or wrong type
|
|
171
|
+
* @public
|
|
172
|
+
*/
|
|
173
|
+
getPublicKeyJwk(name: string): Result<JsonWebKey>;
|
|
127
174
|
/**
|
|
128
175
|
* Checks if a secret exists.
|
|
129
176
|
* @param name - Name of the secret
|
|
@@ -140,14 +187,20 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
140
187
|
*/
|
|
141
188
|
addSecret(name: string, options?: IAddSecretOptions): Promise<Result<IAddSecretResult>>;
|
|
142
189
|
/**
|
|
143
|
-
* Imports
|
|
190
|
+
* Imports raw 32-byte key material into the vault.
|
|
191
|
+
*
|
|
192
|
+
* Always validates that the key is exactly 32 bytes (AES-256). The optional
|
|
193
|
+
* `type` field is a classification label stored with the entry; it does not
|
|
194
|
+
* change the validation rules. For importing UTF-8 API key strings (variable
|
|
195
|
+
* length), use {@link KeyStore.importApiKey} instead.
|
|
196
|
+
*
|
|
144
197
|
* @param name - Unique name for the secret
|
|
145
|
-
* @param key - The 32-byte AES-256 key
|
|
146
|
-
* @param options - Optional description, whether to replace existing
|
|
198
|
+
* @param key - The 32-byte AES-256 key material
|
|
199
|
+
* @param options - Optional type classification, description, whether to replace existing
|
|
147
200
|
* @returns Success with entry, Failure if locked, key invalid, or exists and !replace
|
|
148
201
|
* @public
|
|
149
202
|
*/
|
|
150
|
-
importSecret(name: string, key: Uint8Array, options?:
|
|
203
|
+
importSecret(name: string, key: Uint8Array, options?: IImportKeyOptions): Promise<Result<IAddSecretResult>>;
|
|
151
204
|
/**
|
|
152
205
|
* Adds a secret derived from a password using PBKDF2.
|
|
153
206
|
*
|
|
@@ -164,12 +217,81 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
164
217
|
*/
|
|
165
218
|
addSecretFromPassword(name: string, password: string, options?: IAddSecretFromPasswordOptions): Promise<Result<IAddSecretFromPasswordResult>>;
|
|
166
219
|
/**
|
|
167
|
-
*
|
|
220
|
+
* Verifies that a candidate password derives the same key material currently
|
|
221
|
+
* stored under `name`, using the supplied
|
|
222
|
+
* {@link CryptoUtils.IKeyDerivationParams | key derivation parameters}.
|
|
223
|
+
*
|
|
224
|
+
* The keystore does not persist per-slot key derivation parameters with the
|
|
225
|
+
* entry — callers receive them from `addSecretFromPassword` and store them
|
|
226
|
+
* alongside the encrypted artifact (or wherever else makes sense). Pass
|
|
227
|
+
* those same parameters here for verification.
|
|
228
|
+
*
|
|
229
|
+
* Re-derives a key from `password` + `keyDerivation`, then compares it to
|
|
230
|
+
* the stored key material in constant time. Restricted to entries of type
|
|
231
|
+
* `'encryption-key'` — the type produced by `addSecretFromPassword`. Other
|
|
232
|
+
* symmetric types (`'api-key'`) and asymmetric entries are rejected so
|
|
233
|
+
* the boolean result reflects "this slot accepts this password" rather
|
|
234
|
+
* than an incidental byte-equality match against unrelated material.
|
|
235
|
+
*
|
|
236
|
+
* Note: the keystore does not currently flag whether an `'encryption-key'`
|
|
237
|
+
* entry was actually password-derived (vs. random via `addSecret` or raw
|
|
238
|
+
* via `importSecret`). A `true` result therefore means "the candidate
|
|
239
|
+
* password produces the same 32 bytes currently stored", which is what
|
|
240
|
+
* the equivalent consumer-side helper (`verifyGatePassword`) already
|
|
241
|
+
* implies for entries it manages.
|
|
242
|
+
*
|
|
243
|
+
* @param name - Name of the secret to verify against
|
|
244
|
+
* @param password - Candidate password to test
|
|
245
|
+
* @param keyDerivation - The key derivation parameters returned by
|
|
246
|
+
* `addSecretFromPassword` when the secret was created. Only
|
|
247
|
+
* `kdf: 'pbkdf2'` is supported.
|
|
248
|
+
* @returns Success(true) when the candidate matches the stored key,
|
|
249
|
+
* Success(false) when it does not, Failure if locked, secret missing,
|
|
250
|
+
* wrong type, unsupported `kdf`, or key derivation fails
|
|
251
|
+
* @public
|
|
252
|
+
*/
|
|
253
|
+
verifySecretFromPassword(name: string, password: string, keyDerivation: IKeyDerivationParams): Promise<Result<boolean>>;
|
|
254
|
+
/**
|
|
255
|
+
* Adds a secret derived from a password using Argon2id (RFC 9106).
|
|
256
|
+
*
|
|
257
|
+
* The Argon2id provider must be supplied explicitly; the KeyStore does not
|
|
258
|
+
* hold one by default (consumers opt in by depending on the argon2 package).
|
|
259
|
+
*
|
|
260
|
+
* Returns the key derivation parameters so callers can store them alongside
|
|
261
|
+
* encrypted artifacts, enabling future re-derivation and verification.
|
|
262
|
+
*
|
|
263
|
+
* @param name - Unique name for the secret
|
|
264
|
+
* @param password - Password or passphrase
|
|
265
|
+
* @param argon2idProvider - Argon2id provider (Node or Browser implementation)
|
|
266
|
+
* @param options - Optional: Argon2id params (defaults to ARGON2ID_OWASP_MIN), description, replace flag
|
|
267
|
+
* @returns Success with entry and keyDerivation params, Failure if locked or invalid
|
|
268
|
+
* @public
|
|
269
|
+
*/
|
|
270
|
+
addSecretFromPasswordArgon2id(name: string, password: string, argon2idProvider: IArgon2idProvider, options?: IAddSecretFromPasswordArgon2idOptions): Promise<Result<IAddSecretFromPasswordResult>>;
|
|
271
|
+
/**
|
|
272
|
+
* Verifies a candidate password against an Argon2id-derived entry using the
|
|
273
|
+
* supplied key derivation parameters. Constant-time comparison.
|
|
274
|
+
*
|
|
275
|
+
* @param name - Name of the secret to verify against
|
|
276
|
+
* @param password - Candidate password to test
|
|
277
|
+
* @param argon2idProvider - Argon2id provider (must produce bit-identical output for identical inputs)
|
|
278
|
+
* @param keyDerivation - The Argon2id key derivation parameters returned by `addSecretFromPasswordArgon2id`
|
|
279
|
+
* @returns Success(true) if candidate matches stored key, Success(false) if not,
|
|
280
|
+
* Failure if locked, secret missing, wrong type, or derivation fails
|
|
281
|
+
* @public
|
|
282
|
+
*/
|
|
283
|
+
verifySecretFromPasswordArgon2id(name: string, password: string, argon2idProvider: IArgon2idProvider, keyDerivation: IArgon2idKeyDerivationParams): Promise<Result<boolean>>;
|
|
284
|
+
/**
|
|
285
|
+
* Removes a secret by name. Vault-first: the in-memory vault entry is dropped
|
|
286
|
+
* before any storage cleanup runs. For asymmetric-keypair entries, best-effort
|
|
287
|
+
* calls {@link CryptoUtils.KeyStore.IPrivateKeyStorage}.delete on the entry's
|
|
288
|
+
* `id`; a failure is reported via `warning` on the result but does not roll
|
|
289
|
+
* back the vault removal.
|
|
168
290
|
* @param name - Name of the secret to remove
|
|
169
|
-
* @returns Success with removed entry, Failure if not found or locked
|
|
291
|
+
* @returns Success with removed entry (and optional warning), Failure if not found or locked
|
|
170
292
|
* @public
|
|
171
293
|
*/
|
|
172
|
-
removeSecret(name: string): Result<
|
|
294
|
+
removeSecret(name: string): Promise<Result<IRemoveSecretResult>>;
|
|
173
295
|
/**
|
|
174
296
|
* Imports an API key string into the vault.
|
|
175
297
|
* The string is UTF-8 encoded and stored with type `'api-key'`.
|
|
@@ -179,7 +301,7 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
179
301
|
* @returns Success with entry, Failure if locked, empty, or exists and !replace
|
|
180
302
|
* @public
|
|
181
303
|
*/
|
|
182
|
-
importApiKey(name: string, apiKey: string, options?: IImportSecretOptions): Result<IAddSecretResult
|
|
304
|
+
importApiKey(name: string, apiKey: string, options?: IImportSecretOptions): Promise<Result<IAddSecretResult>>;
|
|
183
305
|
/**
|
|
184
306
|
* Retrieves an API key string by name.
|
|
185
307
|
* Only works for secrets with type `'api-key'`.
|
|
@@ -188,6 +310,59 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
188
310
|
* @public
|
|
189
311
|
*/
|
|
190
312
|
getApiKey(name: string): Result<string>;
|
|
313
|
+
/**
|
|
314
|
+
* Adds a new asymmetric keypair to the vault. Storage-first: the private key
|
|
315
|
+
* is stored under a freshly-minted `id` before the public-key vault entry is
|
|
316
|
+
* committed. If the storage call fails, no vault entry is written and the
|
|
317
|
+
* operation returns Failure.
|
|
318
|
+
*
|
|
319
|
+
* When `replace: true` displaces an existing entry (asymmetric or symmetric),
|
|
320
|
+
* a fresh `id` is minted; the displaced entry's resources are released
|
|
321
|
+
* best-effort. Failure of the storage delete is reported via `warning` on the
|
|
322
|
+
* result but does not roll back the replacement.
|
|
323
|
+
*
|
|
324
|
+
* Requires a {@link CryptoUtils.KeyStore.IPrivateKeyStorage} backend
|
|
325
|
+
* supplied at construction.
|
|
326
|
+
*
|
|
327
|
+
* Extractability of the generated private key defaults to the storage
|
|
328
|
+
* backend's {@link CryptoUtils.KeyStore.IPrivateKeyStorage.supportsNonExtractable}.
|
|
329
|
+
* `options.extractable` overrides that default for this key only; requesting
|
|
330
|
+
* `extractable: false` against a backend that cannot store non-extractable
|
|
331
|
+
* keys fails loudly rather than silently generating an extractable key.
|
|
332
|
+
*
|
|
333
|
+
* @param name - Unique name for the entry
|
|
334
|
+
* @param options - Algorithm, optional description, replace flag, extractable override
|
|
335
|
+
* @returns Success with the new entry, Failure if locked, no provider, storage write failed,
|
|
336
|
+
* or the requested extractability cannot be honored by the backend
|
|
337
|
+
* @public
|
|
338
|
+
*/
|
|
339
|
+
addKeyPair(name: string, options: IAddKeyPairOptions): Promise<Result<IAddKeyPairResult>>;
|
|
340
|
+
/**
|
|
341
|
+
* Retrieves the keypair for an asymmetric-keypair entry. The private key is
|
|
342
|
+
* loaded from {@link CryptoUtils.KeyStore.IPrivateKeyStorage} on every call —
|
|
343
|
+
* the keystore never caches private `CryptoKey` references between calls.
|
|
344
|
+
* The public key is re-imported from the vault's JWK so callers always
|
|
345
|
+
* receive a `CryptoKey` rather than the JWK form.
|
|
346
|
+
*
|
|
347
|
+
* With `options.rehydrate: true`, if the storage backend holds no blob for
|
|
348
|
+
* the entry's `id` and the entry carries an `escrowedPrivateKeyJwk` (see
|
|
349
|
+
* `addKeyPair(name, { escrow: true })`), the escrowed JWK is imported and
|
|
350
|
+
* stored under the entry's `id` before being returned — recovering the
|
|
351
|
+
* private key on a fresh device from the vault plus master password. This is
|
|
352
|
+
* fill-a-gap only: an existing storage blob is never overwritten.
|
|
353
|
+
*
|
|
354
|
+
* @param name - Name of the entry
|
|
355
|
+
* @param options - Optional {@link CryptoUtils.KeyStore.IGetKeyPairOptions}
|
|
356
|
+
* (currently the `rehydrate` escrow-recovery flag).
|
|
357
|
+
* @returns Success with `{ publicKey, privateKey }`, Failure if not found,
|
|
358
|
+
* locked, wrong type, no provider, or storage load (and any escrow
|
|
359
|
+
* rehydration) failed.
|
|
360
|
+
* @public
|
|
361
|
+
*/
|
|
362
|
+
getKeyPair(name: string, options?: IGetKeyPairOptions): Promise<Result<{
|
|
363
|
+
publicKey: CryptoKey;
|
|
364
|
+
privateKey: CryptoKey;
|
|
365
|
+
}>>;
|
|
191
366
|
/**
|
|
192
367
|
* Lists secret names filtered by type.
|
|
193
368
|
* @param type - The secret type to filter by
|
|
@@ -202,7 +377,7 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
202
377
|
* @returns Success with updated entry, Failure if source not found, target exists, or locked
|
|
203
378
|
* @public
|
|
204
379
|
*/
|
|
205
|
-
renameSecret(oldName: string, newName: string): Result<
|
|
380
|
+
renameSecret(oldName: string, newName: string): Result<IKeyStoreEntry>;
|
|
206
381
|
/**
|
|
207
382
|
* Saves the key store, returning the encrypted file content.
|
|
208
383
|
* Requires the master password to encrypt.
|
|
@@ -211,6 +386,20 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
211
386
|
* @public
|
|
212
387
|
*/
|
|
213
388
|
save(password: string): Promise<Result<IKeyStoreFile>>;
|
|
389
|
+
/**
|
|
390
|
+
* Saves the key store using a pre-derived key, bypassing PBKDF2 key
|
|
391
|
+
* derivation. Use this when the derived key has been stored externally
|
|
392
|
+
* (e.g., in another key store) and the original password is no longer
|
|
393
|
+
* available.
|
|
394
|
+
*
|
|
395
|
+
* The supplied key must be the same key that was (or would be) derived
|
|
396
|
+
* from the master password using the key store's PBKDF2 parameters.
|
|
397
|
+
*
|
|
398
|
+
* @param derivedKey - The pre-derived master key (32 bytes for AES-256)
|
|
399
|
+
* @returns Success with IKeyStoreFile, Failure if locked or key invalid
|
|
400
|
+
* @public
|
|
401
|
+
*/
|
|
402
|
+
saveWithKey(derivedKey: Uint8Array): Promise<Result<IKeyStoreFile>>;
|
|
214
403
|
/**
|
|
215
404
|
* Changes the master password.
|
|
216
405
|
* Re-encrypts the vault with the new password-derived key.
|
|
@@ -235,5 +424,73 @@ export declare class KeyStore implements IEncryptionProvider {
|
|
|
235
424
|
* @public
|
|
236
425
|
*/
|
|
237
426
|
getEncryptionConfig(): Result<Pick<IEncryptionConfig, 'secretProvider' | 'cryptoProvider'>>;
|
|
427
|
+
/**
|
|
428
|
+
* Encrypts the vault with a derived key and returns the key store file.
|
|
429
|
+
* Shared by `save()` and `saveWithKey()`.
|
|
430
|
+
*/
|
|
431
|
+
private _encryptVault;
|
|
432
|
+
/**
|
|
433
|
+
* Decrypts the vault with a derived key and loads secrets into memory.
|
|
434
|
+
* Shared by `unlock()` and `unlockWithKey()`.
|
|
435
|
+
*/
|
|
436
|
+
private _decryptVault;
|
|
437
|
+
/**
|
|
438
|
+
* Releases the resources held by an entry being displaced from the vault.
|
|
439
|
+
* Symmetric entries get their key buffer zeroed in place. Asymmetric entries
|
|
440
|
+
* have their private-key blob best-effort deleted from
|
|
441
|
+
* {@link CryptoUtils.KeyStore.IPrivateKeyStorage}; if the storage call fails,
|
|
442
|
+
* a warning string is returned but the displacement still proceeds — the
|
|
443
|
+
* orphaned blob is left for consumer-side GC. Without a configured provider,
|
|
444
|
+
* asymmetric cleanup is silently skipped.
|
|
445
|
+
* @returns A warning string if storage cleanup failed, otherwise undefined.
|
|
446
|
+
*/
|
|
447
|
+
private _releaseEntryResources;
|
|
448
|
+
/**
|
|
449
|
+
* Exports the transient extractable private `CryptoKey` to a JWK for escrow,
|
|
450
|
+
* via WebCrypto's `exportKey('jwk', ...)` (cross-runtime through
|
|
451
|
+
* `globalThis.crypto.subtle`). The result is carried in the vault entry — the
|
|
452
|
+
* same custody class as the public JWK — and is never returned from a public
|
|
453
|
+
* method nor logged.
|
|
454
|
+
*/
|
|
455
|
+
private _exportPrivateKeyJwk;
|
|
456
|
+
/**
|
|
457
|
+
* Re-imports an escrowed private-key JWK as a `CryptoKey` for `algorithm`
|
|
458
|
+
* with the requested extractability. The WebCrypto JWK-import descriptor is
|
|
459
|
+
* shared between the public and private halves for every supported algorithm,
|
|
460
|
+
* so `IKeyPairAlgorithmParams.importPublicKey` is reused; the private/public
|
|
461
|
+
* distinction is carried by the requested usages (see
|
|
462
|
+
* {@link KeyStore._privateKeyUsagesFor}). Cross-runtime through
|
|
463
|
+
* `globalThis.crypto.subtle`.
|
|
464
|
+
*/
|
|
465
|
+
private _importEscrowedPrivateKey;
|
|
466
|
+
/**
|
|
467
|
+
* Loads the private key for `entry` from storage, or — when
|
|
468
|
+
* `options.rehydrate` is set, storage holds no blob, and the entry carries an
|
|
469
|
+
* escrowed JWK — imports the escrowed key, persists it under the entry's `id`
|
|
470
|
+
* (fill-a-gap; never overwrites an existing blob), and returns it.
|
|
471
|
+
*/
|
|
472
|
+
private _loadOrRehydratePrivateKey;
|
|
473
|
+
/**
|
|
474
|
+
* Computes the key usages to request when importing an escrowed private JWK.
|
|
475
|
+
* Mirrors `EncryptedFilePrivateKeyStorage`: intersect the algorithm's private
|
|
476
|
+
* usages (its keypair usages minus the public-only ones) with the JWK's
|
|
477
|
+
* recorded `key_ops` so we request exactly the operations the stored key
|
|
478
|
+
* supports; fall back to the algorithm's private usages when `key_ops` is
|
|
479
|
+
* absent.
|
|
480
|
+
*/
|
|
481
|
+
private static _privateKeyUsagesFor;
|
|
482
|
+
/**
|
|
483
|
+
* Constant-time byte comparison. Returns false immediately for length
|
|
484
|
+
* mismatch (length is not secret); for equal-length inputs, walks the full
|
|
485
|
+
* buffer accumulating differences via XOR so the running time does not leak
|
|
486
|
+
* the position of the first differing byte.
|
|
487
|
+
*/
|
|
488
|
+
private static _timingSafeEqual;
|
|
489
|
+
/**
|
|
490
|
+
* Mints a fresh UUID v4 storage handle using the crypto provider's
|
|
491
|
+
* {@link CryptoUtils.ICryptoProvider.generateRandomBytes | generateRandomBytes}.
|
|
492
|
+
* Random-bytes failures propagate as Failure.
|
|
493
|
+
*/
|
|
494
|
+
private _generateId;
|
|
238
495
|
}
|
|
239
496
|
//# sourceMappingURL=keyStore.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"keyStore.d.ts","sourceRoot":"","sources":["../../../../src/packlets/crypto-utils/keystore/keyStore.ts"],"names":[],"mappings":"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"}
|