@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,108 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: download
|
|
3
|
+
category: dom/fs
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# download
|
|
11
|
+
|
|
12
|
+
> Client-side file download — triggers a save prompt without navigation.
|
|
13
|
+
|
|
14
|
+
**Module** `download` | **Source** `packages/front/fw/src/dom/fs/download.js` | **Deps** none | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
const dl = runtime.resolve('download');
|
|
20
|
+
// Returns: { url, blob, bytes, text }
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## API
|
|
24
|
+
|
|
25
|
+
| Method | Signature | Returns |
|
|
26
|
+
|---------|-----------|---------|
|
|
27
|
+
| `url` | `(href: string, name: string) => void` | Download from an existing URL (`data:` or `blob:`) |
|
|
28
|
+
| `blob` | `(blob: Blob, name: string) => void` | Download a `Blob` (Object URL auto-revoked) |
|
|
29
|
+
| `bytes` | `(data: Uint8Array, name: string, type?: string) => void` | Download a `Uint8Array` (default `application/octet-stream`) |
|
|
30
|
+
| `text` | `(content: string, name: string, type?: string) => void` | Download a string (default `text/plain;charset=utf-8`) |
|
|
31
|
+
|
|
32
|
+
### `dl.url(href, name)`
|
|
33
|
+
|
|
34
|
+
Download from an existing URL (`data:` or `blob:`). The caller is responsible for revoking Object URLs.
|
|
35
|
+
|
|
36
|
+
```js
|
|
37
|
+
dl.url('data:text/plain;base64,SGVsbG8=', 'hello.txt');
|
|
38
|
+
dl.url(blobUrl, 'export.bin');
|
|
39
|
+
// ⚠ if blobUrl is an Object URL, revoke manually after
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### `dl.blob(blob, name)`
|
|
43
|
+
|
|
44
|
+
Download a `Blob`. Creates and revokes the Object URL automatically.
|
|
45
|
+
|
|
46
|
+
```js
|
|
47
|
+
const blob = new Blob(['Hello World'], { type: 'text/plain' });
|
|
48
|
+
dl.blob(blob, 'hello.txt');
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### `dl.bytes(data, name, type?)`
|
|
52
|
+
|
|
53
|
+
Download a `Uint8Array`. Default MIME type: `'application/octet-stream'`.
|
|
54
|
+
|
|
55
|
+
```js
|
|
56
|
+
dl.bytes(uint8Array, 'image.png', 'image/png');
|
|
57
|
+
dl.bytes(csvBytes, 'export.csv', 'text/csv;charset=utf-8');
|
|
58
|
+
dl.bytes(binaryData, 'data.bin'); // application/octet-stream
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### `dl.text(content, name, type?)`
|
|
62
|
+
|
|
63
|
+
Download a string. Default MIME type: `'text/plain;charset=utf-8'`.
|
|
64
|
+
|
|
65
|
+
```js
|
|
66
|
+
dl.text('Line 1\nLine 2', 'export.txt');
|
|
67
|
+
dl.text(JSON.stringify(data, null, 2), 'data.json', 'application/json');
|
|
68
|
+
dl.text(csvContent, 'report.csv', 'text/csv;charset=utf-8');
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Examples
|
|
72
|
+
|
|
73
|
+
### Export of processed data
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
const dl = runtime.resolve('download');
|
|
77
|
+
const gzip = runtime.resolve('gzip');
|
|
78
|
+
const utf8 = runtime.resolve('utf8');
|
|
79
|
+
|
|
80
|
+
// Compressed JSON export
|
|
81
|
+
const json = JSON.stringify(dataset, null, 2);
|
|
82
|
+
const compressed = gzip.gzipSync(utf8.toBytes(json));
|
|
83
|
+
dl.bytes(compressed, 'dataset.json.gz', 'application/gzip');
|
|
84
|
+
|
|
85
|
+
// Plain text export
|
|
86
|
+
dl.text(json, 'dataset.json', 'application/json');
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### Export from a canvas
|
|
90
|
+
|
|
91
|
+
```js
|
|
92
|
+
const canvas = document.querySelector('canvas');
|
|
93
|
+
canvas.toBlob((blob) => {
|
|
94
|
+
dl.blob(blob, 'screenshot.png');
|
|
95
|
+
}, 'image/png');
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Notes
|
|
99
|
+
|
|
100
|
+
- No navigation — the page stays in place.
|
|
101
|
+
- The browser shows a "Save as" prompt or saves automatically to the Downloads folder.
|
|
102
|
+
- Requires `document` and `URL.createObjectURL` (not available in workers).
|
|
103
|
+
- `dl.blob` and `dl.bytes` automatically revoke the Object URL after triggering.
|
|
104
|
+
|
|
105
|
+
## See also
|
|
106
|
+
|
|
107
|
+
- [ajax](../net/ajax.md) — fetch data to download
|
|
108
|
+
- [storage](./storage.md), [indexedDB](./indexedDB.md) — local data sources
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: fsAccess
|
|
3
|
+
category: dom/fs
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: partial
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# fsAccess
|
|
11
|
+
|
|
12
|
+
> File System Access API + OPFS — pick, read, write, list files and directories.
|
|
13
|
+
|
|
14
|
+
**Module** `fsAccess` | **Source** `packages/front/fw/src/dom/fs/fsAccess.js` | **Deps** none | **Worker-safe** partial (OPFS yes — pickers no, DOM-bound)
|
|
15
|
+
|
|
16
|
+
`fsAccess` unifies two complementary browser APIs: the **File System Access API** (pickers triggered by a user gesture, main thread only) and the **Origin Private File System / OPFS** (`navigator.storage.getDirectory()`, origin-isolated sandbox, accessible from Workers). Both families expose the same `read` / `write` / handle helpers, making migration between contexts straightforward.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const fs = runtime.resolve('fsAccess');
|
|
22
|
+
// Returns: { pickFile, pickFiles, pickDirectory, pickSave,
|
|
23
|
+
// read, write, opfs, support,
|
|
24
|
+
// getFile, getFileHandle, getDirectoryHandle, list, remove }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|---------|-----------|---------|
|
|
31
|
+
| `support` | `() => SupportInfo` | `{fsa, opfs, writableStreams}` |
|
|
32
|
+
| `pickFile` | `(opts?) => Promise<FileSystemFileHandle \| null>` | null if cancelled |
|
|
33
|
+
| `pickFiles` | `(opts?) => Promise<FileSystemFileHandle[]>` | `[]` if cancelled |
|
|
34
|
+
| `pickDirectory` | `(opts?) => Promise<FileSystemDirectoryHandle \| null>` | null if cancelled |
|
|
35
|
+
| `pickSave` | `(opts?) => Promise<FileSystemFileHandle \| null>` | null if cancelled |
|
|
36
|
+
| `read` | `(handle, opts?) => Promise<Uint8Array \| string \| ReadableStream>` | based on `as` |
|
|
37
|
+
| `write` | `(handle, data, opts?) => Promise<void>` | — |
|
|
38
|
+
| `opfs` | `() => Promise<FileSystemDirectoryHandle>` | OPFS root |
|
|
39
|
+
| `getFile` | `(handle) => Promise<File>` | native File object |
|
|
40
|
+
| `getFileHandle` | `(dirHandle, name, opts?) => Promise<FileSystemFileHandle>` | — |
|
|
41
|
+
| `getDirectoryHandle` | `(dirHandle, name, opts?) => Promise<FileSystemDirectoryHandle>` | — |
|
|
42
|
+
| `list` | `(dirHandle) => AsyncGenerator<Entry>` | `{name, kind, handle}` |
|
|
43
|
+
| `remove` | `(dirHandle, name, opts?) => Promise<void>` | — |
|
|
44
|
+
|
|
45
|
+
### `support()`
|
|
46
|
+
|
|
47
|
+
Returns the capabilities available in the current context (main thread or worker):
|
|
48
|
+
|
|
49
|
+
```ts
|
|
50
|
+
{ fsa: boolean, opfs: boolean, writableStreams: boolean }
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
`fsa`: `showOpenFilePicker` available. `opfs`: `navigator.storage.getDirectory` available. `writableStreams`: `FileSystemWritableFileStream` or OPFS available.
|
|
54
|
+
|
|
55
|
+
### `pickFile(opts?)` / `pickFiles(opts?)` / `pickDirectory(opts?)` / `pickSave(opts?)`
|
|
56
|
+
|
|
57
|
+
Delegate directly to native APIs (`showOpenFilePicker`, `showSaveFilePicker`, `showDirectoryPicker`). All throw `Error('fsAccess: File System Access API not supported')` if `support().fsa === false`. They return `null` / `[]` if the user cancels (traps native `AbortError`); any other error is rethrown as-is (including `SecurityError` if called without a user gesture).
|
|
58
|
+
|
|
59
|
+
**Options `pickFile` / `pickFiles`:**
|
|
60
|
+
|
|
61
|
+
| Option | Type | Description |
|
|
62
|
+
|--------|------|-------------|
|
|
63
|
+
| `types` | `FilePickerAcceptType[]` | MIME / extension filters |
|
|
64
|
+
| `excludeAcceptAllOption` | `boolean` | Hides the "All files" filter |
|
|
65
|
+
|
|
66
|
+
**Options `pickDirectory`:**
|
|
67
|
+
|
|
68
|
+
| Option | Type | Default | Description |
|
|
69
|
+
|--------|------|--------|-------------|
|
|
70
|
+
| `mode` | `'read' \| 'readwrite'` | `'read'` | Requested access level |
|
|
71
|
+
|
|
72
|
+
**Options `pickSave`:**
|
|
73
|
+
|
|
74
|
+
| Option | Type | Description |
|
|
75
|
+
|--------|------|-------------|
|
|
76
|
+
| `suggestedName` | `string` | Pre-filled file name |
|
|
77
|
+
| `types` | `FilePickerAcceptType[]` | MIME / extension filters |
|
|
78
|
+
|
|
79
|
+
### `read(handle, opts?)`
|
|
80
|
+
|
|
81
|
+
| `as` option | Returned value |
|
|
82
|
+
|-------------|-----------------|
|
|
83
|
+
| `'bytes'` (default) | `Uint8Array` — raw contents |
|
|
84
|
+
| `'text'` | `string` — UTF-8 decoded |
|
|
85
|
+
| `'stream'` | `ReadableStream` — streaming access |
|
|
86
|
+
|
|
87
|
+
Throws `TypeError` if `handle` is invalid (null, object without `getFile`).
|
|
88
|
+
|
|
89
|
+
### `write(handle, data, opts?)`
|
|
90
|
+
|
|
91
|
+
`data` accepts: `Uint8Array`, `string`, `Blob`, `ReadableStream`. Creates a `FileSystemWritableFileStream`, writes the data, then closes the stream.
|
|
92
|
+
|
|
93
|
+
| Option | Type | Default | Description |
|
|
94
|
+
|--------|------|--------|-------------|
|
|
95
|
+
| `append` | `boolean` | `false` | Append at the end instead of overwriting |
|
|
96
|
+
|
|
97
|
+
Throws `TypeError` if `handle` is invalid.
|
|
98
|
+
|
|
99
|
+
### `opfs()`
|
|
100
|
+
|
|
101
|
+
Returns the `FileSystemDirectoryHandle` root of the OPFS (Origin Private File System). The promise is cached at instance level — successive calls return the same value without re-querying the browser.
|
|
102
|
+
|
|
103
|
+
Throws `Error('fsAccess: OPFS not supported')` if `support().opfs === false`.
|
|
104
|
+
|
|
105
|
+
### `list(dirHandle)`
|
|
106
|
+
|
|
107
|
+
Async generator that iterates `dirHandle.entries()` and returns `{ name: string, kind: 'file'|'directory', handle }` objects.
|
|
108
|
+
|
|
109
|
+
## Examples
|
|
110
|
+
|
|
111
|
+
### Open a user file (main thread)
|
|
112
|
+
|
|
113
|
+
```js
|
|
114
|
+
const fs = runtime.resolve('fsAccess');
|
|
115
|
+
|
|
116
|
+
const handle = await fs.pickFile({
|
|
117
|
+
types: [{ description: 'JSON', accept: { 'application/json': ['.json'] } }]
|
|
118
|
+
});
|
|
119
|
+
if (handle) {
|
|
120
|
+
const text = await fs.read(handle, { as: 'text' });
|
|
121
|
+
console.log(JSON.parse(text));
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
### Save an export (main thread)
|
|
126
|
+
|
|
127
|
+
```js
|
|
128
|
+
const fs = runtime.resolve('fsAccess');
|
|
129
|
+
|
|
130
|
+
const handle = await fs.pickSave({
|
|
131
|
+
suggestedName: 'export.csv',
|
|
132
|
+
types: [{ description: 'CSV', accept: { 'text/csv': ['.csv'] } }]
|
|
133
|
+
});
|
|
134
|
+
if (handle) {
|
|
135
|
+
await fs.write(handle, 'col1,col2\n1,2\n');
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Use OPFS as application storage (worker-safe)
|
|
140
|
+
|
|
141
|
+
```js
|
|
142
|
+
const fs = runtime.resolve('fsAccess');
|
|
143
|
+
|
|
144
|
+
const root = await fs.opfs();
|
|
145
|
+
const fh = await fs.getFileHandle(root, 'cache.bin', { create: true });
|
|
146
|
+
await fs.write(fh, new Uint8Array([0x01, 0x02, 0x03]));
|
|
147
|
+
const data = await fs.read(fh); // Uint8Array
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### Iterate an OPFS directory
|
|
151
|
+
|
|
152
|
+
```js
|
|
153
|
+
const fs = runtime.resolve('fsAccess');
|
|
154
|
+
const root = await fs.opfs();
|
|
155
|
+
|
|
156
|
+
for await (const entry of fs.list(root)) {
|
|
157
|
+
console.log(entry.name, entry.kind); // 'cache.bin' 'file'
|
|
158
|
+
}
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### Read an OPFS subdirectory
|
|
162
|
+
|
|
163
|
+
```js
|
|
164
|
+
const fs = runtime.resolve('fsAccess');
|
|
165
|
+
const root = await fs.opfs();
|
|
166
|
+
const subdir = await fs.getDirectoryHandle(root, 'myapp', { create: true });
|
|
167
|
+
const fh = await fs.getFileHandle(subdir, 'settings.json', { create: true });
|
|
168
|
+
await fs.write(fh, JSON.stringify({ theme: 'dark' }));
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
## Worker Usage
|
|
172
|
+
|
|
173
|
+
The OPFS part of the module is worker-safe. Pickers (`pick*`) require the main thread.
|
|
174
|
+
|
|
175
|
+
```js
|
|
176
|
+
// Inside a Worker:
|
|
177
|
+
const fs = runtime.resolve('fsAccess');
|
|
178
|
+
const { opfs } = fs;
|
|
179
|
+
|
|
180
|
+
const root = await opfs();
|
|
181
|
+
const fh = await fs.getFileHandle(root, 'worker-output.bin', { create: true });
|
|
182
|
+
await fs.write(fh, new Uint8Array(self.processedData));
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
For OPFS from a dedicated worker, `FileSystemSyncAccessHandle` (synchronous API) is accessible via `handle.createSyncAccessHandle()` — not wrapped by this module (direct access to the native handle).
|
|
186
|
+
|
|
187
|
+
## Notes
|
|
188
|
+
|
|
189
|
+
- Pickers (`pick*`) require a **user gesture** (click, keypress…) — a programmatic call triggers a native `SecurityError` not caught by the `AbortError` wrapper.
|
|
190
|
+
- `opfs()` caches the root per factory instance. With multi-instance (isolation: true), each instance has its own cache but points to the same origin OPFS.
|
|
191
|
+
- `write` with `append: true` positions the cursor at `file.size` before writing — this operation is not atomic and may produce corrupted data if multiple writers compete without a lock (see the `mutex` module).
|
|
192
|
+
- Pickers require an E2E test (real browser, J3+); unit tests cover `support()`, OPFS and error branches.
|
|
193
|
+
- Compatibility: FSA since Chrome 86+, Edge 86+, Opera 72+. OPFS since Chrome 86+, Firefox 111+, Safari 15.2+. Firefox < 111: OPFS unavailable.
|
|
194
|
+
|
|
195
|
+
## See also
|
|
196
|
+
|
|
197
|
+
- [indexedDB](./indexedDB.md) — structured key-value persistence (IndexedDB)
|
|
198
|
+
- [storage](./storage.md) — localStorage / sessionStorage cross-tab
|
|
199
|
+
- [download](./download.md) — file export without a picker
|
|
200
|
+
- [mutex](../../io/sync/mutex.md) — async lock for concurrent OPFS writers
|
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: indexedDB
|
|
3
|
+
category: dom/fs
|
|
4
|
+
dependencies: ['broadcastChannel']
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# indexedDB
|
|
11
|
+
|
|
12
|
+
> IndexedDB wrapper with Promise API per store, named change listeners, and cross-tab notifications via BroadcastChannel.
|
|
13
|
+
|
|
14
|
+
**Module** `indexedDB` | **Source** `packages/front/fw/src/dom/fs/indexedDB.js` | **Deps** `broadcastChannel` | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
const idb = runtime.resolve('indexedDB');
|
|
20
|
+
// Returns: { isSupported, open, drop }
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## API
|
|
24
|
+
|
|
25
|
+
### `idb.isSupported() → boolean`
|
|
26
|
+
|
|
27
|
+
### `idb.open(name, version, upgrade?, options?) → Promise<DB>`
|
|
28
|
+
|
|
29
|
+
Opens or creates/migrates an IndexedDB database.
|
|
30
|
+
|
|
31
|
+
```js
|
|
32
|
+
const db = await idb.open('myApp', 1, (db, oldVersion, newVersion) => {
|
|
33
|
+
// Called if version changes
|
|
34
|
+
if (oldVersion < 1) {
|
|
35
|
+
db.createObjectStore('cache');
|
|
36
|
+
db.createObjectStore('users', { keyPath: 'id' });
|
|
37
|
+
}
|
|
38
|
+
});
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
| Param | Type | Description |
|
|
42
|
+
|-------|------|-------------|
|
|
43
|
+
| `name` | `string` | Database name |
|
|
44
|
+
| `version` | `number` | Version (integer ≥ 1) |
|
|
45
|
+
| `upgrade` | `(db, oldVersion, newVersion) → void` | Migration callback (optional) |
|
|
46
|
+
| `options` | `{ crossTab?, namespace? }` | Cross-tab options (optional, see below) |
|
|
47
|
+
|
|
48
|
+
#### Options
|
|
49
|
+
|
|
50
|
+
| Option | Type | Default | Description |
|
|
51
|
+
|--------|------|--------|-------------|
|
|
52
|
+
| `crossTab` | `boolean` | `true` | If `false`, disables all cross-tab broadcasting. `listen` events stay same-tab only. |
|
|
53
|
+
| `namespace` | `string` | `''` | BroadcastChannel name prefix to isolate events between user sessions sharing the same browser. Must not contain `:`. |
|
|
54
|
+
|
|
55
|
+
**Channel name construction**:
|
|
56
|
+
|
|
57
|
+
```js
|
|
58
|
+
// With namespace:
|
|
59
|
+
const channelName = `idb:${namespace}:${name}`; // e.g.: 'idb:user-42:myApp'
|
|
60
|
+
|
|
61
|
+
// Without namespace:
|
|
62
|
+
const channelName = `idb:${name}`; // e.g.: 'idb:myApp'
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
**Validation**:
|
|
66
|
+
- `crossTab` must be a boolean if provided, otherwise `throw 'indexedDB: crossTab must be a boolean'`.
|
|
67
|
+
- `namespace` must be a string without `:`, otherwise `throw 'indexedDB: namespace must be a string without ":"'`.
|
|
68
|
+
|
|
69
|
+
### `idb.drop(name) → Promise<void>`
|
|
70
|
+
|
|
71
|
+
Permanently deletes the database.
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
### `DB` — database handle
|
|
76
|
+
|
|
77
|
+
```js
|
|
78
|
+
db.name // → string
|
|
79
|
+
db.version // → number
|
|
80
|
+
db.storeNames // → string[]
|
|
81
|
+
db.close() // closes the connection and the broadcastChannel (if active)
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### `db.store(storeName) → IDBStoreAccessor`
|
|
85
|
+
|
|
86
|
+
Returns an accessor for the named store.
|
|
87
|
+
|
|
88
|
+
### `db.listen` — change notifications
|
|
89
|
+
|
|
90
|
+
Fires after each `set`, `del`, and `clear` on any store.
|
|
91
|
+
|
|
92
|
+
```js
|
|
93
|
+
db.listen.add('myListener', ({ type, store, key, cross }) => {
|
|
94
|
+
// type : 'set' | 'del' | 'clear'
|
|
95
|
+
// store : store name
|
|
96
|
+
// key : IDBValidKey | null (null for 'clear')
|
|
97
|
+
// cross : true if event came from another tab
|
|
98
|
+
console.log(type, store, key);
|
|
99
|
+
});
|
|
100
|
+
|
|
101
|
+
db.listen.del('myListener');
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
### `IDBStoreAccessor` — CRUD methods
|
|
107
|
+
|
|
108
|
+
```js
|
|
109
|
+
const s = db.store('cache');
|
|
110
|
+
|
|
111
|
+
// Read
|
|
112
|
+
const val = await s.get(key); // → * | undefined
|
|
113
|
+
const exists = await s.has(key); // → boolean
|
|
114
|
+
const all = await s.getAll(); // → *[]
|
|
115
|
+
const allKeys = await s.getAllKeys(); // → IDBValidKey[]
|
|
116
|
+
const count = await s.count(); // → number
|
|
117
|
+
|
|
118
|
+
// Write
|
|
119
|
+
const stored = await s.set(key, value); // → IDBValidKey (stored key)
|
|
120
|
+
await s.del(key);
|
|
121
|
+
await s.clear();
|
|
122
|
+
|
|
123
|
+
// Iteration
|
|
124
|
+
await s.each((value, key) => {
|
|
125
|
+
// Return false to stop iteration
|
|
126
|
+
if (key === 'stop') return false;
|
|
127
|
+
console.log(key, value);
|
|
128
|
+
});
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
All `set`, `del`, `clear` methods emit a notification to registered listeners.
|
|
132
|
+
|
|
133
|
+
### Query filtering
|
|
134
|
+
|
|
135
|
+
`getAll`, `getAllKeys`, and `count` accept a `query` (key or `IDBKeyRange`) and an optional max `count`:
|
|
136
|
+
|
|
137
|
+
```js
|
|
138
|
+
await s.getAll(IDBKeyRange.bound('a', 'z'), 10);
|
|
139
|
+
await s.count(IDBKeyRange.lowerBound('prefix_'));
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### Cross-tab change notification
|
|
143
|
+
|
|
144
|
+
Listeners receive `cross: false` for changes in the same tab, `cross: true` for changes from other tabs (via the `broadcastChannel` module).
|
|
145
|
+
|
|
146
|
+
Compatibility: Chrome 54+, Firefox 38+, Safari 15.4+. Silent degradation if `BroadcastChannel` is not available (same-tab only).
|
|
147
|
+
|
|
148
|
+
### Multi-user isolation with `namespace`
|
|
149
|
+
|
|
150
|
+
Use the `namespace` option to isolate BroadcastChannel events between multiple user sessions sharing the same browser (e.g. two authenticated accounts in two tabs):
|
|
151
|
+
|
|
152
|
+
```js
|
|
153
|
+
// Tab A — user 42
|
|
154
|
+
const dbA = await idb.open('myApp', 1, undefined, { namespace: 'user-42' });
|
|
155
|
+
// Channel: 'idb:user-42:myApp'
|
|
156
|
+
|
|
157
|
+
// Tab B — user 99
|
|
158
|
+
const dbB = await idb.open('myApp', 1, undefined, { namespace: 'user-99' });
|
|
159
|
+
// Channel: 'idb:user-99:myApp'
|
|
160
|
+
|
|
161
|
+
// Mutations in A trigger NO callback in B (separate channels)
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
> **Warning**: `namespace` isolates **only** BroadcastChannel broadcasting. IndexedDB store contents share the same database if `name` is identical — data separation between users must be done at a higher level (prefix on `name` or on keys).
|
|
165
|
+
|
|
166
|
+
### Opt-out cross-tab with `crossTab: false`
|
|
167
|
+
|
|
168
|
+
```js
|
|
169
|
+
// No BroadcastChannel created — same-tab events only
|
|
170
|
+
const db = await idb.open('myApp', 1, undefined, { crossTab: false });
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## Examples
|
|
174
|
+
|
|
175
|
+
### Complete — config + listener
|
|
176
|
+
|
|
177
|
+
```js
|
|
178
|
+
const idb = runtime.resolve('indexedDB');
|
|
179
|
+
|
|
180
|
+
// Open with migration and user namespace
|
|
181
|
+
const db = await idb.open('app', 2,
|
|
182
|
+
(db, oldVersion) => {
|
|
183
|
+
if (oldVersion < 1) db.createObjectStore('config');
|
|
184
|
+
if (oldVersion < 2) db.createObjectStore('logs');
|
|
185
|
+
},
|
|
186
|
+
{ namespace: 'user-42' }
|
|
187
|
+
);
|
|
188
|
+
|
|
189
|
+
const config = db.store('config');
|
|
190
|
+
|
|
191
|
+
// CRUD
|
|
192
|
+
await config.set('theme', 'dark');
|
|
193
|
+
await config.set('lang', 'fr');
|
|
194
|
+
|
|
195
|
+
const theme = await config.get('theme'); // 'dark'
|
|
196
|
+
const keys = await config.getAllKeys(); // ['theme', 'lang']
|
|
197
|
+
|
|
198
|
+
// Iterate
|
|
199
|
+
await config.each((val, key) => console.log(key, '=', val));
|
|
200
|
+
|
|
201
|
+
// Listen to changes (including cross-tab, same namespace only)
|
|
202
|
+
db.listen.add('sync', ({ type, store, key, cross }) => {
|
|
203
|
+
if (store === 'config') refreshUI();
|
|
204
|
+
});
|
|
205
|
+
|
|
206
|
+
db.close();
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
## Notes
|
|
210
|
+
|
|
211
|
+
- The `broadcastChannel` module is declared as a dependency: no native `new BroadcastChannel(...)` in this module.
|
|
212
|
+
- If `broadcastChannel.isSupported()` returns `false`, degradation is silent (same-tab only, no error).
|
|
213
|
+
- `namespace` resolves the multi-session BroadcastChannel ambiguity, but does not replace a prefix on `name` or on keys for data separation in the database.
|
|
214
|
+
|
|
215
|
+
## See also
|
|
216
|
+
|
|
217
|
+
- [storage](./storage.md) — localStorage / sessionStorage (synchronous, simple)
|
|
218
|
+
- [broadcastChannel](../net/broadcastChannel.md) — underlying module for cross-tab broadcasting
|
|
219
|
+
- [download](./download.md)
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: remoteStore
|
|
3
|
+
category: dom/fs
|
|
4
|
+
dependencies: [ajax, ws, eventBus]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# remoteStore
|
|
11
|
+
|
|
12
|
+
> Remote key-value store with pluggable HTTP or WebSocket transport and real-time watch.
|
|
13
|
+
|
|
14
|
+
**Module** `remoteStore` | **Source** `packages/front/fw/src/dom/fs/remoteStore.js` | **Deps** `ajax`, `ws`, `eventBus` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
The module exposes a single `create(opts)` method that returns a remote store instance.
|
|
17
|
+
Two transports are available: `'http'` (default, independent requests with 1 network retry)
|
|
18
|
+
and `'ws'` (persistent JSON-RPC connection, exponential reconnect, real-time watch).
|
|
19
|
+
|
|
20
|
+
Conflict resolution is out of scope — delegated to `sde_task_sync`.
|
|
21
|
+
|
|
22
|
+
## Resolve
|
|
23
|
+
|
|
24
|
+
```js
|
|
25
|
+
const remoteStore = runtime.resolve('remoteStore');
|
|
26
|
+
// Returns: { create }
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## API
|
|
30
|
+
|
|
31
|
+
### `remoteStore.create(opts)`
|
|
32
|
+
|
|
33
|
+
| Option | Type | Default | Description |
|
|
34
|
+
|--------|------|--------|-------------|
|
|
35
|
+
| `endpoint` | `string` | — | HTTP or WebSocket base URL (required). |
|
|
36
|
+
| `auth` | `string` | — | Bearer token (HTTP) or initial auth (WS). |
|
|
37
|
+
| `transport` | `'http'\|'ws'` | `'http'` | Transport to use. |
|
|
38
|
+
| `headers` | `object` | `{}` | Additional HTTP headers (HTTP only). |
|
|
39
|
+
|
|
40
|
+
Returns a `RemoteStoreInstance`.
|
|
41
|
+
|
|
42
|
+
### Instance — methods
|
|
43
|
+
|
|
44
|
+
| Method | Signature | Returns |
|
|
45
|
+
|---------|-----------|---------|
|
|
46
|
+
| `get(key)` | `(string) => Promise<value \| null>` | Value or `null` if absent (404). |
|
|
47
|
+
| `set(key, value)` | `(string, any) => Promise<void>` | Resolves when write is confirmed. |
|
|
48
|
+
| `delete(key)` | `(string) => Promise<void>` | Resolves when deletion is confirmed. |
|
|
49
|
+
| `list(params?)` | `({ prefix?, limit?, cursor? }) => Promise<{ keys, cursor? }>` | Cursor-based pagination. |
|
|
50
|
+
| `batch(ops)` | `(Array<{op, key, value?}>) => Promise<void>` | Batch of operations (see semantics below). |
|
|
51
|
+
| `watch(pattern, fn)` | `(string, Function) => off` | WS only — real-time changes. |
|
|
52
|
+
| `connected()` | `() => boolean` | `true` if the connection is active. |
|
|
53
|
+
| `close()` | `() => void` | Permanently closes the store. |
|
|
54
|
+
|
|
55
|
+
### `batch` — HTTP vs WS semantics
|
|
56
|
+
|
|
57
|
+
| Transport | Behavior |
|
|
58
|
+
|-----------|--------------|
|
|
59
|
+
| **HTTP** | Single POST `/batch` with `{ ops: [...] }`. Operations are executed server-side without atomicity guarantee. On network error, 1 automatic retry. |
|
|
60
|
+
| **WS** | Single RPC message `{ op: 'batch', ops: [...], id }`. Atomicity is guaranteed server-side (all or nothing). |
|
|
61
|
+
|
|
62
|
+
### `watch(pattern, fn)` — WS only
|
|
63
|
+
|
|
64
|
+
Supported patterns: `'*'` (all keys), `'prefix:*'` (prefix), `'exact:key'` (exact).
|
|
65
|
+
Returns an `off()` function to unsubscribe.
|
|
66
|
+
|
|
67
|
+
In HTTP mode, `watch` immediately returns a no-op `off` function without triggering an error.
|
|
68
|
+
|
|
69
|
+
## Examples
|
|
70
|
+
|
|
71
|
+
### Basic HTTP usage
|
|
72
|
+
|
|
73
|
+
```js
|
|
74
|
+
const remoteStore = runtime.resolve('remoteStore');
|
|
75
|
+
const store = remoteStore.create({
|
|
76
|
+
endpoint: 'https://api.example.com/store',
|
|
77
|
+
auth: 'my-bearer-token'
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
await store.set('user:1', { name: 'Alice', role: 'admin' });
|
|
81
|
+
const user = await store.get('user:1');
|
|
82
|
+
// { name: 'Alice', role: 'admin' }
|
|
83
|
+
|
|
84
|
+
const listing = await store.list({ prefix: 'user:', limit: 50 });
|
|
85
|
+
// { keys: ['user:1', ...], cursor: '...' }
|
|
86
|
+
|
|
87
|
+
await store.delete('user:1');
|
|
88
|
+
store.close();
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### WebSocket usage with watch
|
|
92
|
+
|
|
93
|
+
```js
|
|
94
|
+
const remoteStore = runtime.resolve('remoteStore');
|
|
95
|
+
const store = remoteStore.create({
|
|
96
|
+
endpoint: 'wss://api.example.com/store',
|
|
97
|
+
transport: 'ws',
|
|
98
|
+
auth: 'my-bearer-token'
|
|
99
|
+
});
|
|
100
|
+
|
|
101
|
+
// Watch session changes in real time
|
|
102
|
+
const off = store.watch('sess:*', ({ key, value }) => {
|
|
103
|
+
console.log('Session changed:', key, value);
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
await store.set('sess:abc', { userId: 42 });
|
|
107
|
+
// → handler called: { op: 'change', key: 'sess:abc', value: { userId: 42 } }
|
|
108
|
+
|
|
109
|
+
off(); // unsubscribe
|
|
110
|
+
store.close();
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Atomic WS batch
|
|
114
|
+
|
|
115
|
+
```js
|
|
116
|
+
const store = remoteStore.create({ endpoint: 'wss://api.example.com/store', transport: 'ws' });
|
|
117
|
+
await store.batch([
|
|
118
|
+
{ op: 'set', key: 'counter', value: 0 },
|
|
119
|
+
{ op: 'set', key: 'status', value: 'active' },
|
|
120
|
+
{ op: 'delete', key: 'stale' }
|
|
121
|
+
]);
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Worker Usage
|
|
125
|
+
|
|
126
|
+
```js
|
|
127
|
+
const worker = fw.createWorker(
|
|
128
|
+
function ({ libs, args, process }) {
|
|
129
|
+
const store = libs.remoteStore.create({
|
|
130
|
+
endpoint: args[0],
|
|
131
|
+
transport: 'ws',
|
|
132
|
+
auth: args[1]
|
|
133
|
+
});
|
|
134
|
+
store.get('config').then(v => {
|
|
135
|
+
store.close();
|
|
136
|
+
self.postMessage(v);
|
|
137
|
+
});
|
|
138
|
+
},
|
|
139
|
+
{ dependencies: ['remoteStore'], args: ['wss://api.example.com/store', 'token'] }
|
|
140
|
+
);
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## Notes
|
|
144
|
+
|
|
145
|
+
- In HTTP mode, `connected()` always returns `true` — there is no persistent connection.
|
|
146
|
+
- In WS mode, pending RPCs are automatically rejected if the connection closes; they are not re-emitted after reconnection (the caller must retry).
|
|
147
|
+
- WS reconnection uses exponential backoff capped at 30 s; each attempt emits `'remoteStore:reconnect'` on `eventBus` with `{ endpoint, attempt }`.
|
|
148
|
+
- `batch` semantics differ by transport: best-effort sequential in HTTP, atomic in WS.
|
|
149
|
+
- `watch` is only functional in `'ws'` mode; in `'http'` mode it returns a no-op `off` function.
|
|
150
|
+
- The `encoding: 'cbor'` option is reserved for a future integration of the `cbor` module; MVP = JSON only.
|
|
151
|
+
|
|
152
|
+
## See also
|
|
153
|
+
|
|
154
|
+
- [ajax](../net/ajax.md) — underlying HTTP transport
|
|
155
|
+
- [ws](../net/ws.md) — underlying WebSocket transport
|
|
156
|
+
- [eventBus](../../io/utils/eventBus.md) — `remoteStore:reconnect` events
|
|
157
|
+
- [indexedDB](./indexedDB.md) — local key-value persistence
|
|
158
|
+
- [storage](./storage.md) — localStorage / sessionStorage
|