@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,381 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @description
|
|
7
|
+
* High-level wrapper over `RTCPeerConnection` + `RTCDataChannel`.
|
|
8
|
+
*
|
|
9
|
+
* Signaling-agnostic: SDP/ICE exchange is the caller's responsibility, but
|
|
10
|
+
* the wrapper hides the most common WebRTC foot-guns:
|
|
11
|
+
*
|
|
12
|
+
* - **ICE queue**: `addIceCandidate()` calls received before
|
|
13
|
+
* `setRemoteDescription` resolves are buffered and flushed in order
|
|
14
|
+
* immediately after the remote description is applied.
|
|
15
|
+
* - **DataChannel send queue**: `dc.send(data)` calls issued before the
|
|
16
|
+
* channel is `open` are buffered (up to `sendQueueMax`) and flushed on
|
|
17
|
+
* `open`. Overflow is reported via the channel's `onerror`.
|
|
18
|
+
* - **Listener cleanup**: closing a peer or a data channel removes every
|
|
19
|
+
* bridged listener so the listener Sets cannot retain references to
|
|
20
|
+
* user closures.
|
|
21
|
+
* - **Structured errors**: all rejected promises and overflow errors are
|
|
22
|
+
* wrapped as `WebRTCError` (`{kind, cause}`) for ergonomic handling at
|
|
23
|
+
* call sites, mirroring `ajax.HttpError`.
|
|
24
|
+
*
|
|
25
|
+
* Not worker-safe: `RTCPeerConnection` is main-thread only.
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* Structured error wrapper for WebRTC failures.
|
|
30
|
+
*
|
|
31
|
+
* `kind` is a stable string identifier you can switch on:
|
|
32
|
+
*
|
|
33
|
+
* - `'setLocal'` / `'setRemote'` - SDP application failed
|
|
34
|
+
* - `'addIceCandidate'` - ICE candidate ingestion failed (after flush)
|
|
35
|
+
* - `'createOffer'` / `'createAnswer'` - SDP negotiation failed
|
|
36
|
+
* - `'sendOverflow'` - DataChannel send queue exceeded `sendQueueMax`
|
|
37
|
+
* - `'sendClosed'` - `send()` called after the channel was closed
|
|
38
|
+
*
|
|
39
|
+
* @typedef {new (kind: string, message: string, cause?: unknown) => Error & { kind: string, cause?: unknown }} WebRTCErrorCtor
|
|
40
|
+
*/
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* A buffered DataChannel wrapper returned by `WebrtcPeer.dataChannel()`.
|
|
44
|
+
*
|
|
45
|
+
* @typedef {Object} WebrtcDataChannel
|
|
46
|
+
* @property {(data: string|Blob|ArrayBuffer|ArrayBufferView) => void} send Send data, buffering until the channel is open.
|
|
47
|
+
* @property {() => void} close Close the channel and remove all listeners.
|
|
48
|
+
* @property {string} readyState Underlying `RTCDataChannel.readyState` (read-only).
|
|
49
|
+
* @property {number} queuedAmount Number of messages buffered awaiting open (read-only).
|
|
50
|
+
* @property {Function} onopen Open-handler setter (write-only).
|
|
51
|
+
* @property {Function} onmessage Message-handler setter (write-only).
|
|
52
|
+
* @property {Function} onclose Close-handler setter (write-only).
|
|
53
|
+
* @property {Function} onerror Error-handler setter (write-only).
|
|
54
|
+
* @property {RTCDataChannel} raw Underlying native data channel.
|
|
55
|
+
*/
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* A peer-connection handle returned by `WebrtcAPI.peer()`.
|
|
59
|
+
*
|
|
60
|
+
* @typedef {Object} WebrtcPeer
|
|
61
|
+
* @property {(name: string, cb: Function) => (() => void)} on Register a listener; returns an unsubscribe.
|
|
62
|
+
* @property {(name: string, cb: Function) => void} off Remove a listener.
|
|
63
|
+
* @property {(options?: RTCOfferOptions) => Promise<RTCSessionDescriptionInit>} createOffer Create an SDP offer.
|
|
64
|
+
* @property {(options?: RTCAnswerOptions) => Promise<RTCSessionDescriptionInit>} createAnswer Create an SDP answer.
|
|
65
|
+
* @property {(desc: RTCLocalSessionDescriptionInit) => Promise<void>} setLocal Apply the local description.
|
|
66
|
+
* @property {(desc: RTCSessionDescriptionInit) => Promise<void>} setRemote Apply the remote description and flush queued ICE.
|
|
67
|
+
* @property {(candidate: RTCIceCandidateInit|RTCIceCandidate) => Promise<void>} addIceCandidate Add or queue a remote ICE candidate.
|
|
68
|
+
* @property {(label: string, options?: RTCDataChannelInit & {sendQueueMax?: number}) => WebrtcDataChannel} dataChannel Open a buffered data channel.
|
|
69
|
+
* @property {(track: MediaStreamTrack, ...streams: MediaStream[]) => RTCRtpSender} addTrack Add a media track.
|
|
70
|
+
* @property {(sender: RTCRtpSender) => void} removeTrack Remove a media track sender.
|
|
71
|
+
* @property {() => void} close Close the connection and release all bridges.
|
|
72
|
+
* @property {number} pendingIce Number of ICE candidates currently buffered (read-only).
|
|
73
|
+
* @property {string} connectionState Underlying `RTCPeerConnection.connectionState` (read-only).
|
|
74
|
+
* @property {string} iceConnectionState Underlying `RTCPeerConnection.iceConnectionState` (read-only).
|
|
75
|
+
* @property {RTCPeerConnection} raw Underlying native peer connection.
|
|
76
|
+
*/
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Public API returned by `webrtc.factory()`.
|
|
80
|
+
*
|
|
81
|
+
* @typedef {Object} WebrtcAPI
|
|
82
|
+
* @property {(config?: RTCConfiguration) => WebrtcPeer} peer Create a peer-connection wrapper.
|
|
83
|
+
* @property {WebRTCErrorCtor} WebRTCError Structured error constructor (instanceof-able via the resolved module).
|
|
84
|
+
*/
|
|
85
|
+
|
|
86
|
+
export const webrtc = {
|
|
87
|
+
name: 'webrtc',
|
|
88
|
+
type: 'fw.dom.net',
|
|
89
|
+
dependencies: [],
|
|
90
|
+
|
|
91
|
+
/** @returns {WebrtcAPI} */
|
|
92
|
+
factory() {
|
|
93
|
+
/**
|
|
94
|
+
* Structured WebRTC error. Defined inside the factory (worker-safe — no
|
|
95
|
+
* module-scope capture). `name` is set via defineProperty so it survives
|
|
96
|
+
* sanity's frozen `Error.prototype`.
|
|
97
|
+
*/
|
|
98
|
+
class WebRTCError extends Error {
|
|
99
|
+
constructor(kind, message, cause) {
|
|
100
|
+
super(message);
|
|
101
|
+
Object.defineProperty(this, 'name', { value: 'WebRTCError', writable: true, configurable: true });
|
|
102
|
+
this.kind = kind;
|
|
103
|
+
if (cause !== undefined) this.cause = cause;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Create a peer connection wrapper.
|
|
109
|
+
*
|
|
110
|
+
* @param {RTCConfiguration} [config={}]
|
|
111
|
+
* @returns {object} peer handle
|
|
112
|
+
*/
|
|
113
|
+
function peer(config = {}) {
|
|
114
|
+
const RTC = typeof RTCPeerConnection !== 'undefined' ? RTCPeerConnection : globalThis.RTCPeerConnection;
|
|
115
|
+
if (!RTC) throw new Error('webrtc: RTCPeerConnection is not available in this environment');
|
|
116
|
+
|
|
117
|
+
const raw = new RTC(config);
|
|
118
|
+
/** @type {Map<string, Set<Function>>} */
|
|
119
|
+
const _listeners = new Map();
|
|
120
|
+
|
|
121
|
+
/** ICE candidates buffered until setRemoteDescription resolves. */
|
|
122
|
+
const _iceQueue = [];
|
|
123
|
+
/** Resolves once a remote description has been applied at least once. */
|
|
124
|
+
let _remoteReady = false;
|
|
125
|
+
|
|
126
|
+
/** Live DataChannel wrappers, so close() can tear them down. */
|
|
127
|
+
const _dataChannels = new Set();
|
|
128
|
+
|
|
129
|
+
function _emit(name, ...args) {
|
|
130
|
+
const fns = _listeners.get(name);
|
|
131
|
+
if (!fns) return;
|
|
132
|
+
for (const fn of [...fns]) fn(...args);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
// Wire native events into the unified emitter.
|
|
136
|
+
raw.onicecandidate = (e) => _emit('icecandidate', e.candidate);
|
|
137
|
+
raw.ontrack = (e) => _emit('track', e);
|
|
138
|
+
raw.ondatachannel = (e) => _emit('datachannel', e);
|
|
139
|
+
raw.onconnectionstatechange = () => _emit('connectionstatechange', raw.connectionState);
|
|
140
|
+
raw.onicegatheringstatechange = () => _emit('icegatheringstatechange', raw.iceGatheringState);
|
|
141
|
+
raw.oniceconnectionstatechange = () => _emit('iceconnectionstatechange', raw.iceConnectionState);
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Register a listener. Returns an unsubscribe function.
|
|
145
|
+
* @param {string} name
|
|
146
|
+
* @param {Function} cb
|
|
147
|
+
* @returns {() => void}
|
|
148
|
+
*/
|
|
149
|
+
function on(name, cb) {
|
|
150
|
+
if (!_listeners.has(name)) _listeners.set(name, new Set());
|
|
151
|
+
_listeners.get(name).add(cb);
|
|
152
|
+
return () => _listeners.get(name)?.delete(cb);
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
function off(name, cb) {
|
|
156
|
+
_listeners.get(name)?.delete(cb);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
async function createOffer(options) {
|
|
160
|
+
try {
|
|
161
|
+
return await raw.createOffer(options);
|
|
162
|
+
} catch (e) {
|
|
163
|
+
throw new WebRTCError('createOffer', 'createOffer failed', e);
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
async function createAnswer(options) {
|
|
168
|
+
try {
|
|
169
|
+
return await raw.createAnswer(options);
|
|
170
|
+
} catch (e) {
|
|
171
|
+
throw new WebRTCError('createAnswer', 'createAnswer failed', e);
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
async function setLocal(desc) {
|
|
176
|
+
try {
|
|
177
|
+
return await raw.setLocalDescription(desc);
|
|
178
|
+
} catch (e) {
|
|
179
|
+
throw new WebRTCError('setLocal', 'setLocalDescription failed', e);
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* Apply a remote description, then flush every queued ICE candidate
|
|
185
|
+
* in arrival order. Errors from individual candidates are surfaced
|
|
186
|
+
* via the `icecandidateerror` emitter but do not abort the flush.
|
|
187
|
+
*/
|
|
188
|
+
async function setRemote(desc) {
|
|
189
|
+
try {
|
|
190
|
+
await raw.setRemoteDescription(desc);
|
|
191
|
+
} catch (e) {
|
|
192
|
+
throw new WebRTCError('setRemote', 'setRemoteDescription failed', e);
|
|
193
|
+
}
|
|
194
|
+
_remoteReady = true;
|
|
195
|
+
// Flush queue.
|
|
196
|
+
const pending = _iceQueue.splice(0);
|
|
197
|
+
for (const c of pending) {
|
|
198
|
+
try {
|
|
199
|
+
await raw.addIceCandidate(c);
|
|
200
|
+
} catch (e) {
|
|
201
|
+
_emit('icecandidateerror', new WebRTCError('addIceCandidate', 'queued addIceCandidate failed', e));
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* Add a remote ICE candidate. When `setRemoteDescription` has not
|
|
208
|
+
* yet resolved, the candidate is buffered and flushed once the
|
|
209
|
+
* remote description is applied. Returns a Promise that resolves
|
|
210
|
+
* once the candidate is either queued or applied.
|
|
211
|
+
*
|
|
212
|
+
* @param {RTCIceCandidateInit|RTCIceCandidate} candidate
|
|
213
|
+
* @returns {Promise<void>}
|
|
214
|
+
*/
|
|
215
|
+
async function addIceCandidate(candidate) {
|
|
216
|
+
if (!_remoteReady) {
|
|
217
|
+
_iceQueue.push(candidate);
|
|
218
|
+
return;
|
|
219
|
+
}
|
|
220
|
+
try {
|
|
221
|
+
await raw.addIceCandidate(candidate);
|
|
222
|
+
} catch (e) {
|
|
223
|
+
throw new WebRTCError('addIceCandidate', 'addIceCandidate failed', e);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* Open a data channel.
|
|
229
|
+
*
|
|
230
|
+
* The returned wrapper queues `send()` calls issued before the
|
|
231
|
+
* channel reaches the `'open'` state and flushes them
|
|
232
|
+
* automatically. Queue overflow raises a `WebRTCError` of kind
|
|
233
|
+
* `sendOverflow` via the channel's `onerror` handler (and the
|
|
234
|
+
* `send()` call rejects with the same error).
|
|
235
|
+
*
|
|
236
|
+
* @param {string} label
|
|
237
|
+
* @param {RTCDataChannelInit & {sendQueueMax?: number}} [options]
|
|
238
|
+
* @returns {object} wrapper
|
|
239
|
+
*/
|
|
240
|
+
function dataChannel(label, options = {}) {
|
|
241
|
+
const { sendQueueMax = 1024, ...dcInit } = options;
|
|
242
|
+
const dc = raw.createDataChannel(label, dcInit);
|
|
243
|
+
|
|
244
|
+
/** @type {{onopen: Function[], onmessage: Function[], onclose: Function[], onerror: Function[]}} */
|
|
245
|
+
const _dcListeners = { onopen: [], onmessage: [], onclose: [], onerror: [] };
|
|
246
|
+
|
|
247
|
+
/** Outgoing messages buffered until readyState === 'open'. */
|
|
248
|
+
const _sendQueue = [];
|
|
249
|
+
|
|
250
|
+
function _fireDcError(err) {
|
|
251
|
+
for (const fn of _dcListeners.onerror) fn(err);
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
dc.onopen = (e) => {
|
|
255
|
+
// Flush the send queue in order. Stop on first send-failure
|
|
256
|
+
// and surface it through onerror.
|
|
257
|
+
while (_sendQueue.length) {
|
|
258
|
+
const data = _sendQueue.shift();
|
|
259
|
+
try {
|
|
260
|
+
dc.send(data);
|
|
261
|
+
} catch (err) {
|
|
262
|
+
_fireDcError(new WebRTCError('sendClosed', 'flush after open failed', err));
|
|
263
|
+
break;
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
for (const fn of _dcListeners.onopen) fn(e);
|
|
267
|
+
};
|
|
268
|
+
dc.onmessage = (e) => { for (const fn of _dcListeners.onmessage) fn(e.data, e); };
|
|
269
|
+
dc.onclose = (e) => {
|
|
270
|
+
// Drop any still-queued messages - channel will never open.
|
|
271
|
+
_sendQueue.length = 0;
|
|
272
|
+
for (const fn of _dcListeners.onclose) fn(e);
|
|
273
|
+
};
|
|
274
|
+
dc.onerror = (e) => { for (const fn of _dcListeners.onerror) fn(e); };
|
|
275
|
+
|
|
276
|
+
/**
|
|
277
|
+
* Send data on the channel. Buffers when the channel is not
|
|
278
|
+
* yet open. Rejects with `WebRTCError` on overflow or when
|
|
279
|
+
* the channel is already closed/closing.
|
|
280
|
+
*
|
|
281
|
+
* @param {string|Blob|ArrayBuffer|ArrayBufferView} data
|
|
282
|
+
*/
|
|
283
|
+
function send(data) {
|
|
284
|
+
const state = dc.readyState;
|
|
285
|
+
if (state === 'closed' || state === 'closing') {
|
|
286
|
+
const err = new WebRTCError('sendClosed', `send() called while readyState='${state}'`);
|
|
287
|
+
_fireDcError(err);
|
|
288
|
+
throw err;
|
|
289
|
+
}
|
|
290
|
+
if (state !== 'open') {
|
|
291
|
+
if (_sendQueue.length >= sendQueueMax) {
|
|
292
|
+
const err = new WebRTCError('sendOverflow', `send queue exceeded sendQueueMax=${sendQueueMax}`);
|
|
293
|
+
_fireDcError(err);
|
|
294
|
+
throw err;
|
|
295
|
+
}
|
|
296
|
+
_sendQueue.push(data);
|
|
297
|
+
return;
|
|
298
|
+
}
|
|
299
|
+
// @ts-ignore - RTCDataChannel.send accepts string|ArrayBuffer|Blob|ArrayBufferView; TS overload is too strict
|
|
300
|
+
dc.send(data);
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
/**
|
|
304
|
+
* Close the channel and remove every registered listener so
|
|
305
|
+
* the listener arrays cannot retain caller closures.
|
|
306
|
+
*/
|
|
307
|
+
function close() {
|
|
308
|
+
_sendQueue.length = 0;
|
|
309
|
+
_dcListeners.onopen.length = 0;
|
|
310
|
+
_dcListeners.onmessage.length = 0;
|
|
311
|
+
_dcListeners.onclose.length = 0;
|
|
312
|
+
_dcListeners.onerror.length = 0;
|
|
313
|
+
try { dc.close(); } catch { /* ignore double-close */ }
|
|
314
|
+
// Detach native handlers to drop the bridge closures.
|
|
315
|
+
dc.onopen = dc.onmessage = dc.onclose = dc.onerror = null;
|
|
316
|
+
_dataChannels.delete(wrapper);
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
const wrapper = {
|
|
320
|
+
send, close,
|
|
321
|
+
get readyState() { return dc.readyState; },
|
|
322
|
+
get queuedAmount() { return _sendQueue.length; },
|
|
323
|
+
set onopen(fn) { _dcListeners.onopen = [fn]; },
|
|
324
|
+
set onmessage(fn) { _dcListeners.onmessage = [fn]; },
|
|
325
|
+
set onclose(fn) { _dcListeners.onclose = [fn]; },
|
|
326
|
+
set onerror(fn) { _dcListeners.onerror = [fn]; },
|
|
327
|
+
raw: dc,
|
|
328
|
+
};
|
|
329
|
+
|
|
330
|
+
_dataChannels.add(wrapper);
|
|
331
|
+
return wrapper;
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
function addTrack(track, ...streams) {
|
|
335
|
+
return raw.addTrack(track, ...streams);
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
function removeTrack(sender) {
|
|
339
|
+
return raw.removeTrack(sender);
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
/**
|
|
343
|
+
* Close the peer connection and release every listener bridge.
|
|
344
|
+
* Each live data channel created via {@link dataChannel} is
|
|
345
|
+
* closed too so its listener arrays drop user closures.
|
|
346
|
+
*/
|
|
347
|
+
function close() {
|
|
348
|
+
// Tear down each live data channel wrapper first.
|
|
349
|
+
for (const w of [..._dataChannels]) {
|
|
350
|
+
try { w.close(); } catch { /* ignore */ }
|
|
351
|
+
}
|
|
352
|
+
_dataChannels.clear();
|
|
353
|
+
|
|
354
|
+
_listeners.clear();
|
|
355
|
+
_iceQueue.length = 0;
|
|
356
|
+
raw.onicecandidate = null;
|
|
357
|
+
raw.ontrack = null;
|
|
358
|
+
raw.ondatachannel = null;
|
|
359
|
+
raw.onconnectionstatechange = null;
|
|
360
|
+
raw.onicegatheringstatechange = null;
|
|
361
|
+
raw.oniceconnectionstatechange = null;
|
|
362
|
+
raw.close();
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
return {
|
|
366
|
+
on, off,
|
|
367
|
+
createOffer, createAnswer,
|
|
368
|
+
setLocal, setRemote, addIceCandidate,
|
|
369
|
+
dataChannel, addTrack, removeTrack,
|
|
370
|
+
close,
|
|
371
|
+
/** @returns {number} number of ICE candidates currently buffered. */
|
|
372
|
+
get pendingIce() { return _iceQueue.length; },
|
|
373
|
+
get connectionState() { return raw.connectionState; },
|
|
374
|
+
get iceConnectionState() { return raw.iceConnectionState; },
|
|
375
|
+
raw,
|
|
376
|
+
};
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
return { peer, WebRTCError };
|
|
380
|
+
},
|
|
381
|
+
};
|
|
@@ -0,0 +1,290 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview WebSocket client with automatic reconnection, exponential
|
|
7
|
+
* backoff, and an outbound message queue.
|
|
8
|
+
*
|
|
9
|
+
* Improvements over the legacy implementation:
|
|
10
|
+
* - `MozWebSocket` fallback removed (standard `WebSocket` since Firefox 11)
|
|
11
|
+
* - Exponential backoff with full jitter on reconnection (no fixed 600 ms delay)
|
|
12
|
+
* - Outbound message queue: `send()` buffers messages while disconnected and
|
|
13
|
+
* flushes them automatically on the next successful open
|
|
14
|
+
* - `off(event)` to unregister individual handlers
|
|
15
|
+
* - `close(code, reason)` for a permanent close that disables reconnection
|
|
16
|
+
* - `isOpen` and `readyState` getters
|
|
17
|
+
* - `bufferedAmount` getter
|
|
18
|
+
* - Configurable `maxDelay` cap on the backoff interval
|
|
19
|
+
* - `onclose` handler receives structured `{ reconnecting, attempt, remaining }` context
|
|
20
|
+
*
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* @typedef {object} WsOptions
|
|
25
|
+
* @property {string} url - WebSocket server URL.
|
|
26
|
+
* @property {number} [retry=0] - Max reconnection attempts.
|
|
27
|
+
* @property {number} [retryDelay=1000] - Base reconnection delay in ms.
|
|
28
|
+
* @property {number} [maxDelay=30000] - Upper bound for the backoff delay in ms.
|
|
29
|
+
* @property {string} [binary='arraybuffer'] - Binary message type.
|
|
30
|
+
*/
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* @typedef {object} WsConnection
|
|
34
|
+
* @property {function(string, function): WsConnection} on - Register a lifecycle event handler.
|
|
35
|
+
* @property {function(string): WsConnection} off - Remove a lifecycle event handler.
|
|
36
|
+
* @property {function(string|ArrayBuffer|Blob|ArrayBufferView): WsConnection} send - Send data.
|
|
37
|
+
* @property {function(number=, string=): void} close - Permanently close the connection.
|
|
38
|
+
* @property {boolean} isOpen - True when the socket is in the OPEN state.
|
|
39
|
+
* @property {number} readyState - Current readyState of the underlying socket.
|
|
40
|
+
* @property {number} bufferedAmount - Bytes queued in the native socket's send buffer.
|
|
41
|
+
*/
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* Object returned by `ws.factory()`: a `create(opts)` factory function that
|
|
45
|
+
* opens a WebSocket and returns a {@link WsConnection} handle.
|
|
46
|
+
* @typedef {function(string|WsOptions): WsConnection} WsAPI
|
|
47
|
+
*/
|
|
48
|
+
|
|
49
|
+
export const ws = {
|
|
50
|
+
name: 'ws',
|
|
51
|
+
type: 'fw.dom.net',
|
|
52
|
+
dependencies: [],
|
|
53
|
+
|
|
54
|
+
/** @returns {WsAPI} */
|
|
55
|
+
factory() {
|
|
56
|
+
|
|
57
|
+
// --- Internal ---
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Derive a fully qualified WebSocket URL from `raw`.
|
|
61
|
+
*
|
|
62
|
+
* - Already absolute (`ws://` / `wss://`): returned unchanged.
|
|
63
|
+
* - Relative path: prefixed with the protocol that matches the page
|
|
64
|
+
* (`https:` → `wss://`, `http:` → `ws://`) and the current host.
|
|
65
|
+
*
|
|
66
|
+
* @param {string} raw
|
|
67
|
+
* @returns {string}
|
|
68
|
+
*/
|
|
69
|
+
function resolveUrl(raw) {
|
|
70
|
+
if (/^wss?:\/\//i.test(raw)) return raw;
|
|
71
|
+
const proto = (typeof location !== 'undefined' && location.protocol === 'https:') ? 'wss' : 'ws';
|
|
72
|
+
const host = typeof location !== 'undefined' ? location.host : '';
|
|
73
|
+
return `${proto}://${host}/${raw.replace(/^\/+/, '')}`;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Compute the next reconnection delay using exponential backoff with
|
|
78
|
+
* full jitter: `random(0, min(maxDelay, base × 2^attempt))`.
|
|
79
|
+
*
|
|
80
|
+
* Full jitter avoids thundering-herd reconnections when many clients
|
|
81
|
+
* lose connectivity simultaneously.
|
|
82
|
+
*
|
|
83
|
+
* @param {number} attempt - Zero-based reconnect attempt counter.
|
|
84
|
+
* @param {number} baseDelay - Base delay in ms.
|
|
85
|
+
* @param {number} maxDelay - Maximum delay cap in ms.
|
|
86
|
+
* @returns {number} Delay in ms.
|
|
87
|
+
*/
|
|
88
|
+
function backoff(attempt, baseDelay, maxDelay) {
|
|
89
|
+
const cap = Math.min(maxDelay, baseDelay * (2 ** attempt));
|
|
90
|
+
// crypto-based jitter : Math.random is blocked by sanity/base.js.
|
|
91
|
+
// crypto.getRandomValues is NOT blocked; fall back to 0.5 only in
|
|
92
|
+
// no-crypto environments (where sanity is not active anyway).
|
|
93
|
+
const g = globalThis;
|
|
94
|
+
let r = 0.5;
|
|
95
|
+
if (g.crypto && g.crypto.getRandomValues) {
|
|
96
|
+
const b = new Uint32Array(1);
|
|
97
|
+
g.crypto.getRandomValues(b);
|
|
98
|
+
r = b[0] / 0x100000000;
|
|
99
|
+
}
|
|
100
|
+
return r * cap;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
// --- Public API ---
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Open a WebSocket connection.
|
|
107
|
+
*
|
|
108
|
+
* When a `string` is passed it is used directly as the URL with all
|
|
109
|
+
* other options left at their defaults.
|
|
110
|
+
*
|
|
111
|
+
* @param {string|WsOptions} opts - URL string or options object.
|
|
112
|
+
* @returns {WsConnection}
|
|
113
|
+
*/
|
|
114
|
+
return function create(opts) {
|
|
115
|
+
const options = typeof opts === 'string' ? { url: opts } : { ...opts };
|
|
116
|
+
const url = resolveUrl(options.url ?? '');
|
|
117
|
+
const maxRetry = options.retry ?? 0;
|
|
118
|
+
const baseDelay = options.retryDelay ?? 1000;
|
|
119
|
+
const maxDelay = options.maxDelay ?? 30000;
|
|
120
|
+
const binary = options.binary ?? 'arraybuffer';
|
|
121
|
+
|
|
122
|
+
let socket = null;
|
|
123
|
+
let attempt = 0; // backoff exponent, reset on successful open
|
|
124
|
+
let retryCount = 0; // total reconnection attempts made
|
|
125
|
+
let terminated = false; // set by close() - disables further reconnection
|
|
126
|
+
let retryTimer = null;
|
|
127
|
+
|
|
128
|
+
const queue = []; // messages buffered while not OPEN
|
|
129
|
+
|
|
130
|
+
/** @type {{ open: Function, close: Function, message: Function, error: Function }} */
|
|
131
|
+
const handlers = {
|
|
132
|
+
open: () => {},
|
|
133
|
+
close: () => {},
|
|
134
|
+
message: () => {},
|
|
135
|
+
error: () => {}
|
|
136
|
+
};
|
|
137
|
+
|
|
138
|
+
function connect() {
|
|
139
|
+
if (terminated) return;
|
|
140
|
+
|
|
141
|
+
socket = new WebSocket(url);
|
|
142
|
+
// @ts-ignore - binary is validated string; TS BinaryType union does not cover runtime assignment
|
|
143
|
+
socket.binaryType = binary;
|
|
144
|
+
|
|
145
|
+
socket.onopen = event => {
|
|
146
|
+
attempt = 0;
|
|
147
|
+
retryCount = 0;
|
|
148
|
+
// Drain the outbound queue now that the connection is live
|
|
149
|
+
while (queue.length > 0 && socket.readyState === WebSocket.OPEN) {
|
|
150
|
+
socket.send(queue.shift());
|
|
151
|
+
}
|
|
152
|
+
handlers.open(event);
|
|
153
|
+
};
|
|
154
|
+
|
|
155
|
+
socket.onclose = event => {
|
|
156
|
+
socket = null;
|
|
157
|
+
if (!terminated && retryCount < maxRetry) {
|
|
158
|
+
const delay = backoff(attempt, baseDelay, maxDelay);
|
|
159
|
+
attempt++;
|
|
160
|
+
retryCount++;
|
|
161
|
+
retryTimer = setTimeout(connect, delay);
|
|
162
|
+
handlers.close(event, {
|
|
163
|
+
reconnecting: true,
|
|
164
|
+
attempt: retryCount,
|
|
165
|
+
remaining: maxRetry - retryCount
|
|
166
|
+
});
|
|
167
|
+
} else {
|
|
168
|
+
handlers.close(event, { reconnecting: false, attempt: retryCount, remaining: 0 });
|
|
169
|
+
}
|
|
170
|
+
};
|
|
171
|
+
|
|
172
|
+
socket.onmessage = event => {
|
|
173
|
+
handlers.message(event.data, event);
|
|
174
|
+
};
|
|
175
|
+
|
|
176
|
+
socket.onerror = event => {
|
|
177
|
+
// onerror is always followed by onclose - state update happens there
|
|
178
|
+
handlers.error(event);
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
connect();
|
|
183
|
+
|
|
184
|
+
return {
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* Register a handler for a lifecycle event.
|
|
188
|
+
*
|
|
189
|
+
* | Event | Callback signature |
|
|
190
|
+
* |-----------|--------------------|
|
|
191
|
+
* | `open` | `(event: Event) => void` |
|
|
192
|
+
* | `close` | `(event: CloseEvent, ctx: { reconnecting, attempt, remaining }) => void` |
|
|
193
|
+
* | `message` | `(data: string \| ArrayBuffer \| Blob, event: MessageEvent) => void` |
|
|
194
|
+
* | `error` | `(event: Event) => void` |
|
|
195
|
+
*
|
|
196
|
+
* Calling `on` for an event that already has a handler replaces it.
|
|
197
|
+
*
|
|
198
|
+
* @param {'open'|'close'|'message'|'error'} event
|
|
199
|
+
* @param {function} fn
|
|
200
|
+
* @returns {WsConnection} This instance (chainable).
|
|
201
|
+
*/
|
|
202
|
+
on(event, fn) {
|
|
203
|
+
if (Object.prototype.hasOwnProperty.call(handlers, event)) {
|
|
204
|
+
handlers[event] = fn;
|
|
205
|
+
}
|
|
206
|
+
return this;
|
|
207
|
+
},
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* Remove the handler for a lifecycle event (replaced with a no-op).
|
|
211
|
+
*
|
|
212
|
+
* @param {'open'|'close'|'message'|'error'} event
|
|
213
|
+
* @returns {WsConnection} This instance (chainable).
|
|
214
|
+
*/
|
|
215
|
+
off(event) {
|
|
216
|
+
if (Object.prototype.hasOwnProperty.call(handlers, event)) {
|
|
217
|
+
handlers[event] = () => {};
|
|
218
|
+
}
|
|
219
|
+
return this;
|
|
220
|
+
},
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Send `data` over the WebSocket.
|
|
224
|
+
*
|
|
225
|
+
* When the connection is not yet open or is temporarily closed
|
|
226
|
+
* pending a reconnect, the message is placed in an outbound
|
|
227
|
+
* queue and flushed automatically once the socket reopens.
|
|
228
|
+
*
|
|
229
|
+
* @param {string | ArrayBuffer | Blob | ArrayBufferView} data
|
|
230
|
+
* @returns {WsConnection} This instance (chainable).
|
|
231
|
+
*/
|
|
232
|
+
send(data) {
|
|
233
|
+
// Silently discard messages sent after a permanent close -
|
|
234
|
+
// the queue will never be flushed so buffering would leak memory.
|
|
235
|
+
if (terminated) return this;
|
|
236
|
+
if (socket !== null && socket.readyState === WebSocket.OPEN) {
|
|
237
|
+
socket.send(data);
|
|
238
|
+
} else {
|
|
239
|
+
queue.push(data);
|
|
240
|
+
}
|
|
241
|
+
return this;
|
|
242
|
+
},
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Permanently close the connection.
|
|
246
|
+
*
|
|
247
|
+
* Cancels any pending reconnect timer, clears the outbound
|
|
248
|
+
* queue, and closes the underlying socket. After calling
|
|
249
|
+
* `close()`, no further reconnection attempts are made.
|
|
250
|
+
*
|
|
251
|
+
* @param {number} [code=1000] - WebSocket close code.
|
|
252
|
+
* @param {string} [reason=''] - Human-readable close reason.
|
|
253
|
+
*/
|
|
254
|
+
close(code = 1000, reason = '') {
|
|
255
|
+
terminated = true;
|
|
256
|
+
clearTimeout(retryTimer);
|
|
257
|
+
queue.length = 0;
|
|
258
|
+
if (socket !== null) socket.close(code, reason);
|
|
259
|
+
},
|
|
260
|
+
|
|
261
|
+
/**
|
|
262
|
+
* `true` when the underlying socket is in the `OPEN` state.
|
|
263
|
+
* @type {boolean}
|
|
264
|
+
*/
|
|
265
|
+
get isOpen() {
|
|
266
|
+
return socket !== null && socket.readyState === WebSocket.OPEN;
|
|
267
|
+
},
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* The `readyState` of the underlying socket
|
|
271
|
+
* (`CONNECTING=0`, `OPEN=1`, `CLOSING=2`, `CLOSED=3`).
|
|
272
|
+
* Returns `WebSocket.CLOSED` when no socket exists.
|
|
273
|
+
* @type {number}
|
|
274
|
+
*/
|
|
275
|
+
get readyState() {
|
|
276
|
+
return socket !== null ? socket.readyState : WebSocket.CLOSED;
|
|
277
|
+
},
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* Bytes queued in the native socket's send buffer.
|
|
281
|
+
* Returns `0` when not connected.
|
|
282
|
+
* @type {number}
|
|
283
|
+
*/
|
|
284
|
+
get bufferedAmount() {
|
|
285
|
+
return socket !== null ? socket.bufferedAmount : 0;
|
|
286
|
+
}
|
|
287
|
+
};
|
|
288
|
+
};
|
|
289
|
+
}
|
|
290
|
+
};
|