@awacloud/fw 0.1.0 → 1.0.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 +125 -0
- package/NOTICE +8 -0
- package/README.md +163 -31
- package/dist/build/fw.core.pure.meta.json +6 -6
- package/dist/build/fw.core.pure.min.js +15 -12
- package/dist/build/fw.full.pure.meta.json +13 -7
- package/dist/build/fw.full.pure.min.js +45 -42
- package/dist/build/fw.minimal.pure.meta.json +6 -6
- package/dist/build/fw.minimal.pure.min.js +16 -13
- package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
- package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
- package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
- package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
- package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
- package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
- package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
- package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
- package/dist/build/fw.pwa.pure.meta.json +7 -6
- package/dist/build/fw.pwa.pure.min.js +38 -35
- package/dist/build/fw.site-interactive.pure.meta.json +6 -6
- package/dist/build/fw.site-interactive.pure.min.js +37 -34
- package/dist/build/fw.site.pure.meta.json +6 -6
- package/dist/build/fw.site.pure.min.js +24 -21
- package/dist/build/fw.spa.pure.meta.json +8 -7
- package/dist/build/fw.spa.pure.min.js +41 -38
- package/dist/build/sanity-base-classic.min.js +1 -1
- package/dist/build/sanity.min.js +1 -1
- package/dist/types/core/internal.d.ts +29 -0
- package/dist/types/core/internal.d.ts.map +1 -0
- package/dist/types/core/logger.d.ts +23 -4
- package/dist/types/core/logger.d.ts.map +1 -1
- package/dist/types/core/modules.d.ts +374 -61
- package/dist/types/core/modules.d.ts.map +1 -1
- package/dist/types/core/runtime.d.ts +10 -6
- package/dist/types/core/runtime.d.ts.map +1 -1
- package/dist/types/core/worker-helper.d.ts +35 -0
- package/dist/types/core/worker-helper.d.ts.map +1 -1
- package/dist/types/crypto/cipher/aes.d.ts +1 -7
- package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
- package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
- package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
- package/dist/types/crypto/hash/argon2.d.ts +0 -15
- package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
- package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
- package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
- package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
- package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha224.d.ts +1 -1
- package/dist/types/crypto/hash/sha256.d.ts +4 -13
- package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha384.d.ts +1 -1
- package/dist/types/crypto/hash/sha512.d.ts +4 -13
- package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
- package/dist/types/crypto/mode/cmac.d.ts +0 -6
- package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
- package/dist/types/crypto/mode/ctr.d.ts +0 -6
- package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
- package/dist/types/crypto/mode/gcm.d.ts +0 -9
- package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ecc.d.ts +0 -1
- package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
- package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
- package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
- package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
- package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
- package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
- package/dist/types/crypto/pkc/rsa.d.ts +0 -24
- package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
- package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/x25519.d.ts +0 -6
- package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
- package/dist/types/crypto/utils/bitArray.d.ts +0 -8
- package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
- package/dist/types/crypto/utils/jws.d.ts +6 -14
- package/dist/types/crypto/utils/jws.d.ts.map +1 -1
- package/dist/types/crypto/utils/keyformat.d.ts +52 -0
- package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
- package/dist/types/crypto/utils/random.d.ts +1 -10
- package/dist/types/crypto/utils/random.d.ts.map +1 -1
- package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
- package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
- package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
- package/dist/types/crypto/utils/x509.d.ts +397 -0
- package/dist/types/crypto/utils/x509.d.ts.map +1 -0
- package/dist/types/crypto/wasm/argon2.d.ts +2 -1
- package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
- package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
- package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
- package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
- package/dist/types/crypto/wasm/runtime.d.ts +13 -0
- package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
- package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
- package/dist/types/dom/fs/fileIntake.d.ts +59 -0
- package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
- package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
- package/dist/types/dom/query/dnd.d.ts.map +1 -1
- package/dist/types/dom/query/sound.d.ts +89 -0
- package/dist/types/dom/query/sound.d.ts.map +1 -0
- package/dist/types/dom/rendering/chart.d.ts.map +1 -1
- package/dist/types/dom/rendering/component.d.ts +9 -3
- package/dist/types/dom/rendering/component.d.ts.map +1 -1
- package/dist/types/dom/rendering/parser.d.ts +39 -0
- package/dist/types/dom/rendering/parser.d.ts.map +1 -1
- package/dist/types/dom/rendering/render.d.ts.map +1 -1
- package/dist/types/dom/rendering/sanitize.d.ts +4 -0
- package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
- package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
- package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
- package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
- package/dist/types/dom/rendering/template.d.ts +9 -3
- package/dist/types/dom/rendering/template.d.ts.map +1 -1
- package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
- package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
- package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
- package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession.d.ts +18 -6
- package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
- package/dist/types/dom/sw/installPrompt.d.ts +89 -0
- package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
- package/dist/types/dom/sw/precache.d.ts +149 -0
- package/dist/types/dom/sw/precache.d.ts.map +1 -0
- package/dist/types/dom/sw/swUpdate.d.ts +129 -0
- package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
- package/dist/types/dom/utils/clipboard.d.ts +8 -0
- package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
- package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
- package/dist/types/dom/utils/route.d.ts.map +1 -1
- package/dist/types/dom/utils/ua.d.ts +2 -2
- package/dist/types/dom/utils/ua.d.ts.map +1 -1
- package/dist/types/io/calc/crc32.d.ts.map +1 -1
- package/dist/types/io/codec/b64.d.ts +24 -0
- package/dist/types/io/codec/b64.d.ts.map +1 -1
- package/dist/types/io/codec/cbor.d.ts +1 -0
- package/dist/types/io/codec/cbor.d.ts.map +1 -1
- package/dist/types/io/codec/hex.d.ts.map +1 -1
- package/dist/types/io/codec/msgpack.d.ts +1 -0
- package/dist/types/io/codec/msgpack.d.ts.map +1 -1
- package/dist/types/io/codec/url.d.ts +3 -1
- package/dist/types/io/codec/url.d.ts.map +1 -1
- package/dist/types/io/codec/utf8.d.ts.map +1 -1
- package/dist/types/io/compress/bitstream.d.ts +1 -1
- package/dist/types/io/compress/brotli.d.ts +0 -1
- package/dist/types/io/compress/brotli.d.ts.map +1 -1
- package/dist/types/io/compress/brotli_shared.d.ts +0 -4
- package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
- package/dist/types/io/compress/deflate.d.ts +14 -1
- package/dist/types/io/compress/deflate.d.ts.map +1 -1
- package/dist/types/io/compress/gzip.d.ts +4 -0
- package/dist/types/io/compress/gzip.d.ts.map +1 -1
- package/dist/types/io/compress/huffman.d.ts +7 -0
- package/dist/types/io/compress/huffman.d.ts.map +1 -1
- package/dist/types/io/compress/lz4.d.ts +4 -2
- package/dist/types/io/compress/lz4.d.ts.map +1 -1
- package/dist/types/io/compress/lz77.d.ts +17 -0
- package/dist/types/io/compress/lz77.d.ts.map +1 -1
- package/dist/types/io/compress/lzw.d.ts +2 -0
- package/dist/types/io/compress/lzw.d.ts.map +1 -1
- package/dist/types/io/compress/zip.d.ts.map +1 -1
- package/dist/types/io/compress/zlib.d.ts +9 -2
- package/dist/types/io/compress/zlib.d.ts.map +1 -1
- package/dist/types/io/math/linalg.d.ts.map +1 -1
- package/dist/types/process/rpc.d.ts.map +1 -1
- package/dist/types/process/workerPool.d.ts.map +1 -1
- package/dist/types/sanity/base.d.ts +12 -2
- package/dist/types/sanity/base.d.ts.map +1 -1
- package/dist/types/sanity/lockdown.d.ts +6 -5
- package/dist/types/sanity/lockdown.d.ts.map +1 -1
- package/dist/types/sanity/wasm-gate.d.ts +1 -1
- package/docs/README.md +17 -10
- package/docs/api/README.md +5 -5
- package/docs/api/core/logger.md +2 -1
- package/docs/api/core/modules.md +3 -3
- package/docs/api/core/runtime.md +9 -9
- package/docs/api/core/worker-helper.md +12 -2
- package/docs/api/crypto/README.md +1 -1
- package/docs/api/crypto/cipher/README.md +2 -2
- package/docs/api/crypto/cipher/aes.md +5 -10
- package/docs/api/crypto/cipher/chacha20.md +3 -8
- package/docs/api/crypto/hash/README.md +5 -5
- package/docs/api/crypto/hash/adf.md +21 -11
- package/docs/api/crypto/hash/argon2.md +3 -12
- package/docs/api/crypto/hash/blake2b.md +12 -14
- package/docs/api/crypto/hash/pbkdf2.md +1 -1
- package/docs/api/crypto/hash/sha224.md +2 -2
- package/docs/api/crypto/hash/sha256.md +4 -4
- package/docs/api/crypto/hash/sha3.md +2 -2
- package/docs/api/crypto/hash/sha384.md +1 -1
- package/docs/api/crypto/hash/sha512.md +5 -5
- package/docs/api/crypto/hash/sha512_224.md +1 -1
- package/docs/api/crypto/hash/sha512_256.md +1 -1
- package/docs/api/crypto/mode/README.md +3 -3
- package/docs/api/crypto/mode/cbc.md +2 -2
- package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
- package/docs/api/crypto/mode/cmac.md +4 -4
- package/docs/api/crypto/mode/ctr.md +2 -3
- package/docs/api/crypto/mode/gcm.md +5 -5
- package/docs/api/crypto/mode/kw.md +4 -4
- package/docs/api/crypto/pkc/README.md +8 -8
- package/docs/api/crypto/pkc/ecc.md +19 -17
- package/docs/api/crypto/pkc/ed25519.md +10 -15
- package/docs/api/crypto/pkc/hybridKem.md +8 -2
- package/docs/api/crypto/pkc/hybridSign.md +34 -7
- package/docs/api/crypto/pkc/ml_dsa.md +20 -19
- package/docs/api/crypto/pkc/ml_kem.md +3 -3
- package/docs/api/crypto/pkc/rsa.md +7 -9
- package/docs/api/crypto/pkc/slh_dsa.md +12 -12
- package/docs/api/crypto/pkc/x25519.md +5 -4
- package/docs/api/crypto/utils/README.md +7 -7
- package/docs/api/crypto/utils/aes_modes.md +2 -5
- package/docs/api/crypto/utils/asn1.md +25 -16
- package/docs/api/crypto/utils/jws.md +6 -4
- package/docs/api/crypto/utils/keyformat.md +24 -15
- package/docs/api/crypto/utils/pad.md +1 -1
- package/docs/api/crypto/utils/pem.md +3 -3
- package/docs/api/crypto/utils/random.md +3 -4
- package/docs/api/crypto/utils/rsaKeygen.md +2 -2
- package/docs/api/crypto/utils/totp.md +2 -2
- package/docs/api/crypto/utils/uuid.md +5 -5
- package/docs/api/crypto/utils/x509.md +124 -0
- package/docs/api/crypto/wasm/aes.md +1 -1
- package/docs/api/crypto/wasm/argon2.md +6 -4
- package/docs/api/crypto/wasm/ml_kem.md +1 -0
- package/docs/api/crypto/wasm/pbkdf2.md +8 -8
- package/docs/api/crypto/wasm/rsa.md +1 -1
- package/docs/api/crypto/wasm/runtime.md +27 -10
- package/docs/api/crypto/webcrypto/aes.md +1 -1
- package/docs/api/crypto/webcrypto/aeskw.md +2 -2
- package/docs/api/crypto/webcrypto/digest.md +3 -5
- package/docs/api/crypto/webcrypto/ecc.md +1 -1
- package/docs/api/crypto/webcrypto/ed25519.md +1 -1
- package/docs/api/crypto/webcrypto/rsa.md +3 -2
- package/docs/api/crypto/webcrypto/x25519.md +1 -1
- package/docs/api/dom/README.md +6 -1
- package/docs/api/dom/fs/README.md +1 -0
- package/docs/api/dom/fs/fileIntake.md +120 -0
- package/docs/api/dom/fs/fsAccess.md +1 -0
- package/docs/api/dom/fs/indexedDB.md +1 -1
- package/docs/api/dom/fs/storage.md +1 -1
- package/docs/api/dom/query/README.md +2 -1
- package/docs/api/dom/query/dnd.md +4 -1
- package/docs/api/dom/query/dom.md +5 -0
- package/docs/api/dom/query/sound.md +103 -0
- package/docs/api/dom/rendering/README.md +4 -3
- package/docs/api/dom/rendering/chart.md +5 -4
- package/docs/api/dom/rendering/component.md +25 -3
- package/docs/api/dom/rendering/parser.md +5 -2
- package/docs/api/dom/rendering/reactiveBind.md +1 -1
- package/docs/api/dom/rendering/render.md +2 -2
- package/docs/api/dom/rendering/sanitize.md +10 -2
- package/docs/api/dom/rendering/secPolicy.md +4 -4
- package/docs/api/dom/rendering/styleSheet.md +85 -0
- package/docs/api/dom/rendering/template.md +20 -5
- package/docs/api/dom/rendering/themeTokens.md +6 -3
- package/docs/api/dom/rendering/uiSession.md +18 -5
- package/docs/api/dom/rendering/virtualScroll.md +2 -2
- package/docs/api/dom/sensors/geolocation.md +1 -1
- package/docs/api/dom/sw/README.md +7 -1
- package/docs/api/dom/sw/cache.md +2 -1
- package/docs/api/dom/sw/installPrompt.md +111 -0
- package/docs/api/dom/sw/precache.md +124 -0
- package/docs/api/dom/sw/serviceWorker.md +4 -2
- package/docs/api/dom/sw/swUpdate.md +112 -0
- package/docs/api/dom/utils/clipboard.md +56 -5
- package/docs/api/dom/utils/entropyCollector.md +1 -1
- package/docs/api/dom/utils/keybindings.md +17 -2
- package/docs/api/dom/utils/leaderElection.md +2 -2
- package/docs/api/dom/utils/route.md +1 -0
- package/docs/api/dom/utils/ua.md +15 -10
- package/docs/api/io/calc/crc32.md +4 -1
- package/docs/api/io/codec/README.md +2 -2
- package/docs/api/io/codec/b64.md +31 -2
- package/docs/api/io/codec/buffer.md +1 -1
- package/docs/api/io/codec/cbor.md +6 -4
- package/docs/api/io/codec/csv.md +178 -178
- package/docs/api/io/codec/hex.md +10 -2
- package/docs/api/io/codec/msgpack.md +4 -3
- package/docs/api/io/codec/url.md +4 -3
- package/docs/api/io/codec/utf8.md +3 -3
- package/docs/api/io/compress/bitstream.md +6 -3
- package/docs/api/io/compress/brotli.md +36 -4
- package/docs/api/io/compress/brotli_shared.md +1 -1
- package/docs/api/io/compress/deflate.md +42 -34
- package/docs/api/io/compress/gzip.md +26 -6
- package/docs/api/io/compress/huffman.md +2 -1
- package/docs/api/io/compress/lz4.md +5 -3
- package/docs/api/io/compress/lz77.md +26 -3
- package/docs/api/io/compress/lzw.md +13 -8
- package/docs/api/io/compress/zip.md +36 -10
- package/docs/api/io/compress/zlib.md +21 -5
- package/docs/api/io/math/linalg.md +1 -1
- package/docs/api/io/utils/valid.md +1 -1
- package/docs/api/process/rpc.md +3 -2
- package/docs/api/process/workerPool.md +1 -1
- package/docs/api/sanity/base.md +9 -5
- package/docs/api/sanity/lockdown.md +7 -6
- package/docs/api/surface.json +12311 -0
- package/docs/api/typed.md +5 -3
- package/docs/dev/README.md +2 -0
- package/docs/dev/bench.md +76 -0
- package/docs/dev/crypto-references.md +54 -0
- package/docs/dev/provenance.md +30 -7
- package/docs/dev/publishing.md +7 -7
- package/docs/dev/runtime.md +1 -1
- package/docs/dev/testing.md +13 -0
- package/docs/evidence/l4-evidence.md +86 -0
- package/docs/evidence/pqc-hybrid-evidence.md +7 -6
- package/docs/guide/README.md +1 -0
- package/docs/guide/_QUICK_REF.md +5 -5
- package/docs/guide/doc-format.md +4 -3
- package/docs/guide/integrations-hmr.md +1 -1
- package/docs/guide/module-creation-workflow.md +8 -8
- package/docs/guide/rendering-pipeline.md +11 -4
- package/docs/guide/security.md +7 -5
- package/docs/guide/stability.md +123 -0
- package/docs/guide/tutorial-todo.md +20 -8
- package/docs/guide/typescript.md +9 -0
- package/docs/guide/worker-confinement.md +30 -17
- package/docs/notes/lz77-deflate-factorization.md +3 -3
- package/docs/tools/README.md +1 -1
- package/docs/tools/bundler.md +3 -3
- package/docs/tools/codegen.md +1 -1
- package/docs/tools/standalone.md +0 -1
- package/fw.config.json +2 -2
- package/integrations/_shared/catalog.generated.json +7 -1
- package/integrations/_shared/core.js +1 -1
- package/integrations/astro/index.js +1 -1
- package/integrations/eslint/README.md +7 -1
- package/integrations/nextjs/index.js +1 -1
- package/integrations/nodejs/README.md +3 -3
- package/integrations/turbopack/index.js +2 -2
- package/integrations/typedoc/categorize.js +1 -1
- package/integrations/typedoc/typedoc.json +2 -1
- package/integrations/vite/index.js +2 -2
- package/integrations/vite/vite-env.d.ts +7 -4
- package/integrations/webpack/index.js +3 -3
- package/package.json +76 -10
- package/src/core/internal.js +31 -0
- package/src/core/logger.js +95 -23
- package/src/core/modules.js +17 -8
- package/src/core/readyState.js +1 -1
- package/src/core/runtime.js +74 -27
- package/src/core/worker-helper.js +83 -4
- package/src/crypto/NIST_CONFORMANCE.md +47 -34
- package/src/crypto/cipher/aes.acvp.md +7 -8
- package/src/crypto/cipher/aes.js +280 -229
- package/src/crypto/cipher/chacha20.acvp.md +6 -7
- package/src/crypto/cipher/chacha20.js +91 -61
- package/src/crypto/hash/adf.js +1 -1
- package/src/crypto/hash/argon2.acvp.md +11 -15
- package/src/crypto/hash/argon2.js +9 -24
- package/src/crypto/hash/blake2b.js +157 -125
- package/src/crypto/hash/hkdf.acvp.md +15 -15
- package/src/crypto/hash/hkdf.js +1 -1
- package/src/crypto/hash/hmac.acvp.md +10 -12
- package/src/crypto/hash/hmac.js +5 -1
- package/src/crypto/hash/pbkdf2.acvp.md +13 -13
- package/src/crypto/hash/pbkdf2.js +36 -8
- package/src/crypto/hash/poly1305.acvp.md +10 -6
- package/src/crypto/hash/poly1305.js +171 -50
- package/src/crypto/hash/sha224.acvp.md +3 -3
- package/src/crypto/hash/sha224.js +4 -4
- package/src/crypto/hash/sha256.acvp.md +2 -2
- package/src/crypto/hash/sha256.js +514 -50
- package/src/crypto/hash/sha3.acvp.md +9 -9
- package/src/crypto/hash/sha3.js +127 -71
- package/src/crypto/hash/sha384.acvp.md +3 -3
- package/src/crypto/hash/sha384.js +4 -4
- package/src/crypto/hash/sha512.acvp.md +7 -8
- package/src/crypto/hash/sha512.js +107 -108
- package/src/crypto/hash/sha512_224.acvp.md +6 -6
- package/src/crypto/hash/sha512_224.js +2 -2
- package/src/crypto/hash/sha512_256.acvp.md +6 -6
- package/src/crypto/hash/sha512_256.js +2 -2
- package/src/crypto/mode/cbc.acvp.md +2 -2
- package/src/crypto/mode/cbc.js +1 -1
- package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
- package/src/crypto/mode/chacha20poly1305.js +3 -3
- package/src/crypto/mode/cmac.acvp.md +5 -5
- package/src/crypto/mode/cmac.js +8 -8
- package/src/crypto/mode/ctr.acvp.md +2 -2
- package/src/crypto/mode/ctr.js +1 -3
- package/src/crypto/mode/gcm.acvp.md +6 -6
- package/src/crypto/mode/gcm.js +7 -7
- package/src/crypto/mode/kw.acvp.md +4 -4
- package/src/crypto/mode/kw.js +5 -5
- package/src/crypto/pkc/ecc.acvp.md +13 -13
- package/src/crypto/pkc/ecc.js +9 -11
- package/src/crypto/pkc/ed25519.acvp.md +30 -34
- package/src/crypto/pkc/ed25519.js +453 -94
- package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
- package/src/crypto/pkc/hybridSign.js +103 -24
- package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
- package/src/crypto/pkc/ml_dsa.js +29 -32
- package/src/crypto/pkc/ml_kem.acvp.md +7 -7
- package/src/crypto/pkc/ml_kem.js +15 -21
- package/src/crypto/pkc/rsa.acvp.md +11 -15
- package/src/crypto/pkc/rsa.js +7 -44
- package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
- package/src/crypto/pkc/slh_dsa.js +16 -18
- package/src/crypto/pkc/x25519.acvp.md +13 -10
- package/src/crypto/pkc/x25519.js +273 -29
- package/src/crypto/utils/aes_modes.acvp.md +1 -2
- package/src/crypto/utils/aes_modes.js +2 -2
- package/src/crypto/utils/asn1-oid.js +1 -1
- package/src/crypto/utils/asn1.js +1 -1
- package/src/crypto/utils/bitArray.js +33 -48
- package/src/crypto/utils/bn.js +1 -1
- package/src/crypto/utils/jws.js +37 -41
- package/src/crypto/utils/keyformat.js +181 -2
- package/src/crypto/utils/pem.js +1 -1
- package/src/crypto/utils/random.acvp.md +5 -5
- package/src/crypto/utils/random.js +845 -846
- package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
- package/src/crypto/utils/rsaKeygen.js +6 -6
- package/src/crypto/utils/totp.js +1 -1
- package/src/crypto/utils/uuid.acvp.md +5 -5
- package/src/crypto/utils/uuid.js +11 -10
- package/src/crypto/utils/x509.js +591 -0
- package/src/crypto/wasm/aes.js +1 -1
- package/src/crypto/wasm/aes.scalar.wasm +0 -0
- package/src/crypto/wasm/argon2.js +17 -1
- package/src/crypto/wasm/argon2.scalar.wasm +0 -0
- package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
- package/src/crypto/wasm/blake2b.simd.wasm +0 -0
- package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
- package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
- package/src/crypto/wasm/cmac.scalar.wasm +0 -0
- package/src/crypto/wasm/ecc.js +3 -3
- package/src/crypto/wasm/ecc.scalar.wasm +0 -0
- package/src/crypto/wasm/ed25519.js +1 -1
- package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
- package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
- package/src/crypto/wasm/hmac.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_dsa.js +2 -2
- package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
- package/src/crypto/wasm/ml_kem.js +2 -2
- package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
- package/src/crypto/wasm/pbkdf2.js +8 -6
- package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
- package/src/crypto/wasm/rsa.js +6 -5
- package/src/crypto/wasm/rsa.scalar.wasm +0 -0
- package/src/crypto/wasm/runtime.js +84 -17
- package/src/crypto/wasm/sha2.scalar.wasm +0 -0
- package/src/crypto/wasm/sha3.scalar.wasm +0 -0
- package/src/crypto/wasm/sha3.simd.wasm +0 -0
- package/src/crypto/wasm/slh_dsa.js +1 -1
- package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
- package/src/crypto/wasm/x25519.js +1 -1
- package/src/crypto/wasm/x25519.scalar.wasm +0 -0
- package/src/crypto/webcrypto/aes.js +8 -2
- package/src/crypto/webcrypto/aeskw.js +7 -2
- package/src/crypto/webcrypto/digest.js +1 -15
- package/src/crypto/webcrypto/ecc.js +2 -2
- package/src/crypto/webcrypto/ed25519.js +2 -2
- package/src/crypto/webcrypto/hmac.js +2 -2
- package/src/crypto/webcrypto/rsa.js +7 -2
- package/src/crypto/webcrypto/x25519.js +2 -2
- package/src/dom/display/animate.js +1 -1
- package/src/dom/display/fullscreen.js +1 -1
- package/src/dom/fs/download.js +1 -1
- package/src/dom/fs/fileIntake.js +192 -0
- package/src/dom/fs/fsAccess.js +2 -3
- package/src/dom/fs/indexedDB.js +1 -1
- package/src/dom/fs/remoteStore.js +1 -1
- package/src/dom/fs/storage.js +1 -1
- package/src/dom/lifecycle/idle.js +1 -1
- package/src/dom/lifecycle/visibility.js +1 -1
- package/src/dom/lifecycle/wakeLock.js +1 -1
- package/src/dom/net/ajax.js +1 -1
- package/src/dom/net/network.js +1 -1
- package/src/dom/net/sse.js +1 -1
- package/src/dom/net/webrtc.js +1 -1
- package/src/dom/net/ws.js +1 -1
- package/src/dom/query/dnd.js +56 -4
- package/src/dom/query/dom.js +1 -1
- package/src/dom/query/events.js +1 -1
- package/src/dom/query/gesture.js +1 -1
- package/src/dom/query/media.js +1 -1
- package/src/dom/query/sound.js +333 -0
- package/src/dom/rendering/chart.js +736 -663
- package/src/dom/rendering/component.js +25 -14
- package/src/dom/rendering/devtools.js +2 -2
- package/src/dom/rendering/parser.js +155 -12
- package/src/dom/rendering/render.js +14 -4
- package/src/dom/rendering/sanitize.js +11 -4
- package/src/dom/rendering/secPolicy.js +6 -4
- package/src/dom/rendering/styleSheet.js +217 -0
- package/src/dom/rendering/template.js +72 -13
- package/src/dom/rendering/themeTokens.js +542 -522
- package/src/dom/rendering/uiSession-core.js +51 -6
- package/src/dom/rendering/uiSession-direct.js +1 -1
- package/src/dom/rendering/uiSession-list.js +4 -4
- package/src/dom/rendering/uiSession.js +1 -1
- package/src/dom/rendering/virtualScroll.js +341 -341
- package/src/dom/sensors/battery.js +1 -1
- package/src/dom/sensors/geolocation.js +1 -1
- package/src/dom/sensors/networkInfo.js +1 -1
- package/src/dom/sensors/sensors.js +1 -1
- package/src/dom/sw/backgroundSync.js +1 -1
- package/src/dom/sw/cache.js +1 -1
- package/src/dom/sw/installPrompt.js +151 -0
- package/src/dom/sw/precache.js +257 -0
- package/src/dom/sw/push.js +1 -1
- package/src/dom/sw/sharedWorker.js +1 -1
- package/src/dom/sw/swUpdate.js +239 -0
- package/src/dom/utils/a11y.js +1 -1
- package/src/dom/utils/clipboard.js +56 -6
- package/src/dom/utils/entropyCollector.js +1 -1
- package/src/dom/utils/focus.js +1 -1
- package/src/dom/utils/form.js +1 -1
- package/src/dom/utils/keybindings.js +600 -574
- package/src/dom/utils/leaderElection.js +1 -1
- package/src/dom/utils/notifications.js +1 -1
- package/src/dom/utils/permissions.js +107 -107
- package/src/dom/utils/route.js +14 -2
- package/src/dom/utils/ua.js +42 -28
- package/src/dom/utils/webauthn.js +1 -1
- package/src/io/binary/reader.js +1 -1
- package/src/io/binary/writer.js +1 -1
- package/src/io/calc/bigint.js +1 -1
- package/src/io/calc/crc32.js +28 -2
- package/src/io/calc/easing.js +514 -514
- package/src/io/codec/b64.js +189 -52
- package/src/io/codec/base32.js +1 -1
- package/src/io/codec/base58.js +1 -1
- package/src/io/codec/buffer.js +1 -1
- package/src/io/codec/cbor.js +111 -18
- package/src/io/codec/csv.js +1 -1
- package/src/io/codec/hex.js +51 -6
- package/src/io/codec/mime.js +1 -1
- package/src/io/codec/msgpack.js +47 -6
- package/src/io/codec/url.js +24 -7
- package/src/io/codec/utf8.js +5 -3
- package/src/io/codec/xml.js +1 -1
- package/src/io/compress/bitstream.js +2 -2
- package/src/io/compress/brotli.js +663 -163
- package/src/io/compress/brotli_dict.js +1 -1
- package/src/io/compress/brotli_dict_words.js +1 -1
- package/src/io/compress/brotli_frame.js +1 -1
- package/src/io/compress/brotli_shared.js +7 -7
- package/src/io/compress/deflate.js +87 -53
- package/src/io/compress/gzip.js +187 -74
- package/src/io/compress/huffman.js +24 -1
- package/src/io/compress/lz4.js +45 -7
- package/src/io/compress/lz77.js +148 -63
- package/src/io/compress/lzw.js +35 -19
- package/src/io/compress/zip.js +862 -815
- package/src/io/compress/zlib.js +87 -7
- package/src/io/i18n/i18n.js +1 -1
- package/src/io/math/fixed-point.js +1 -1
- package/src/io/math/geom.js +1 -1
- package/src/io/math/interp.js +1 -1
- package/src/io/math/linalg.js +10 -4
- package/src/io/math/stats.js +1 -1
- package/src/io/structures/btree.js +1 -1
- package/src/io/structures/heap.js +1 -1
- package/src/io/structures/lruCache.js +1 -1
- package/src/io/structures/ringBuffer.js +1 -1
- package/src/io/structures/tree-walker.js +1 -1
- package/src/io/structures/trie.js +1 -1
- package/src/io/sync/abort.js +1 -1
- package/src/io/sync/atomics.js +1 -1
- package/src/io/sync/cancellable.js +1 -1
- package/src/io/sync/channel.js +1 -1
- package/src/io/sync/mutex.js +1 -1
- package/src/io/sync/semaphore.js +1 -1
- package/src/io/sync/tokenBucket.js +1 -1
- package/src/io/text/ansi.js +1 -1
- package/src/io/text/html-entities.js +1 -1
- package/src/io/time/date.js +1 -1
- package/src/io/timing/clock.js +1 -1
- package/src/io/timing/rateLimit.js +1 -1
- package/src/io/timing/scheduler.js +1 -1
- package/src/io/utils/errors.js +1 -1
- package/src/io/utils/eventBus.js +1 -1
- package/src/io/utils/signal.js +1 -1
- package/src/io/utils/valid.js +1 -1
- package/src/main.js +1 -1
- package/src/process/message.js +1 -1
- package/src/process/rpc.js +7 -3
- package/src/process/workerPool.js +11 -4
- package/src/sanity/base.js +85 -39
- package/src/sanity/lockdown-apply.js +3 -3
- package/src/sanity/lockdown.js +58 -32
- package/src/sanity/wasm-gate.js +2 -2
- package/src/typed.js +7 -3
- package/third-party/NOTICE-brotli-dictionary.txt +69 -0
- package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
- package/third-party/NOTICE-whatwg-entities.txt +44 -0
- package/types/registry.generated.d.ts +7 -1
- package/types/typed.d.ts +7 -3
- package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
- package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
- package/docs/api/crypto/utils/aes_ctr.md +0 -71
- package/src/crypto/utils/aes_ctr.acvp.md +0 -67
- package/src/crypto/utils/aes_ctr.js +0 -134
package/src/dom/sw/cache.js
CHANGED
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @description
|
|
7
|
+
* Page-side PWA install helpers: the `beforeinstallprompt` deferral (with
|
|
8
|
+
* `appinstalled`) and the File Handling `launchQueue` consumer. Both APIs are
|
|
9
|
+
* feature-detected, never assumed — they are Chromium-only today.
|
|
10
|
+
*
|
|
11
|
+
* `install()` keeps the browser's install offer until the page asks for it
|
|
12
|
+
* (`prompt()`, on a user gesture — never a nag). `launchQueue()` hands the
|
|
13
|
+
* files an installed app was opened with to a callback, as
|
|
14
|
+
* `FileSystemFileHandle`s (the consumer calls `handle.getFile()`, and may
|
|
15
|
+
* keep the handle to write back).
|
|
16
|
+
*
|
|
17
|
+
* Not worker-safe: both events fire on the page's window.
|
|
18
|
+
*
|
|
19
|
+
* @example
|
|
20
|
+
* const installPrompt = runtime.resolve('installPrompt');
|
|
21
|
+
* const offer = installPrompt.install({
|
|
22
|
+
* onAvailable: () => { button.hidden = false; },
|
|
23
|
+
* onInstalled: () => { button.hidden = true; },
|
|
24
|
+
* });
|
|
25
|
+
* button.addEventListener('click', async () => { await offer.prompt(); });
|
|
26
|
+
* installPrompt.launchQueue({ onFiles: async (handles) => open(await handles[0].getFile()) });
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Options of `install()`.
|
|
31
|
+
* @typedef {object} InstallOptions
|
|
32
|
+
* @property {EventTarget} [win] - The window the events fire on (default `globalThis`).
|
|
33
|
+
* @property {() => void} [onAvailable] - Called when the browser offers installation.
|
|
34
|
+
* @property {() => void} [onInstalled] - Called once the app is installed.
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* The install offer returned by `install()`.
|
|
39
|
+
* @typedef {object} InstallOffer
|
|
40
|
+
* @property {() => boolean} available - An install offer is deferred and can be prompted.
|
|
41
|
+
* @property {() => Promise<'accepted'|'dismissed'|'unavailable'>} prompt - Show the deferred offer; never rejects.
|
|
42
|
+
* @property {() => void} dispose - Remove both listeners and drop the deferred offer.
|
|
43
|
+
*/
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Options of `launchQueue()`.
|
|
47
|
+
* @typedef {object} LaunchQueueOptions
|
|
48
|
+
* @property {any} [win] - The window carrying `launchQueue` (default `globalThis`).
|
|
49
|
+
* @property {(handles: FileSystemFileHandle[]) => void} onFiles - Receives the launched files' handles (never an empty list).
|
|
50
|
+
*/
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* The launch-queue consumer returned by `launchQueue()`.
|
|
54
|
+
* @typedef {object} LaunchQueueConsumer
|
|
55
|
+
* @property {boolean} supported - The File Handling launch queue exists on this page.
|
|
56
|
+
* @property {() => void} dispose - Neutralise the consumer (a consumer cannot be removed).
|
|
57
|
+
*/
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Public surface returned by the installPrompt factory.
|
|
61
|
+
* @typedef {object} InstallPromptAPI
|
|
62
|
+
* @property {(opts?: InstallOptions) => InstallOffer} install - Defer the browser's install offer.
|
|
63
|
+
* @property {(opts: LaunchQueueOptions) => LaunchQueueConsumer} launchQueue - Consume the File Handling launch queue.
|
|
64
|
+
*/
|
|
65
|
+
|
|
66
|
+
export const installPrompt = {
|
|
67
|
+
name: 'installPrompt',
|
|
68
|
+
version: '1.0.0',
|
|
69
|
+
type: 'fw.dom.sw',
|
|
70
|
+
dependencies: [],
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* @returns {InstallPromptAPI}
|
|
74
|
+
*/
|
|
75
|
+
factory() {
|
|
76
|
+
/**
|
|
77
|
+
* Defer the `beforeinstallprompt` offer until the page prompts it.
|
|
78
|
+
* @param {InstallOptions} [opts]
|
|
79
|
+
* @returns {InstallOffer}
|
|
80
|
+
* @throws {TypeError} When `win` is not an EventTarget.
|
|
81
|
+
*/
|
|
82
|
+
function install({ win = globalThis, onAvailable, onInstalled } = {}) {
|
|
83
|
+
if (!win || typeof win.addEventListener !== 'function') {
|
|
84
|
+
throw new TypeError('installPrompt.install: win must be an EventTarget');
|
|
85
|
+
}
|
|
86
|
+
/** @type {any} */
|
|
87
|
+
let deferred = null;
|
|
88
|
+
|
|
89
|
+
/** @param {Event} e */
|
|
90
|
+
function onBeforeInstall(e) {
|
|
91
|
+
e.preventDefault();
|
|
92
|
+
deferred = e;
|
|
93
|
+
onAvailable?.();
|
|
94
|
+
}
|
|
95
|
+
function onAppInstalled() {
|
|
96
|
+
deferred = null;
|
|
97
|
+
onInstalled?.();
|
|
98
|
+
}
|
|
99
|
+
win.addEventListener('beforeinstallprompt', onBeforeInstall);
|
|
100
|
+
win.addEventListener('appinstalled', onAppInstalled);
|
|
101
|
+
|
|
102
|
+
return {
|
|
103
|
+
available: () => deferred !== null,
|
|
104
|
+
async prompt() {
|
|
105
|
+
if (deferred === null) return 'unavailable';
|
|
106
|
+
const e = deferred;
|
|
107
|
+
deferred = null;
|
|
108
|
+
try {
|
|
109
|
+
await e.prompt();
|
|
110
|
+
if (!e.userChoice) return 'dismissed';
|
|
111
|
+
const c = await e.userChoice;
|
|
112
|
+
return c && c.outcome === 'accepted' ? 'accepted' : 'dismissed';
|
|
113
|
+
} catch {
|
|
114
|
+
return 'dismissed';
|
|
115
|
+
}
|
|
116
|
+
},
|
|
117
|
+
dispose() {
|
|
118
|
+
win.removeEventListener('beforeinstallprompt', onBeforeInstall);
|
|
119
|
+
win.removeEventListener('appinstalled', onAppInstalled);
|
|
120
|
+
deferred = null;
|
|
121
|
+
},
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* Hand the files an installed app was launched with to `onFiles`.
|
|
127
|
+
* @param {LaunchQueueOptions} opts
|
|
128
|
+
* @returns {LaunchQueueConsumer}
|
|
129
|
+
* @throws {TypeError} When `onFiles` is not a function.
|
|
130
|
+
*/
|
|
131
|
+
function launchQueue({ win = globalThis, onFiles } = /** @type {any} */ ({})) {
|
|
132
|
+
if (typeof onFiles !== 'function') {
|
|
133
|
+
throw new TypeError('installPrompt.launchQueue: onFiles must be a function');
|
|
134
|
+
}
|
|
135
|
+
const queue = /** @type {any} */ (win)?.launchQueue;
|
|
136
|
+
const supported = !!queue && typeof queue.setConsumer === 'function';
|
|
137
|
+
if (!supported) return { supported: false, dispose() {} };
|
|
138
|
+
|
|
139
|
+
queue.setConsumer((params) => {
|
|
140
|
+
const handles = params && params.files ? [...params.files] : [];
|
|
141
|
+
if (handles.length) onFiles(handles);
|
|
142
|
+
});
|
|
143
|
+
return {
|
|
144
|
+
supported: true,
|
|
145
|
+
dispose() { queue.setConsumer(() => {}); },
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
return { install, launchQueue };
|
|
150
|
+
},
|
|
151
|
+
};
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @description
|
|
7
|
+
* Worker-side release precache for a service worker, over the `cache` module.
|
|
8
|
+
*
|
|
9
|
+
* `install` pre-caches a release's files into a cache named after its
|
|
10
|
+
* version (`prefix + version`); the very first install (no active
|
|
11
|
+
* registration) takes over at once, a later one WAITS for the page's word.
|
|
12
|
+
* `activate` deletes this prefix's older caches — never another app's — and
|
|
13
|
+
* claims the pages. `fetch` serves same-origin GET requests cache-first (the
|
|
14
|
+
* release's own copy, a navigation miss falling back to the page) or
|
|
15
|
+
* network-first (the network, its last copy when offline), as chosen per
|
|
16
|
+
* request by a strategy function. `message` answers the page-side `swUpdate`
|
|
17
|
+
* protocol: skip waiting, and report the release on a transferred port.
|
|
18
|
+
*
|
|
19
|
+
* Worker-safe: runs inside a ServiceWorkerGlobalScope. The scope is passed
|
|
20
|
+
* explicitly (`scope: self`), never captured.
|
|
21
|
+
*
|
|
22
|
+
* @example
|
|
23
|
+
* // sw.js (module worker)
|
|
24
|
+
* import { cache } from './fw/dom/sw/cache.js';
|
|
25
|
+
* import { precache } from './fw/dom/sw/precache.js';
|
|
26
|
+
* precache.factory(cache.factory()).create({
|
|
27
|
+
* scope: self, prefix: 'my-app-', version: 'v1', urls: ['./', 'main.js'],
|
|
28
|
+
* }).listen();
|
|
29
|
+
*/
|
|
30
|
+
import { cache } from './cache.js';
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Strategy chosen for one request.
|
|
34
|
+
* @typedef {'cache-first'|'network-first'|'pass'} StrategyKind
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* The message types the worker answers.
|
|
39
|
+
* @typedef {object} PrecacheMessages
|
|
40
|
+
* @property {string} skipWaiting - Take over now (`skipWaiting()`).
|
|
41
|
+
* @property {string} version - Answer `{ version }` on the first transferred port.
|
|
42
|
+
*/
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Options of `create()`.
|
|
46
|
+
* @typedef {object} PrecacheOptions
|
|
47
|
+
* @property {any} scope - The worker global scope (`self`); required.
|
|
48
|
+
* @property {string} prefix - Cache-name prefix owned by this app.
|
|
49
|
+
* @property {string} version - The release; the cache is `prefix + version`.
|
|
50
|
+
* @property {string[]} urls - The release's files, relative to the worker.
|
|
51
|
+
* @property {(request: Request, url: URL) => StrategyKind} [strategy] - Per-request strategy (default always `'cache-first'`).
|
|
52
|
+
* @property {string|null} [navigationFallback] - URL served for a navigation miss in cache-first (default `'./'`; `null` goes to the network).
|
|
53
|
+
* @property {boolean} [cacheRuntime] - Keep a copy of 200 network responses (default `true`).
|
|
54
|
+
* @property {'first-install'|'always'|'never'} [takeOver] - When install calls `skipWaiting()` (default `'first-install'`).
|
|
55
|
+
* @property {boolean} [claim] - `clients.claim()` on activate (default `true`).
|
|
56
|
+
* @property {PrecacheMessages|null} [messages] - The message protocol (default `DEFAULT_MESSAGES`; `null` installs no message listener).
|
|
57
|
+
*/
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* The event handlers of one instance.
|
|
61
|
+
* @typedef {object} PrecacheHandlers
|
|
62
|
+
* @property {(event: any) => void} install - Pre-cache, then take over per `takeOver`.
|
|
63
|
+
* @property {(event: any) => void} activate - Delete this prefix's other caches, then claim.
|
|
64
|
+
* @property {(event: any) => void} fetch - Route a same-origin GET through the strategy.
|
|
65
|
+
* @property {(event: any) => void} message - Answer skip-waiting and version requests.
|
|
66
|
+
*/
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* The instance returned by `create()`.
|
|
70
|
+
* @typedef {object} PrecacheInstance
|
|
71
|
+
* @property {string} cacheName - `prefix + version`.
|
|
72
|
+
* @property {PrecacheHandlers} handlers - The event handlers, callable directly.
|
|
73
|
+
* @property {(request: Request) => Promise<Response>} cacheFirst - The release's copy first, then the network.
|
|
74
|
+
* @property {(request: Request) => Promise<Response>} networkFirst - The network first, then the last copy.
|
|
75
|
+
* @property {() => PrecacheInstance} listen - Attach the handlers to the scope (idempotent).
|
|
76
|
+
*/
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Public surface returned by the precache factory.
|
|
80
|
+
* @typedef {object} PrecacheAPI
|
|
81
|
+
* @property {(opts: PrecacheOptions) => PrecacheInstance} create - Build a release precache for one worker scope.
|
|
82
|
+
* @property {Readonly<PrecacheMessages>} DEFAULT_MESSAGES - The default wire protocol (shared with `swUpdate`).
|
|
83
|
+
*/
|
|
84
|
+
|
|
85
|
+
export const precache = {
|
|
86
|
+
name: 'precache',
|
|
87
|
+
version: '1.0.0',
|
|
88
|
+
type: 'fw.dom.sw',
|
|
89
|
+
dependencies: ['cache'],
|
|
90
|
+
deps: [cache],
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* @param {{open: (name: string) => Promise<any>, delete: (name: string) => Promise<boolean>, keys: () => Promise<string[]>}} cache - Module cache (fw)
|
|
94
|
+
* @returns {PrecacheAPI}
|
|
95
|
+
*/
|
|
96
|
+
factory(cache) {
|
|
97
|
+
const DEFAULT_MESSAGES = Object.freeze({ skipWaiting: 'awa-sw-skip-waiting', version: 'awa-sw-version' });
|
|
98
|
+
const TAKE_OVER = ['first-install', 'always', 'never'];
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* @param {unknown} v
|
|
102
|
+
* @returns {boolean}
|
|
103
|
+
* @private
|
|
104
|
+
*/
|
|
105
|
+
function isNonEmptyString(v) {
|
|
106
|
+
return typeof v === 'string' && v !== '';
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Build a release precache for one worker scope.
|
|
111
|
+
* @param {PrecacheOptions} opts
|
|
112
|
+
* @returns {PrecacheInstance}
|
|
113
|
+
* @throws {TypeError} When an option is invalid (see the guards).
|
|
114
|
+
*/
|
|
115
|
+
function create({
|
|
116
|
+
scope,
|
|
117
|
+
prefix,
|
|
118
|
+
version,
|
|
119
|
+
urls,
|
|
120
|
+
strategy = () => 'cache-first',
|
|
121
|
+
navigationFallback = './',
|
|
122
|
+
cacheRuntime = true,
|
|
123
|
+
takeOver = 'first-install',
|
|
124
|
+
claim = true,
|
|
125
|
+
messages = DEFAULT_MESSAGES,
|
|
126
|
+
} = /** @type {any} */ ({})) {
|
|
127
|
+
if (!scope || typeof scope.addEventListener !== 'function') {
|
|
128
|
+
throw new TypeError('precache.create: scope must be an EventTarget (the worker global scope)');
|
|
129
|
+
}
|
|
130
|
+
if (!isNonEmptyString(prefix)) throw new TypeError('precache.create: prefix must be a non-empty string');
|
|
131
|
+
if (!isNonEmptyString(version)) throw new TypeError('precache.create: version must be a non-empty string');
|
|
132
|
+
if (!Array.isArray(urls) || !urls.every((u) => typeof u === 'string')) {
|
|
133
|
+
throw new TypeError('precache.create: urls must be an array of strings');
|
|
134
|
+
}
|
|
135
|
+
if (typeof strategy !== 'function') throw new TypeError('precache.create: strategy must be a function');
|
|
136
|
+
if (!TAKE_OVER.includes(takeOver)) {
|
|
137
|
+
throw new TypeError(`precache.create: takeOver must be one of ${TAKE_OVER.join(', ')}`);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
const cacheName = prefix + version;
|
|
141
|
+
let listening = false;
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* @param {Request} request
|
|
145
|
+
* @returns {Promise<Response>}
|
|
146
|
+
*/
|
|
147
|
+
async function cacheFirst(request) {
|
|
148
|
+
const c = await cache.open(cacheName);
|
|
149
|
+
const navigate = request.mode === 'navigate';
|
|
150
|
+
const hit = (await c.match(request, { ignoreSearch: navigate }))
|
|
151
|
+
|| (navigate && navigationFallback
|
|
152
|
+
? await c.match(new URL(navigationFallback, scope.location.href).href)
|
|
153
|
+
: undefined);
|
|
154
|
+
if (hit) return hit;
|
|
155
|
+
let response;
|
|
156
|
+
try {
|
|
157
|
+
response = await fetch(request);
|
|
158
|
+
} catch {
|
|
159
|
+
return Response.error();
|
|
160
|
+
}
|
|
161
|
+
if (response.status === 200 && cacheRuntime) {
|
|
162
|
+
c.put(request, response.clone()).catch(() => {});
|
|
163
|
+
}
|
|
164
|
+
return response;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* @param {Request} request
|
|
169
|
+
* @returns {Promise<Response>}
|
|
170
|
+
*/
|
|
171
|
+
async function networkFirst(request) {
|
|
172
|
+
let response;
|
|
173
|
+
try {
|
|
174
|
+
response = await fetch(request);
|
|
175
|
+
} catch {
|
|
176
|
+
response = null;
|
|
177
|
+
}
|
|
178
|
+
if (response) {
|
|
179
|
+
if (response.status === 200 && cacheRuntime) {
|
|
180
|
+
const copy = response.clone();
|
|
181
|
+
cache.open(cacheName).then((c) => c.put(request, copy)).catch(() => {});
|
|
182
|
+
}
|
|
183
|
+
return response;
|
|
184
|
+
}
|
|
185
|
+
const c = await cache.open(cacheName);
|
|
186
|
+
return (await c.match(request, { ignoreSearch: request.mode === 'navigate' })) || Response.error();
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/** @type {PrecacheHandlers} */
|
|
190
|
+
const handlers = {
|
|
191
|
+
install(event) {
|
|
192
|
+
event.waitUntil(
|
|
193
|
+
cache.open(cacheName)
|
|
194
|
+
.then((c) => c.addAll(urls))
|
|
195
|
+
.then(() => {
|
|
196
|
+
if (takeOver === 'always' || (takeOver === 'first-install' && !scope.registration.active)) {
|
|
197
|
+
return scope.skipWaiting();
|
|
198
|
+
}
|
|
199
|
+
return undefined;
|
|
200
|
+
})
|
|
201
|
+
);
|
|
202
|
+
},
|
|
203
|
+
activate(event) {
|
|
204
|
+
event.waitUntil(
|
|
205
|
+
cache.keys()
|
|
206
|
+
.then((names) => Promise.all(names
|
|
207
|
+
.filter((n) => n.startsWith(prefix) && n !== cacheName)
|
|
208
|
+
.map((n) => cache.delete(n))))
|
|
209
|
+
.then(() => (claim ? scope.clients.claim() : undefined))
|
|
210
|
+
);
|
|
211
|
+
},
|
|
212
|
+
fetch(event) {
|
|
213
|
+
const request = event.request;
|
|
214
|
+
if (request.method !== 'GET') return;
|
|
215
|
+
const url = new URL(request.url);
|
|
216
|
+
if (url.origin !== new URL(scope.location.href).origin) return;
|
|
217
|
+
const kind = strategy(request, url);
|
|
218
|
+
if (kind === 'pass') return;
|
|
219
|
+
if (kind === 'network-first') {
|
|
220
|
+
event.respondWith(networkFirst(request));
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
event.respondWith(cacheFirst(request));
|
|
224
|
+
},
|
|
225
|
+
message(event) {
|
|
226
|
+
if (messages === null) return;
|
|
227
|
+
const type = event.data && event.data.type;
|
|
228
|
+
if (type === messages.skipWaiting) {
|
|
229
|
+
event.waitUntil(scope.skipWaiting());
|
|
230
|
+
} else if (type === messages.version && event.ports && event.ports[0]) {
|
|
231
|
+
event.ports[0].postMessage({ version });
|
|
232
|
+
}
|
|
233
|
+
},
|
|
234
|
+
};
|
|
235
|
+
|
|
236
|
+
/** @type {PrecacheInstance} */
|
|
237
|
+
const instance = {
|
|
238
|
+
cacheName,
|
|
239
|
+
handlers,
|
|
240
|
+
cacheFirst,
|
|
241
|
+
networkFirst,
|
|
242
|
+
listen() {
|
|
243
|
+
if (listening) return instance;
|
|
244
|
+
listening = true;
|
|
245
|
+
scope.addEventListener('install', handlers.install);
|
|
246
|
+
scope.addEventListener('activate', handlers.activate);
|
|
247
|
+
scope.addEventListener('fetch', handlers.fetch);
|
|
248
|
+
if (messages !== null) scope.addEventListener('message', handlers.message);
|
|
249
|
+
return instance;
|
|
250
|
+
},
|
|
251
|
+
};
|
|
252
|
+
return instance;
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
return { create, DEFAULT_MESSAGES };
|
|
256
|
+
},
|
|
257
|
+
};
|
package/src/dom/sw/push.js
CHANGED