@awacloud/fw 0.1.0
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/CHANGELOG.md +79 -0
- package/LICENSE +176 -0
- package/NOTICE +12 -0
- package/README.md +355 -0
- package/dist/build/fw.core.pure.meta.json +29 -0
- package/dist/build/fw.core.pure.min.js +26 -0
- package/dist/build/fw.full.pure.meta.json +224 -0
- package/dist/build/fw.full.pure.min.js +60 -0
- package/dist/build/fw.minimal.pure.meta.json +21 -0
- package/dist/build/fw.minimal.pure.min.js +26 -0
- package/dist/build/fw.pack.compress-heavy.pure.meta.json +29 -0
- package/dist/build/fw.pack.compress-heavy.pure.min.js +8 -0
- package/dist/build/fw.pack.crypto-advanced.pure.meta.json +38 -0
- package/dist/build/fw.pack.crypto-advanced.pure.min.js +6 -0
- package/dist/build/fw.pack.crypto-basic.pure.meta.json +29 -0
- package/dist/build/fw.pack.crypto-basic.pure.min.js +6 -0
- package/dist/build/fw.pack.crypto-identity.pure.meta.json +29 -0
- package/dist/build/fw.pack.crypto-identity.pure.min.js +9 -0
- package/dist/build/fw.pack.realtime.pure.meta.json +21 -0
- package/dist/build/fw.pack.realtime.pure.min.js +6 -0
- package/dist/build/fw.pack.sensors.pure.meta.json +21 -0
- package/dist/build/fw.pack.sensors.pure.min.js +6 -0
- package/dist/build/fw.pack.structures-advanced.pure.meta.json +20 -0
- package/dist/build/fw.pack.structures-advanced.pure.min.js +6 -0
- package/dist/build/fw.pack.text-advanced.pure.meta.json +20 -0
- package/dist/build/fw.pack.text-advanced.pure.min.js +6 -0
- package/dist/build/fw.pwa.pure.meta.json +127 -0
- package/dist/build/fw.pwa.pure.min.js +55 -0
- package/dist/build/fw.site-interactive.pure.meta.json +81 -0
- package/dist/build/fw.site-interactive.pure.min.js +52 -0
- package/dist/build/fw.site.pure.meta.json +51 -0
- package/dist/build/fw.site.pure.min.js +35 -0
- package/dist/build/fw.spa.pure.meta.json +108 -0
- package/dist/build/fw.spa.pure.min.js +55 -0
- package/dist/build/io/compress/brotli_dict.bin +432 -0
- package/dist/build/sanity-base-classic.min.js +6 -0
- package/dist/build/sanity-community-classic.min.js +6 -0
- package/dist/build/sanity.min.js +6 -0
- package/dist/types/core/logger.d.ts +71 -0
- package/dist/types/core/logger.d.ts.map +1 -0
- package/dist/types/core/modules.d.ts +3962 -0
- package/dist/types/core/modules.d.ts.map +1 -0
- package/dist/types/core/readyState.d.ts +14 -0
- package/dist/types/core/readyState.d.ts.map +1 -0
- package/dist/types/core/runtime.d.ts +625 -0
- package/dist/types/core/runtime.d.ts.map +1 -0
- package/dist/types/core/worker-helper.d.ts +153 -0
- package/dist/types/core/worker-helper.d.ts.map +1 -0
- package/dist/types/crypto/cipher/aes.d.ts +55 -0
- package/dist/types/crypto/cipher/aes.d.ts.map +1 -0
- package/dist/types/crypto/cipher/chacha20.d.ts +33 -0
- package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -0
- package/dist/types/crypto/hash/adf.d.ts +65 -0
- package/dist/types/crypto/hash/adf.d.ts.map +1 -0
- package/dist/types/crypto/hash/argon2.d.ts +79 -0
- package/dist/types/crypto/hash/argon2.d.ts.map +1 -0
- package/dist/types/crypto/hash/blake2b.d.ts +40 -0
- package/dist/types/crypto/hash/blake2b.d.ts.map +1 -0
- package/dist/types/crypto/hash/hkdf.d.ts +88 -0
- package/dist/types/crypto/hash/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/hash/hmac.d.ts +85 -0
- package/dist/types/crypto/hash/hmac.d.ts.map +1 -0
- package/dist/types/crypto/hash/pbkdf2.d.ts +80 -0
- package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/hash/poly1305.d.ts +31 -0
- package/dist/types/crypto/hash/poly1305.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha224.d.ts +80 -0
- package/dist/types/crypto/hash/sha224.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha256.d.ts +82 -0
- package/dist/types/crypto/hash/sha256.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha3.d.ts +111 -0
- package/dist/types/crypto/hash/sha3.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha384.d.ts +84 -0
- package/dist/types/crypto/hash/sha384.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512.d.ts +87 -0
- package/dist/types/crypto/hash/sha512.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512_224.d.ts +84 -0
- package/dist/types/crypto/hash/sha512_224.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512_256.d.ts +84 -0
- package/dist/types/crypto/hash/sha512_256.d.ts.map +1 -0
- package/dist/types/crypto/mode/cbc.d.ts +38 -0
- package/dist/types/crypto/mode/cbc.d.ts.map +1 -0
- package/dist/types/crypto/mode/chacha20poly1305.d.ts +71 -0
- package/dist/types/crypto/mode/chacha20poly1305.d.ts.map +1 -0
- package/dist/types/crypto/mode/cmac.d.ts +56 -0
- package/dist/types/crypto/mode/cmac.d.ts.map +1 -0
- package/dist/types/crypto/mode/ctr.d.ts +52 -0
- package/dist/types/crypto/mode/ctr.d.ts.map +1 -0
- package/dist/types/crypto/mode/gcm.d.ts +88 -0
- package/dist/types/crypto/mode/gcm.d.ts.map +1 -0
- package/dist/types/crypto/mode/kw.d.ts +60 -0
- package/dist/types/crypto/mode/kw.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ecc.d.ts +284 -0
- package/dist/types/crypto/pkc/ecc.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ed25519.d.ts +107 -0
- package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/pkc/hybridKem.d.ts +154 -0
- package/dist/types/crypto/pkc/hybridKem.d.ts.map +1 -0
- package/dist/types/crypto/pkc/hybridSign.d.ts +383 -0
- package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ml_dsa.d.ts +174 -0
- package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ml_kem.d.ts +194 -0
- package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -0
- package/dist/types/crypto/pkc/rsa.d.ts +175 -0
- package/dist/types/crypto/pkc/rsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/slh_dsa.d.ts +232 -0
- package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/x25519.d.ts +37 -0
- package/dist/types/crypto/pkc/x25519.d.ts.map +1 -0
- package/dist/types/crypto/utils/aes_ctr.d.ts +84 -0
- package/dist/types/crypto/utils/aes_ctr.d.ts.map +1 -0
- package/dist/types/crypto/utils/aes_modes.d.ts +128 -0
- package/dist/types/crypto/utils/aes_modes.d.ts.map +1 -0
- package/dist/types/crypto/utils/asn1-oid.d.ts +45 -0
- package/dist/types/crypto/utils/asn1-oid.d.ts.map +1 -0
- package/dist/types/crypto/utils/asn1.d.ts +115 -0
- package/dist/types/crypto/utils/asn1.d.ts.map +1 -0
- package/dist/types/crypto/utils/bitArray.d.ts +75 -0
- package/dist/types/crypto/utils/bitArray.d.ts.map +1 -0
- package/dist/types/crypto/utils/bn.d.ts +214 -0
- package/dist/types/crypto/utils/bn.d.ts.map +1 -0
- package/dist/types/crypto/utils/jws.d.ts +159 -0
- package/dist/types/crypto/utils/jws.d.ts.map +1 -0
- package/dist/types/crypto/utils/keyformat.d.ts +100 -0
- package/dist/types/crypto/utils/keyformat.d.ts.map +1 -0
- package/dist/types/crypto/utils/pad.d.ts +44 -0
- package/dist/types/crypto/utils/pad.d.ts.map +1 -0
- package/dist/types/crypto/utils/pem.d.ts +41 -0
- package/dist/types/crypto/utils/pem.d.ts.map +1 -0
- package/dist/types/crypto/utils/random.d.ts +203 -0
- package/dist/types/crypto/utils/random.d.ts.map +1 -0
- package/dist/types/crypto/utils/rsaKeygen.d.ts +162 -0
- package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -0
- package/dist/types/crypto/utils/totp.d.ts +183 -0
- package/dist/types/crypto/utils/totp.d.ts.map +1 -0
- package/dist/types/crypto/utils/uuid.d.ts +29 -0
- package/dist/types/crypto/utils/uuid.d.ts.map +1 -0
- package/dist/types/crypto/wasm/aes.d.ts +59 -0
- package/dist/types/crypto/wasm/aes.d.ts.map +1 -0
- package/dist/types/crypto/wasm/argon2.d.ts +70 -0
- package/dist/types/crypto/wasm/argon2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/blake2b.d.ts +59 -0
- package/dist/types/crypto/wasm/blake2b.d.ts.map +1 -0
- package/dist/types/crypto/wasm/chacha20poly1305.d.ts +43 -0
- package/dist/types/crypto/wasm/chacha20poly1305.d.ts.map +1 -0
- package/dist/types/crypto/wasm/cmac.d.ts +42 -0
- package/dist/types/crypto/wasm/cmac.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ecc.d.ts +56 -0
- package/dist/types/crypto/wasm/ecc.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ed25519.d.ts +52 -0
- package/dist/types/crypto/wasm/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/wasm/hkdf.d.ts +40 -0
- package/dist/types/crypto/wasm/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/wasm/hmac.d.ts +42 -0
- package/dist/types/crypto/wasm/hmac.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ml_dsa.d.ts +48 -0
- package/dist/types/crypto/wasm/ml_dsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ml_kem.d.ts +58 -0
- package/dist/types/crypto/wasm/ml_kem.d.ts.map +1 -0
- package/dist/types/crypto/wasm/pbkdf2.d.ts +38 -0
- package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/rsa.d.ts +56 -0
- package/dist/types/crypto/wasm/rsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/runtime.d.ts +99 -0
- package/dist/types/crypto/wasm/runtime.d.ts.map +1 -0
- package/dist/types/crypto/wasm/sha2.d.ts +45 -0
- package/dist/types/crypto/wasm/sha2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/sha3.d.ts +57 -0
- package/dist/types/crypto/wasm/sha3.d.ts.map +1 -0
- package/dist/types/crypto/wasm/slh_dsa.d.ts +62 -0
- package/dist/types/crypto/wasm/slh_dsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/x25519.d.ts +53 -0
- package/dist/types/crypto/wasm/x25519.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/aes.d.ts +59 -0
- package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/aeskw.d.ts +40 -0
- package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/digest.d.ts +43 -0
- package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/ecc.d.ts +51 -0
- package/dist/types/crypto/webcrypto/ecc.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/ed25519.d.ts +43 -0
- package/dist/types/crypto/webcrypto/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/hkdf.d.ts +18 -0
- package/dist/types/crypto/webcrypto/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/hmac.d.ts +43 -0
- package/dist/types/crypto/webcrypto/hmac.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/pbkdf2.d.ts +18 -0
- package/dist/types/crypto/webcrypto/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/rsa.d.ts +51 -0
- package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/x25519.d.ts +43 -0
- package/dist/types/crypto/webcrypto/x25519.d.ts.map +1 -0
- package/dist/types/dom/display/animate.d.ts +35 -0
- package/dist/types/dom/display/animate.d.ts.map +1 -0
- package/dist/types/dom/display/fullscreen.d.ts +59 -0
- package/dist/types/dom/display/fullscreen.d.ts.map +1 -0
- package/dist/types/dom/fs/download.d.ts +36 -0
- package/dist/types/dom/fs/download.d.ts.map +1 -0
- package/dist/types/dom/fs/fsAccess.d.ts +107 -0
- package/dist/types/dom/fs/fsAccess.d.ts.map +1 -0
- package/dist/types/dom/fs/indexedDB.d.ts +62 -0
- package/dist/types/dom/fs/indexedDB.d.ts.map +1 -0
- package/dist/types/dom/fs/remoteStore.d.ts +64 -0
- package/dist/types/dom/fs/remoteStore.d.ts.map +1 -0
- package/dist/types/dom/fs/storage.d.ts +56 -0
- package/dist/types/dom/fs/storage.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/idle.d.ts +91 -0
- package/dist/types/dom/lifecycle/idle.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/visibility.d.ts +49 -0
- package/dist/types/dom/lifecycle/visibility.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/wakeLock.d.ts +69 -0
- package/dist/types/dom/lifecycle/wakeLock.d.ts.map +1 -0
- package/dist/types/dom/net/ajax.d.ts +27 -0
- package/dist/types/dom/net/ajax.d.ts.map +1 -0
- package/dist/types/dom/net/broadcastChannel.d.ts +51 -0
- package/dist/types/dom/net/broadcastChannel.d.ts.map +1 -0
- package/dist/types/dom/net/network.d.ts +80 -0
- package/dist/types/dom/net/network.d.ts.map +1 -0
- package/dist/types/dom/net/sse.d.ts +72 -0
- package/dist/types/dom/net/sse.d.ts.map +1 -0
- package/dist/types/dom/net/webrtc.d.ts +149 -0
- package/dist/types/dom/net/webrtc.d.ts.map +1 -0
- package/dist/types/dom/net/ws.d.ts +70 -0
- package/dist/types/dom/net/ws.d.ts.map +1 -0
- package/dist/types/dom/query/dnd.d.ts +86 -0
- package/dist/types/dom/query/dnd.d.ts.map +1 -0
- package/dist/types/dom/query/dom.d.ts +194 -0
- package/dist/types/dom/query/dom.d.ts.map +1 -0
- package/dist/types/dom/query/events.d.ts +135 -0
- package/dist/types/dom/query/events.d.ts.map +1 -0
- package/dist/types/dom/query/gesture.d.ts +59 -0
- package/dist/types/dom/query/gesture.d.ts.map +1 -0
- package/dist/types/dom/query/media.d.ts +156 -0
- package/dist/types/dom/query/media.d.ts.map +1 -0
- package/dist/types/dom/rendering/chart.d.ts +143 -0
- package/dist/types/dom/rendering/chart.d.ts.map +1 -0
- package/dist/types/dom/rendering/component.d.ts +92 -0
- package/dist/types/dom/rendering/component.d.ts.map +1 -0
- package/dist/types/dom/rendering/devtools-ui.d.ts +83 -0
- package/dist/types/dom/rendering/devtools-ui.d.ts.map +1 -0
- package/dist/types/dom/rendering/devtools.d.ts +68 -0
- package/dist/types/dom/rendering/devtools.d.ts.map +1 -0
- package/dist/types/dom/rendering/parser.d.ts +216 -0
- package/dist/types/dom/rendering/parser.d.ts.map +1 -0
- package/dist/types/dom/rendering/reactiveBind.d.ts +101 -0
- package/dist/types/dom/rendering/reactiveBind.d.ts.map +1 -0
- package/dist/types/dom/rendering/render.d.ts +121 -0
- package/dist/types/dom/rendering/render.d.ts.map +1 -0
- package/dist/types/dom/rendering/sanitize.d.ts +48 -0
- package/dist/types/dom/rendering/sanitize.d.ts.map +1 -0
- package/dist/types/dom/rendering/secPolicy.d.ts +89 -0
- package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -0
- package/dist/types/dom/rendering/template.d.ts +251 -0
- package/dist/types/dom/rendering/template.d.ts.map +1 -0
- package/dist/types/dom/rendering/themeTokens.d.ts +61 -0
- package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-core.d.ts +192 -0
- package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-direct.d.ts +63 -0
- package/dist/types/dom/rendering/uiSession-direct.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-list.d.ts +205 -0
- package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession.d.ts +285 -0
- package/dist/types/dom/rendering/uiSession.d.ts.map +1 -0
- package/dist/types/dom/rendering/virtualScroll.d.ts +80 -0
- package/dist/types/dom/rendering/virtualScroll.d.ts.map +1 -0
- package/dist/types/dom/sensors/battery.d.ts +71 -0
- package/dist/types/dom/sensors/battery.d.ts.map +1 -0
- package/dist/types/dom/sensors/geolocation.d.ts +83 -0
- package/dist/types/dom/sensors/geolocation.d.ts.map +1 -0
- package/dist/types/dom/sensors/networkInfo.d.ts +82 -0
- package/dist/types/dom/sensors/networkInfo.d.ts.map +1 -0
- package/dist/types/dom/sensors/sensors.d.ts +191 -0
- package/dist/types/dom/sensors/sensors.d.ts.map +1 -0
- package/dist/types/dom/sw/backgroundSync.d.ts +48 -0
- package/dist/types/dom/sw/backgroundSync.d.ts.map +1 -0
- package/dist/types/dom/sw/cache.d.ts +71 -0
- package/dist/types/dom/sw/cache.d.ts.map +1 -0
- package/dist/types/dom/sw/push.d.ts +77 -0
- package/dist/types/dom/sw/push.d.ts.map +1 -0
- package/dist/types/dom/sw/serviceWorker.d.ts +57 -0
- package/dist/types/dom/sw/serviceWorker.d.ts.map +1 -0
- package/dist/types/dom/sw/sharedWorker.d.ts +81 -0
- package/dist/types/dom/sw/sharedWorker.d.ts.map +1 -0
- package/dist/types/dom/utils/a11y.d.ts +53 -0
- package/dist/types/dom/utils/a11y.d.ts.map +1 -0
- package/dist/types/dom/utils/clipboard.d.ts +44 -0
- package/dist/types/dom/utils/clipboard.d.ts.map +1 -0
- package/dist/types/dom/utils/entropyCollector.d.ts +58 -0
- package/dist/types/dom/utils/entropyCollector.d.ts.map +1 -0
- package/dist/types/dom/utils/focus.d.ts +123 -0
- package/dist/types/dom/utils/focus.d.ts.map +1 -0
- package/dist/types/dom/utils/form.d.ts +227 -0
- package/dist/types/dom/utils/form.d.ts.map +1 -0
- package/dist/types/dom/utils/formKit.d.ts +206 -0
- package/dist/types/dom/utils/formKit.d.ts.map +1 -0
- package/dist/types/dom/utils/keybindings.d.ts +53 -0
- package/dist/types/dom/utils/keybindings.d.ts.map +1 -0
- package/dist/types/dom/utils/leaderElection.d.ts +70 -0
- package/dist/types/dom/utils/leaderElection.d.ts.map +1 -0
- package/dist/types/dom/utils/notifications.d.ts +164 -0
- package/dist/types/dom/utils/notifications.d.ts.map +1 -0
- package/dist/types/dom/utils/permissions.d.ts +35 -0
- package/dist/types/dom/utils/permissions.d.ts.map +1 -0
- package/dist/types/dom/utils/route.d.ts +117 -0
- package/dist/types/dom/utils/route.d.ts.map +1 -0
- package/dist/types/dom/utils/ua.d.ts +35 -0
- package/dist/types/dom/utils/ua.d.ts.map +1 -0
- package/dist/types/dom/utils/webauthn.d.ts +98 -0
- package/dist/types/dom/utils/webauthn.d.ts.map +1 -0
- package/dist/types/io/binary/reader.d.ts +59 -0
- package/dist/types/io/binary/reader.d.ts.map +1 -0
- package/dist/types/io/binary/writer.d.ts +56 -0
- package/dist/types/io/binary/writer.d.ts.map +1 -0
- package/dist/types/io/calc/adler32.d.ts +31 -0
- package/dist/types/io/calc/adler32.d.ts.map +1 -0
- package/dist/types/io/calc/bigint.d.ts +74 -0
- package/dist/types/io/calc/bigint.d.ts.map +1 -0
- package/dist/types/io/calc/crc32.d.ts +36 -0
- package/dist/types/io/calc/crc32.d.ts.map +1 -0
- package/dist/types/io/calc/easing.d.ts +60 -0
- package/dist/types/io/calc/easing.d.ts.map +1 -0
- package/dist/types/io/codec/b64.d.ts +28 -0
- package/dist/types/io/codec/b64.d.ts.map +1 -0
- package/dist/types/io/codec/base32.d.ts +28 -0
- package/dist/types/io/codec/base32.d.ts.map +1 -0
- package/dist/types/io/codec/base58.d.ts +28 -0
- package/dist/types/io/codec/base58.d.ts.map +1 -0
- package/dist/types/io/codec/buffer.d.ts +66 -0
- package/dist/types/io/codec/buffer.d.ts.map +1 -0
- package/dist/types/io/codec/cbor.d.ts +43 -0
- package/dist/types/io/codec/cbor.d.ts.map +1 -0
- package/dist/types/io/codec/csv.d.ts +35 -0
- package/dist/types/io/codec/csv.d.ts.map +1 -0
- package/dist/types/io/codec/hex.d.ts +28 -0
- package/dist/types/io/codec/hex.d.ts.map +1 -0
- package/dist/types/io/codec/mime.d.ts +100 -0
- package/dist/types/io/codec/mime.d.ts.map +1 -0
- package/dist/types/io/codec/msgpack.d.ts +36 -0
- package/dist/types/io/codec/msgpack.d.ts.map +1 -0
- package/dist/types/io/codec/url.d.ts +52 -0
- package/dist/types/io/codec/url.d.ts.map +1 -0
- package/dist/types/io/codec/utf8.d.ts +22 -0
- package/dist/types/io/codec/utf8.d.ts.map +1 -0
- package/dist/types/io/codec/xml.d.ts +91 -0
- package/dist/types/io/codec/xml.d.ts.map +1 -0
- package/dist/types/io/compress/bitstream.d.ts +51 -0
- package/dist/types/io/compress/bitstream.d.ts.map +1 -0
- package/dist/types/io/compress/brotli.d.ts +86 -0
- package/dist/types/io/compress/brotli.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_dict.d.ts +76 -0
- package/dist/types/io/compress/brotli_dict.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_dict_words.d.ts +43 -0
- package/dist/types/io/compress/brotli_dict_words.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_frame.d.ts +166 -0
- package/dist/types/io/compress/brotli_frame.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_shared.d.ts +165 -0
- package/dist/types/io/compress/brotli_shared.d.ts.map +1 -0
- package/dist/types/io/compress/deflate.d.ts +89 -0
- package/dist/types/io/compress/deflate.d.ts.map +1 -0
- package/dist/types/io/compress/gzip.d.ts +100 -0
- package/dist/types/io/compress/gzip.d.ts.map +1 -0
- package/dist/types/io/compress/huffman.d.ts +37 -0
- package/dist/types/io/compress/huffman.d.ts.map +1 -0
- package/dist/types/io/compress/lz4.d.ts +45 -0
- package/dist/types/io/compress/lz4.d.ts.map +1 -0
- package/dist/types/io/compress/lz77.d.ts +66 -0
- package/dist/types/io/compress/lz77.d.ts.map +1 -0
- package/dist/types/io/compress/lzw.d.ts +37 -0
- package/dist/types/io/compress/lzw.d.ts.map +1 -0
- package/dist/types/io/compress/zip.d.ts +112 -0
- package/dist/types/io/compress/zip.d.ts.map +1 -0
- package/dist/types/io/compress/zlib.d.ts +97 -0
- package/dist/types/io/compress/zlib.d.ts.map +1 -0
- package/dist/types/io/i18n/i18n.d.ts +64 -0
- package/dist/types/io/i18n/i18n.d.ts.map +1 -0
- package/dist/types/io/math/fixed-point.d.ts +30 -0
- package/dist/types/io/math/fixed-point.d.ts.map +1 -0
- package/dist/types/io/math/geom.d.ts +125 -0
- package/dist/types/io/math/geom.d.ts.map +1 -0
- package/dist/types/io/math/interp.d.ts +48 -0
- package/dist/types/io/math/interp.d.ts.map +1 -0
- package/dist/types/io/math/linalg.d.ts +117 -0
- package/dist/types/io/math/linalg.d.ts.map +1 -0
- package/dist/types/io/math/stats.d.ts +45 -0
- package/dist/types/io/math/stats.d.ts.map +1 -0
- package/dist/types/io/structures/btree.d.ts +84 -0
- package/dist/types/io/structures/btree.d.ts.map +1 -0
- package/dist/types/io/structures/heap.d.ts +75 -0
- package/dist/types/io/structures/heap.d.ts.map +1 -0
- package/dist/types/io/structures/lruCache.d.ts +88 -0
- package/dist/types/io/structures/lruCache.d.ts.map +1 -0
- package/dist/types/io/structures/ringBuffer.d.ts +82 -0
- package/dist/types/io/structures/ringBuffer.d.ts.map +1 -0
- package/dist/types/io/structures/tree-walker.d.ts +95 -0
- package/dist/types/io/structures/tree-walker.d.ts.map +1 -0
- package/dist/types/io/structures/trie.d.ts +71 -0
- package/dist/types/io/structures/trie.d.ts.map +1 -0
- package/dist/types/io/sync/abort.d.ts +59 -0
- package/dist/types/io/sync/abort.d.ts.map +1 -0
- package/dist/types/io/sync/atomics.d.ts +107 -0
- package/dist/types/io/sync/atomics.d.ts.map +1 -0
- package/dist/types/io/sync/cancellable.d.ts +69 -0
- package/dist/types/io/sync/cancellable.d.ts.map +1 -0
- package/dist/types/io/sync/channel.d.ts +70 -0
- package/dist/types/io/sync/channel.d.ts.map +1 -0
- package/dist/types/io/sync/mutex.d.ts +39 -0
- package/dist/types/io/sync/mutex.d.ts.map +1 -0
- package/dist/types/io/sync/semaphore.d.ts +40 -0
- package/dist/types/io/sync/semaphore.d.ts.map +1 -0
- package/dist/types/io/sync/tokenBucket.d.ts +53 -0
- package/dist/types/io/sync/tokenBucket.d.ts.map +1 -0
- package/dist/types/io/text/ansi.d.ts +125 -0
- package/dist/types/io/text/ansi.d.ts.map +1 -0
- package/dist/types/io/text/html-entities.d.ts +35 -0
- package/dist/types/io/text/html-entities.d.ts.map +1 -0
- package/dist/types/io/text/semver.d.ts +75 -0
- package/dist/types/io/text/semver.d.ts.map +1 -0
- package/dist/types/io/text/str.d.ts +88 -0
- package/dist/types/io/text/str.d.ts.map +1 -0
- package/dist/types/io/text/unicode.d.ts +70 -0
- package/dist/types/io/text/unicode.d.ts.map +1 -0
- package/dist/types/io/time/date.d.ts +73 -0
- package/dist/types/io/time/date.d.ts.map +1 -0
- package/dist/types/io/timing/clock.d.ts +39 -0
- package/dist/types/io/timing/clock.d.ts.map +1 -0
- package/dist/types/io/timing/rateLimit.d.ts +40 -0
- package/dist/types/io/timing/rateLimit.d.ts.map +1 -0
- package/dist/types/io/timing/scheduler.d.ts +122 -0
- package/dist/types/io/timing/scheduler.d.ts.map +1 -0
- package/dist/types/io/utils/bitmap.d.ts +34 -0
- package/dist/types/io/utils/bitmap.d.ts.map +1 -0
- package/dist/types/io/utils/errors.d.ts +94 -0
- package/dist/types/io/utils/errors.d.ts.map +1 -0
- package/dist/types/io/utils/eventBus.d.ts +68 -0
- package/dist/types/io/utils/eventBus.d.ts.map +1 -0
- package/dist/types/io/utils/queue.d.ts +69 -0
- package/dist/types/io/utils/queue.d.ts.map +1 -0
- package/dist/types/io/utils/signal.d.ts +362 -0
- package/dist/types/io/utils/signal.d.ts.map +1 -0
- package/dist/types/io/utils/ui8.d.ts +34 -0
- package/dist/types/io/utils/ui8.d.ts.map +1 -0
- package/dist/types/io/utils/valid.d.ts +130 -0
- package/dist/types/io/utils/valid.d.ts.map +1 -0
- package/dist/types/main.d.ts +25 -0
- package/dist/types/main.d.ts.map +1 -0
- package/dist/types/process/message.d.ts +64 -0
- package/dist/types/process/message.d.ts.map +1 -0
- package/dist/types/process/rpc.d.ts +35 -0
- package/dist/types/process/rpc.d.ts.map +1 -0
- package/dist/types/process/workerPool.d.ts +62 -0
- package/dist/types/process/workerPool.d.ts.map +1 -0
- package/dist/types/sanity/base.d.ts +28 -0
- package/dist/types/sanity/base.d.ts.map +1 -0
- package/dist/types/sanity/community.d.ts +20 -0
- package/dist/types/sanity/community.d.ts.map +1 -0
- package/dist/types/sanity/lockdown-apply.d.ts +7 -0
- package/dist/types/sanity/lockdown-apply.d.ts.map +1 -0
- package/dist/types/sanity/lockdown.d.ts +43 -0
- package/dist/types/sanity/lockdown.d.ts.map +1 -0
- package/dist/types/sanity/wasm-gate.d.ts +128 -0
- package/dist/types/sanity/wasm-gate.d.ts.map +1 -0
- package/docs/README.md +301 -0
- package/docs/api/README.md +33 -0
- package/docs/api/core/README.md +14 -0
- package/docs/api/core/logger.md +151 -0
- package/docs/api/core/main.md +105 -0
- package/docs/api/core/modules.md +123 -0
- package/docs/api/core/readyState.md +94 -0
- package/docs/api/core/runtime.md +499 -0
- package/docs/api/core/worker-helper.md +180 -0
- package/docs/api/crypto/README.md +39 -0
- package/docs/api/crypto/cipher/README.md +24 -0
- package/docs/api/crypto/cipher/aes.md +101 -0
- package/docs/api/crypto/cipher/chacha20.md +85 -0
- package/docs/api/crypto/hash/README.md +49 -0
- package/docs/api/crypto/hash/adf.md +61 -0
- package/docs/api/crypto/hash/argon2.md +92 -0
- package/docs/api/crypto/hash/blake2b.md +88 -0
- package/docs/api/crypto/hash/hkdf.md +82 -0
- package/docs/api/crypto/hash/hmac.md +90 -0
- package/docs/api/crypto/hash/pbkdf2.md +93 -0
- package/docs/api/crypto/hash/poly1305.md +71 -0
- package/docs/api/crypto/hash/sha224.md +61 -0
- package/docs/api/crypto/hash/sha256.md +84 -0
- package/docs/api/crypto/hash/sha3.md +89 -0
- package/docs/api/crypto/hash/sha384.md +58 -0
- package/docs/api/crypto/hash/sha512.md +73 -0
- package/docs/api/crypto/hash/sha512_224.md +59 -0
- package/docs/api/crypto/hash/sha512_256.md +58 -0
- package/docs/api/crypto/mode/README.md +33 -0
- package/docs/api/crypto/mode/cbc.md +69 -0
- package/docs/api/crypto/mode/chacha20poly1305.md +77 -0
- package/docs/api/crypto/mode/cmac.md +79 -0
- package/docs/api/crypto/mode/ctr.md +66 -0
- package/docs/api/crypto/mode/gcm.md +93 -0
- package/docs/api/crypto/mode/kw.md +84 -0
- package/docs/api/crypto/pkc/README.md +48 -0
- package/docs/api/crypto/pkc/ecc.md +91 -0
- package/docs/api/crypto/pkc/ed25519.md +99 -0
- package/docs/api/crypto/pkc/hybridKem.md +178 -0
- package/docs/api/crypto/pkc/hybridSign.md +192 -0
- package/docs/api/crypto/pkc/ml_dsa.md +99 -0
- package/docs/api/crypto/pkc/ml_kem.md +90 -0
- package/docs/api/crypto/pkc/rsa.md +87 -0
- package/docs/api/crypto/pkc/slh_dsa.md +86 -0
- package/docs/api/crypto/pkc/x25519.md +84 -0
- package/docs/api/crypto/utils/README.md +39 -0
- package/docs/api/crypto/utils/aes_ctr.md +71 -0
- package/docs/api/crypto/utils/aes_modes.md +81 -0
- package/docs/api/crypto/utils/asn1-oid.md +130 -0
- package/docs/api/crypto/utils/asn1.md +69 -0
- package/docs/api/crypto/utils/bitArray.md +77 -0
- package/docs/api/crypto/utils/bn.md +67 -0
- package/docs/api/crypto/utils/jws.md +94 -0
- package/docs/api/crypto/utils/keyformat.md +78 -0
- package/docs/api/crypto/utils/pad.md +66 -0
- package/docs/api/crypto/utils/pem.md +63 -0
- package/docs/api/crypto/utils/random.md +103 -0
- package/docs/api/crypto/utils/rsaKeygen.md +118 -0
- package/docs/api/crypto/utils/totp.md +159 -0
- package/docs/api/crypto/utils/uuid.md +98 -0
- package/docs/api/crypto/wasm/README.md +76 -0
- package/docs/api/crypto/wasm/aes.md +128 -0
- package/docs/api/crypto/wasm/argon2.md +110 -0
- package/docs/api/crypto/wasm/blake2b.md +103 -0
- package/docs/api/crypto/wasm/chacha20poly1305.md +120 -0
- package/docs/api/crypto/wasm/cmac.md +119 -0
- package/docs/api/crypto/wasm/ecc.md +114 -0
- package/docs/api/crypto/wasm/ed25519.md +117 -0
- package/docs/api/crypto/wasm/hkdf.md +163 -0
- package/docs/api/crypto/wasm/hmac.md +129 -0
- package/docs/api/crypto/wasm/ml_dsa.md +99 -0
- package/docs/api/crypto/wasm/ml_kem.md +91 -0
- package/docs/api/crypto/wasm/pbkdf2.md +111 -0
- package/docs/api/crypto/wasm/rsa.md +113 -0
- package/docs/api/crypto/wasm/runtime.md +172 -0
- package/docs/api/crypto/wasm/sha2.md +95 -0
- package/docs/api/crypto/wasm/sha3.md +127 -0
- package/docs/api/crypto/wasm/slh_dsa.md +89 -0
- package/docs/api/crypto/wasm/x25519.md +116 -0
- package/docs/api/crypto/webcrypto/README.md +56 -0
- package/docs/api/crypto/webcrypto/aes.md +140 -0
- package/docs/api/crypto/webcrypto/aeskw.md +120 -0
- package/docs/api/crypto/webcrypto/digest.md +103 -0
- package/docs/api/crypto/webcrypto/ecc.md +122 -0
- package/docs/api/crypto/webcrypto/ed25519.md +121 -0
- package/docs/api/crypto/webcrypto/hkdf.md +141 -0
- package/docs/api/crypto/webcrypto/hmac.md +112 -0
- package/docs/api/crypto/webcrypto/pbkdf2.md +140 -0
- package/docs/api/crypto/webcrypto/rsa.md +149 -0
- package/docs/api/crypto/webcrypto/x25519.md +96 -0
- package/docs/api/dom/README.md +117 -0
- package/docs/api/dom/display/README.md +27 -0
- package/docs/api/dom/display/animate.md +113 -0
- package/docs/api/dom/display/fullscreen.md +121 -0
- package/docs/api/dom/fs/README.md +36 -0
- package/docs/api/dom/fs/download.md +108 -0
- package/docs/api/dom/fs/fsAccess.md +200 -0
- package/docs/api/dom/fs/indexedDB.md +219 -0
- package/docs/api/dom/fs/remoteStore.md +158 -0
- package/docs/api/dom/fs/storage.md +197 -0
- package/docs/api/dom/lifecycle/README.md +11 -0
- package/docs/api/dom/lifecycle/idle.md +89 -0
- package/docs/api/dom/lifecycle/visibility.md +73 -0
- package/docs/api/dom/lifecycle/wakeLock.md +94 -0
- package/docs/api/dom/net/README.md +31 -0
- package/docs/api/dom/net/ajax.md +176 -0
- package/docs/api/dom/net/broadcastChannel.md +110 -0
- package/docs/api/dom/net/network.md +137 -0
- package/docs/api/dom/net/sse.md +141 -0
- package/docs/api/dom/net/webrtc.md +158 -0
- package/docs/api/dom/net/ws.md +168 -0
- package/docs/api/dom/query/README.md +30 -0
- package/docs/api/dom/query/dnd.md +137 -0
- package/docs/api/dom/query/dom.md +275 -0
- package/docs/api/dom/query/events.md +211 -0
- package/docs/api/dom/query/gesture.md +137 -0
- package/docs/api/dom/query/media.md +188 -0
- package/docs/api/dom/rendering/README.md +41 -0
- package/docs/api/dom/rendering/chart.md +149 -0
- package/docs/api/dom/rendering/component.md +287 -0
- package/docs/api/dom/rendering/devtools-ui.md +129 -0
- package/docs/api/dom/rendering/devtools.md +157 -0
- package/docs/api/dom/rendering/parser.md +200 -0
- package/docs/api/dom/rendering/reactiveBind.md +234 -0
- package/docs/api/dom/rendering/render.md +219 -0
- package/docs/api/dom/rendering/sanitize.md +97 -0
- package/docs/api/dom/rendering/secPolicy.md +155 -0
- package/docs/api/dom/rendering/template.md +301 -0
- package/docs/api/dom/rendering/themeTokens.md +175 -0
- package/docs/api/dom/rendering/uiSession.md +546 -0
- package/docs/api/dom/rendering/virtualScroll.md +126 -0
- package/docs/api/dom/sensors/README.md +12 -0
- package/docs/api/dom/sensors/battery.md +70 -0
- package/docs/api/dom/sensors/geolocation.md +115 -0
- package/docs/api/dom/sensors/networkInfo.md +73 -0
- package/docs/api/dom/sensors/sensors.md +123 -0
- package/docs/api/dom/sw/README.md +31 -0
- package/docs/api/dom/sw/backgroundSync.md +145 -0
- package/docs/api/dom/sw/cache.md +116 -0
- package/docs/api/dom/sw/push.md +114 -0
- package/docs/api/dom/sw/serviceWorker.md +90 -0
- package/docs/api/dom/sw/sharedWorker.md +131 -0
- package/docs/api/dom/utils/README.md +25 -0
- package/docs/api/dom/utils/a11y.md +143 -0
- package/docs/api/dom/utils/clipboard.md +146 -0
- package/docs/api/dom/utils/entropyCollector.md +175 -0
- package/docs/api/dom/utils/focus.md +140 -0
- package/docs/api/dom/utils/form.md +196 -0
- package/docs/api/dom/utils/formKit.md +181 -0
- package/docs/api/dom/utils/keybindings.md +138 -0
- package/docs/api/dom/utils/leaderElection.md +130 -0
- package/docs/api/dom/utils/notifications.md +106 -0
- package/docs/api/dom/utils/permissions.md +82 -0
- package/docs/api/dom/utils/route.md +112 -0
- package/docs/api/dom/utils/ua.md +119 -0
- package/docs/api/dom/utils/webauthn.md +190 -0
- package/docs/api/io/README.md +20 -0
- package/docs/api/io/binary/README.md +29 -0
- package/docs/api/io/binary/reader.md +126 -0
- package/docs/api/io/binary/writer.md +127 -0
- package/docs/api/io/calc/README.md +22 -0
- package/docs/api/io/calc/adler32.md +75 -0
- package/docs/api/io/calc/bigint.md +105 -0
- package/docs/api/io/calc/crc32.md +74 -0
- package/docs/api/io/calc/easing.md +118 -0
- package/docs/api/io/codec/README.md +35 -0
- package/docs/api/io/codec/b64.md +92 -0
- package/docs/api/io/codec/base32.md +98 -0
- package/docs/api/io/codec/base58.md +104 -0
- package/docs/api/io/codec/buffer.md +144 -0
- package/docs/api/io/codec/cbor.md +179 -0
- package/docs/api/io/codec/csv.md +178 -0
- package/docs/api/io/codec/hex.md +75 -0
- package/docs/api/io/codec/mime.md +156 -0
- package/docs/api/io/codec/msgpack.md +142 -0
- package/docs/api/io/codec/url.md +265 -0
- package/docs/api/io/codec/utf8.md +84 -0
- package/docs/api/io/codec/xml.md +87 -0
- package/docs/api/io/compress/README.md +62 -0
- package/docs/api/io/compress/bitstream.md +131 -0
- package/docs/api/io/compress/brotli.md +232 -0
- package/docs/api/io/compress/brotli_dict.md +119 -0
- package/docs/api/io/compress/brotli_dict_words.md +142 -0
- package/docs/api/io/compress/brotli_frame.md +214 -0
- package/docs/api/io/compress/brotli_shared.md +144 -0
- package/docs/api/io/compress/deflate.md +474 -0
- package/docs/api/io/compress/gzip.md +130 -0
- package/docs/api/io/compress/huffman.md +210 -0
- package/docs/api/io/compress/lz4.md +278 -0
- package/docs/api/io/compress/lz77.md +180 -0
- package/docs/api/io/compress/lzw.md +121 -0
- package/docs/api/io/compress/zip.md +209 -0
- package/docs/api/io/compress/zlib.md +125 -0
- package/docs/api/io/i18n/README.md +23 -0
- package/docs/api/io/i18n/i18n.md +128 -0
- package/docs/api/io/math/README.md +24 -0
- package/docs/api/io/math/fixed-point.md +115 -0
- package/docs/api/io/math/geom.md +144 -0
- package/docs/api/io/math/interp.md +115 -0
- package/docs/api/io/math/linalg.md +138 -0
- package/docs/api/io/math/stats.md +109 -0
- package/docs/api/io/structures/README.md +31 -0
- package/docs/api/io/structures/btree.md +155 -0
- package/docs/api/io/structures/heap.md +166 -0
- package/docs/api/io/structures/lruCache.md +156 -0
- package/docs/api/io/structures/ringBuffer.md +188 -0
- package/docs/api/io/structures/tree-walker.md +132 -0
- package/docs/api/io/structures/trie.md +138 -0
- package/docs/api/io/sync/README.md +29 -0
- package/docs/api/io/sync/abort.md +129 -0
- package/docs/api/io/sync/atomics.md +159 -0
- package/docs/api/io/sync/cancellable.md +176 -0
- package/docs/api/io/sync/channel.md +125 -0
- package/docs/api/io/sync/mutex.md +93 -0
- package/docs/api/io/sync/semaphore.md +106 -0
- package/docs/api/io/sync/tokenBucket.md +139 -0
- package/docs/api/io/text/README.md +23 -0
- package/docs/api/io/text/ansi.md +182 -0
- package/docs/api/io/text/html-entities.md +79 -0
- package/docs/api/io/text/semver.md +158 -0
- package/docs/api/io/text/str.md +129 -0
- package/docs/api/io/text/unicode.md +89 -0
- package/docs/api/io/time/README.md +22 -0
- package/docs/api/io/time/date.md +128 -0
- package/docs/api/io/timing/README.md +32 -0
- package/docs/api/io/timing/clock.md +102 -0
- package/docs/api/io/timing/rateLimit.md +137 -0
- package/docs/api/io/timing/scheduler.md +163 -0
- package/docs/api/io/utils/README.md +30 -0
- package/docs/api/io/utils/bitmap.md +96 -0
- package/docs/api/io/utils/errors.md +165 -0
- package/docs/api/io/utils/eventBus.md +162 -0
- package/docs/api/io/utils/queue.md +141 -0
- package/docs/api/io/utils/signal.md +388 -0
- package/docs/api/io/utils/ui8.md +111 -0
- package/docs/api/io/utils/valid.md +272 -0
- package/docs/api/process/README.md +18 -0
- package/docs/api/process/message.md +166 -0
- package/docs/api/process/rpc.md +161 -0
- package/docs/api/process/workerPool.md +130 -0
- package/docs/api/sanity/base.md +132 -0
- package/docs/api/sanity/community.md +96 -0
- package/docs/api/sanity/lockdown.md +128 -0
- package/docs/api/typed.md +85 -0
- package/docs/dev/README.md +25 -0
- package/docs/dev/provenance.md +80 -0
- package/docs/dev/publishing.md +31 -0
- package/docs/dev/runtime.md +64 -0
- package/docs/dev/testing.md +61 -0
- package/docs/dev/types.md +35 -0
- package/docs/evidence/pqc-hybrid-evidence.md +438 -0
- package/docs/guide/README.md +38 -0
- package/docs/guide/_QUICK_REF.md +341 -0
- package/docs/guide/by-use-case.md +160 -0
- package/docs/guide/doc-format.md +306 -0
- package/docs/guide/gesture-dnd-side-channel.md +119 -0
- package/docs/guide/getting-started.md +134 -0
- package/docs/guide/hmr.md +187 -0
- package/docs/guide/integration-bundlers.md +193 -0
- package/docs/guide/integrations-hmr.md +103 -0
- package/docs/guide/module-creation-workflow.md +342 -0
- package/docs/guide/module-pattern.md +244 -0
- package/docs/guide/rendering-pipeline.md +422 -0
- package/docs/guide/security.md +346 -0
- package/docs/guide/test-format.md +190 -0
- package/docs/guide/tutorial-todo.md +298 -0
- package/docs/guide/typescript.md +215 -0
- package/docs/guide/worker-confinement.md +301 -0
- package/docs/guide/workers.md +168 -0
- package/docs/notes/lz77-deflate-factorization.md +96 -0
- package/docs/notes/worker-confinement-spike.md +302 -0
- package/docs/tools/README.md +56 -0
- package/docs/tools/aot.md +108 -0
- package/docs/tools/audit.md +61 -0
- package/docs/tools/bundler.md +215 -0
- package/docs/tools/codegen.md +64 -0
- package/docs/tools/jsx.md +236 -0
- package/docs/tools/precompilation.md +88 -0
- package/docs/tools/standalone.md +107 -0
- package/fw.config.json +129 -0
- package/integrations/README.md +52 -0
- package/integrations/_shared/catalog.generated.json +207 -0
- package/integrations/_shared/config-resolve.js +201 -0
- package/integrations/_shared/core.js +362 -0
- package/integrations/astro/README.md +96 -0
- package/integrations/astro/index.d.ts +42 -0
- package/integrations/astro/index.js +94 -0
- package/integrations/bun/README.md +62 -0
- package/integrations/bun/index.d.ts +30 -0
- package/integrations/bun/index.js +134 -0
- package/integrations/deno/README.md +55 -0
- package/integrations/deno/deno.json +10 -0
- package/integrations/esbuild/README.md +75 -0
- package/integrations/esbuild/backend.js +147 -0
- package/integrations/esbuild/index.d.ts +32 -0
- package/integrations/esbuild/index.js +147 -0
- package/integrations/eslint/README.md +27 -0
- package/integrations/eslint/no-factory-capture.js +99 -0
- package/integrations/jest/README.md +45 -0
- package/integrations/jest/bun-test-shim.js +43 -0
- package/integrations/nestjs/README.md +68 -0
- package/integrations/nestjs/index.d.ts +38 -0
- package/integrations/nestjs/index.js +99 -0
- package/integrations/nextjs/README.md +149 -0
- package/integrations/nextjs/index.d.ts +30 -0
- package/integrations/nextjs/index.js +98 -0
- package/integrations/nodejs/README.md +46 -0
- package/integrations/nodejs/package.node.example.json +31 -0
- package/integrations/rollup/README.md +65 -0
- package/integrations/rollup/backend.js +132 -0
- package/integrations/rollup/index.d.ts +32 -0
- package/integrations/rollup/index.js +84 -0
- package/integrations/turbopack/README.md +56 -0
- package/integrations/turbopack/index.d.ts +47 -0
- package/integrations/turbopack/index.js +164 -0
- package/integrations/typedoc/README.md +57 -0
- package/integrations/typedoc/categorize.js +121 -0
- package/integrations/typedoc/tsconfig.typedoc.json +14 -0
- package/integrations/typedoc/typedoc.json +19 -0
- package/integrations/vite/README.md +115 -0
- package/integrations/vite/index.d.ts +29 -0
- package/integrations/vite/index.js +182 -0
- package/integrations/vite/package.json +8 -0
- package/integrations/vite/vite-env.d.ts +36 -0
- package/integrations/vitest/README.md +77 -0
- package/integrations/vitest/bun-test-shim.js +92 -0
- package/integrations/vitest/vitest.config.js +41 -0
- package/integrations/webpack/README.md +53 -0
- package/integrations/webpack/index.d.ts +29 -0
- package/integrations/webpack/index.js +182 -0
- package/package.json +303 -0
- package/src/core/logger.js +373 -0
- package/src/core/modules.js +289 -0
- package/src/core/readyState.js +119 -0
- package/src/core/runtime.js +929 -0
- package/src/core/worker-helper.js +261 -0
- package/src/crypto/NIST_CONFORMANCE.md +249 -0
- package/src/crypto/cipher/aes.acvp.md +74 -0
- package/src/crypto/cipher/aes.js +512 -0
- package/src/crypto/cipher/chacha20.acvp.md +117 -0
- package/src/crypto/cipher/chacha20.js +147 -0
- package/src/crypto/hash/adf.acvp.md +144 -0
- package/src/crypto/hash/adf.js +127 -0
- package/src/crypto/hash/argon2.acvp.md +144 -0
- package/src/crypto/hash/argon2.js +517 -0
- package/src/crypto/hash/blake2b.acvp.md +122 -0
- package/src/crypto/hash/blake2b.js +367 -0
- package/src/crypto/hash/hkdf.acvp.md +128 -0
- package/src/crypto/hash/hkdf.js +145 -0
- package/src/crypto/hash/hmac.acvp.md +110 -0
- package/src/crypto/hash/hmac.js +177 -0
- package/src/crypto/hash/pbkdf2.acvp.md +122 -0
- package/src/crypto/hash/pbkdf2.js +120 -0
- package/src/crypto/hash/poly1305.acvp.md +111 -0
- package/src/crypto/hash/poly1305.js +126 -0
- package/src/crypto/hash/sha224.acvp.md +81 -0
- package/src/crypto/hash/sha224.js +60 -0
- package/src/crypto/hash/sha256.acvp.md +75 -0
- package/src/crypto/hash/sha256.js +217 -0
- package/src/crypto/hash/sha3.acvp.md +133 -0
- package/src/crypto/hash/sha3.js +391 -0
- package/src/crypto/hash/sha384.acvp.md +82 -0
- package/src/crypto/hash/sha384.js +61 -0
- package/src/crypto/hash/sha512.acvp.md +84 -0
- package/src/crypto/hash/sha512.js +314 -0
- package/src/crypto/hash/sha512_224.acvp.md +90 -0
- package/src/crypto/hash/sha512_224.js +66 -0
- package/src/crypto/hash/sha512_256.acvp.md +96 -0
- package/src/crypto/hash/sha512_256.js +75 -0
- package/src/crypto/mode/cbc.acvp.md +105 -0
- package/src/crypto/mode/cbc.js +136 -0
- package/src/crypto/mode/chacha20poly1305.acvp.md +116 -0
- package/src/crypto/mode/chacha20poly1305.js +190 -0
- package/src/crypto/mode/cmac.acvp.md +106 -0
- package/src/crypto/mode/cmac.js +172 -0
- package/src/crypto/mode/ctr.acvp.md +110 -0
- package/src/crypto/mode/ctr.js +174 -0
- package/src/crypto/mode/gcm.acvp.md +129 -0
- package/src/crypto/mode/gcm.js +333 -0
- package/src/crypto/mode/kw.acvp.md +145 -0
- package/src/crypto/mode/kw.js +323 -0
- package/src/crypto/pkc/ecc.acvp.md +181 -0
- package/src/crypto/pkc/ecc.js +941 -0
- package/src/crypto/pkc/ed25519.acvp.md +172 -0
- package/src/crypto/pkc/ed25519.js +582 -0
- package/src/crypto/pkc/hybrid-kat.provenance.md +89 -0
- package/src/crypto/pkc/hybridKem.js +255 -0
- package/src/crypto/pkc/hybridSign.js +437 -0
- package/src/crypto/pkc/ml_dsa.acvp.md +146 -0
- package/src/crypto/pkc/ml_dsa.js +984 -0
- package/src/crypto/pkc/ml_kem.acvp.md +117 -0
- package/src/crypto/pkc/ml_kem.js +596 -0
- package/src/crypto/pkc/rsa.acvp.md +187 -0
- package/src/crypto/pkc/rsa.js +470 -0
- package/src/crypto/pkc/slh_dsa.acvp.md +155 -0
- package/src/crypto/pkc/slh_dsa.js +820 -0
- package/src/crypto/pkc/x25519.acvp.md +113 -0
- package/src/crypto/pkc/x25519.js +290 -0
- package/src/crypto/utils/aes_ctr.acvp.md +67 -0
- package/src/crypto/utils/aes_ctr.js +134 -0
- package/src/crypto/utils/aes_modes.acvp.md +66 -0
- package/src/crypto/utils/aes_modes.js +241 -0
- package/src/crypto/utils/asn1-oid.js +369 -0
- package/src/crypto/utils/asn1.js +343 -0
- package/src/crypto/utils/bitArray.js +312 -0
- package/src/crypto/utils/bn.js +825 -0
- package/src/crypto/utils/jws.js +222 -0
- package/src/crypto/utils/keyformat.js +303 -0
- package/src/crypto/utils/pad.js +198 -0
- package/src/crypto/utils/pem.js +90 -0
- package/src/crypto/utils/random.acvp.md +167 -0
- package/src/crypto/utils/random.js +846 -0
- package/src/crypto/utils/rsaKeygen.acvp.md +158 -0
- package/src/crypto/utils/rsaKeygen.js +448 -0
- package/src/crypto/utils/totp.js +409 -0
- package/src/crypto/utils/uuid.acvp.md +137 -0
- package/src/crypto/utils/uuid.js +176 -0
- package/src/crypto/wasm/aes.js +494 -0
- package/src/crypto/wasm/argon2.js +236 -0
- package/src/crypto/wasm/blake2b.js +213 -0
- package/src/crypto/wasm/chacha20poly1305.js +238 -0
- package/src/crypto/wasm/cmac.js +207 -0
- package/src/crypto/wasm/ecc.js +437 -0
- package/src/crypto/wasm/ed25519.js +307 -0
- package/src/crypto/wasm/hkdf.js +183 -0
- package/src/crypto/wasm/hmac.js +215 -0
- package/src/crypto/wasm/ml_dsa.js +375 -0
- package/src/crypto/wasm/ml_kem.js +313 -0
- package/src/crypto/wasm/pbkdf2.js +205 -0
- package/src/crypto/wasm/rsa.js +674 -0
- package/src/crypto/wasm/runtime.js +400 -0
- package/src/crypto/wasm/sha2.js +183 -0
- package/src/crypto/wasm/sha3.js +221 -0
- package/src/crypto/wasm/slh_dsa.js +397 -0
- package/src/crypto/wasm/x25519.js +241 -0
- package/src/crypto/webcrypto/aes.js +370 -0
- package/src/crypto/webcrypto/aeskw.js +185 -0
- package/src/crypto/webcrypto/digest.js +136 -0
- package/src/crypto/webcrypto/ecc.js +371 -0
- package/src/crypto/webcrypto/ed25519.js +248 -0
- package/src/crypto/webcrypto/hkdf.js +132 -0
- package/src/crypto/webcrypto/hmac.js +213 -0
- package/src/crypto/webcrypto/pbkdf2.js +146 -0
- package/src/crypto/webcrypto/rsa.js +415 -0
- package/src/crypto/webcrypto/x25519.js +250 -0
- package/src/dom/display/animate.js +154 -0
- package/src/dom/display/fullscreen.js +305 -0
- package/src/dom/fs/download.js +118 -0
- package/src/dom/fs/fsAccess.js +307 -0
- package/src/dom/fs/indexedDB.js +465 -0
- package/src/dom/fs/remoteStore.js +484 -0
- package/src/dom/fs/storage.js +440 -0
- package/src/dom/lifecycle/idle.js +133 -0
- package/src/dom/lifecycle/visibility.js +140 -0
- package/src/dom/lifecycle/wakeLock.js +187 -0
- package/src/dom/net/ajax.js +303 -0
- package/src/dom/net/broadcastChannel.js +89 -0
- package/src/dom/net/network.js +260 -0
- package/src/dom/net/sse.js +295 -0
- package/src/dom/net/webrtc.js +381 -0
- package/src/dom/net/ws.js +290 -0
- package/src/dom/query/dnd.js +409 -0
- package/src/dom/query/dom.js +831 -0
- package/src/dom/query/events.js +425 -0
- package/src/dom/query/gesture.js +396 -0
- package/src/dom/query/media.js +616 -0
- package/src/dom/rendering/chart.js +663 -0
- package/src/dom/rendering/component.js +469 -0
- package/src/dom/rendering/devtools-ui.js +399 -0
- package/src/dom/rendering/devtools.js +352 -0
- package/src/dom/rendering/parser.js +1055 -0
- package/src/dom/rendering/reactiveBind.js +341 -0
- package/src/dom/rendering/render.js +601 -0
- package/src/dom/rendering/sanitize.js +364 -0
- package/src/dom/rendering/secPolicy.js +281 -0
- package/src/dom/rendering/template.js +1031 -0
- package/src/dom/rendering/themeTokens.js +522 -0
- package/src/dom/rendering/uiSession-core.js +597 -0
- package/src/dom/rendering/uiSession-direct.js +251 -0
- package/src/dom/rendering/uiSession-list.js +751 -0
- package/src/dom/rendering/uiSession.js +145 -0
- package/src/dom/rendering/virtualScroll.js +341 -0
- package/src/dom/sensors/battery.js +153 -0
- package/src/dom/sensors/geolocation.js +156 -0
- package/src/dom/sensors/networkInfo.js +136 -0
- package/src/dom/sensors/sensors.js +340 -0
- package/src/dom/sw/backgroundSync.js +113 -0
- package/src/dom/sw/cache.js +139 -0
- package/src/dom/sw/push.js +181 -0
- package/src/dom/sw/serviceWorker.js +193 -0
- package/src/dom/sw/sharedWorker.js +192 -0
- package/src/dom/utils/a11y.js +244 -0
- package/src/dom/utils/clipboard.js +113 -0
- package/src/dom/utils/entropyCollector.js +344 -0
- package/src/dom/utils/focus.js +421 -0
- package/src/dom/utils/form.js +535 -0
- package/src/dom/utils/formKit.js +427 -0
- package/src/dom/utils/keybindings.js +574 -0
- package/src/dom/utils/leaderElection.js +280 -0
- package/src/dom/utils/notifications.js +218 -0
- package/src/dom/utils/permissions.js +107 -0
- package/src/dom/utils/route.js +482 -0
- package/src/dom/utils/ua.js +109 -0
- package/src/dom/utils/webauthn.js +369 -0
- package/src/external/README.md +15 -0
- package/src/io/binary/reader.js +374 -0
- package/src/io/binary/writer.js +351 -0
- package/src/io/calc/adler32.js +94 -0
- package/src/io/calc/bigint.js +276 -0
- package/src/io/calc/crc32.js +111 -0
- package/src/io/calc/easing.js +514 -0
- package/src/io/codec/b64.js +235 -0
- package/src/io/codec/base32.js +147 -0
- package/src/io/codec/base58.js +167 -0
- package/src/io/codec/buffer.js +630 -0
- package/src/io/codec/cbor.js +550 -0
- package/src/io/codec/csv.js +299 -0
- package/src/io/codec/hex.js +129 -0
- package/src/io/codec/mime.js +398 -0
- package/src/io/codec/msgpack.js +491 -0
- package/src/io/codec/url.js +530 -0
- package/src/io/codec/utf8.js +181 -0
- package/src/io/codec/xml.js +428 -0
- package/src/io/compress/bitstream.js +199 -0
- package/src/io/compress/brotli.js +3073 -0
- package/src/io/compress/brotli_dict.bin +432 -0
- package/src/io/compress/brotli_dict.js +356 -0
- package/src/io/compress/brotli_dict_words.js +157 -0
- package/src/io/compress/brotli_frame.js +420 -0
- package/src/io/compress/brotli_shared.js +715 -0
- package/src/io/compress/deflate.js +1432 -0
- package/src/io/compress/gzip.js +406 -0
- package/src/io/compress/huffman.js +322 -0
- package/src/io/compress/lz4.js +451 -0
- package/src/io/compress/lz77.js +408 -0
- package/src/io/compress/lzw.js +332 -0
- package/src/io/compress/zip.js +815 -0
- package/src/io/compress/zlib.js +340 -0
- package/src/io/i18n/i18n.js +236 -0
- package/src/io/math/fixed-point.js +269 -0
- package/src/io/math/geom.js +350 -0
- package/src/io/math/interp.js +263 -0
- package/src/io/math/linalg.js +472 -0
- package/src/io/math/stats.js +339 -0
- package/src/io/structures/btree.js +357 -0
- package/src/io/structures/heap.js +249 -0
- package/src/io/structures/lruCache.js +219 -0
- package/src/io/structures/ringBuffer.js +208 -0
- package/src/io/structures/tree-walker.js +413 -0
- package/src/io/structures/trie.js +219 -0
- package/src/io/sync/abort.js +196 -0
- package/src/io/sync/atomics.js +342 -0
- package/src/io/sync/cancellable.js +279 -0
- package/src/io/sync/channel.js +301 -0
- package/src/io/sync/mutex.js +148 -0
- package/src/io/sync/semaphore.js +156 -0
- package/src/io/sync/tokenBucket.js +208 -0
- package/src/io/text/ansi.js +536 -0
- package/src/io/text/html-entities.js +143 -0
- package/src/io/text/semver.js +375 -0
- package/src/io/text/str.js +243 -0
- package/src/io/text/unicode.js +188 -0
- package/src/io/time/date.js +355 -0
- package/src/io/timing/clock.js +79 -0
- package/src/io/timing/rateLimit.js +264 -0
- package/src/io/timing/scheduler.js +351 -0
- package/src/io/utils/bitmap.js +94 -0
- package/src/io/utils/errors.js +269 -0
- package/src/io/utils/eventBus.js +315 -0
- package/src/io/utils/queue.js +223 -0
- package/src/io/utils/signal.js +858 -0
- package/src/io/utils/ui8.js +99 -0
- package/src/io/utils/valid.js +556 -0
- package/src/main.js +41 -0
- package/src/polyfill/README.md +9 -0
- package/src/process/message.js +257 -0
- package/src/process/rpc.js +286 -0
- package/src/process/workerPool.js +392 -0
- package/src/sanity/base.js +374 -0
- package/src/sanity/community.js +254 -0
- package/src/sanity/lockdown-apply.js +58 -0
- package/src/sanity/lockdown.js +408 -0
- package/src/sanity/wasm-gate.js +316 -0
- package/src/typed.js +53 -0
- package/third-party/NOTICE-penner-easing +88 -0
- package/third-party/NOTICE-sjcl +50 -0
- package/tools/_lib/cli-help.js +55 -0
- package/tools/rendering/aot/index.js +148 -0
- package/tools/rendering/aot/lib/dom-codegen.js +295 -0
- package/tools/rendering/jsx/index.js +654 -0
- package/tools/rendering/precompilation/index.js +368 -0
- package/types/registry.generated.d.ts +217 -0
- package/types/typed.d.ts +106 -0
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: webcryptoEcc
|
|
3
|
+
category: crypto/webcrypto
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# webcryptoEcc
|
|
11
|
+
|
|
12
|
+
> WebCrypto-backed async ECDSA + ECDH on NIST P-256/384/521 via `crypto.subtle`.
|
|
13
|
+
|
|
14
|
+
**Module** `webcryptoEcc` | **Source** `packages/front/fw/src/crypto/webcrypto/ecc.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Opt-in alternative to the pure-JS `ecc` module, which remains the default. Async, `Uint8Array`/`CryptoKey`/`CryptoKeyPair` I/O. Every method resolves to its result or `false` — never rejects. ECDSA signatures are raw IEEE P1363 `r||s` (not ASN.1/DER). Curve25519 (Ed25519/X25519) and secp256k1 are out of scope.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const webcryptoEcc = runtime.resolve('webcryptoEcc');
|
|
22
|
+
// Returns: { isAvailable, generateKey, sign, verify, deriveBits, deriveKey, importKey, exportKey }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `isAvailable` | `() => boolean` | `true` when `crypto.subtle` is present |
|
|
30
|
+
| `generateKey` | `(kind: 'ECDSA'\|'ECDH', curve?: 'P-256'\|'P-384'\|'P-521', extractable?: boolean) => Promise<CryptoKeyPair\|false>` | Key pair or `false` |
|
|
31
|
+
| `sign` | `(privateKey: CryptoKey, data: Uint8Array, hash?: 'SHA-256'\|'SHA-384'\|'SHA-512') => Promise<Uint8Array\|false>` | Raw `r\|\|s` signature or `false` |
|
|
32
|
+
| `verify` | `(publicKey: CryptoKey, signature: Uint8Array, data: Uint8Array, hash?: 'SHA-256'\|'SHA-384'\|'SHA-512') => Promise<boolean>` | `true`/`false` |
|
|
33
|
+
| `deriveBits` | `(privateKey: CryptoKey, publicKey: CryptoKey, lengthBits: number) => Promise<Uint8Array\|false>` | Shared secret or `false` |
|
|
34
|
+
| `deriveKey` | `(privateKey: CryptoKey, publicKey: CryptoKey, derivedKeyAlg: object, usages: string[], extractable?: boolean) => Promise<CryptoKey\|false>` | Derived key or `false` |
|
|
35
|
+
| `importKey` | `(format: 'raw'\|'spki'\|'pkcs8'\|'jwk', keyData: Uint8Array\|object, kind: 'ECDSA'\|'ECDH', curve: 'P-256'\|'P-384'\|'P-521', usages: string[], extractable?: boolean) => Promise<CryptoKey\|false>` | `CryptoKey` or `false` |
|
|
36
|
+
| `exportKey` | `(format: 'raw'\|'spki'\|'pkcs8'\|'jwk', key: CryptoKey) => Promise<Uint8Array\|object\|false>` | `Uint8Array` (DER/raw), object (jwk), or `false` |
|
|
37
|
+
|
|
38
|
+
ECDSA hash defaults to `SHA-256`; curve defaults to `P-256`. `generateKey` assigns usages by kind — ECDSA → `['sign','verify']`, ECDH → `['deriveBits','deriveKey']`. `importKey` defaults `extractable` to `false` for `pkcs8` (private keys), `true` otherwise. `'raw'` carries the public point only.
|
|
39
|
+
|
|
40
|
+
Operations resolve `false` when:
|
|
41
|
+
- `crypto.subtle` is unavailable (`[crypto] NOT READY` logged)
|
|
42
|
+
- `kind`, `curve`, `hash`, or `format` is invalid (`[crypto] INVALID` logged)
|
|
43
|
+
- a key is used with the wrong kind — `sign`/`verify` require an ECDSA key, `deriveBits`/`deriveKey` require an ECDH key (`[crypto] INVALID` logged)
|
|
44
|
+
- the underlying `crypto.subtle` call rejects (`[crypto] FAIL` logged)
|
|
45
|
+
|
|
46
|
+
## Examples
|
|
47
|
+
|
|
48
|
+
### ECDSA sign and verify
|
|
49
|
+
|
|
50
|
+
```js
|
|
51
|
+
const pair = await webcryptoEcc.generateKey('ECDSA', 'P-256');
|
|
52
|
+
const data = new TextEncoder().encode('message');
|
|
53
|
+
|
|
54
|
+
const sig = await webcryptoEcc.sign(pair.privateKey, data, 'SHA-256');
|
|
55
|
+
// sig is a 64-byte Uint8Array (raw r||s) for P-256
|
|
56
|
+
|
|
57
|
+
const ok = await webcryptoEcc.verify(pair.publicKey, sig, data, 'SHA-256');
|
|
58
|
+
// ok === true
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### ECDH shared secret
|
|
62
|
+
|
|
63
|
+
```js
|
|
64
|
+
const alice = await webcryptoEcc.generateKey('ECDH', 'P-256');
|
|
65
|
+
const bob = await webcryptoEcc.generateKey('ECDH', 'P-256');
|
|
66
|
+
|
|
67
|
+
const secretA = await webcryptoEcc.deriveBits(alice.privateKey, bob.publicKey, 256);
|
|
68
|
+
const secretB = await webcryptoEcc.deriveBits(bob.privateKey, alice.publicKey, 256);
|
|
69
|
+
// secretA and secretB are equal (Diffie–Hellman agreement)
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### ECDH into an AES-GCM key
|
|
73
|
+
|
|
74
|
+
```js
|
|
75
|
+
const key = await webcryptoEcc.deriveKey(
|
|
76
|
+
alice.privateKey,
|
|
77
|
+
bob.publicKey,
|
|
78
|
+
{ name: 'AES-GCM', length: 256 },
|
|
79
|
+
['encrypt', 'decrypt']
|
|
80
|
+
);
|
|
81
|
+
// key is a usable AES-GCM CryptoKey
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Import / export
|
|
85
|
+
|
|
86
|
+
```js
|
|
87
|
+
const rawPub = await webcryptoEcc.exportKey('raw', pair.publicKey); // Uint8Array
|
|
88
|
+
const jwk = await webcryptoEcc.exportKey('jwk', pair.publicKey); // object
|
|
89
|
+
|
|
90
|
+
const imported = await webcryptoEcc.importKey('raw', rawPub, 'ECDSA', 'P-256', ['verify']);
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Worker Usage
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
const worker = fw.createWorker(
|
|
97
|
+
function ({ libs }) {
|
|
98
|
+
libs.webcryptoEcc.generateKey('ECDSA', 'P-256')
|
|
99
|
+
.then((pair) => libs.webcryptoEcc.sign(
|
|
100
|
+
pair.privateKey,
|
|
101
|
+
new TextEncoder().encode('hi')
|
|
102
|
+
))
|
|
103
|
+
.then(self.postMessage);
|
|
104
|
+
},
|
|
105
|
+
{ dependencies: ['webcryptoEcc'] }
|
|
106
|
+
);
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## Notes
|
|
110
|
+
|
|
111
|
+
- **Raw signatures**: WebCrypto ECDSA uses the IEEE P1363 fixed-width `r||s` form (64 bytes for P-256, 96 for P-384, 132 for P-521), NOT ASN.1/DER. This module performs no DER transcoding — convert at the call site if a DER consumer requires it.
|
|
112
|
+
- **Curves**: only the NIST P-curves WebCrypto supports — P-256, P-384, P-521. secp256k1 is not in WebCrypto; Ed25519/X25519 live in the dedicated `ed25519`/`x25519` modules.
|
|
113
|
+
- **Cross-kind safety**: keys are typed by `algorithm.name`. Signing with an ECDH key, or deriving with an ECDSA key, is rejected with `[crypto] INVALID` and resolves `false`.
|
|
114
|
+
- **No-throw contract**: every method is `async` and resolves to its result or `false`; `crypto.subtle` rejections are caught and logged, never propagated.
|
|
115
|
+
- **Worker-safe**: `crypto.subtle` is available in Web Workers; this module has no DOM dependency and no main-thread closures.
|
|
116
|
+
|
|
117
|
+
## See also
|
|
118
|
+
|
|
119
|
+
- [ecc](../pkc/ecc.md) — pure-JS elliptic-curve module, the default
|
|
120
|
+
- [ed25519](./ed25519.md) — WebCrypto Ed25519 signatures
|
|
121
|
+
- [x25519](./x25519.md) — WebCrypto X25519 key agreement
|
|
122
|
+
- [digest](./digest.md) — WebCrypto SHA-1/256/384/512
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: webcryptoEd25519
|
|
3
|
+
category: crypto/webcrypto
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# webcryptoEd25519
|
|
11
|
+
|
|
12
|
+
> WebCrypto-backed Ed25519 (RFC 8032) sign/verify via `crypto.subtle`.
|
|
13
|
+
|
|
14
|
+
**Module** `webcryptoEd25519` | **Source** `packages/front/fw/src/crypto/webcrypto/ed25519.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Opt-in alternative to the pure-JS `ed25519` module. Async, `Uint8Array`/`CryptoKey`/`CryptoKeyPair`. Every method resolves to a result or `false` — never rejects. Supports generate, sign, verify, and import/export in `raw`, `spki`, `pkcs8`, and `jwk` formats.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const webcryptoEd25519 = runtime.resolve('webcryptoEd25519');
|
|
22
|
+
// Returns: { isAvailable, generateKey, sign, verify, importKey, exportKey }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `isAvailable` | `() => boolean` | `true` when `crypto.subtle` is present |
|
|
30
|
+
| `generateKey` | `(extractable?: boolean) => Promise<CryptoKeyPair\|false>` | Key pair or `false` if Ed25519 is unsupported |
|
|
31
|
+
| `sign` | `(privateKey: CryptoKey, message: Uint8Array) => Promise<Uint8Array\|false>` | 64-byte signature or `false` on error |
|
|
32
|
+
| `verify` | `(publicKey: CryptoKey, signature: Uint8Array, message: Uint8Array) => Promise<boolean>` | `true` if valid, `false` otherwise |
|
|
33
|
+
| `importKey` | `(format: 'raw'\|'spki'\|'pkcs8'\|'jwk', keyData: Uint8Array\|object, usages: KeyUsage[], extractable?: boolean) => Promise<CryptoKey\|false>` | Imported `CryptoKey` or `false` |
|
|
34
|
+
| `exportKey` | `(format: 'raw'\|'spki'\|'pkcs8'\|'jwk', key: CryptoKey) => Promise<Uint8Array\|object\|false>` | Raw/DER → `Uint8Array`; jwk → object; `false` on error |
|
|
35
|
+
|
|
36
|
+
`generateKey` defaults `extractable` to `true`. `importKey` defaults `extractable` to `false` for `pkcs8` (private key material) and `true` for all other formats.
|
|
37
|
+
|
|
38
|
+
Every operation resolves `false` when:
|
|
39
|
+
- `crypto.subtle` is unavailable (`[crypto] NOT READY` logged)
|
|
40
|
+
- A key guard fails: `key.algorithm.name !== 'Ed25519'` (`[crypto] INVALID` logged)
|
|
41
|
+
- An invalid `format` is supplied (`[crypto] INVALID` logged)
|
|
42
|
+
- An invalid input type is supplied (`[crypto] INVALID` logged)
|
|
43
|
+
- `crypto.subtle` itself rejects (`[crypto] FAIL` logged)
|
|
44
|
+
|
|
45
|
+
## Examples
|
|
46
|
+
|
|
47
|
+
### Generate and sign
|
|
48
|
+
|
|
49
|
+
```js
|
|
50
|
+
const kp = await webcryptoEd25519.generateKey();
|
|
51
|
+
if (kp === false) {
|
|
52
|
+
// Ed25519 unsupported on this engine — fall back to pure-JS ed25519
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
const message = new TextEncoder().encode('hello');
|
|
56
|
+
const signature = await webcryptoEd25519.sign(kp.privateKey, message);
|
|
57
|
+
// signature is a Uint8Array of 64 bytes
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Verify
|
|
61
|
+
|
|
62
|
+
```js
|
|
63
|
+
const valid = await webcryptoEd25519.verify(kp.publicKey, signature, message);
|
|
64
|
+
// valid === true
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Import a raw public key (32 bytes)
|
|
68
|
+
|
|
69
|
+
```js
|
|
70
|
+
// pubKeyBytes: Uint8Array of 32 bytes (raw Ed25519 public key)
|
|
71
|
+
const pubKey = await webcryptoEd25519.importKey('raw', pubKeyBytes, ['verify']);
|
|
72
|
+
const ok = await webcryptoEd25519.verify(pubKey, signature, message);
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### Export / import round-trip
|
|
76
|
+
|
|
77
|
+
```js
|
|
78
|
+
const rawBytes = await webcryptoEd25519.exportKey('raw', kp.publicKey);
|
|
79
|
+
// rawBytes is a 32-byte Uint8Array
|
|
80
|
+
|
|
81
|
+
const jwk = await webcryptoEd25519.exportKey('jwk', kp.publicKey);
|
|
82
|
+
// jwk is { kty: 'OKP', crv: 'Ed25519', x: '...', ... }
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Availability guard
|
|
86
|
+
|
|
87
|
+
```js
|
|
88
|
+
if (!webcryptoEd25519.isAvailable()) {
|
|
89
|
+
// crypto.subtle is absent — use pure-JS ed25519 module instead
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Worker Usage
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
const worker = fw.createWorker(
|
|
97
|
+
function ({ libs, args }) {
|
|
98
|
+
const enc = (s) => new TextEncoder().encode(s);
|
|
99
|
+
libs.webcryptoEd25519.generateKey().then(async (kp) => {
|
|
100
|
+
if (!kp) { self.postMessage(null); return; }
|
|
101
|
+
const sig = await libs.webcryptoEd25519.sign(kp.privateKey, enc(args[0]));
|
|
102
|
+
self.postMessage(sig);
|
|
103
|
+
});
|
|
104
|
+
},
|
|
105
|
+
{ dependencies: ['webcryptoEd25519'], args: ['hello'] }
|
|
106
|
+
);
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## Notes
|
|
110
|
+
|
|
111
|
+
- **RFC 8032**: Ed25519 is specified in [RFC 8032](https://www.rfc-editor.org/rfc/rfc8032). Signatures are deterministic (no random nonce) and always 64 bytes. Public keys are 32 bytes in raw format.
|
|
112
|
+
- **Engine availability**: `'Ed25519'` is a newer WebCrypto algorithm — Chrome ≥ 113, Firefox ≥ 130, Safari ≥ 17. On older engines `generateKey` (and all ops) resolve `false`; no feature-detect beyond the `crypto.subtle` guard is performed. Probe with `await generateKey()` at startup if runtime availability is uncertain.
|
|
113
|
+
- **No-throw contract**: all methods are `async` and resolve to a result or `false`. `crypto.subtle` rejections are caught and logged; they never propagate.
|
|
114
|
+
- **Key guards**: `sign`, `verify`, and `exportKey` check `key.algorithm.name === 'Ed25519'` before calling subtle, resolving `false` if the guard fails.
|
|
115
|
+
- **Worker-safe**: `crypto.subtle` is available in Web Workers; this module has no DOM dependency and no main-thread closures.
|
|
116
|
+
|
|
117
|
+
## See also
|
|
118
|
+
|
|
119
|
+
- [ed25519](../pkc/ed25519.md) — pure-JS Ed25519 (synchronous, bitArray I/O, no WebCrypto)
|
|
120
|
+
- [x25519](./x25519.md) — WebCrypto X25519 key agreement (ECDH over Curve25519)
|
|
121
|
+
- [ecc](./ecc.md) — WebCrypto ECDSA/ECDH over NIST curves
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: webcryptoHkdf
|
|
3
|
+
category: crypto/webcrypto
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# webcryptoHkdf
|
|
11
|
+
|
|
12
|
+
> WebCrypto-backed HKDF deriveBits/deriveKey wrapping crypto.subtle (RFC 5869).
|
|
13
|
+
|
|
14
|
+
**Module** `webcryptoHkdf` | **Source** `packages/front/fw/src/crypto/webcrypto/hkdf.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Performs HKDF key derivation (RFC 5869) via `crypto.subtle`: imports the IKM
|
|
17
|
+
as an HKDF base key, then calls `deriveBits` or `deriveKey`. Combined
|
|
18
|
+
extract+expand only — WebCrypto does not expose the separate HKDF-Extract and
|
|
19
|
+
HKDF-Expand primitives. Opt-in alternative to the pure-JS `hkdf` module.
|
|
20
|
+
|
|
21
|
+
Supported hashes: `'SHA-1'`, `'SHA-256'` (default), `'SHA-384'`, `'SHA-512'`.
|
|
22
|
+
SHA-3 and other hashes are not supported by the WebCrypto API.
|
|
23
|
+
|
|
24
|
+
## Resolve
|
|
25
|
+
|
|
26
|
+
```js
|
|
27
|
+
const h = runtime.resolve('webcryptoHkdf');
|
|
28
|
+
// Returns: { isAvailable, deriveBits, deriveKey }
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## API
|
|
32
|
+
|
|
33
|
+
| Method | Signature | Returns |
|
|
34
|
+
|--------|-----------|---------|
|
|
35
|
+
| `isAvailable` | `() => boolean` | `true` when `crypto.subtle` is present. |
|
|
36
|
+
| `deriveBits` | `(ikm, salt, info, lengthBits, hash?) => Promise<Uint8Array\|false>` | Derived key material as bytes, or `false` on error. |
|
|
37
|
+
| `deriveKey` | `(ikm, salt, info, derivedKeyAlg, usages, hash?, extractable?) => Promise<CryptoKey\|false>` | A `CryptoKey` ready to use, or `false` on error. |
|
|
38
|
+
|
|
39
|
+
### Parameters
|
|
40
|
+
|
|
41
|
+
**`deriveBits(ikm, salt, info, lengthBits, hash?)`**
|
|
42
|
+
|
|
43
|
+
| Parameter | Type | Description |
|
|
44
|
+
|-----------|------|-------------|
|
|
45
|
+
| `ikm` | `Uint8Array` | Input keying material. |
|
|
46
|
+
| `salt` | `Uint8Array` | Salt value. Empty `Uint8Array` is valid (RFC 5869 §2.2 treats it as a block of zeros). |
|
|
47
|
+
| `info` | `Uint8Array` | Context / application-specific information. May be empty. |
|
|
48
|
+
| `lengthBits` | `number` | Number of bits to derive. Must be a positive multiple of 8. |
|
|
49
|
+
| `hash` | `HashName?` | Hash algorithm. Default: `'SHA-256'`. |
|
|
50
|
+
|
|
51
|
+
**`deriveKey(ikm, salt, info, derivedKeyAlg, usages, hash?, extractable?)`**
|
|
52
|
+
|
|
53
|
+
| Parameter | Type | Description |
|
|
54
|
+
|-----------|------|-------------|
|
|
55
|
+
| `ikm` | `Uint8Array` | Input keying material. |
|
|
56
|
+
| `salt` | `Uint8Array` | Salt value. |
|
|
57
|
+
| `info` | `Uint8Array` | Context information. |
|
|
58
|
+
| `derivedKeyAlg` | `object` | WebCrypto key-algorithm descriptor (e.g. `{name:'AES-GCM',length:256}`). |
|
|
59
|
+
| `usages` | `KeyUsage[]` | Key usage array (e.g. `['encrypt','decrypt']`). |
|
|
60
|
+
| `hash` | `HashName?` | Hash algorithm. Default: `'SHA-256'`. |
|
|
61
|
+
| `extractable` | `boolean?` | Whether the derived key is extractable. Default: `false`. |
|
|
62
|
+
|
|
63
|
+
### Error behavior (no-throw contract)
|
|
64
|
+
|
|
65
|
+
All methods resolve to `false` (never reject) when:
|
|
66
|
+
- `crypto.subtle` is unavailable — logs `[crypto] NOT READY`.
|
|
67
|
+
- `hash` is not in the supported set — logs `[crypto] INVALID`.
|
|
68
|
+
- `lengthBits` is not a positive multiple of 8 — logs `[crypto] INVALID`.
|
|
69
|
+
- `crypto.subtle` rejects — logs `[crypto] FAIL`.
|
|
70
|
+
|
|
71
|
+
## Examples
|
|
72
|
+
|
|
73
|
+
### Derive raw key material (RFC 5869 Test Case 1)
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
const h = runtime.resolve('webcryptoHkdf');
|
|
77
|
+
|
|
78
|
+
const ikm = new Uint8Array([0x0b, 0x0b, /* … 22 bytes */]);
|
|
79
|
+
const salt = new Uint8Array([0x00, 0x01, 0x02, /* … */]);
|
|
80
|
+
const info = new Uint8Array([0xf0, 0xf1, /* … */]);
|
|
81
|
+
|
|
82
|
+
const okm = await h.deriveBits(ikm, salt, info, 336); // 42 bytes
|
|
83
|
+
// okm: Uint8Array(42) — matches RFC 5869 A.1 expected OKM
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Derive an AES-GCM key
|
|
87
|
+
|
|
88
|
+
```js
|
|
89
|
+
const aesKey = await h.deriveKey(
|
|
90
|
+
ikm, salt, info,
|
|
91
|
+
{ name: 'AES-GCM', length: 256 },
|
|
92
|
+
['encrypt', 'decrypt'],
|
|
93
|
+
'SHA-256'
|
|
94
|
+
);
|
|
95
|
+
// aesKey: CryptoKey { type: 'secret', algorithm: { name: 'AES-GCM', … } }
|
|
96
|
+
const ct = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, aesKey, plaintext);
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Derive with empty salt and info
|
|
100
|
+
|
|
101
|
+
```js
|
|
102
|
+
// RFC 5869 §2.2: empty salt is treated as HashLen zeros internally
|
|
103
|
+
const okm = await h.deriveBits(ikm, new Uint8Array(0), new Uint8Array(0), 336);
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Worker usage
|
|
107
|
+
|
|
108
|
+
```js
|
|
109
|
+
const worker = fw.createWorker(
|
|
110
|
+
async function ({ libs, args }) {
|
|
111
|
+
const okm = await libs.webcryptoHkdf.deriveBits(
|
|
112
|
+
args.ikm, args.salt, args.info, 256
|
|
113
|
+
);
|
|
114
|
+
self.postMessage(okm);
|
|
115
|
+
},
|
|
116
|
+
{ dependencies: ['webcryptoHkdf'], args: { ikm, salt, info } }
|
|
117
|
+
);
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Notes
|
|
121
|
+
|
|
122
|
+
- **Combined extract+expand only**: WebCrypto HKDF does not expose the extract
|
|
123
|
+
and expand stages separately. Use the pure-JS `hkdf` module when you need
|
|
124
|
+
access to the intermediate PRK or per-component operations.
|
|
125
|
+
- **SHA-3 not supported**: WebCrypto mandates SHA-1/256/384/512 only.
|
|
126
|
+
For HMAC-SHA-3 or BLAKE2b-based HKDF, use the pure-JS `hkdf` module.
|
|
127
|
+
- **Zero-length salt**: RFC 5869 §2.2 specifies that a missing/empty salt is
|
|
128
|
+
treated as a string of HashLen zero bytes. `crypto.subtle` implements this
|
|
129
|
+
correctly — pass `new Uint8Array(0)`.
|
|
130
|
+
- **OKM length limit**: RFC 5869 §2.3 limits output to `255 × HashLen` bytes.
|
|
131
|
+
Violations are rejected by `crypto.subtle` (resolves to `false`).
|
|
132
|
+
- **Availability**: call `isAvailable()` before use in environments where
|
|
133
|
+
`crypto.subtle` may be absent (e.g. `http:` pages, older Node.js without
|
|
134
|
+
the `webcrypto` flag).
|
|
135
|
+
|
|
136
|
+
## See also
|
|
137
|
+
|
|
138
|
+
- [hkdf](../hash/hkdf.md) — pure-JS HKDF (extract+expand separately, bitArray I/O)
|
|
139
|
+
- [webcryptoPbkdf2](./pbkdf2.md) — WebCrypto PBKDF2 (password-based KDF)
|
|
140
|
+
- [webcryptoHmac](./hmac.md) — WebCrypto HMAC
|
|
141
|
+
- [webcryptoDigest](./digest.md) — WebCrypto SHA-256/384/512/1 digests
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: webcryptoHmac
|
|
3
|
+
category: crypto/webcrypto
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# webcryptoHmac
|
|
11
|
+
|
|
12
|
+
> WebCrypto-backed HMAC sign/verify over `crypto.subtle` — native CryptoKey, constant-time verify.
|
|
13
|
+
|
|
14
|
+
**Module** `webcryptoHmac` | **Source** `packages/front/fw/src/crypto/webcrypto/hmac.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Async, one-shot HMAC over SHA-256 (default), SHA-384, SHA-512, or SHA-1 (legacy).
|
|
17
|
+
Opt-in alternative to the pure-JS `hmac` module; keys are native `CryptoKey` objects
|
|
18
|
+
and `verify` is constant-time per the platform guarantee.
|
|
19
|
+
|
|
20
|
+
## Resolve
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
const webcryptoHmac = runtime.resolve('webcryptoHmac');
|
|
24
|
+
// Returns: { isAvailable, importKey, generateKey, sign, verify, mac }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Member | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `isAvailable` | `() => boolean` | `true` when `crypto.subtle` is present |
|
|
32
|
+
| `importKey` | `(rawKey: Uint8Array, hash?, extractable?) => Promise<CryptoKey\|false>` | Imports a raw key for HMAC under `hash` |
|
|
33
|
+
| `generateKey` | `(hash?, lengthBits?, extractable?) => Promise<CryptoKey\|false>` | Generates a random HMAC key |
|
|
34
|
+
| `sign` | `(key: CryptoKey, data: Uint8Array) => Promise<Uint8Array\|false>` | Computes HMAC tag |
|
|
35
|
+
| `verify` | `(key: CryptoKey, signature: Uint8Array, data: Uint8Array) => Promise<boolean>` | Verifies HMAC tag (constant-time) |
|
|
36
|
+
| `mac` | `(rawKey: Uint8Array, data: Uint8Array, hash?) => Promise<Uint8Array\|false>` | One-shot: importKey then sign |
|
|
37
|
+
|
|
38
|
+
**Default hash**: `'SHA-256'`. Supported: `'SHA-256'`, `'SHA-384'`, `'SHA-512'`, `'SHA-1'`.
|
|
39
|
+
`'SHA-1'` emits `console.warn('[crypto] DEPRECATED: HMAC-SHA-1')`.
|
|
40
|
+
|
|
41
|
+
All operations resolve to a result or `false`; they never reject.
|
|
42
|
+
|
|
43
|
+
## Examples
|
|
44
|
+
|
|
45
|
+
### One-shot MAC (most common)
|
|
46
|
+
|
|
47
|
+
```js
|
|
48
|
+
const { webcryptoHmac } = fw.runtime.resolveAll(['webcryptoHmac']);
|
|
49
|
+
const key = new TextEncoder().encode('secret-key');
|
|
50
|
+
const data = new TextEncoder().encode('message');
|
|
51
|
+
const tag = await webcryptoHmac.mac(key, data); // Uint8Array (32 bytes)
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Import key, sign, then verify
|
|
55
|
+
|
|
56
|
+
```js
|
|
57
|
+
const rawKey = crypto.getRandomValues(new Uint8Array(32));
|
|
58
|
+
const key = await webcryptoHmac.importKey(rawKey, 'SHA-256');
|
|
59
|
+
const data = new TextEncoder().encode('payload');
|
|
60
|
+
const sig = await webcryptoHmac.sign(key, data); // Uint8Array
|
|
61
|
+
const ok = await webcryptoHmac.verify(key, sig, data); // true
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Generate a fresh key
|
|
65
|
+
|
|
66
|
+
```js
|
|
67
|
+
const key = await webcryptoHmac.generateKey('SHA-512'); // CryptoKey
|
|
68
|
+
const data = new TextEncoder().encode('test');
|
|
69
|
+
const tag = await webcryptoHmac.sign(key, data);
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### HMAC-SHA-384
|
|
73
|
+
|
|
74
|
+
```js
|
|
75
|
+
const tag = await webcryptoHmac.mac(rawKey, data, 'SHA-384');
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Worker usage
|
|
79
|
+
|
|
80
|
+
```js
|
|
81
|
+
const worker = fw.createWorker(
|
|
82
|
+
async function ({ libs, args }) {
|
|
83
|
+
const [rawKey, payload] = args;
|
|
84
|
+
const tag = await libs.webcryptoHmac.mac(rawKey, new TextEncoder().encode(payload));
|
|
85
|
+
self.postMessage(tag);
|
|
86
|
+
},
|
|
87
|
+
{ dependencies: ['webcryptoHmac'], args: [rawKey, 'message'] }
|
|
88
|
+
);
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Notes
|
|
92
|
+
|
|
93
|
+
- **Keys are native `CryptoKey`** objects, not `bitArray`. Use `importKey` to
|
|
94
|
+
bring a raw `Uint8Array` secret into WebCrypto, or `generateKey` for ephemeral use.
|
|
95
|
+
- **`verify` is constant-time** per the WebCrypto specification — the platform
|
|
96
|
+
performs the comparison without early exit.
|
|
97
|
+
- **No-throw contract**: every method catches `crypto.subtle` rejections internally
|
|
98
|
+
and resolves `false`; callers never need a `try/catch`.
|
|
99
|
+
- **Unsupported hash** (anything outside SHA-256/384/512/SHA-1): logs
|
|
100
|
+
`[crypto] INVALID` and resolves `false`.
|
|
101
|
+
- **SHA-1**: accepted for legacy interop only. Triggers a deprecation warning and
|
|
102
|
+
is forbidden by SP 800-131A §5 for new protocols.
|
|
103
|
+
- **`isAvailable`**: check this once at startup if the runtime environment is
|
|
104
|
+
unknown (e.g. a sandboxed iframe). All other methods also guard internally.
|
|
105
|
+
- **Opt-in alternative**: for environments without `crypto.subtle` (or when
|
|
106
|
+
`bitArray` I/O or SHA-3/BLAKE2b is needed) use the pure-JS `hmac` module.
|
|
107
|
+
|
|
108
|
+
## See also
|
|
109
|
+
|
|
110
|
+
- [../hash/hmac.md](../hash/hmac.md) — pure-JS HMAC default, bitArray I/O, SHA-3/BLAKE2b support
|
|
111
|
+
- [digest.md](./digest.md) — WebCrypto SHA-256/384/512 one-shot digest
|
|
112
|
+
- [../hash/sha256.md](../hash/sha256.md), [../hash/sha512.md](../hash/sha512.md) — pure-JS hash modules
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: webcryptoPbkdf2
|
|
3
|
+
category: crypto/webcrypto
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# webcryptoPbkdf2
|
|
11
|
+
|
|
12
|
+
> Async PBKDF2 key derivation via `crypto.subtle` — SHA-1/256/384/512 PRFs, zero dependencies.
|
|
13
|
+
|
|
14
|
+
**Module** `webcryptoPbkdf2` | **Source** `packages/front/fw/src/crypto/webcrypto/pbkdf2.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
The factory returns an object with `isAvailable`, `deriveBits`, and `deriveKey`. Wraps
|
|
17
|
+
`crypto.subtle.importKey` + `deriveBits` / `deriveKey`. Default iteration count is
|
|
18
|
+
600 000 (OWASP 2023). All methods are `async` and resolve to `false` on any error —
|
|
19
|
+
they never throw or reject.
|
|
20
|
+
|
|
21
|
+
## Resolve
|
|
22
|
+
|
|
23
|
+
```js
|
|
24
|
+
import { webcryptoPbkdf2 } from '@awacloud/fw/crypto/webcrypto/pbkdf2';
|
|
25
|
+
const wc = webcryptoPbkdf2.factory();
|
|
26
|
+
|
|
27
|
+
if (!wc.isAvailable()) {
|
|
28
|
+
// Fall back to pure-JS pbkdf2 module
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## API
|
|
33
|
+
|
|
34
|
+
| Method | Signature | Returns |
|
|
35
|
+
|--------|-----------|---------|
|
|
36
|
+
| `isAvailable` | `() => boolean` | `true` when `crypto.subtle` is present |
|
|
37
|
+
| `deriveBits` | `(password, salt, lengthBits, iterations?, hash?) => Promise<Uint8Array\|false>` | Derived key bytes, or `false` on error |
|
|
38
|
+
| `deriveKey` | `(password, salt, derivedKeyAlg, usages, iterations?, hash?, extractable?) => Promise<CryptoKey\|false>` | Derived `CryptoKey`, or `false` on error |
|
|
39
|
+
|
|
40
|
+
### Parameters
|
|
41
|
+
|
|
42
|
+
**`deriveBits`**
|
|
43
|
+
|
|
44
|
+
| Parameter | Type | Default | Constraint |
|
|
45
|
+
|-----------|------|---------|------------|
|
|
46
|
+
| `password` | `Uint8Array` | — | required |
|
|
47
|
+
| `salt` | `Uint8Array` | — | required |
|
|
48
|
+
| `lengthBits` | `number` | — | positive multiple of 8 |
|
|
49
|
+
| `iterations` | `number` | `600000` | positive integer ≥ 1 |
|
|
50
|
+
| `hash` | `HashName` | `'SHA-256'` | one of `SHA-1`, `SHA-256`, `SHA-384`, `SHA-512` |
|
|
51
|
+
|
|
52
|
+
**`deriveKey`**
|
|
53
|
+
|
|
54
|
+
| Parameter | Type | Default | Notes |
|
|
55
|
+
|-----------|------|---------|-------|
|
|
56
|
+
| `password` | `Uint8Array` | — | required |
|
|
57
|
+
| `salt` | `Uint8Array` | — | required |
|
|
58
|
+
| `derivedKeyAlg` | `object` | — | WebCrypto key-algorithm dict, e.g. `{name:'AES-GCM', length:256}` |
|
|
59
|
+
| `usages` | `KeyUsage[]` | — | e.g. `['encrypt', 'decrypt']` |
|
|
60
|
+
| `iterations` | `number` | `600000` | positive integer ≥ 1 |
|
|
61
|
+
| `hash` | `HashName` | `'SHA-256'` | one of `SHA-1`, `SHA-256`, `SHA-384`, `SHA-512` |
|
|
62
|
+
| `extractable` | `boolean` | `false` | whether the key material can be exported |
|
|
63
|
+
|
|
64
|
+
## Examples
|
|
65
|
+
|
|
66
|
+
### Derive raw key bytes (AES-256)
|
|
67
|
+
|
|
68
|
+
```js
|
|
69
|
+
const enc = new TextEncoder();
|
|
70
|
+
const wc = webcryptoPbkdf2.factory();
|
|
71
|
+
|
|
72
|
+
const dk = await wc.deriveBits(
|
|
73
|
+
enc.encode('correct horse battery staple'),
|
|
74
|
+
enc.encode('unique-per-user-salt'),
|
|
75
|
+
256, // bits — 32 bytes
|
|
76
|
+
600000, // OWASP 2023
|
|
77
|
+
'SHA-256'
|
|
78
|
+
);
|
|
79
|
+
// dk: Uint8Array(32)
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Derive a CryptoKey for AES-GCM
|
|
83
|
+
|
|
84
|
+
```js
|
|
85
|
+
const key = await wc.deriveKey(
|
|
86
|
+
enc.encode('passphrase'),
|
|
87
|
+
enc.encode('salt'),
|
|
88
|
+
{ name: 'AES-GCM', length: 256 },
|
|
89
|
+
['encrypt', 'decrypt'],
|
|
90
|
+
600000,
|
|
91
|
+
'SHA-256'
|
|
92
|
+
);
|
|
93
|
+
if (key) {
|
|
94
|
+
const iv = crypto.getRandomValues(new Uint8Array(12));
|
|
95
|
+
const ct = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, key, plaintext);
|
|
96
|
+
}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Worker-offload (recommended for high iteration counts)
|
|
100
|
+
|
|
101
|
+
PBKDF2 at 600 000 iterations takes ~300–800 ms. Delegate to a Worker to keep the UI responsive:
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
const worker = fw.createWorker(
|
|
105
|
+
function ({ libs, args }) {
|
|
106
|
+
const wc = libs.webcryptoPbkdf2.factory();
|
|
107
|
+
wc.deriveBits(args[0], args[1], 256, 600000).then(dk => self.postMessage(dk));
|
|
108
|
+
},
|
|
109
|
+
{ dependencies: ['webcryptoPbkdf2'], args: [password, salt] }
|
|
110
|
+
);
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Check availability and fall back
|
|
114
|
+
|
|
115
|
+
```js
|
|
116
|
+
const wc = webcryptoPbkdf2.factory();
|
|
117
|
+
if (wc.isAvailable()) {
|
|
118
|
+
return await wc.deriveBits(password, salt, 256, 600000);
|
|
119
|
+
} else {
|
|
120
|
+
// Fall back to pure-JS pbkdf2 module
|
|
121
|
+
return pbkdf2(password, salt, 600000, 256);
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Notes
|
|
126
|
+
|
|
127
|
+
- **Default 600 000 iterations** matches OWASP 2023 for PBKDF2-HMAC-SHA-256 password storage.
|
|
128
|
+
- **Supported PRFs**: SHA-1, SHA-256, SHA-384, SHA-512 only — the WebCrypto specification
|
|
129
|
+
restricts PBKDF2 to the SHA-1/2 family. For SHA-3 PRFs use the pure-JS `pbkdf2` module.
|
|
130
|
+
- **Validation**: invalid `iterations` (< 1 or non-integer), `lengthBits` (≤ 0 or not a multiple
|
|
131
|
+
of 8), or unsupported `hash` resolve to `false` with a `[crypto] INVALID` console error.
|
|
132
|
+
- **No throw contract**: every failure path catches internally and resolves `false`.
|
|
133
|
+
- **Worker-safe**: `crypto.subtle` is available in Web Workers; the factory captures no
|
|
134
|
+
main-thread references.
|
|
135
|
+
|
|
136
|
+
## See also
|
|
137
|
+
|
|
138
|
+
- [`../hash/pbkdf2.md`](../hash/pbkdf2.md) — pure-JS PBKDF2 (SHA-1/2 and SHA-3 PRFs, bitArray I/O)
|
|
139
|
+
- [`./hkdf.md`](./hkdf.md) — WebCrypto HKDF (non-password KDF)
|
|
140
|
+
- [`./digest.md`](./digest.md) — WebCrypto digest (SHA-1/256/384/512)
|