@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,409 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @description
|
|
7
|
+
* TOTP (RFC 6238) and HOTP (RFC 4226) - time-based one-time-password code
|
|
8
|
+
* generation. Includes enrollment helpers (secret generation, `otpauth://`
|
|
9
|
+
* URI) and verification with a constant-time tolerance window.
|
|
10
|
+
*
|
|
11
|
+
* Algorithm: HOTP(secret, T) where T = floor((now - T0) / period), T encoded
|
|
12
|
+
* as 8 big-endian bytes, HMAC-SHA-1/256/512 depending on the chosen
|
|
13
|
+
* algorithm, then dynamic truncation (RFC 4226 §5.3) and modulo 10^digits.
|
|
14
|
+
*
|
|
15
|
+
* **Recommendation**: prefer `algorithm: 'SHA-256'` for new installations.
|
|
16
|
+
* SHA-1 is kept as the default for RFC 6238 compatibility and interop with
|
|
17
|
+
* existing authenticators (Google Authenticator, Authy, etc.). The SHA-1
|
|
18
|
+
* default is deliberate; callers that need stronger defaults must pass
|
|
19
|
+
* `algorithm: 'SHA-256'` explicitly on both `enroll` and `generate`/`verify`.
|
|
20
|
+
*
|
|
21
|
+
* Out of scope: QR-code rendering (handled on the app side), NTP
|
|
22
|
+
* synchronisation, recursive multi-hash TOTP.
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* const totp = runtime.resolve('totp');
|
|
26
|
+
* const { secret, uri } = totp.enroll({ issuer: 'MyApp', account: 'user@example.com' });
|
|
27
|
+
* const code = totp.generate(secret);
|
|
28
|
+
* const result = totp.verify(code, secret); // { valid: true, delta: 0 }
|
|
29
|
+
*/
|
|
30
|
+
import { hmac } from '../hash/hmac.js';
|
|
31
|
+
import { random } from './random.js';
|
|
32
|
+
import { base32 } from '../../io/codec/base32.js';
|
|
33
|
+
import { bitArray } from './bitArray.js';
|
|
34
|
+
import { sha256 } from '../hash/sha256.js';
|
|
35
|
+
import { sha512 } from '../hash/sha512.js';
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* TOTP/HOTP helper surface returned by `factory()`.
|
|
39
|
+
* @typedef {object} TotpAPI
|
|
40
|
+
* @property {(secret: Uint8Array|string, opts?: { algorithm?: 'SHA-1'|'SHA-256'|'SHA-512', digits?: 6|7|8, period?: number, t?: number }) => string} generate - Generate a zero-padded TOTP code for the given secret and time.
|
|
41
|
+
* @property {(code: string, secret: Uint8Array|string, opts?: { algorithm?: 'SHA-1'|'SHA-256'|'SHA-512', digits?: 6|7|8, period?: number, t?: number, window?: number }) => { valid: boolean, delta?: number }} verify - Verify a TOTP code against a constant-time tolerance window.
|
|
42
|
+
* @property {(opts: { issuer: string, account: string, algorithm?: 'SHA-1'|'SHA-256'|'SHA-512', digits?: 6|7|8, period?: number, secretLen?: number }) => { secret: string, secretBytes: Uint8Array, uri: string }} enroll - Generate a random secret and an otpauth:// URI for enrollment.
|
|
43
|
+
* @property {(opts: { issuer: string, account: string, secret: string, algorithm?: 'SHA-1'|'SHA-256'|'SHA-512', digits?: 6|7|8, period?: number }) => string} uri - Build an otpauth://totp/ URI matching the Google Authenticator spec.
|
|
44
|
+
*/
|
|
45
|
+
|
|
46
|
+
export const totp = {
|
|
47
|
+
name: 'totp',
|
|
48
|
+
version: '1.0.0',
|
|
49
|
+
type: 'fw.crypto.utils',
|
|
50
|
+
dependencies: ['hmac', 'random', 'base32', 'bitArray', 'sha256', 'sha512'],
|
|
51
|
+
deps: [hmac, random, base32, bitArray, sha256, sha512],
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* @param {Object} hmac HMAC module (RFC 2104) - used for SHA-256 and SHA-512.
|
|
55
|
+
* @param {Object} random CSPRNG module.
|
|
56
|
+
* @param {Object} base32 Base32 module (RFC 4648).
|
|
57
|
+
* @param {Object} bitArray bitArray module (Uint8Array ↔ bitArray conversion).
|
|
58
|
+
* @param {Object} sha256 SHA-256 module (used via hmac for 'SHA-256').
|
|
59
|
+
* @param {Object} sha512 SHA-512 module (used via hmac for 'SHA-512').
|
|
60
|
+
* @returns {TotpAPI}
|
|
61
|
+
*/
|
|
62
|
+
factory(hmac, random, base32, bitArray, sha256, sha512) {
|
|
63
|
+
|
|
64
|
+
// ── Inline SHA-1 (RFC 3174 / FIPS 180-4) ────────────────────────────────
|
|
65
|
+
// Kept inline because sha1 does not exist as a separate fw module.
|
|
66
|
+
// SHA-256 and SHA-512 use the fw hmac module via a bitArray bridge.
|
|
67
|
+
|
|
68
|
+
function _sha1(data) {
|
|
69
|
+
const len = data.length;
|
|
70
|
+
const bitLen = len * 8;
|
|
71
|
+
const padLen = ((55 - len) % 64 + 64) % 64 + 1;
|
|
72
|
+
const total = len + padLen + 8;
|
|
73
|
+
const msg = new Uint8Array(total);
|
|
74
|
+
msg.set(data);
|
|
75
|
+
msg[len] = 0x80;
|
|
76
|
+
msg[total - 4] = (bitLen >>> 24) & 0xff;
|
|
77
|
+
msg[total - 3] = (bitLen >>> 16) & 0xff;
|
|
78
|
+
msg[total - 2] = (bitLen >>> 8) & 0xff;
|
|
79
|
+
msg[total - 1] = bitLen & 0xff;
|
|
80
|
+
|
|
81
|
+
let h0 = 0x67452301, h1 = 0xefcdab89, h2 = 0x98badcfe,
|
|
82
|
+
h3 = 0x10325476, h4 = 0xc3d2e1f0;
|
|
83
|
+
|
|
84
|
+
const w = new Int32Array(80);
|
|
85
|
+
|
|
86
|
+
for (let i = 0; i < total; i += 64) {
|
|
87
|
+
for (let j = 0; j < 16; j++) {
|
|
88
|
+
const off = i + j * 4;
|
|
89
|
+
w[j] = ((msg[off] << 24) | (msg[off + 1] << 16) |
|
|
90
|
+
(msg[off + 2] << 8) | msg[off + 3]) | 0;
|
|
91
|
+
}
|
|
92
|
+
for (let j = 16; j < 80; j++) {
|
|
93
|
+
const x = w[j - 3] ^ w[j - 8] ^ w[j - 14] ^ w[j - 16];
|
|
94
|
+
w[j] = (x << 1) | (x >>> 31);
|
|
95
|
+
}
|
|
96
|
+
let a = h0, b = h1, c = h2, d = h3, e = h4;
|
|
97
|
+
for (let j = 0; j < 80; j++) {
|
|
98
|
+
let f, k;
|
|
99
|
+
if (j < 20) {
|
|
100
|
+
f = (b & c) | (~b & d);
|
|
101
|
+
k = 0x5a827999;
|
|
102
|
+
} else if (j < 40) {
|
|
103
|
+
f = b ^ c ^ d;
|
|
104
|
+
k = 0x6ed9eba1;
|
|
105
|
+
} else if (j < 60) {
|
|
106
|
+
f = (b & c) | (b & d) | (c & d);
|
|
107
|
+
k = 0x8f1bbcdc;
|
|
108
|
+
} else {
|
|
109
|
+
f = b ^ c ^ d;
|
|
110
|
+
k = 0xca62c1d6;
|
|
111
|
+
}
|
|
112
|
+
const temp = (((a << 5) | (a >>> 27)) + f + e + k + w[j]) | 0;
|
|
113
|
+
e = d; d = c;
|
|
114
|
+
c = (b << 30) | (b >>> 2);
|
|
115
|
+
b = a; a = temp;
|
|
116
|
+
}
|
|
117
|
+
h0 = (h0 + a) | 0;
|
|
118
|
+
h1 = (h1 + b) | 0;
|
|
119
|
+
h2 = (h2 + c) | 0;
|
|
120
|
+
h3 = (h3 + d) | 0;
|
|
121
|
+
h4 = (h4 + e) | 0;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
const digest = new Uint8Array(20);
|
|
125
|
+
const dv = new DataView(digest.buffer);
|
|
126
|
+
dv.setInt32(0, h0, false);
|
|
127
|
+
dv.setInt32(4, h1, false);
|
|
128
|
+
dv.setInt32(8, h2, false);
|
|
129
|
+
dv.setInt32(12, h3, false);
|
|
130
|
+
dv.setInt32(16, h4, false);
|
|
131
|
+
return digest;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// ── HMAC via the fw module (SHA-256 and SHA-512) ─────────────────────────
|
|
135
|
+
// The fw hmac module operates on bitArray (SJCL format).
|
|
136
|
+
// Bridge: Uint8Array → bitArray (via bitArray.ui8_to_ba) and
|
|
137
|
+
// bitArray → Uint8Array (via bitArray.ba_to_ui8).
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Compute HMAC using the fw hmac module.
|
|
141
|
+
* @param {object} HashModule - sha256 or sha512 (resolved fw module).
|
|
142
|
+
* @param {Uint8Array} keyBytes
|
|
143
|
+
* @param {Uint8Array} dataBytes
|
|
144
|
+
* @returns {Uint8Array}
|
|
145
|
+
*/
|
|
146
|
+
function _hmacFw(HashModule, keyBytes, dataBytes) {
|
|
147
|
+
const keyBa = bitArray.ui8_to_ba(keyBytes);
|
|
148
|
+
const dataBa = bitArray.ui8_to_ba(dataBytes);
|
|
149
|
+
const macBa = new hmac.fn(keyBa, HashModule).encrypt(dataBa);
|
|
150
|
+
return bitArray.ba_to_ui8(macBa);
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* Inline HMAC-SHA-1 (RFC 2104 + RFC 3174).
|
|
155
|
+
* Kept inline because sha1 does not exist as a separate fw module.
|
|
156
|
+
* @param {Uint8Array} keyBytes
|
|
157
|
+
* @param {Uint8Array} dataBytes
|
|
158
|
+
* @returns {Uint8Array}
|
|
159
|
+
*/
|
|
160
|
+
function _hmacSha1(keyBytes, dataBytes) {
|
|
161
|
+
const blockSize = 64;
|
|
162
|
+
const k = keyBytes.length > blockSize ? _sha1(keyBytes) : keyBytes;
|
|
163
|
+
const keyPad = new Uint8Array(blockSize);
|
|
164
|
+
keyPad.set(k);
|
|
165
|
+
|
|
166
|
+
const ipad = new Uint8Array(blockSize);
|
|
167
|
+
const opad = new Uint8Array(blockSize);
|
|
168
|
+
for (let i = 0; i < blockSize; i++) {
|
|
169
|
+
ipad[i] = keyPad[i] ^ 0x36;
|
|
170
|
+
opad[i] = keyPad[i] ^ 0x5c;
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
const inner = new Uint8Array(blockSize + dataBytes.length);
|
|
174
|
+
inner.set(ipad);
|
|
175
|
+
inner.set(dataBytes, blockSize);
|
|
176
|
+
const innerHash = _sha1(inner);
|
|
177
|
+
|
|
178
|
+
const outer = new Uint8Array(blockSize + innerHash.length);
|
|
179
|
+
outer.set(opad);
|
|
180
|
+
outer.set(innerHash, blockSize);
|
|
181
|
+
return _sha1(outer);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* Dispatch HMAC according to the algorithm.
|
|
186
|
+
* @param {string} algorithm - 'SHA-1'|'SHA-256'|'SHA-512'
|
|
187
|
+
* @param {Uint8Array} keyBytes
|
|
188
|
+
* @param {Uint8Array} dataBytes
|
|
189
|
+
* @returns {Uint8Array}
|
|
190
|
+
*/
|
|
191
|
+
function _hmacCompute(algorithm, keyBytes, dataBytes) {
|
|
192
|
+
if (algorithm === 'SHA-1') return _hmacSha1(keyBytes, dataBytes);
|
|
193
|
+
if (algorithm === 'SHA-256') return _hmacFw(sha256, keyBytes, dataBytes);
|
|
194
|
+
if (algorithm === 'SHA-512') return _hmacFw(sha512, keyBytes, dataBytes);
|
|
195
|
+
throw new Error('totp: unsupported algorithm: ' + algorithm);
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
// ── Internal helpers ─────────────────────────────────────────────────────
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Encode counter T as 8 big-endian bytes (RFC 6238).
|
|
202
|
+
* @param {number} t
|
|
203
|
+
* @returns {Uint8Array}
|
|
204
|
+
*/
|
|
205
|
+
function _counterToBytes(t) {
|
|
206
|
+
const buf = new Uint8Array(8);
|
|
207
|
+
const hi = Math.floor(t / 0x100000000);
|
|
208
|
+
const lo = t >>> 0;
|
|
209
|
+
buf[0] = (hi >>> 24) & 0xff;
|
|
210
|
+
buf[1] = (hi >>> 16) & 0xff;
|
|
211
|
+
buf[2] = (hi >>> 8) & 0xff;
|
|
212
|
+
buf[3] = hi & 0xff;
|
|
213
|
+
buf[4] = (lo >>> 24) & 0xff;
|
|
214
|
+
buf[5] = (lo >>> 16) & 0xff;
|
|
215
|
+
buf[6] = (lo >>> 8) & 0xff;
|
|
216
|
+
buf[7] = lo & 0xff;
|
|
217
|
+
return buf;
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/**
|
|
221
|
+
* Decode a secret given as Uint8Array or base32 string.
|
|
222
|
+
* @param {Uint8Array|string} secret
|
|
223
|
+
* @returns {Uint8Array}
|
|
224
|
+
*/
|
|
225
|
+
function _decodeSecret(secret) {
|
|
226
|
+
if (secret instanceof Uint8Array) return secret;
|
|
227
|
+
if (typeof secret === 'string') return base32.toBytes(secret);
|
|
228
|
+
throw new TypeError('totp: secret must be Uint8Array or base32 string');
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// ── HOTP (RFC 4226 §5) ───────────────────────────────────────────────────
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Compute HOTP(secret, counter).
|
|
235
|
+
* @param {Uint8Array} secretBytes
|
|
236
|
+
* @param {number} counter
|
|
237
|
+
* @param {string} algorithm
|
|
238
|
+
* @param {number} digits
|
|
239
|
+
* @returns {string}
|
|
240
|
+
*/
|
|
241
|
+
function _hotp(secretBytes, counter, algorithm, digits) {
|
|
242
|
+
const msgBytes = _counterToBytes(counter);
|
|
243
|
+
const macBytes = _hmacCompute(algorithm, secretBytes, msgBytes);
|
|
244
|
+
|
|
245
|
+
// Dynamic truncation (RFC 4226 §5.3)
|
|
246
|
+
const offset = macBytes[macBytes.length - 1] & 0x0f;
|
|
247
|
+
const binCode = (
|
|
248
|
+
((macBytes[offset] & 0x7f) * 0x1000000) +
|
|
249
|
+
((macBytes[offset + 1] & 0xff) * 0x10000) +
|
|
250
|
+
((macBytes[offset + 2] & 0xff) * 0x100) +
|
|
251
|
+
(macBytes[offset + 3] & 0xff)
|
|
252
|
+
);
|
|
253
|
+
|
|
254
|
+
const otp = binCode % Math.pow(10, digits);
|
|
255
|
+
return String(otp).padStart(digits, '0');
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
// ── Constant-time comparison ─────────────────────────────────────────────
|
|
259
|
+
|
|
260
|
+
/**
|
|
261
|
+
* Constant-time string comparison (no short-circuit).
|
|
262
|
+
* @param {string} a
|
|
263
|
+
* @param {string} b
|
|
264
|
+
* @returns {boolean}
|
|
265
|
+
*/
|
|
266
|
+
function _ctEqual(a, b) {
|
|
267
|
+
if (a.length !== b.length) return false;
|
|
268
|
+
let diff = 0;
|
|
269
|
+
for (let i = 0; i < a.length; i++) {
|
|
270
|
+
diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
|
|
271
|
+
}
|
|
272
|
+
return diff === 0;
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
// ── Public API ───────────────────────────────────────────────────────────
|
|
276
|
+
|
|
277
|
+
/**
|
|
278
|
+
* Generate a TOTP code for the given secret and time.
|
|
279
|
+
*
|
|
280
|
+
* @param {Uint8Array|string} secret - Secret key (Uint8Array or base32).
|
|
281
|
+
* @param {object} [opts]
|
|
282
|
+
* @param {'SHA-1'|'SHA-256'|'SHA-512'} [opts.algorithm='SHA-1'] - HMAC algorithm.
|
|
283
|
+
* @param {6|7|8} [opts.digits=6] - Number of digits.
|
|
284
|
+
* @param {number} [opts.period=30] - Period in seconds.
|
|
285
|
+
* @param {number} [opts.t] - Epoch in seconds (default: now).
|
|
286
|
+
* @returns {string} Zero-padded OTP code.
|
|
287
|
+
*/
|
|
288
|
+
function generate(secret, opts) {
|
|
289
|
+
const o = opts || {};
|
|
290
|
+
const algorithm = o.algorithm || 'SHA-1';
|
|
291
|
+
const digits = o.digits || 6;
|
|
292
|
+
const period = o.period || 30;
|
|
293
|
+
const now = (o.t !== undefined) ? o.t : Math.floor(Date.now() / 1000);
|
|
294
|
+
|
|
295
|
+
const secretBytes = _decodeSecret(secret);
|
|
296
|
+
const T = Math.floor(now / period);
|
|
297
|
+
return _hotp(secretBytes, T, algorithm, digits);
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
/**
|
|
301
|
+
* Verify a TOTP code against a tolerance window.
|
|
302
|
+
*
|
|
303
|
+
* The comparison is constant-time: every step in the window is
|
|
304
|
+
* always evaluated, with no short-circuit on the first match.
|
|
305
|
+
* Both `_ctEqual` and the window walk avoid early-return paths
|
|
306
|
+
* that would leak the matching delta via timing.
|
|
307
|
+
*
|
|
308
|
+
* @param {string} code - OTP code to verify.
|
|
309
|
+
* @param {Uint8Array|string} secret - Secret key.
|
|
310
|
+
* @param {object} [opts]
|
|
311
|
+
* @param {'SHA-1'|'SHA-256'|'SHA-512'} [opts.algorithm='SHA-1']
|
|
312
|
+
* @param {6|7|8} [opts.digits=6]
|
|
313
|
+
* @param {number} [opts.period=30]
|
|
314
|
+
* @param {number} [opts.t] - Epoch in seconds (default: now).
|
|
315
|
+
* @param {number} [opts.window=1] - Tolerance window (steps before/after).
|
|
316
|
+
* @returns {{ valid: boolean, delta?: number }}
|
|
317
|
+
*/
|
|
318
|
+
function verify(code, secret, opts) {
|
|
319
|
+
const o = opts || {};
|
|
320
|
+
const algorithm = o.algorithm || 'SHA-1';
|
|
321
|
+
const digits = o.digits || 6;
|
|
322
|
+
const period = o.period || 30;
|
|
323
|
+
const now = (o.t !== undefined) ? o.t : Math.floor(Date.now() / 1000);
|
|
324
|
+
const window = (o.window !== undefined) ? o.window : 1;
|
|
325
|
+
|
|
326
|
+
const secretBytes = _decodeSecret(secret);
|
|
327
|
+
const T = Math.floor(now / period);
|
|
328
|
+
|
|
329
|
+
let matchDelta = null;
|
|
330
|
+
|
|
331
|
+
// Full window walk with no short-circuit: every candidate is
|
|
332
|
+
// computed and compared even after a match is found, so the
|
|
333
|
+
// total work (and timing) is constant across success/failure.
|
|
334
|
+
for (let delta = -window; delta <= window; delta++) {
|
|
335
|
+
const candidate = _hotp(secretBytes, T + delta, algorithm, digits);
|
|
336
|
+
if (_ctEqual(candidate, code)) {
|
|
337
|
+
if (matchDelta === null) matchDelta = delta;
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
if (matchDelta !== null) {
|
|
342
|
+
return { valid: true, delta: matchDelta };
|
|
343
|
+
}
|
|
344
|
+
return { valid: false };
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
/**
|
|
348
|
+
* Generate a random secret and an otpauth:// URI for enrollment.
|
|
349
|
+
*
|
|
350
|
+
* @param {{issuer: string, account: string, algorithm?: 'SHA-1'|'SHA-256'|'SHA-512', digits?: 6|7|8, period?: number, secretLen?: number}} opts
|
|
351
|
+
* @returns {{ secret: string, secretBytes: Uint8Array, uri: string }}
|
|
352
|
+
*/
|
|
353
|
+
function enroll(opts) {
|
|
354
|
+
const algorithm = (opts && opts.algorithm) || 'SHA-1';
|
|
355
|
+
const digits = (opts && opts.digits) || 6;
|
|
356
|
+
const period = (opts && opts.period) || 30;
|
|
357
|
+
const secretLen = (opts && opts.secretLen) || 20;
|
|
358
|
+
|
|
359
|
+
const secretBytes = random.bytes(secretLen);
|
|
360
|
+
if (secretBytes === false) {
|
|
361
|
+
throw new Error('totp.enroll: failed to generate secret (random.bytes returned false)');
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
// Base32 without padding (authenticator compatibility).
|
|
365
|
+
const secretB32 = base32.fromBytes(secretBytes).replace(/=+$/, '');
|
|
366
|
+
|
|
367
|
+
const otpUri = uri({
|
|
368
|
+
issuer: opts.issuer,
|
|
369
|
+
account: opts.account,
|
|
370
|
+
secret: secretB32,
|
|
371
|
+
algorithm,
|
|
372
|
+
digits,
|
|
373
|
+
period
|
|
374
|
+
});
|
|
375
|
+
|
|
376
|
+
return { secret: secretB32, secretBytes, uri: otpUri };
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
/**
|
|
380
|
+
* Build an otpauth://totp/ URI matching the Google Authenticator spec.
|
|
381
|
+
*
|
|
382
|
+
* Format: `otpauth://totp/<issuer>:<account>?secret=...&issuer=...&algorithm=...&digits=...&period=...`
|
|
383
|
+
*
|
|
384
|
+
* @param {{issuer: string, account: string, secret: string, algorithm?: 'SHA-1'|'SHA-256'|'SHA-512', digits?: 6|7|8, period?: number}} opts
|
|
385
|
+
* @returns {string}
|
|
386
|
+
*/
|
|
387
|
+
function uri(opts) {
|
|
388
|
+
const issuer = (opts && opts.issuer) || '';
|
|
389
|
+
const account = (opts && opts.account) || '';
|
|
390
|
+
const secret = (opts && opts.secret) || '';
|
|
391
|
+
const algorithm = (opts && opts.algorithm) || 'SHA-1';
|
|
392
|
+
const digits = (opts && opts.digits) || 6;
|
|
393
|
+
const period = (opts && opts.period) || 30;
|
|
394
|
+
|
|
395
|
+
const label = encodeURIComponent(issuer) + ':' + encodeURIComponent(account);
|
|
396
|
+
const params = [
|
|
397
|
+
'secret=' + encodeURIComponent(secret),
|
|
398
|
+
'issuer=' + encodeURIComponent(issuer),
|
|
399
|
+
'algorithm=' + encodeURIComponent(algorithm),
|
|
400
|
+
'digits=' + digits,
|
|
401
|
+
'period=' + period
|
|
402
|
+
].join('&');
|
|
403
|
+
|
|
404
|
+
return 'otpauth://totp/' + label + '?' + params;
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
return { generate, verify, enroll, uri };
|
|
408
|
+
}
|
|
409
|
+
};
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# `uuid.js` — RFC 4122 / RFC 9562 conformance
|
|
2
|
+
|
|
3
|
+
## Standards
|
|
4
|
+
|
|
5
|
+
- **Primary**: **RFC 9562** — *Universally Unique IDentifiers (UUIDs)*
|
|
6
|
+
(May 2024) — supersedes RFC 4122. Identical binary format,
|
|
7
|
+
clarified terminology + new variants (v6/v7/v8, not implemented here).
|
|
8
|
+
- **Secondary**: **RFC 4122** — *A Universally Unique IDentifier (UUID)
|
|
9
|
+
URN Namespace* (July 2005) — still widely referenced, supported.
|
|
10
|
+
- **Canonical string format**: RFC 4122 §3 / RFC 9562 §4:
|
|
11
|
+
`xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx` (36 chars: 32 hex + 4 dashes,
|
|
12
|
+
where `M` = version nibble and `N` ∈ {8, 9, a, b} = variant nibble).
|
|
13
|
+
- **Vectors**: RFC 9562 §A (non-normative examples) + interop
|
|
14
|
+
cross-check with the `valid.js:uuid` regex validator.
|
|
15
|
+
- **Outside NIST**: no FIPS standard covers UUIDs. Security relies
|
|
16
|
+
exclusively on the quality of the randomness source (`crypto.getRandomValues`,
|
|
17
|
+
cf. `random.acvp.md` SP 800-90B).
|
|
18
|
+
|
|
19
|
+
## Implemented algorithm
|
|
20
|
+
|
|
21
|
+
`uuid.factory(hex)` exposes 2 generators:
|
|
22
|
+
|
|
23
|
+
- **`v1(raw=false, prng=false, format='compact')`** — UUID v1 (time-based,
|
|
24
|
+
RFC 4122 §4.2 / RFC 9562 §5.1). Combines a 60-bit timestamp (100-ns ticks
|
|
25
|
+
since 1582-10-15), a 14-bit clockseq (anti-rollback), a 48-bit
|
|
26
|
+
node (random MAC, multicast bit forced per RFC §4.5).
|
|
27
|
+
- **`v4(raw=false, prng=false, format='compact')`** — UUID v4 (random,
|
|
28
|
+
RFC 4122 §4.4 / RFC 9562 §5.4). 122 random bits + 4 version bits
|
|
29
|
+
(`0100` = v4) + 2 variant bits (`10` = RFC 4122).
|
|
30
|
+
|
|
31
|
+
### Output
|
|
32
|
+
|
|
33
|
+
| Param | Type | Description |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| `raw=true` | `Uint8Array(16)` | Raw binary, version + variant patched |
|
|
36
|
+
| `raw=false` + `format='compact'` (default) | `string` 32 hex | No dashes, **back-compat** with the historical API |
|
|
37
|
+
| `raw=false` + `format='rfc4122'` | `string` 36 chars | Canonical RFC 4122 §3 format (with dashes) |
|
|
38
|
+
|
|
39
|
+
### Randomness source
|
|
40
|
+
|
|
41
|
+
- Default: `crypto.getRandomValues` (Web Crypto API `RandomSource`,
|
|
42
|
+
SP 800-90B-grade in every validated JS runtime).
|
|
43
|
+
- Custom `prng` callback: **test-only / replay** use only. No-op PRNG
|
|
44
|
+
detection: if the signature returns `undefined/null` AND does not
|
|
45
|
+
modify the supplied buffer, automatic fallback to
|
|
46
|
+
`crypto.getRandomValues` (safe by default).
|
|
47
|
+
|
|
48
|
+
## Test coverage
|
|
49
|
+
|
|
50
|
+
### Integrated vectors / properties
|
|
51
|
+
|
|
52
|
+
| Source | Reference | Test (`describe` / `test`) | Property verified |
|
|
53
|
+
|---|---|---|---|
|
|
54
|
+
| RFC 4122 §3 | Canonical format with dashes | `format=rfc4122 returns canonical RFC 4122 §3 format` | strict regex + dashes at positions 8/13/18/23 + version nibble |
|
|
55
|
+
| RFC 4122 §4.1.3 | Version nibble v1 = `0001` | `should set UUID version to 1 and RFC 4122 variant` | `(raw[6] & 0xf0) >> 4 === 1` |
|
|
56
|
+
| RFC 4122 §4.1.3 | Version nibble v4 = `0100` | `should set UUID version to 4 and RFC 4122 variant` | `(raw[6] & 0xf0) >> 4 === 4` |
|
|
57
|
+
| RFC 4122 §4.1.1 | 2-bit variant = `10` | (same) | `(raw[8] & 0xc0) >> 6 === 2` |
|
|
58
|
+
| RFC 4122 §4.1.1 | Variant nibble ∈ {8, 9, a, b} | `format=rfc4122 v4 ... variant nibble` | `id[19] ∈ [89ab]` |
|
|
59
|
+
| RFC 9562 §A.4 (style) | Byte-exact vector, deterministic v4 prng | `format=rfc4122 byte-exact known vector` | canonical string = `91c274f2-9a0d-4ce6-9d5d-b2c3d4e5f607` |
|
|
60
|
+
| Cross-check `valid.js:uuid` | Validator interop | `format=rfc4122 v4/v1 matches valid.js uuid regex` | 50 consecutive random outputs match the strict regex |
|
|
61
|
+
| Cross-format | `compact` vs `rfc4122` byte-equivalent | `rfc4122 reformat is byte-equivalent to compact` | `rfc.replace(/-/g, '') === compact` (deterministic prng) |
|
|
62
|
+
|
|
63
|
+
### Security properties tested
|
|
64
|
+
|
|
65
|
+
- [x] **Correct binary format** — version + variant nibbles patched
|
|
66
|
+
per RFC 4122 §4.1.1 + §4.1.3.
|
|
67
|
+
- [x] **Canonical string format** — `format='rfc4122'` produces the
|
|
68
|
+
`xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx` representation validated by a
|
|
69
|
+
strict regex (33 cases tested: 50 v4 + 50 v1 + byte-exact vector).
|
|
70
|
+
- [x] **Back-compat** — `format='compact'` (default) returns 32 hex
|
|
71
|
+
chars without dashes, identical to the module's historical API.
|
|
72
|
+
- [x] **Safe default randomness source** — `crypto.getRandomValues`.
|
|
73
|
+
A custom PRNG can only be used via an explicit parameter; no-op
|
|
74
|
+
detection + automatic fallback to `crypto.getRandomValues`.
|
|
75
|
+
- [x] **Validator interop** — the `format='rfc4122'` output matches
|
|
76
|
+
the public `valid.js:194` regex (`uuid` format) byte-exact.
|
|
77
|
+
- [x] **Statistical uniqueness** — `should generate different values across
|
|
78
|
+
calls` (v1 + v4).
|
|
79
|
+
- [x] **v1 monotonicity** — clockseq incremented if dt < 0 or nsecs ≥ 10000
|
|
80
|
+
(RFC 4122 §4.2.1.2). No direct test, but the code follows the RFC 4122
|
|
81
|
+
algorithm.
|
|
82
|
+
|
|
83
|
+
### Security properties not covered
|
|
84
|
+
|
|
85
|
+
- [ ] **UUIDv6 / v7 / v8** (RFC 9562 §5.6-5.8) — not implemented. v7
|
|
86
|
+
in particular is recommended for modern use cases (sortable + random)
|
|
87
|
+
as an alternative to v1. **P3** — no breaking change required for
|
|
88
|
+
a future addition.
|
|
89
|
+
- [ ] **UUIDv3 / v5** (name-based MD5 / SHA-1, RFC 4122 §4.3) — not
|
|
90
|
+
implemented. SP 800-131A deprecates SHA-1 and MD-5; v5 remains useful
|
|
91
|
+
for deterministic namespaces but is outside the scope of this module,
|
|
92
|
+
which focuses on random/time-based generation.
|
|
93
|
+
- [ ] **Real MAC for v1** — RFC 4122 §4.5 authorizes using a random
|
|
94
|
+
MAC when no hardware MAC is accessible (the browser runtime case).
|
|
95
|
+
The current implementation uses `crypto.getRandomValues` with the
|
|
96
|
+
multicast bit forced per spec — **conforms to RFC 4122 §4.5**.
|
|
97
|
+
|
|
98
|
+
## RFC 4122 / RFC 9562 conformance
|
|
99
|
+
|
|
100
|
+
| Requirement | Status | Evidence |
|
|
101
|
+
|---|---|---|
|
|
102
|
+
| 16-byte binary format | ✅ | `Uint8Array.length === 16` tested for v1 and v4 |
|
|
103
|
+
| v1/v4 version nibble patched | ✅ | bit-mask test `(raw[6] & 0xf0) >> 4` |
|
|
104
|
+
| RFC 4122 variant nibble patched | ✅ | bit-mask test `(raw[8] & 0xc0) >> 6 === 2` |
|
|
105
|
+
| Canonical string format with dashes | ✅ | `format='rfc4122'` byte-exact + strict regex 50× |
|
|
106
|
+
| Cryptographic randomness source | ✅ | `crypto.getRandomValues` (default), auto fallback if prng is a no-op |
|
|
107
|
+
| No `throw` | ✅ | no code path uses `throw` |
|
|
108
|
+
| Validator interop | ✅ | `valid.js:194` regex matches all 100 tested outputs |
|
|
109
|
+
|
|
110
|
+
## Known limitations
|
|
111
|
+
|
|
112
|
+
- **v1 uses a random MAC**, not a hardware MAC (impossible in a
|
|
113
|
+
browser context). RFC 4122 §4.5 paragraph 2 explicitly authorizes
|
|
114
|
+
this degraded mode with the multicast bit forced.
|
|
115
|
+
- **v3/v5/v6/v7/v8 variants not implemented** — see the `[ ]` checks above.
|
|
116
|
+
- **No nil UUID support** (`00000000-0000-0000-0000-000000000000`,
|
|
117
|
+
RFC 4122 §4.1.7) nor max UUID (RFC 9562 §5.10). Trivially addable
|
|
118
|
+
as exported constants if needed.
|
|
119
|
+
- **Test-only PRNG buffer**: the `prng` parameter is documented as
|
|
120
|
+
test-only; no production usage should pass a `prng` other than
|
|
121
|
+
`false`. No-op PRNG detection + automatic fallback to
|
|
122
|
+
`crypto.getRandomValues` prevents accidentally degrading the
|
|
123
|
+
randomness source.
|
|
124
|
+
|
|
125
|
+
## Cross-references
|
|
126
|
+
|
|
127
|
+
- Module: [`crypto/utils/uuid.js`](./uuid.js)
|
|
128
|
+
- Tests: [`crypto/utils/uuid.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/utils/uuid.test.js) — **21 tests**
|
|
129
|
+
(including 6 new `format='rfc4122'` tests + cross-check against the
|
|
130
|
+
`valid.js:uuid` regex on 100 samples).
|
|
131
|
+
- Validator interop: [`io/utils/valid.js:194`](../../io/utils/valid.js)
|
|
132
|
+
(`uuid` format regex).
|
|
133
|
+
- Randomness source: [`crypto/utils/random.js`](./random.js) — `crypto.getRandomValues`
|
|
134
|
+
used directly (no userspace DRBG for this module).
|
|
135
|
+
- Global conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
|
|
136
|
+
- RFC 9562: [`https://datatracker.ietf.org/doc/html/rfc9562`](https://datatracker.ietf.org/doc/html/rfc9562)
|
|
137
|
+
- RFC 4122: [`https://datatracker.ietf.org/doc/html/rfc4122`](https://datatracker.ietf.org/doc/html/rfc4122)
|