@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,846 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @typedef {Int8Array|Uint8Array|Uint8ClampedArray|Int16Array|Uint16Array|Int32Array|Uint32Array|BigInt64Array|BigUint64Array} TypedArray
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* @fileoverview CSPRNG wrapper around `crypto.getRandomValues` plus a
|
|
11
|
+
* SP 800-90A compliant CTR_DRBG-AES-256 (no derivation function).
|
|
12
|
+
*
|
|
13
|
+
* Two surfaces are exposed:
|
|
14
|
+
*
|
|
15
|
+
* 1. **Direct API** (`bytes`, `words`, `bits`, `isReady`) - thin wrapper
|
|
16
|
+
* over `crypto.getRandomValues`. Vetted by the platform; the recommended
|
|
17
|
+
* path for general-purpose use.
|
|
18
|
+
*
|
|
19
|
+
* 2. **`drbg(options)`** - instantiates a CTR_DRBG per NIST SP 800-90A
|
|
20
|
+
* §10.2 (AES-256, no df). Suitable as a FIPS 140-3 "approved" DRBG
|
|
21
|
+
* assuming the entropy source (`crypto.getRandomValues`, treated as a
|
|
22
|
+
* validated NRBG per SP 800-90C) and the surrounding module satisfy
|
|
23
|
+
* the rest of the FIPS module-level requirements.
|
|
24
|
+
*
|
|
25
|
+
* The DRBG performs:
|
|
26
|
+
* - **POST / KAT** at first instantiation (cached process-wide),
|
|
27
|
+
* - **Continuous health test (RCT)** on every entropy buffer drawn
|
|
28
|
+
* from `crypto.getRandomValues` (SP 800-90B §4.4.1),
|
|
29
|
+
* - **Reseed** with fresh OS entropy when the reseed_counter exceeds
|
|
30
|
+
* the configured limit (default 2^32, well below the 2^48 spec cap),
|
|
31
|
+
* - Acceptance of `additional_input` on every `generate()` call so that
|
|
32
|
+
* environmental entropy (e.g. from `entropyCollector`) can be mixed
|
|
33
|
+
* in without depending on its module at construction time.
|
|
34
|
+
*
|
|
35
|
+
* `entropyCollector` is **not** a dependency: the caller wires its
|
|
36
|
+
* callback to `drbg.addAdditionalInput()` so that the next `generate()`
|
|
37
|
+
* consumes the accumulated bytes via the spec-defined update path.
|
|
38
|
+
* This keeps `random` worker-safe (DOM-free).
|
|
39
|
+
*
|
|
40
|
+
* The KAT vector used by `_runSelfTest()` is the official NIST CAVP
|
|
41
|
+
* CTR_DRBG-AES-256 (no-df, PredictionResistance=False, COUNT=0) vector from
|
|
42
|
+
* the `drbgvectors_pr_false` archive
|
|
43
|
+
* (https://csrc.nist.gov/projects/cryptographic-algorithm-validation-program/random-number-generators)
|
|
44
|
+
* - also mirrored in BoringSSL's `crypto/fipsmodule/rand/ctrdrbg_vectors.txt`.
|
|
45
|
+
* Sufficient for the algorithmic KAT; full FIPS 140-3 validation additionally
|
|
46
|
+
* requires the surrounding module-level operational tests outside this file.
|
|
47
|
+
*
|
|
48
|
+
*/
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Low-level CTR_DRBG instance produced by the internal `_makeDrbg` factory
|
|
52
|
+
* (exposed via `_internal.makeDrbg`). Caller drives the full SP 800-90A
|
|
53
|
+
* lifecycle manually with explicit seed material.
|
|
54
|
+
* @typedef {object} DrbgCore
|
|
55
|
+
* @property {(entropyBytes: Uint8Array, personalisationBytes?: Uint8Array, nonceBytes?: Uint8Array) => boolean} instantiate Seed the DRBG.
|
|
56
|
+
* @property {(entropyBytes: Uint8Array, additionalInputBytes?: Uint8Array) => boolean} reseed Reseed with caller-supplied entropy.
|
|
57
|
+
* @property {(n: number, additionalInputBytes?: Uint8Array) => (Uint8Array | false)} generate Produce `n` random bytes.
|
|
58
|
+
* @property {() => void} uninstantiate Wipe internal state.
|
|
59
|
+
* @property {boolean} isLive Whether the DRBG has been instantiated (getter).
|
|
60
|
+
* @property {number} reseedCounter Current reseed counter (getter).
|
|
61
|
+
* @property {number} securityStrength Security strength in bits (getter).
|
|
62
|
+
* @property {number} aesKeyBits Configured AES key size in bits (getter).
|
|
63
|
+
* @property {boolean} useDf Whether a derivation function is used (getter).
|
|
64
|
+
* @property {number} seedBytes Seed length in bytes (getter).
|
|
65
|
+
*/
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* High-level CTR_DRBG instance returned by `api.drbg(options)`. Auto-seeds
|
|
69
|
+
* from OS entropy and supports mixing in pending additional input.
|
|
70
|
+
* @typedef {object} Drbg
|
|
71
|
+
* @property {(n: number, additionalInput?: Uint8Array) => (Uint8Array | false)} generate Produce `n` random bytes, folding in any pending additional input.
|
|
72
|
+
* @property {(additionalInput?: Uint8Array) => boolean} reseed Reseed with fresh OS entropy.
|
|
73
|
+
* @property {(bytes: Uint8Array | number[] | Uint32Array | number) => boolean} addAdditionalInput Buffer entropy for the next `generate()`/`reseed()`.
|
|
74
|
+
* @property {() => void} uninstantiate Wipe internal state and pending buffer.
|
|
75
|
+
* @property {boolean} isLive Whether the DRBG is live (getter).
|
|
76
|
+
* @property {number} reseedCounter Current reseed counter (getter).
|
|
77
|
+
* @property {number} securityStrength Security strength in bits (getter).
|
|
78
|
+
*/
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* SP 800-90B continuous health-test surface.
|
|
82
|
+
* @typedef {object} RandomHealth
|
|
83
|
+
* @property {(buf: Uint8Array | number[]) => boolean} feed Push bytes through RCT + APT; `false` on failure.
|
|
84
|
+
* @property {() => void} reset Clear state and the latched-dead flag.
|
|
85
|
+
* @property {boolean} isDead True once any continuous test has failed (getter).
|
|
86
|
+
*/
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Public shape returned by `random.factory()`.
|
|
90
|
+
* @typedef {object} RandomAPI
|
|
91
|
+
* @property {<T extends TypedArray>(array: T) => T} fill Fill a typed array in place with secure random values.
|
|
92
|
+
* @property {() => (number | false)} float Secure random float in `[0, 1)`.
|
|
93
|
+
* @property {(min: number, max: number) => (number | false)} int Secure random integer in `[min, max]` (rejection-sampled).
|
|
94
|
+
* @property {(n: number) => (Uint8Array | false)} bytes `n` random bytes (direct OS RBG).
|
|
95
|
+
* @property {(n: number) => (number[] | false)} words `n` random 32-bit words (direct OS RBG).
|
|
96
|
+
* @property {(n: number) => (number[] | false)} bits Random bit array of `n` bits (direct OS RBG).
|
|
97
|
+
* @property {() => boolean} isReady Whether `crypto.getRandomValues` is available.
|
|
98
|
+
* @property {() => boolean} selfTest Run / re-run the CTR_DRBG power-on self-test.
|
|
99
|
+
* @property {{ makeDrbg: (opts?: { aesKeyBits?: 128|192|256, df?: boolean }) => (DrbgCore | false) }} _internal Test-only internal CTR_DRBG factory.
|
|
100
|
+
* @property {RandomHealth} health Continuous health-test surface.
|
|
101
|
+
* @property {(options?: { aesKeyBits?: 128|192|256, df?: boolean, personalisation?: Uint8Array }) => (Drbg | false)} drbg Build a fresh CTR_DRBG-AES-256 (no-df) instance.
|
|
102
|
+
*/
|
|
103
|
+
|
|
104
|
+
import { bitArray } from './bitArray.js';
|
|
105
|
+
import { aes } from '../cipher/aes.js';
|
|
106
|
+
import { sha256 } from '../hash/sha256.js';
|
|
107
|
+
|
|
108
|
+
export const random = {
|
|
109
|
+
name: 'random',
|
|
110
|
+
version: '1.0.0',
|
|
111
|
+
type: 'fw.crypto.utils',
|
|
112
|
+
dependencies: ['bitArray', 'aes', 'sha256'],
|
|
113
|
+
deps: [bitArray, aes, sha256],
|
|
114
|
+
|
|
115
|
+
/** @returns {RandomAPI} */
|
|
116
|
+
factory(bitArray, aes, sha256) {
|
|
117
|
+
|
|
118
|
+
const _MAX_BYTES_PER_CALL = 65536;
|
|
119
|
+
const _hasCrypto = typeof crypto !== 'undefined' && !!crypto.getRandomValues;
|
|
120
|
+
|
|
121
|
+
// ── byte/word helpers (big-endian, AES convention) ───────────────
|
|
122
|
+
|
|
123
|
+
function _bytesToWords(b) {
|
|
124
|
+
const n = b.length >>> 2;
|
|
125
|
+
const out = new Array(n);
|
|
126
|
+
for (let i = 0; i < n; i++) {
|
|
127
|
+
const j = i << 2;
|
|
128
|
+
out[i] = ((b[j] << 24) | (b[j + 1] << 16) | (b[j + 2] << 8) | b[j + 3]) | 0;
|
|
129
|
+
}
|
|
130
|
+
return out;
|
|
131
|
+
}
|
|
132
|
+
function _wordsToBytes(w, count, into, off) {
|
|
133
|
+
for (let i = 0; i < count; i++) {
|
|
134
|
+
const j = off + (i << 2);
|
|
135
|
+
into[j] = (w[i] >>> 24) & 0xff;
|
|
136
|
+
into[j + 1] = (w[i] >>> 16) & 0xff;
|
|
137
|
+
into[j + 2] = (w[i] >>> 8) & 0xff;
|
|
138
|
+
into[j + 3] = w[i] & 0xff;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// ── continuous health tests (SP 800-90B §4.4) ────────────────────
|
|
143
|
+
//
|
|
144
|
+
// Both tests run continuously across the lifetime of the entropy
|
|
145
|
+
// source - state persists across calls, not per-buffer. Once either
|
|
146
|
+
// test fails, the source is marked dead permanently (SP 800-90B §4.5:
|
|
147
|
+
// "Once a continuous test failure is detected, no more outputs from
|
|
148
|
+
// the noise source shall be used").
|
|
149
|
+
//
|
|
150
|
+
// Parameters assume a full-entropy byte source (H = 8 bits/byte) and
|
|
151
|
+
// α = 2^-20 false-alarm probability:
|
|
152
|
+
//
|
|
153
|
+
// RCT (§4.4.1) - Repetition Count Test
|
|
154
|
+
// C_rct = 1 + ⌈-log2(α) / H⌉ = 1 + ⌈20/8⌉ = 4
|
|
155
|
+
// Fail if 4 identical consecutive samples.
|
|
156
|
+
//
|
|
157
|
+
// APT (§4.4.2) - Adaptive Proportion Test
|
|
158
|
+
// Window W = 512 samples, p = 2^-H = 1/256, mean = 2.
|
|
159
|
+
// Cutoff C_apt = 13 (smallest C such that P(Bin(512,1/256) > C) ≤ α).
|
|
160
|
+
// Fail if the anchor sample appears more than 13 times in the
|
|
161
|
+
// non-overlapping 512-sample window.
|
|
162
|
+
|
|
163
|
+
const _RCT_CUTOFF = 4;
|
|
164
|
+
const _APT_W = 512;
|
|
165
|
+
const _APT_C = 13;
|
|
166
|
+
|
|
167
|
+
const _rct = { prev: -1, run: 0 };
|
|
168
|
+
const _apt = { anchor: -1, count: 0, idx: 0 };
|
|
169
|
+
let _entropyDead = false;
|
|
170
|
+
|
|
171
|
+
function _healthCheck(buf) {
|
|
172
|
+
if (_entropyDead) return false;
|
|
173
|
+
for (let i = 0; i < buf.length; i++) {
|
|
174
|
+
const b = buf[i];
|
|
175
|
+
|
|
176
|
+
// RCT
|
|
177
|
+
if (b === _rct.prev) {
|
|
178
|
+
_rct.run++;
|
|
179
|
+
if (_rct.run >= _RCT_CUTOFF) {
|
|
180
|
+
_entropyDead = true;
|
|
181
|
+
console.error('[crypto] CORRUPT: random: RCT health-test failed on entropy source');
|
|
182
|
+
return false;
|
|
183
|
+
}
|
|
184
|
+
} else {
|
|
185
|
+
_rct.prev = b;
|
|
186
|
+
_rct.run = 1;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// APT
|
|
190
|
+
if (_apt.anchor === -1) {
|
|
191
|
+
_apt.anchor = b;
|
|
192
|
+
_apt.count = 1;
|
|
193
|
+
_apt.idx = 1;
|
|
194
|
+
} else {
|
|
195
|
+
_apt.idx++;
|
|
196
|
+
if (b === _apt.anchor) {
|
|
197
|
+
_apt.count++;
|
|
198
|
+
if (_apt.count > _APT_C) {
|
|
199
|
+
_entropyDead = true;
|
|
200
|
+
console.error('[crypto] CORRUPT: random: APT health-test failed on entropy source');
|
|
201
|
+
return false;
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
if (_apt.idx >= _APT_W) _apt.anchor = -1;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
return true;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
function _resetHealth() {
|
|
211
|
+
_rct.prev = -1; _rct.run = 0;
|
|
212
|
+
_apt.anchor = -1; _apt.count = 0; _apt.idx = 0;
|
|
213
|
+
_entropyDead = false;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
// ── raw OS entropy with chunking + continuous health tests ───────
|
|
217
|
+
|
|
218
|
+
function _getRandomBytes(out) {
|
|
219
|
+
if (!_hasCrypto) {
|
|
220
|
+
console.error('[crypto] NOT READY: crypto.getRandomValues unavailable');
|
|
221
|
+
return false;
|
|
222
|
+
}
|
|
223
|
+
let offset = 0;
|
|
224
|
+
while (offset < out.length) {
|
|
225
|
+
const chunk = Math.min(_MAX_BYTES_PER_CALL, out.length - offset);
|
|
226
|
+
crypto.getRandomValues(out.subarray(offset, offset + chunk));
|
|
227
|
+
offset += chunk;
|
|
228
|
+
}
|
|
229
|
+
return out;
|
|
230
|
+
}
|
|
231
|
+
function _getEntropy(nBytes) {
|
|
232
|
+
if (_entropyDead) {
|
|
233
|
+
console.error('[crypto] CORRUPT: random: entropy source previously failed health test');
|
|
234
|
+
return false;
|
|
235
|
+
}
|
|
236
|
+
const buf = _getRandomBytes(new Uint8Array(nBytes));
|
|
237
|
+
if (buf === false) return false;
|
|
238
|
+
if (!_healthCheck(buf)) return false;
|
|
239
|
+
return buf;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
// ── CTR_DRBG-AES-{128,192,256}, no-df + with-df - SP 800-90A §10.2 ──
|
|
243
|
+
//
|
|
244
|
+
// Parameters (parametric since Iteration H4):
|
|
245
|
+
// aesKeyBits ∈ {128, 192, 256} → keylen = 16 / 24 / 32 bytes
|
|
246
|
+
// blocklen = 16 bytes (AES)
|
|
247
|
+
// seedlen = keylen + blocklen
|
|
248
|
+
// security_strength = aesKeyBits
|
|
249
|
+
// reseed_interval ≤ 2^48 (we use 2^32 for safety)
|
|
250
|
+
// max_bytes_per_request ≤ 2^19 bits = 65536 bytes
|
|
251
|
+
// df : SP 800-90A §10.4.2 Block Cipher Derivation Function.
|
|
252
|
+
// If true, instantiate/reseed accept any-length entropy +
|
|
253
|
+
// nonce + perso/additional-input strings ; df distills them
|
|
254
|
+
// into seedlen bytes via BCC. If false, all inputs must be
|
|
255
|
+
// exactly seedlen bytes.
|
|
256
|
+
|
|
257
|
+
const _BLK_WORDS = 4;
|
|
258
|
+
const _BLK_BYTES = 16;
|
|
259
|
+
const _MAX_GEN_BYTES = 65536;
|
|
260
|
+
const _RESEED_INTERVAL = 0x100000000; // 2^32, < spec cap 2^48
|
|
261
|
+
|
|
262
|
+
// Build a CTR_DRBG instance.
|
|
263
|
+
// @param {object} [opts]
|
|
264
|
+
// @param {128|192|256} [opts.aesKeyBits=256]
|
|
265
|
+
// @param {boolean} [opts.df=false]
|
|
266
|
+
function _makeDrbg(opts) {
|
|
267
|
+
opts = opts || {};
|
|
268
|
+
const aesKeyBits = opts.aesKeyBits || 256;
|
|
269
|
+
const useDf = !!opts.df;
|
|
270
|
+
if (aesKeyBits !== 128 && aesKeyBits !== 192 && aesKeyBits !== 256) {
|
|
271
|
+
console.error('[crypto] BUG: ctr_drbg: aesKeyBits must be 128, 192 or 256');
|
|
272
|
+
return false;
|
|
273
|
+
}
|
|
274
|
+
const KEY_BYTES = aesKeyBits / 8;
|
|
275
|
+
const KEY_WORDS = KEY_BYTES / 4;
|
|
276
|
+
const SEED_BYTES = KEY_BYTES + _BLK_BYTES;
|
|
277
|
+
const SEED_WORDS = SEED_BYTES / 4;
|
|
278
|
+
|
|
279
|
+
let K = new Array(KEY_WORDS).fill(0);
|
|
280
|
+
let V = new Array(_BLK_WORDS).fill(0);
|
|
281
|
+
let cipher = null;
|
|
282
|
+
let reseedCt = 0;
|
|
283
|
+
let live = false;
|
|
284
|
+
|
|
285
|
+
// ── SP 800-90A §10.4.2 - Block Cipher Derivation Function ────
|
|
286
|
+
//
|
|
287
|
+
// BCC(K, data): CBC-MAC of `data` (multiple of 16 bytes) under K.
|
|
288
|
+
function _bcc(Kbytes, dataBytes) {
|
|
289
|
+
const cf = aes.fn(_bytesToWords(Kbytes), false);
|
|
290
|
+
if (cf === false) return false;
|
|
291
|
+
const chain = new Uint8Array(_BLK_BYTES);
|
|
292
|
+
for (let off = 0; off < dataBytes.length; off += _BLK_BYTES) {
|
|
293
|
+
for (let i = 0; i < _BLK_BYTES; i++) chain[i] ^= dataBytes[off + i];
|
|
294
|
+
const blk = cf.encrypt(_bytesToWords(chain));
|
|
295
|
+
_wordsToBytes(blk, _BLK_WORDS, chain, 0);
|
|
296
|
+
}
|
|
297
|
+
return chain;
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
// Block_Cipher_df(input, no_of_bits_to_return) → bytes.
|
|
301
|
+
// Returns SEED_BYTES of distilled output.
|
|
302
|
+
function _df(inputBytes, outBytes) {
|
|
303
|
+
// S = L (4 BE) || N (4 BE) || input || 0x80 || 0x00…0
|
|
304
|
+
const L = inputBytes.length;
|
|
305
|
+
const N = outBytes;
|
|
306
|
+
const headerLen = 4 + 4;
|
|
307
|
+
const rawLen = headerLen + L + 1;
|
|
308
|
+
const padLen = (_BLK_BYTES - (rawLen % _BLK_BYTES)) % _BLK_BYTES;
|
|
309
|
+
const Slen = rawLen + padLen;
|
|
310
|
+
const S = new Uint8Array(Slen);
|
|
311
|
+
S[0] = (L >>> 24) & 0xff; S[1] = (L >>> 16) & 0xff;
|
|
312
|
+
S[2] = (L >>> 8) & 0xff; S[3] = L & 0xff;
|
|
313
|
+
S[4] = (N >>> 24) & 0xff; S[5] = (N >>> 16) & 0xff;
|
|
314
|
+
S[6] = (N >>> 8) & 0xff; S[7] = N & 0xff;
|
|
315
|
+
for (let i = 0; i < L; i++) S[headerLen + i] = inputBytes[i];
|
|
316
|
+
S[headerLen + L] = 0x80;
|
|
317
|
+
// padding 0x00 already set by Uint8Array init.
|
|
318
|
+
|
|
319
|
+
// K_df = 0x00 01 02 … (KEY_BYTES bytes)
|
|
320
|
+
const Kdf = new Uint8Array(KEY_BYTES);
|
|
321
|
+
for (let i = 0; i < KEY_BYTES; i++) Kdf[i] = i;
|
|
322
|
+
|
|
323
|
+
// temp = "" ; while len(temp) < KEY_BYTES + BLK_BYTES :
|
|
324
|
+
// IV = i (4 BE) || 0…0 (BLK-4 zero bytes)
|
|
325
|
+
// temp ||= BCC(K_df, IV || S)
|
|
326
|
+
const tempLen = KEY_BYTES + _BLK_BYTES;
|
|
327
|
+
const temp = new Uint8Array(Math.ceil(tempLen / _BLK_BYTES) * _BLK_BYTES);
|
|
328
|
+
let tempOff = 0;
|
|
329
|
+
let i = 0;
|
|
330
|
+
while (tempOff < tempLen) {
|
|
331
|
+
const ivS = new Uint8Array(_BLK_BYTES + Slen);
|
|
332
|
+
ivS[0] = (i >>> 24) & 0xff; ivS[1] = (i >>> 16) & 0xff;
|
|
333
|
+
ivS[2] = (i >>> 8) & 0xff; ivS[3] = i & 0xff;
|
|
334
|
+
ivS.set(S, _BLK_BYTES);
|
|
335
|
+
const blk = _bcc(Kdf, ivS);
|
|
336
|
+
if (blk === false) return false;
|
|
337
|
+
temp.set(blk, tempOff);
|
|
338
|
+
tempOff += _BLK_BYTES;
|
|
339
|
+
i++;
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
// K' = first KEY_BYTES of temp ; X = next BLK_BYTES of temp.
|
|
343
|
+
const Kp = temp.subarray(0, KEY_BYTES);
|
|
344
|
+
let X = temp.slice(KEY_BYTES, KEY_BYTES + _BLK_BYTES);
|
|
345
|
+
const cf = aes.fn(_bytesToWords(Kp), false);
|
|
346
|
+
if (cf === false) return false;
|
|
347
|
+
|
|
348
|
+
const out = new Uint8Array(outBytes);
|
|
349
|
+
let outOff = 0;
|
|
350
|
+
while (outOff < outBytes) {
|
|
351
|
+
const blk = cf.encrypt(_bytesToWords(X));
|
|
352
|
+
_wordsToBytes(blk, _BLK_WORDS, X, 0);
|
|
353
|
+
const n = Math.min(_BLK_BYTES, outBytes - outOff);
|
|
354
|
+
out.set(X.subarray(0, n), outOff);
|
|
355
|
+
outOff += n;
|
|
356
|
+
}
|
|
357
|
+
return out;
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
function _rebuild() {
|
|
361
|
+
cipher = aes.fn(K, false);
|
|
362
|
+
if (cipher === false) {
|
|
363
|
+
console.error('[crypto] BUG: ctr_drbg: AES key schedule failed');
|
|
364
|
+
return false;
|
|
365
|
+
}
|
|
366
|
+
return true;
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
function _incV() {
|
|
370
|
+
for (let i = _BLK_WORDS - 1; i >= 0; i--) {
|
|
371
|
+
V[i] = (V[i] + 1) | 0;
|
|
372
|
+
if (V[i] !== 0) break;
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
// CTR_DRBG_Update(provided_data: SEED_WORDS, K, V) - §10.2.1.2
|
|
377
|
+
function _update(providedWords) {
|
|
378
|
+
const temp = new Array(SEED_WORDS).fill(0);
|
|
379
|
+
let pos = 0;
|
|
380
|
+
while (pos < SEED_WORDS) {
|
|
381
|
+
_incV();
|
|
382
|
+
const blk = cipher.encrypt(V);
|
|
383
|
+
for (let j = 0; j < _BLK_WORDS && pos < SEED_WORDS; j++) {
|
|
384
|
+
temp[pos++] = blk[j];
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
for (let i = 0; i < SEED_WORDS; i++) temp[i] ^= providedWords[i];
|
|
388
|
+
K = temp.slice(0, KEY_WORDS);
|
|
389
|
+
// Slice exactly _BLK_WORDS for V (avoid AES-192 case where
|
|
390
|
+
// SEED_WORDS = KEY_WORDS + BLK_WORDS = 10 but temp could be
|
|
391
|
+
// longer if generated incorrectly).
|
|
392
|
+
V = temp.slice(KEY_WORDS, KEY_WORDS + _BLK_WORDS);
|
|
393
|
+
return _rebuild();
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
// Distill arbitrary inputs to a SEED_BYTES seed.
|
|
397
|
+
// no-df : caller must provide exactly SEED_BYTES of entropy ;
|
|
398
|
+
// perso/AI is XOR-truncated/padded to SEED_BYTES.
|
|
399
|
+
// df : entropy + nonce + perso (concatenated) → df → SEED_BYTES.
|
|
400
|
+
function _distill(entropyBytes, personalisationBytes, nonceBytes) {
|
|
401
|
+
if (useDf) {
|
|
402
|
+
const eLen = entropyBytes ? entropyBytes.length : 0;
|
|
403
|
+
const nLen = nonceBytes ? nonceBytes.length : 0;
|
|
404
|
+
const pLen = personalisationBytes ? personalisationBytes.length : 0;
|
|
405
|
+
const cat = new Uint8Array(eLen + nLen + pLen);
|
|
406
|
+
if (eLen) cat.set(entropyBytes, 0);
|
|
407
|
+
if (nLen) cat.set(nonceBytes, eLen);
|
|
408
|
+
if (pLen) cat.set(personalisationBytes, eLen + nLen);
|
|
409
|
+
return _df(cat, SEED_BYTES);
|
|
410
|
+
}
|
|
411
|
+
if (!entropyBytes || entropyBytes.length !== SEED_BYTES) {
|
|
412
|
+
console.error('[crypto] BUG: ctr_drbg (no-df): entropy must be exactly ' + SEED_BYTES + ' bytes');
|
|
413
|
+
return false;
|
|
414
|
+
}
|
|
415
|
+
const seed = new Uint8Array(SEED_BYTES);
|
|
416
|
+
seed.set(entropyBytes);
|
|
417
|
+
if (personalisationBytes && personalisationBytes.length > 0) {
|
|
418
|
+
const lim = Math.min(personalisationBytes.length, SEED_BYTES);
|
|
419
|
+
for (let i = 0; i < lim; i++) seed[i] ^= personalisationBytes[i];
|
|
420
|
+
}
|
|
421
|
+
return seed;
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
// §10.2.1.3 Instantiate (df or no-df depending on `useDf`).
|
|
425
|
+
// df : (entropy, nonce, persoString) → df → seed
|
|
426
|
+
// no-df : (entropy, persoString) - entropy must be SEED_BYTES
|
|
427
|
+
function instantiate(entropyBytes, personalisationBytes, nonceBytes) {
|
|
428
|
+
const seed = _distill(entropyBytes, personalisationBytes, nonceBytes);
|
|
429
|
+
if (seed === false) return false;
|
|
430
|
+
K.fill(0); V.fill(0);
|
|
431
|
+
if (!_rebuild()) return false;
|
|
432
|
+
if (!_update(_bytesToWords(seed))) return false;
|
|
433
|
+
reseedCt = 1;
|
|
434
|
+
live = true;
|
|
435
|
+
return true;
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
// §10.2.1.4 Reseed (df or no-df).
|
|
439
|
+
function reseed(entropyBytes, additionalInputBytes) {
|
|
440
|
+
if (!live) {
|
|
441
|
+
console.warn('[crypto] NOT READY: ctr_drbg.reseed: not instantiated');
|
|
442
|
+
return false;
|
|
443
|
+
}
|
|
444
|
+
// Reseed: nonce field unused (nonce is for instantiate only).
|
|
445
|
+
const seed = _distill(entropyBytes, additionalInputBytes, null);
|
|
446
|
+
if (seed === false) return false;
|
|
447
|
+
if (!_update(_bytesToWords(seed))) return false;
|
|
448
|
+
reseedCt = 1;
|
|
449
|
+
return true;
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
// §10.2.1.5.1 Generate (no df)
|
|
453
|
+
function generate(n, additionalInputBytes) {
|
|
454
|
+
if (!live) {
|
|
455
|
+
console.warn('[crypto] NOT READY: ctr_drbg.generate: not instantiated');
|
|
456
|
+
return false;
|
|
457
|
+
}
|
|
458
|
+
if (!Number.isInteger(n) || n < 0 || n > _MAX_GEN_BYTES) {
|
|
459
|
+
console.warn('[crypto] INVALID: ctr_drbg.generate: n must be an integer in [0, ' + _MAX_GEN_BYTES + ']');
|
|
460
|
+
return false;
|
|
461
|
+
}
|
|
462
|
+
if (n === 0) return new Uint8Array(0);
|
|
463
|
+
|
|
464
|
+
if (reseedCt > _RESEED_INTERVAL) {
|
|
465
|
+
const fresh = _getEntropy(SEED_BYTES);
|
|
466
|
+
if (fresh === false) return false;
|
|
467
|
+
if (!reseed(fresh, additionalInputBytes)) return false;
|
|
468
|
+
additionalInputBytes = null;
|
|
469
|
+
}
|
|
470
|
+
|
|
471
|
+
let aiWords;
|
|
472
|
+
if (additionalInputBytes && additionalInputBytes.length > 0) {
|
|
473
|
+
let aiBytes;
|
|
474
|
+
if (useDf) {
|
|
475
|
+
aiBytes = _df(additionalInputBytes, SEED_BYTES);
|
|
476
|
+
if (aiBytes === false) return false;
|
|
477
|
+
} else {
|
|
478
|
+
aiBytes = new Uint8Array(SEED_BYTES);
|
|
479
|
+
aiBytes.set(additionalInputBytes.subarray(0, Math.min(SEED_BYTES, additionalInputBytes.length)));
|
|
480
|
+
}
|
|
481
|
+
aiWords = _bytesToWords(aiBytes);
|
|
482
|
+
if (!_update(aiWords)) return false;
|
|
483
|
+
} else {
|
|
484
|
+
aiWords = new Array(SEED_WORDS).fill(0);
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
const out = new Uint8Array(n);
|
|
488
|
+
let off = 0;
|
|
489
|
+
while (off < n) {
|
|
490
|
+
_incV();
|
|
491
|
+
const blk = cipher.encrypt(V);
|
|
492
|
+
const remaining = n - off;
|
|
493
|
+
if (remaining >= 16) {
|
|
494
|
+
_wordsToBytes(blk, _BLK_WORDS, out, off);
|
|
495
|
+
off += 16;
|
|
496
|
+
} else {
|
|
497
|
+
const tmp = new Uint8Array(16);
|
|
498
|
+
_wordsToBytes(blk, _BLK_WORDS, tmp, 0);
|
|
499
|
+
out.set(tmp.subarray(0, remaining), off);
|
|
500
|
+
off = n;
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
|
|
504
|
+
if (!_update(aiWords)) return false;
|
|
505
|
+
reseedCt++;
|
|
506
|
+
return out;
|
|
507
|
+
}
|
|
508
|
+
|
|
509
|
+
// §11.3 uninstantiate - wipe state
|
|
510
|
+
function uninstantiate() {
|
|
511
|
+
K.fill(0); V.fill(0);
|
|
512
|
+
cipher = null; reseedCt = 0; live = false;
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
return {
|
|
516
|
+
instantiate, reseed, generate, uninstantiate,
|
|
517
|
+
get isLive() { return live; },
|
|
518
|
+
get reseedCounter() { return reseedCt; },
|
|
519
|
+
get securityStrength() { return aesKeyBits; },
|
|
520
|
+
get aesKeyBits() { return aesKeyBits; },
|
|
521
|
+
get useDf() { return useDf; },
|
|
522
|
+
get seedBytes() { return SEED_BYTES; }
|
|
523
|
+
};
|
|
524
|
+
}
|
|
525
|
+
|
|
526
|
+
// ── Power-On Self-Test (KAT) - FIPS 140-3 §7.10 ──────────────────
|
|
527
|
+
//
|
|
528
|
+
// Official NIST CAVP CTR_DRBG vector for AES-256 / no derivation
|
|
529
|
+
// function, PredictionResistance=False, EntropyInputLen=256+128
|
|
530
|
+
// (entropy ‖ nonce, no-df: passed as one 384-bit seed),
|
|
531
|
+
// PersonalizationStringLen=0, AdditionalInputLen=0,
|
|
532
|
+
// ReturnedBitsLen=512. Distributed as part of NIST CAVP's
|
|
533
|
+
// drbgtestvectors archive
|
|
534
|
+
// (https://csrc.nist.gov/projects/cryptographic-algorithm-validation-program/random-number-generators)
|
|
535
|
+
// and mirrored in BoringSSL's
|
|
536
|
+
// `crypto/fipsmodule/rand/ctrdrbg_vectors.txt`.
|
|
537
|
+
//
|
|
538
|
+
// Test sequence (drbgvectors_pr_false, COUNT=0):
|
|
539
|
+
// 1. instantiate(EntropyInput, "")
|
|
540
|
+
// 2. reseed(EntropyInputReseed, "")
|
|
541
|
+
// 3. generate(512 bits, "") ← discarded
|
|
542
|
+
// 4. generate(512 bits, "") == ReturnedBits
|
|
543
|
+
|
|
544
|
+
const _KAT_ENTROPY_INPUT = _hexToBytes(
|
|
545
|
+
'e4bc23c5089a19d86f4119cb3fa08c0a' +
|
|
546
|
+
'4991e0a1def17e101e4c14d9c323460a' +
|
|
547
|
+
'7c2fb58e0b086c6c57b55f56cae25bad'
|
|
548
|
+
);
|
|
549
|
+
const _KAT_ENTROPY_RESEED = _hexToBytes(
|
|
550
|
+
'fd85a836bba85019881e8c6bad23c906' +
|
|
551
|
+
'1adc75477659acaea8e4a01dfe07a183' +
|
|
552
|
+
'2dad1c136f59d70f8653a5dc118663d6'
|
|
553
|
+
);
|
|
554
|
+
const _KAT_EXPECTED_HEX =
|
|
555
|
+
'b2cb8905c05e5950ca31895096be29ea' +
|
|
556
|
+
'3d5a3b82b269495554eb80fe07de43e1' +
|
|
557
|
+
'93b9e7c3ece73b80e062b1c1f68202fb' +
|
|
558
|
+
'b1c52a040ea2478864295282234aaada';
|
|
559
|
+
let _selfTestPassed = null;
|
|
560
|
+
|
|
561
|
+
function _hexToBytes(h) {
|
|
562
|
+
const out = new Uint8Array(h.length >>> 1);
|
|
563
|
+
for (let i = 0; i < out.length; i++) {
|
|
564
|
+
out[i] = parseInt(h.substring(i * 2, i * 2 + 2), 16);
|
|
565
|
+
}
|
|
566
|
+
return out;
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
function _hex(b) {
|
|
570
|
+
let s = '';
|
|
571
|
+
for (let i = 0; i < b.length; i++) {
|
|
572
|
+
const v = b[i];
|
|
573
|
+
s += (v < 16 ? '0' : '') + v.toString(16);
|
|
574
|
+
}
|
|
575
|
+
return s;
|
|
576
|
+
}
|
|
577
|
+
|
|
578
|
+
function _runSelfTest() {
|
|
579
|
+
const d = _makeDrbg();
|
|
580
|
+
// @ts-ignore - comparison with object is safe: _makeDrbg returns false on failure, object otherwise
|
|
581
|
+
if (!d || d === false) return false;
|
|
582
|
+
if (!d.instantiate(_KAT_ENTROPY_INPUT)) return false;
|
|
583
|
+
if (!d.reseed(_KAT_ENTROPY_RESEED)) return false;
|
|
584
|
+
if (d.generate(64) === false) return false;
|
|
585
|
+
const out = d.generate(64);
|
|
586
|
+
if (out === false) return false;
|
|
587
|
+
const got = _hex(out);
|
|
588
|
+
if (got !== _KAT_EXPECTED_HEX) {
|
|
589
|
+
console.error('[crypto] CORRUPT: random.selfTest: CTR_DRBG KAT mismatch (got ' + got + ')');
|
|
590
|
+
return false;
|
|
591
|
+
}
|
|
592
|
+
return true;
|
|
593
|
+
}
|
|
594
|
+
|
|
595
|
+
function _ensureSelfTest() {
|
|
596
|
+
if (_selfTestPassed === null) _selfTestPassed = _runSelfTest();
|
|
597
|
+
return _selfTestPassed;
|
|
598
|
+
}
|
|
599
|
+
|
|
600
|
+
// ── Public API ───────────────────────────────────────────────────
|
|
601
|
+
|
|
602
|
+
const api = {
|
|
603
|
+
|
|
604
|
+
/**
|
|
605
|
+
* Fill an existing typed array in-place with cryptographically
|
|
606
|
+
* secure random values and return it.
|
|
607
|
+
*
|
|
608
|
+
* Valid types: `Int8Array`, `Uint8Array`, `Uint8ClampedArray`,
|
|
609
|
+
* `Int16Array`, `Uint16Array`, `Int32Array`, `Uint32Array`,
|
|
610
|
+
* `BigInt64Array`, `BigUint64Array`. Passing a `Float32Array` or
|
|
611
|
+
* `Float64Array` throws a native `TypeMismatchError`.
|
|
612
|
+
*
|
|
613
|
+
* @template {TypedArray} T
|
|
614
|
+
* @param {T} array
|
|
615
|
+
* @returns {T}
|
|
616
|
+
*/
|
|
617
|
+
fill(array) {
|
|
618
|
+
// todo should throws a native `TypeMismatchError` with crypto.getRandomValues(array).
|
|
619
|
+
// ensure same comportement with _getRandomBytes
|
|
620
|
+
return _getRandomBytes(array);
|
|
621
|
+
},
|
|
622
|
+
|
|
623
|
+
/**
|
|
624
|
+
* Return a cryptographically secure random float in `[0, 1)`.
|
|
625
|
+
* Derived from one 32-bit random integer divided by 2³².
|
|
626
|
+
*
|
|
627
|
+
* @returns {number|false}
|
|
628
|
+
*/
|
|
629
|
+
float() {
|
|
630
|
+
// Route through _getRandomBytes so the dead-source health
|
|
631
|
+
// latch covers float() like the rest of the public API.
|
|
632
|
+
const bytes = _getRandomBytes(new Uint8Array(4));
|
|
633
|
+
if (bytes === false) return false;
|
|
634
|
+
const v = ((bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3]) >>> 0;
|
|
635
|
+
return v / 0x1_0000_0000;
|
|
636
|
+
},
|
|
637
|
+
|
|
638
|
+
/**
|
|
639
|
+
* Return a cryptographically secure random integer in the inclusive
|
|
640
|
+
* range `[min, max]`.
|
|
641
|
+
*
|
|
642
|
+
* Uses rejection sampling to eliminate modulo bias. For ranges much
|
|
643
|
+
* smaller than 2³² the expected iteration count is below 2.
|
|
644
|
+
*
|
|
645
|
+
* @param {number} min - Lower bound (inclusive).
|
|
646
|
+
* @param {number} max - Upper bound (inclusive).
|
|
647
|
+
* @returns {number|false}
|
|
648
|
+
* @throws {RangeError} When `min > max`.
|
|
649
|
+
*/
|
|
650
|
+
int(min, max) {
|
|
651
|
+
if (min > max) throw new RangeError('min must be ≤ max');
|
|
652
|
+
const range = max - min + 1;
|
|
653
|
+
const maxUnbiased = Math.floor(0x1_0000_0000 / range) * range;
|
|
654
|
+
const buf = new Uint8Array(4);
|
|
655
|
+
let value;
|
|
656
|
+
do {
|
|
657
|
+
if (_getRandomBytes(buf) === false) return false;
|
|
658
|
+
value = ((buf[0] << 24) | (buf[1] << 16) | (buf[2] << 8) | buf[3]) >>> 0;
|
|
659
|
+
} while (value >= maxUnbiased);
|
|
660
|
+
return min + (value % range);
|
|
661
|
+
},
|
|
662
|
+
|
|
663
|
+
/** Generate `n` cryptographically random bytes (direct OS RBG). */
|
|
664
|
+
bytes(n) {
|
|
665
|
+
if (!Number.isInteger(n) || n < 0) {
|
|
666
|
+
console.warn('[crypto] INVALID: random.bytes expects a non-negative integer');
|
|
667
|
+
return false;
|
|
668
|
+
}
|
|
669
|
+
return _getRandomBytes(new Uint8Array(n));
|
|
670
|
+
},
|
|
671
|
+
|
|
672
|
+
/** Generate `n` cryptographically random 32-bit words (direct OS RBG). */
|
|
673
|
+
words(n) {
|
|
674
|
+
if (!Number.isInteger(n) || n < 0) {
|
|
675
|
+
console.warn('[crypto] INVALID: random.words expects a non-negative integer');
|
|
676
|
+
return false;
|
|
677
|
+
}
|
|
678
|
+
const bytes = _getRandomBytes(new Uint8Array(n * 4));
|
|
679
|
+
if (bytes === false) return false;
|
|
680
|
+
const out = new Array(n);
|
|
681
|
+
for (let i = 0; i < n; i++) {
|
|
682
|
+
const j = i * 4;
|
|
683
|
+
out[i] = ((bytes[j] << 24) | (bytes[j + 1] << 16) | (bytes[j + 2] << 8) | bytes[j + 3]) | 0;
|
|
684
|
+
}
|
|
685
|
+
return out;
|
|
686
|
+
},
|
|
687
|
+
|
|
688
|
+
/** Generate a random bit array of `n` bits (direct OS RBG). */
|
|
689
|
+
bits(n) {
|
|
690
|
+
if (!Number.isInteger(n) || n < 0) {
|
|
691
|
+
console.warn('[crypto] INVALID: random.bits expects a non-negative integer');
|
|
692
|
+
return false;
|
|
693
|
+
}
|
|
694
|
+
const wordCount = Math.ceil(n / 32);
|
|
695
|
+
const words = api.words(wordCount);
|
|
696
|
+
if (words === false) return false;
|
|
697
|
+
return bitArray.clamp(words, n);
|
|
698
|
+
},
|
|
699
|
+
|
|
700
|
+
/** `true` when `crypto.getRandomValues` is available. */
|
|
701
|
+
isReady() { return _hasCrypto; },
|
|
702
|
+
|
|
703
|
+
/** Run / re-run the CTR_DRBG power-on self-test. */
|
|
704
|
+
selfTest() { _selfTestPassed = _runSelfTest(); return _selfTestPassed; },
|
|
705
|
+
|
|
706
|
+
/**
|
|
707
|
+
* Test-only escape hatch exposing the internal CTR_DRBG factory
|
|
708
|
+
* with caller-controlled seed material. **Not for production
|
|
709
|
+
* use** - the public `drbg()` API auto-pulls OS entropy and is
|
|
710
|
+
* the only path with full FIPS 140-3 lifecycle (POST, RCT/APT
|
|
711
|
+
* health tests, OS NRBG seeding). This surface exists exclusively
|
|
712
|
+
* to replay NIST CAVP / ACVP DRBG vectors with deterministic
|
|
713
|
+
* entropy inputs, so the algorithm itself can be byte-exact
|
|
714
|
+
* validated against the reference vectors.
|
|
715
|
+
*/
|
|
716
|
+
_internal: { makeDrbg: _makeDrbg },
|
|
717
|
+
|
|
718
|
+
/**
|
|
719
|
+
* SP 800-90B continuous health-test surface - primarily for
|
|
720
|
+
* test harnesses and operational diagnostics.
|
|
721
|
+
*
|
|
722
|
+
* NOTE: the RCT/APT state and `_entropyDead` latch are
|
|
723
|
+
* **module-singleton** - they are shared across every
|
|
724
|
+
* `bytes()`/`words()`/`bits()`/`float()`/`int()`/`drbg()` call,
|
|
725
|
+
* and across multiple DRBG instances built from this factory.
|
|
726
|
+
* The underlying entropy source (`crypto.getRandomValues`) is
|
|
727
|
+
* itself process-global, so a single shared health latch
|
|
728
|
+
* matches reality. Tests that need a fresh state must call
|
|
729
|
+
* `reset()` between scenarios.
|
|
730
|
+
*
|
|
731
|
+
* `feed(buf)` : push bytes through RCT + APT (returns false on fail).
|
|
732
|
+
* `reset()` : clear state and clear the latched-dead flag.
|
|
733
|
+
* `isDead` : true once any continuous test has failed.
|
|
734
|
+
*/
|
|
735
|
+
health: {
|
|
736
|
+
feed(buf) { return _healthCheck(buf instanceof Uint8Array ? buf : new Uint8Array(buf)); },
|
|
737
|
+
reset() { _resetHealth(); },
|
|
738
|
+
get isDead() { return _entropyDead; }
|
|
739
|
+
},
|
|
740
|
+
|
|
741
|
+
/**
|
|
742
|
+
* Build a fresh CTR_DRBG-AES-256 (no-df) instance.
|
|
743
|
+
*
|
|
744
|
+
* @param {object} [options]
|
|
745
|
+
* @param {Uint8Array} [options.personalisation] Up to 48 bytes of personalisation
|
|
746
|
+
* string mixed into the seed (XORed,
|
|
747
|
+
* truncated as per SP 800-90A §10.2.1.3.1
|
|
748
|
+
* when no df is used).
|
|
749
|
+
* @returns {object|false} DRBG instance or `false` on POST/seed failure.
|
|
750
|
+
*
|
|
751
|
+
* The returned object exposes:
|
|
752
|
+
* - `generate(n, additionalInput?)` → `Uint8Array | false`
|
|
753
|
+
* - `reseed(additionalInput?)` → `boolean` (pulls fresh entropy from OS RBG)
|
|
754
|
+
* - `addAdditionalInput(bytes)` → mix arbitrary bytes into the next `generate()`
|
|
755
|
+
* - `uninstantiate()` → wipe internal state
|
|
756
|
+
* - `isLive`, `reseedCounter`, `securityStrength`
|
|
757
|
+
*/
|
|
758
|
+
drbg(options = {}) {
|
|
759
|
+
if (!_ensureSelfTest()) {
|
|
760
|
+
console.error('[crypto] CORRUPT: random.drbg refused - POST failed');
|
|
761
|
+
return false;
|
|
762
|
+
}
|
|
763
|
+
const inst = _makeDrbg(options);
|
|
764
|
+
if (inst === false) return false;
|
|
765
|
+
const seed = _getEntropy(inst.seedBytes);
|
|
766
|
+
if (seed === false) return false;
|
|
767
|
+
if (!inst.instantiate(seed, options.personalisation)) return false;
|
|
768
|
+
|
|
769
|
+
// Buffer of pending additional_input (e.g. from entropyCollector).
|
|
770
|
+
let pending = null;
|
|
771
|
+
|
|
772
|
+
return {
|
|
773
|
+
generate(n, additionalInput) {
|
|
774
|
+
let ai = additionalInput || null;
|
|
775
|
+
if (pending !== null) {
|
|
776
|
+
ai = ai === null ? pending
|
|
777
|
+
: (() => { const m = new Uint8Array(pending.length + ai.length);
|
|
778
|
+
m.set(pending); m.set(ai, pending.length); return m; })();
|
|
779
|
+
pending = null;
|
|
780
|
+
}
|
|
781
|
+
return inst.generate(n, ai);
|
|
782
|
+
},
|
|
783
|
+
reseed(additionalInput) {
|
|
784
|
+
const fresh = _getEntropy(inst.seedBytes);
|
|
785
|
+
if (fresh === false) return false;
|
|
786
|
+
let ai = additionalInput || null;
|
|
787
|
+
if (pending !== null) {
|
|
788
|
+
ai = ai === null ? pending
|
|
789
|
+
: (() => { const m = new Uint8Array(pending.length + ai.length);
|
|
790
|
+
m.set(pending); m.set(ai, pending.length); return m; })();
|
|
791
|
+
pending = null;
|
|
792
|
+
}
|
|
793
|
+
return inst.reseed(fresh, ai);
|
|
794
|
+
},
|
|
795
|
+
/**
|
|
796
|
+
* Accumulate caller-supplied entropy (e.g. mouse/keyboard timings
|
|
797
|
+
* from `entropyCollector`) into a pending buffer that is consumed
|
|
798
|
+
* on the next `generate()` or `reseed()` as `additional_input`.
|
|
799
|
+
* Inputs longer than `seedlen` (48 bytes) are folded through
|
|
800
|
+
* SHA-256 to bound the buffer.
|
|
801
|
+
*/
|
|
802
|
+
addAdditionalInput(bytes) {
|
|
803
|
+
if (!(bytes instanceof Uint8Array)) {
|
|
804
|
+
if (Array.isArray(bytes) || bytes instanceof Uint32Array) {
|
|
805
|
+
const tmp = new Uint8Array(bytes.length * 4);
|
|
806
|
+
for (let i = 0; i < bytes.length; i++) {
|
|
807
|
+
const v = bytes[i] | 0;
|
|
808
|
+
tmp[i * 4] = (v >>> 24) & 0xff;
|
|
809
|
+
tmp[i * 4 + 1] = (v >>> 16) & 0xff;
|
|
810
|
+
tmp[i * 4 + 2] = (v >>> 8) & 0xff;
|
|
811
|
+
tmp[i * 4 + 3] = v & 0xff;
|
|
812
|
+
}
|
|
813
|
+
bytes = tmp;
|
|
814
|
+
} else if (typeof bytes === 'number') {
|
|
815
|
+
const v = bytes | 0;
|
|
816
|
+
bytes = new Uint8Array([(v >>> 24) & 0xff, (v >>> 16) & 0xff, (v >>> 8) & 0xff, v & 0xff]);
|
|
817
|
+
} else {
|
|
818
|
+
console.warn('[crypto] BUG: drbg.addAdditionalInput: unsupported data type');
|
|
819
|
+
return false;
|
|
820
|
+
}
|
|
821
|
+
}
|
|
822
|
+
const merged = pending === null ? bytes
|
|
823
|
+
: (() => { const m = new Uint8Array(pending.length + bytes.length);
|
|
824
|
+
m.set(pending); m.set(bytes, pending.length); return m; })();
|
|
825
|
+
if (merged.length <= inst.seedBytes) {
|
|
826
|
+
pending = merged;
|
|
827
|
+
} else {
|
|
828
|
+
// Fold to 32 bytes via SHA-256 to bound the buffer.
|
|
829
|
+
const h = sha256.hash(_bytesToWords(merged.subarray(0, merged.length & ~3)));
|
|
830
|
+
const folded = new Uint8Array(32);
|
|
831
|
+
_wordsToBytes(h, 8, folded, 0);
|
|
832
|
+
pending = folded;
|
|
833
|
+
}
|
|
834
|
+
return true;
|
|
835
|
+
},
|
|
836
|
+
uninstantiate() { pending = null; inst.uninstantiate(); },
|
|
837
|
+
get isLive() { return inst.isLive; },
|
|
838
|
+
get reseedCounter() { return inst.reseedCounter; },
|
|
839
|
+
get securityStrength() { return inst.securityStrength; }
|
|
840
|
+
};
|
|
841
|
+
}
|
|
842
|
+
};
|
|
843
|
+
|
|
844
|
+
return api;
|
|
845
|
+
}
|
|
846
|
+
};
|