@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.
Files changed (609) hide show
  1. package/CHANGELOG.md +125 -0
  2. package/NOTICE +8 -0
  3. package/README.md +163 -31
  4. package/dist/build/fw.core.pure.meta.json +6 -6
  5. package/dist/build/fw.core.pure.min.js +15 -12
  6. package/dist/build/fw.full.pure.meta.json +13 -7
  7. package/dist/build/fw.full.pure.min.js +45 -42
  8. package/dist/build/fw.minimal.pure.meta.json +6 -6
  9. package/dist/build/fw.minimal.pure.min.js +16 -13
  10. package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
  11. package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
  12. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
  13. package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
  14. package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
  15. package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
  16. package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
  17. package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
  18. package/dist/build/fw.pwa.pure.meta.json +7 -6
  19. package/dist/build/fw.pwa.pure.min.js +38 -35
  20. package/dist/build/fw.site-interactive.pure.meta.json +6 -6
  21. package/dist/build/fw.site-interactive.pure.min.js +37 -34
  22. package/dist/build/fw.site.pure.meta.json +6 -6
  23. package/dist/build/fw.site.pure.min.js +24 -21
  24. package/dist/build/fw.spa.pure.meta.json +8 -7
  25. package/dist/build/fw.spa.pure.min.js +41 -38
  26. package/dist/build/sanity-base-classic.min.js +1 -1
  27. package/dist/build/sanity.min.js +1 -1
  28. package/dist/types/core/internal.d.ts +29 -0
  29. package/dist/types/core/internal.d.ts.map +1 -0
  30. package/dist/types/core/logger.d.ts +23 -4
  31. package/dist/types/core/logger.d.ts.map +1 -1
  32. package/dist/types/core/modules.d.ts +374 -61
  33. package/dist/types/core/modules.d.ts.map +1 -1
  34. package/dist/types/core/runtime.d.ts +10 -6
  35. package/dist/types/core/runtime.d.ts.map +1 -1
  36. package/dist/types/core/worker-helper.d.ts +35 -0
  37. package/dist/types/core/worker-helper.d.ts.map +1 -1
  38. package/dist/types/crypto/cipher/aes.d.ts +1 -7
  39. package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
  40. package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
  41. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
  42. package/dist/types/crypto/hash/argon2.d.ts +0 -15
  43. package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
  44. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
  45. package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
  46. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
  47. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
  48. package/dist/types/crypto/hash/sha224.d.ts +1 -1
  49. package/dist/types/crypto/hash/sha256.d.ts +4 -13
  50. package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
  51. package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
  52. package/dist/types/crypto/hash/sha384.d.ts +1 -1
  53. package/dist/types/crypto/hash/sha512.d.ts +4 -13
  54. package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
  55. package/dist/types/crypto/mode/cmac.d.ts +0 -6
  56. package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
  57. package/dist/types/crypto/mode/ctr.d.ts +0 -6
  58. package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
  59. package/dist/types/crypto/mode/gcm.d.ts +0 -9
  60. package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
  61. package/dist/types/crypto/pkc/ecc.d.ts +0 -1
  62. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
  63. package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
  64. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
  65. package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
  66. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
  67. package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
  68. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
  69. package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
  70. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
  71. package/dist/types/crypto/pkc/rsa.d.ts +0 -24
  72. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
  73. package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
  74. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
  75. package/dist/types/crypto/pkc/x25519.d.ts +0 -6
  76. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
  77. package/dist/types/crypto/utils/bitArray.d.ts +0 -8
  78. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
  79. package/dist/types/crypto/utils/jws.d.ts +6 -14
  80. package/dist/types/crypto/utils/jws.d.ts.map +1 -1
  81. package/dist/types/crypto/utils/keyformat.d.ts +52 -0
  82. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
  83. package/dist/types/crypto/utils/random.d.ts +1 -10
  84. package/dist/types/crypto/utils/random.d.ts.map +1 -1
  85. package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
  86. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
  87. package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
  88. package/dist/types/crypto/utils/x509.d.ts +397 -0
  89. package/dist/types/crypto/utils/x509.d.ts.map +1 -0
  90. package/dist/types/crypto/wasm/argon2.d.ts +2 -1
  91. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
  92. package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
  93. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
  94. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
  95. package/dist/types/crypto/wasm/runtime.d.ts +13 -0
  96. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
  97. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
  98. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
  99. package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
  100. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
  101. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
  102. package/dist/types/dom/fs/fileIntake.d.ts +59 -0
  103. package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
  104. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
  105. package/dist/types/dom/query/dnd.d.ts.map +1 -1
  106. package/dist/types/dom/query/sound.d.ts +89 -0
  107. package/dist/types/dom/query/sound.d.ts.map +1 -0
  108. package/dist/types/dom/rendering/chart.d.ts.map +1 -1
  109. package/dist/types/dom/rendering/component.d.ts +9 -3
  110. package/dist/types/dom/rendering/component.d.ts.map +1 -1
  111. package/dist/types/dom/rendering/parser.d.ts +39 -0
  112. package/dist/types/dom/rendering/parser.d.ts.map +1 -1
  113. package/dist/types/dom/rendering/render.d.ts.map +1 -1
  114. package/dist/types/dom/rendering/sanitize.d.ts +4 -0
  115. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
  116. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
  117. package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
  118. package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
  119. package/dist/types/dom/rendering/template.d.ts +9 -3
  120. package/dist/types/dom/rendering/template.d.ts.map +1 -1
  121. package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
  122. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
  123. package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
  124. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
  125. package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
  126. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
  127. package/dist/types/dom/rendering/uiSession.d.ts +18 -6
  128. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
  129. package/dist/types/dom/sw/installPrompt.d.ts +89 -0
  130. package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
  131. package/dist/types/dom/sw/precache.d.ts +149 -0
  132. package/dist/types/dom/sw/precache.d.ts.map +1 -0
  133. package/dist/types/dom/sw/swUpdate.d.ts +129 -0
  134. package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
  135. package/dist/types/dom/utils/clipboard.d.ts +8 -0
  136. package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
  137. package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
  138. package/dist/types/dom/utils/route.d.ts.map +1 -1
  139. package/dist/types/dom/utils/ua.d.ts +2 -2
  140. package/dist/types/dom/utils/ua.d.ts.map +1 -1
  141. package/dist/types/io/calc/crc32.d.ts.map +1 -1
  142. package/dist/types/io/codec/b64.d.ts +24 -0
  143. package/dist/types/io/codec/b64.d.ts.map +1 -1
  144. package/dist/types/io/codec/cbor.d.ts +1 -0
  145. package/dist/types/io/codec/cbor.d.ts.map +1 -1
  146. package/dist/types/io/codec/hex.d.ts.map +1 -1
  147. package/dist/types/io/codec/msgpack.d.ts +1 -0
  148. package/dist/types/io/codec/msgpack.d.ts.map +1 -1
  149. package/dist/types/io/codec/url.d.ts +3 -1
  150. package/dist/types/io/codec/url.d.ts.map +1 -1
  151. package/dist/types/io/codec/utf8.d.ts.map +1 -1
  152. package/dist/types/io/compress/bitstream.d.ts +1 -1
  153. package/dist/types/io/compress/brotli.d.ts +0 -1
  154. package/dist/types/io/compress/brotli.d.ts.map +1 -1
  155. package/dist/types/io/compress/brotli_shared.d.ts +0 -4
  156. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
  157. package/dist/types/io/compress/deflate.d.ts +14 -1
  158. package/dist/types/io/compress/deflate.d.ts.map +1 -1
  159. package/dist/types/io/compress/gzip.d.ts +4 -0
  160. package/dist/types/io/compress/gzip.d.ts.map +1 -1
  161. package/dist/types/io/compress/huffman.d.ts +7 -0
  162. package/dist/types/io/compress/huffman.d.ts.map +1 -1
  163. package/dist/types/io/compress/lz4.d.ts +4 -2
  164. package/dist/types/io/compress/lz4.d.ts.map +1 -1
  165. package/dist/types/io/compress/lz77.d.ts +17 -0
  166. package/dist/types/io/compress/lz77.d.ts.map +1 -1
  167. package/dist/types/io/compress/lzw.d.ts +2 -0
  168. package/dist/types/io/compress/lzw.d.ts.map +1 -1
  169. package/dist/types/io/compress/zip.d.ts.map +1 -1
  170. package/dist/types/io/compress/zlib.d.ts +9 -2
  171. package/dist/types/io/compress/zlib.d.ts.map +1 -1
  172. package/dist/types/io/math/linalg.d.ts.map +1 -1
  173. package/dist/types/process/rpc.d.ts.map +1 -1
  174. package/dist/types/process/workerPool.d.ts.map +1 -1
  175. package/dist/types/sanity/base.d.ts +12 -2
  176. package/dist/types/sanity/base.d.ts.map +1 -1
  177. package/dist/types/sanity/lockdown.d.ts +6 -5
  178. package/dist/types/sanity/lockdown.d.ts.map +1 -1
  179. package/dist/types/sanity/wasm-gate.d.ts +1 -1
  180. package/docs/README.md +17 -10
  181. package/docs/api/README.md +5 -5
  182. package/docs/api/core/logger.md +2 -1
  183. package/docs/api/core/modules.md +3 -3
  184. package/docs/api/core/runtime.md +9 -9
  185. package/docs/api/core/worker-helper.md +12 -2
  186. package/docs/api/crypto/README.md +1 -1
  187. package/docs/api/crypto/cipher/README.md +2 -2
  188. package/docs/api/crypto/cipher/aes.md +5 -10
  189. package/docs/api/crypto/cipher/chacha20.md +3 -8
  190. package/docs/api/crypto/hash/README.md +5 -5
  191. package/docs/api/crypto/hash/adf.md +21 -11
  192. package/docs/api/crypto/hash/argon2.md +3 -12
  193. package/docs/api/crypto/hash/blake2b.md +12 -14
  194. package/docs/api/crypto/hash/pbkdf2.md +1 -1
  195. package/docs/api/crypto/hash/sha224.md +2 -2
  196. package/docs/api/crypto/hash/sha256.md +4 -4
  197. package/docs/api/crypto/hash/sha3.md +2 -2
  198. package/docs/api/crypto/hash/sha384.md +1 -1
  199. package/docs/api/crypto/hash/sha512.md +5 -5
  200. package/docs/api/crypto/hash/sha512_224.md +1 -1
  201. package/docs/api/crypto/hash/sha512_256.md +1 -1
  202. package/docs/api/crypto/mode/README.md +3 -3
  203. package/docs/api/crypto/mode/cbc.md +2 -2
  204. package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
  205. package/docs/api/crypto/mode/cmac.md +4 -4
  206. package/docs/api/crypto/mode/ctr.md +2 -3
  207. package/docs/api/crypto/mode/gcm.md +5 -5
  208. package/docs/api/crypto/mode/kw.md +4 -4
  209. package/docs/api/crypto/pkc/README.md +8 -8
  210. package/docs/api/crypto/pkc/ecc.md +19 -17
  211. package/docs/api/crypto/pkc/ed25519.md +10 -15
  212. package/docs/api/crypto/pkc/hybridKem.md +8 -2
  213. package/docs/api/crypto/pkc/hybridSign.md +34 -7
  214. package/docs/api/crypto/pkc/ml_dsa.md +20 -19
  215. package/docs/api/crypto/pkc/ml_kem.md +3 -3
  216. package/docs/api/crypto/pkc/rsa.md +7 -9
  217. package/docs/api/crypto/pkc/slh_dsa.md +12 -12
  218. package/docs/api/crypto/pkc/x25519.md +5 -4
  219. package/docs/api/crypto/utils/README.md +7 -7
  220. package/docs/api/crypto/utils/aes_modes.md +2 -5
  221. package/docs/api/crypto/utils/asn1.md +25 -16
  222. package/docs/api/crypto/utils/jws.md +6 -4
  223. package/docs/api/crypto/utils/keyformat.md +24 -15
  224. package/docs/api/crypto/utils/pad.md +1 -1
  225. package/docs/api/crypto/utils/pem.md +3 -3
  226. package/docs/api/crypto/utils/random.md +3 -4
  227. package/docs/api/crypto/utils/rsaKeygen.md +2 -2
  228. package/docs/api/crypto/utils/totp.md +2 -2
  229. package/docs/api/crypto/utils/uuid.md +5 -5
  230. package/docs/api/crypto/utils/x509.md +124 -0
  231. package/docs/api/crypto/wasm/aes.md +1 -1
  232. package/docs/api/crypto/wasm/argon2.md +6 -4
  233. package/docs/api/crypto/wasm/ml_kem.md +1 -0
  234. package/docs/api/crypto/wasm/pbkdf2.md +8 -8
  235. package/docs/api/crypto/wasm/rsa.md +1 -1
  236. package/docs/api/crypto/wasm/runtime.md +27 -10
  237. package/docs/api/crypto/webcrypto/aes.md +1 -1
  238. package/docs/api/crypto/webcrypto/aeskw.md +2 -2
  239. package/docs/api/crypto/webcrypto/digest.md +3 -5
  240. package/docs/api/crypto/webcrypto/ecc.md +1 -1
  241. package/docs/api/crypto/webcrypto/ed25519.md +1 -1
  242. package/docs/api/crypto/webcrypto/rsa.md +3 -2
  243. package/docs/api/crypto/webcrypto/x25519.md +1 -1
  244. package/docs/api/dom/README.md +6 -1
  245. package/docs/api/dom/fs/README.md +1 -0
  246. package/docs/api/dom/fs/fileIntake.md +120 -0
  247. package/docs/api/dom/fs/fsAccess.md +1 -0
  248. package/docs/api/dom/fs/indexedDB.md +1 -1
  249. package/docs/api/dom/fs/storage.md +1 -1
  250. package/docs/api/dom/query/README.md +2 -1
  251. package/docs/api/dom/query/dnd.md +4 -1
  252. package/docs/api/dom/query/dom.md +5 -0
  253. package/docs/api/dom/query/sound.md +103 -0
  254. package/docs/api/dom/rendering/README.md +4 -3
  255. package/docs/api/dom/rendering/chart.md +5 -4
  256. package/docs/api/dom/rendering/component.md +25 -3
  257. package/docs/api/dom/rendering/parser.md +5 -2
  258. package/docs/api/dom/rendering/reactiveBind.md +1 -1
  259. package/docs/api/dom/rendering/render.md +2 -2
  260. package/docs/api/dom/rendering/sanitize.md +10 -2
  261. package/docs/api/dom/rendering/secPolicy.md +4 -4
  262. package/docs/api/dom/rendering/styleSheet.md +85 -0
  263. package/docs/api/dom/rendering/template.md +20 -5
  264. package/docs/api/dom/rendering/themeTokens.md +6 -3
  265. package/docs/api/dom/rendering/uiSession.md +18 -5
  266. package/docs/api/dom/rendering/virtualScroll.md +2 -2
  267. package/docs/api/dom/sensors/geolocation.md +1 -1
  268. package/docs/api/dom/sw/README.md +7 -1
  269. package/docs/api/dom/sw/cache.md +2 -1
  270. package/docs/api/dom/sw/installPrompt.md +111 -0
  271. package/docs/api/dom/sw/precache.md +124 -0
  272. package/docs/api/dom/sw/serviceWorker.md +4 -2
  273. package/docs/api/dom/sw/swUpdate.md +112 -0
  274. package/docs/api/dom/utils/clipboard.md +56 -5
  275. package/docs/api/dom/utils/entropyCollector.md +1 -1
  276. package/docs/api/dom/utils/keybindings.md +17 -2
  277. package/docs/api/dom/utils/leaderElection.md +2 -2
  278. package/docs/api/dom/utils/route.md +1 -0
  279. package/docs/api/dom/utils/ua.md +15 -10
  280. package/docs/api/io/calc/crc32.md +4 -1
  281. package/docs/api/io/codec/README.md +2 -2
  282. package/docs/api/io/codec/b64.md +31 -2
  283. package/docs/api/io/codec/buffer.md +1 -1
  284. package/docs/api/io/codec/cbor.md +6 -4
  285. package/docs/api/io/codec/csv.md +178 -178
  286. package/docs/api/io/codec/hex.md +10 -2
  287. package/docs/api/io/codec/msgpack.md +4 -3
  288. package/docs/api/io/codec/url.md +4 -3
  289. package/docs/api/io/codec/utf8.md +3 -3
  290. package/docs/api/io/compress/bitstream.md +6 -3
  291. package/docs/api/io/compress/brotli.md +36 -4
  292. package/docs/api/io/compress/brotli_shared.md +1 -1
  293. package/docs/api/io/compress/deflate.md +42 -34
  294. package/docs/api/io/compress/gzip.md +26 -6
  295. package/docs/api/io/compress/huffman.md +2 -1
  296. package/docs/api/io/compress/lz4.md +5 -3
  297. package/docs/api/io/compress/lz77.md +26 -3
  298. package/docs/api/io/compress/lzw.md +13 -8
  299. package/docs/api/io/compress/zip.md +36 -10
  300. package/docs/api/io/compress/zlib.md +21 -5
  301. package/docs/api/io/math/linalg.md +1 -1
  302. package/docs/api/io/utils/valid.md +1 -1
  303. package/docs/api/process/rpc.md +3 -2
  304. package/docs/api/process/workerPool.md +1 -1
  305. package/docs/api/sanity/base.md +9 -5
  306. package/docs/api/sanity/lockdown.md +7 -6
  307. package/docs/api/surface.json +12311 -0
  308. package/docs/api/typed.md +5 -3
  309. package/docs/dev/README.md +2 -0
  310. package/docs/dev/bench.md +76 -0
  311. package/docs/dev/crypto-references.md +54 -0
  312. package/docs/dev/provenance.md +30 -7
  313. package/docs/dev/publishing.md +7 -7
  314. package/docs/dev/runtime.md +1 -1
  315. package/docs/dev/testing.md +13 -0
  316. package/docs/evidence/l4-evidence.md +86 -0
  317. package/docs/evidence/pqc-hybrid-evidence.md +7 -6
  318. package/docs/guide/README.md +1 -0
  319. package/docs/guide/_QUICK_REF.md +5 -5
  320. package/docs/guide/doc-format.md +4 -3
  321. package/docs/guide/integrations-hmr.md +1 -1
  322. package/docs/guide/module-creation-workflow.md +8 -8
  323. package/docs/guide/rendering-pipeline.md +11 -4
  324. package/docs/guide/security.md +7 -5
  325. package/docs/guide/stability.md +123 -0
  326. package/docs/guide/tutorial-todo.md +20 -8
  327. package/docs/guide/typescript.md +9 -0
  328. package/docs/guide/worker-confinement.md +30 -17
  329. package/docs/notes/lz77-deflate-factorization.md +3 -3
  330. package/docs/tools/README.md +1 -1
  331. package/docs/tools/bundler.md +3 -3
  332. package/docs/tools/codegen.md +1 -1
  333. package/docs/tools/standalone.md +0 -1
  334. package/fw.config.json +2 -2
  335. package/integrations/_shared/catalog.generated.json +7 -1
  336. package/integrations/_shared/core.js +1 -1
  337. package/integrations/astro/index.js +1 -1
  338. package/integrations/eslint/README.md +7 -1
  339. package/integrations/nextjs/index.js +1 -1
  340. package/integrations/nodejs/README.md +3 -3
  341. package/integrations/turbopack/index.js +2 -2
  342. package/integrations/typedoc/categorize.js +1 -1
  343. package/integrations/typedoc/typedoc.json +2 -1
  344. package/integrations/vite/index.js +2 -2
  345. package/integrations/vite/vite-env.d.ts +7 -4
  346. package/integrations/webpack/index.js +3 -3
  347. package/package.json +76 -10
  348. package/src/core/internal.js +31 -0
  349. package/src/core/logger.js +95 -23
  350. package/src/core/modules.js +17 -8
  351. package/src/core/readyState.js +1 -1
  352. package/src/core/runtime.js +74 -27
  353. package/src/core/worker-helper.js +83 -4
  354. package/src/crypto/NIST_CONFORMANCE.md +47 -34
  355. package/src/crypto/cipher/aes.acvp.md +7 -8
  356. package/src/crypto/cipher/aes.js +280 -229
  357. package/src/crypto/cipher/chacha20.acvp.md +6 -7
  358. package/src/crypto/cipher/chacha20.js +91 -61
  359. package/src/crypto/hash/adf.js +1 -1
  360. package/src/crypto/hash/argon2.acvp.md +11 -15
  361. package/src/crypto/hash/argon2.js +9 -24
  362. package/src/crypto/hash/blake2b.js +157 -125
  363. package/src/crypto/hash/hkdf.acvp.md +15 -15
  364. package/src/crypto/hash/hkdf.js +1 -1
  365. package/src/crypto/hash/hmac.acvp.md +10 -12
  366. package/src/crypto/hash/hmac.js +5 -1
  367. package/src/crypto/hash/pbkdf2.acvp.md +13 -13
  368. package/src/crypto/hash/pbkdf2.js +36 -8
  369. package/src/crypto/hash/poly1305.acvp.md +10 -6
  370. package/src/crypto/hash/poly1305.js +171 -50
  371. package/src/crypto/hash/sha224.acvp.md +3 -3
  372. package/src/crypto/hash/sha224.js +4 -4
  373. package/src/crypto/hash/sha256.acvp.md +2 -2
  374. package/src/crypto/hash/sha256.js +514 -50
  375. package/src/crypto/hash/sha3.acvp.md +9 -9
  376. package/src/crypto/hash/sha3.js +127 -71
  377. package/src/crypto/hash/sha384.acvp.md +3 -3
  378. package/src/crypto/hash/sha384.js +4 -4
  379. package/src/crypto/hash/sha512.acvp.md +7 -8
  380. package/src/crypto/hash/sha512.js +107 -108
  381. package/src/crypto/hash/sha512_224.acvp.md +6 -6
  382. package/src/crypto/hash/sha512_224.js +2 -2
  383. package/src/crypto/hash/sha512_256.acvp.md +6 -6
  384. package/src/crypto/hash/sha512_256.js +2 -2
  385. package/src/crypto/mode/cbc.acvp.md +2 -2
  386. package/src/crypto/mode/cbc.js +1 -1
  387. package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
  388. package/src/crypto/mode/chacha20poly1305.js +3 -3
  389. package/src/crypto/mode/cmac.acvp.md +5 -5
  390. package/src/crypto/mode/cmac.js +8 -8
  391. package/src/crypto/mode/ctr.acvp.md +2 -2
  392. package/src/crypto/mode/ctr.js +1 -3
  393. package/src/crypto/mode/gcm.acvp.md +6 -6
  394. package/src/crypto/mode/gcm.js +7 -7
  395. package/src/crypto/mode/kw.acvp.md +4 -4
  396. package/src/crypto/mode/kw.js +5 -5
  397. package/src/crypto/pkc/ecc.acvp.md +13 -13
  398. package/src/crypto/pkc/ecc.js +9 -11
  399. package/src/crypto/pkc/ed25519.acvp.md +30 -34
  400. package/src/crypto/pkc/ed25519.js +453 -94
  401. package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
  402. package/src/crypto/pkc/hybridSign.js +103 -24
  403. package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
  404. package/src/crypto/pkc/ml_dsa.js +29 -32
  405. package/src/crypto/pkc/ml_kem.acvp.md +7 -7
  406. package/src/crypto/pkc/ml_kem.js +15 -21
  407. package/src/crypto/pkc/rsa.acvp.md +11 -15
  408. package/src/crypto/pkc/rsa.js +7 -44
  409. package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
  410. package/src/crypto/pkc/slh_dsa.js +16 -18
  411. package/src/crypto/pkc/x25519.acvp.md +13 -10
  412. package/src/crypto/pkc/x25519.js +273 -29
  413. package/src/crypto/utils/aes_modes.acvp.md +1 -2
  414. package/src/crypto/utils/aes_modes.js +2 -2
  415. package/src/crypto/utils/asn1-oid.js +1 -1
  416. package/src/crypto/utils/asn1.js +1 -1
  417. package/src/crypto/utils/bitArray.js +33 -48
  418. package/src/crypto/utils/bn.js +1 -1
  419. package/src/crypto/utils/jws.js +37 -41
  420. package/src/crypto/utils/keyformat.js +181 -2
  421. package/src/crypto/utils/pem.js +1 -1
  422. package/src/crypto/utils/random.acvp.md +5 -5
  423. package/src/crypto/utils/random.js +845 -846
  424. package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
  425. package/src/crypto/utils/rsaKeygen.js +6 -6
  426. package/src/crypto/utils/totp.js +1 -1
  427. package/src/crypto/utils/uuid.acvp.md +5 -5
  428. package/src/crypto/utils/uuid.js +11 -10
  429. package/src/crypto/utils/x509.js +591 -0
  430. package/src/crypto/wasm/aes.js +1 -1
  431. package/src/crypto/wasm/aes.scalar.wasm +0 -0
  432. package/src/crypto/wasm/argon2.js +17 -1
  433. package/src/crypto/wasm/argon2.scalar.wasm +0 -0
  434. package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
  435. package/src/crypto/wasm/blake2b.simd.wasm +0 -0
  436. package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
  437. package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
  438. package/src/crypto/wasm/cmac.scalar.wasm +0 -0
  439. package/src/crypto/wasm/ecc.js +3 -3
  440. package/src/crypto/wasm/ecc.scalar.wasm +0 -0
  441. package/src/crypto/wasm/ed25519.js +1 -1
  442. package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
  443. package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
  444. package/src/crypto/wasm/hmac.scalar.wasm +0 -0
  445. package/src/crypto/wasm/ml_dsa.js +2 -2
  446. package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
  447. package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
  448. package/src/crypto/wasm/ml_kem.js +2 -2
  449. package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
  450. package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
  451. package/src/crypto/wasm/pbkdf2.js +8 -6
  452. package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
  453. package/src/crypto/wasm/rsa.js +6 -5
  454. package/src/crypto/wasm/rsa.scalar.wasm +0 -0
  455. package/src/crypto/wasm/runtime.js +84 -17
  456. package/src/crypto/wasm/sha2.scalar.wasm +0 -0
  457. package/src/crypto/wasm/sha3.scalar.wasm +0 -0
  458. package/src/crypto/wasm/sha3.simd.wasm +0 -0
  459. package/src/crypto/wasm/slh_dsa.js +1 -1
  460. package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
  461. package/src/crypto/wasm/x25519.js +1 -1
  462. package/src/crypto/wasm/x25519.scalar.wasm +0 -0
  463. package/src/crypto/webcrypto/aes.js +8 -2
  464. package/src/crypto/webcrypto/aeskw.js +7 -2
  465. package/src/crypto/webcrypto/digest.js +1 -15
  466. package/src/crypto/webcrypto/ecc.js +2 -2
  467. package/src/crypto/webcrypto/ed25519.js +2 -2
  468. package/src/crypto/webcrypto/hmac.js +2 -2
  469. package/src/crypto/webcrypto/rsa.js +7 -2
  470. package/src/crypto/webcrypto/x25519.js +2 -2
  471. package/src/dom/display/animate.js +1 -1
  472. package/src/dom/display/fullscreen.js +1 -1
  473. package/src/dom/fs/download.js +1 -1
  474. package/src/dom/fs/fileIntake.js +192 -0
  475. package/src/dom/fs/fsAccess.js +2 -3
  476. package/src/dom/fs/indexedDB.js +1 -1
  477. package/src/dom/fs/remoteStore.js +1 -1
  478. package/src/dom/fs/storage.js +1 -1
  479. package/src/dom/lifecycle/idle.js +1 -1
  480. package/src/dom/lifecycle/visibility.js +1 -1
  481. package/src/dom/lifecycle/wakeLock.js +1 -1
  482. package/src/dom/net/ajax.js +1 -1
  483. package/src/dom/net/network.js +1 -1
  484. package/src/dom/net/sse.js +1 -1
  485. package/src/dom/net/webrtc.js +1 -1
  486. package/src/dom/net/ws.js +1 -1
  487. package/src/dom/query/dnd.js +56 -4
  488. package/src/dom/query/dom.js +1 -1
  489. package/src/dom/query/events.js +1 -1
  490. package/src/dom/query/gesture.js +1 -1
  491. package/src/dom/query/media.js +1 -1
  492. package/src/dom/query/sound.js +333 -0
  493. package/src/dom/rendering/chart.js +736 -663
  494. package/src/dom/rendering/component.js +25 -14
  495. package/src/dom/rendering/devtools.js +2 -2
  496. package/src/dom/rendering/parser.js +155 -12
  497. package/src/dom/rendering/render.js +14 -4
  498. package/src/dom/rendering/sanitize.js +11 -4
  499. package/src/dom/rendering/secPolicy.js +6 -4
  500. package/src/dom/rendering/styleSheet.js +217 -0
  501. package/src/dom/rendering/template.js +72 -13
  502. package/src/dom/rendering/themeTokens.js +542 -522
  503. package/src/dom/rendering/uiSession-core.js +51 -6
  504. package/src/dom/rendering/uiSession-direct.js +1 -1
  505. package/src/dom/rendering/uiSession-list.js +4 -4
  506. package/src/dom/rendering/uiSession.js +1 -1
  507. package/src/dom/rendering/virtualScroll.js +341 -341
  508. package/src/dom/sensors/battery.js +1 -1
  509. package/src/dom/sensors/geolocation.js +1 -1
  510. package/src/dom/sensors/networkInfo.js +1 -1
  511. package/src/dom/sensors/sensors.js +1 -1
  512. package/src/dom/sw/backgroundSync.js +1 -1
  513. package/src/dom/sw/cache.js +1 -1
  514. package/src/dom/sw/installPrompt.js +151 -0
  515. package/src/dom/sw/precache.js +257 -0
  516. package/src/dom/sw/push.js +1 -1
  517. package/src/dom/sw/sharedWorker.js +1 -1
  518. package/src/dom/sw/swUpdate.js +239 -0
  519. package/src/dom/utils/a11y.js +1 -1
  520. package/src/dom/utils/clipboard.js +56 -6
  521. package/src/dom/utils/entropyCollector.js +1 -1
  522. package/src/dom/utils/focus.js +1 -1
  523. package/src/dom/utils/form.js +1 -1
  524. package/src/dom/utils/keybindings.js +600 -574
  525. package/src/dom/utils/leaderElection.js +1 -1
  526. package/src/dom/utils/notifications.js +1 -1
  527. package/src/dom/utils/permissions.js +107 -107
  528. package/src/dom/utils/route.js +14 -2
  529. package/src/dom/utils/ua.js +42 -28
  530. package/src/dom/utils/webauthn.js +1 -1
  531. package/src/io/binary/reader.js +1 -1
  532. package/src/io/binary/writer.js +1 -1
  533. package/src/io/calc/bigint.js +1 -1
  534. package/src/io/calc/crc32.js +28 -2
  535. package/src/io/calc/easing.js +514 -514
  536. package/src/io/codec/b64.js +189 -52
  537. package/src/io/codec/base32.js +1 -1
  538. package/src/io/codec/base58.js +1 -1
  539. package/src/io/codec/buffer.js +1 -1
  540. package/src/io/codec/cbor.js +111 -18
  541. package/src/io/codec/csv.js +1 -1
  542. package/src/io/codec/hex.js +51 -6
  543. package/src/io/codec/mime.js +1 -1
  544. package/src/io/codec/msgpack.js +47 -6
  545. package/src/io/codec/url.js +24 -7
  546. package/src/io/codec/utf8.js +5 -3
  547. package/src/io/codec/xml.js +1 -1
  548. package/src/io/compress/bitstream.js +2 -2
  549. package/src/io/compress/brotli.js +663 -163
  550. package/src/io/compress/brotli_dict.js +1 -1
  551. package/src/io/compress/brotli_dict_words.js +1 -1
  552. package/src/io/compress/brotli_frame.js +1 -1
  553. package/src/io/compress/brotli_shared.js +7 -7
  554. package/src/io/compress/deflate.js +87 -53
  555. package/src/io/compress/gzip.js +187 -74
  556. package/src/io/compress/huffman.js +24 -1
  557. package/src/io/compress/lz4.js +45 -7
  558. package/src/io/compress/lz77.js +148 -63
  559. package/src/io/compress/lzw.js +35 -19
  560. package/src/io/compress/zip.js +862 -815
  561. package/src/io/compress/zlib.js +87 -7
  562. package/src/io/i18n/i18n.js +1 -1
  563. package/src/io/math/fixed-point.js +1 -1
  564. package/src/io/math/geom.js +1 -1
  565. package/src/io/math/interp.js +1 -1
  566. package/src/io/math/linalg.js +10 -4
  567. package/src/io/math/stats.js +1 -1
  568. package/src/io/structures/btree.js +1 -1
  569. package/src/io/structures/heap.js +1 -1
  570. package/src/io/structures/lruCache.js +1 -1
  571. package/src/io/structures/ringBuffer.js +1 -1
  572. package/src/io/structures/tree-walker.js +1 -1
  573. package/src/io/structures/trie.js +1 -1
  574. package/src/io/sync/abort.js +1 -1
  575. package/src/io/sync/atomics.js +1 -1
  576. package/src/io/sync/cancellable.js +1 -1
  577. package/src/io/sync/channel.js +1 -1
  578. package/src/io/sync/mutex.js +1 -1
  579. package/src/io/sync/semaphore.js +1 -1
  580. package/src/io/sync/tokenBucket.js +1 -1
  581. package/src/io/text/ansi.js +1 -1
  582. package/src/io/text/html-entities.js +1 -1
  583. package/src/io/time/date.js +1 -1
  584. package/src/io/timing/clock.js +1 -1
  585. package/src/io/timing/rateLimit.js +1 -1
  586. package/src/io/timing/scheduler.js +1 -1
  587. package/src/io/utils/errors.js +1 -1
  588. package/src/io/utils/eventBus.js +1 -1
  589. package/src/io/utils/signal.js +1 -1
  590. package/src/io/utils/valid.js +1 -1
  591. package/src/main.js +1 -1
  592. package/src/process/message.js +1 -1
  593. package/src/process/rpc.js +7 -3
  594. package/src/process/workerPool.js +11 -4
  595. package/src/sanity/base.js +85 -39
  596. package/src/sanity/lockdown-apply.js +3 -3
  597. package/src/sanity/lockdown.js +58 -32
  598. package/src/sanity/wasm-gate.js +2 -2
  599. package/src/typed.js +7 -3
  600. package/third-party/NOTICE-brotli-dictionary.txt +69 -0
  601. package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
  602. package/third-party/NOTICE-whatwg-entities.txt +44 -0
  603. package/types/registry.generated.d.ts +7 -1
  604. package/types/typed.d.ts +7 -3
  605. package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
  606. package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
  607. package/docs/api/crypto/utils/aes_ctr.md +0 -71
  608. package/src/crypto/utils/aes_ctr.acvp.md +0 -67
  609. package/src/crypto/utils/aes_ctr.js +0 -134
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -36,11 +36,9 @@ import { ed25519 } from '../pkc/ed25519.js';
36
36
  * Public shape returned by `jws.factory()`.
37
37
  * @typedef {object} JwsAPI
38
38
  * @property {(payload: Uint8Array, alg: string, key: Uint8Array, extraHeader?: Object) => (string|false)} sign Sign a payload and return a compact JWS.
39
- * @property {(token: string, key: Uint8Array, opts?: {expectedAlg?: string|string[], expectedTyp?: string}) => ({header:Object, payload:Uint8Array, claims?: Object}|false)} verify Verify a compact JWS.
39
+ * @property {(token: string, key: Uint8Array, opts: {expectedAlg: string|string[], expectedTyp?: string}) => ({header:Object, payload:Uint8Array, claims?: Object}|false)} verify Verify a compact JWS (`expectedAlg` required).
40
40
  * @property {(claims: Object, alg: string, key: Uint8Array) => (string|false)} signJwt Sign a JSON claim set as a JWT.
41
- * @property {(token: string, key: Uint8Array, opts?: {expectedAlg?: string|string[], expectedTyp?: string}) => ({header:Object, payload:Uint8Array, claims?: Object}|false)} verifyJwt Verify a JWT and parse its claims.
42
- * @property {(bytes: Uint8Array) => string} _b64uEnc base64url (no padding) encode.
43
- * @property {(s: string) => (Uint8Array|false)} _b64uDec base64url (no padding) decode.
41
+ * @property {(token: string, key: Uint8Array, opts: {expectedAlg: string|string[], expectedTyp?: string}) => ({header:Object, payload:Uint8Array, claims?: Object}|false)} verifyJwt Verify a JWT and parse its claims (`expectedAlg` required).
44
42
  */
45
43
 
46
44
  export const jws = {
@@ -53,21 +51,12 @@ export const jws = {
53
51
  /** @returns {JwsAPI} */
54
52
  factory(bitArray, utf8, b64, hmac, sha256, sha512, ed25519) {
55
53
 
56
- // ── base64url codec (no padding) - wraps the standard b64 codec ──
54
+ // ── base64url (no padding): `b64.url`, whose decoder accepts the
55
+ // canonical form only (RFC 4648 sections 3.5 and 5), so a token has
56
+ // one accepted spelling and is not malleable.
57
57
 
58
- function _b64uEnc(bytes) {
59
- return b64.fromBytes(bytes).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
60
- }
61
-
62
- function _b64uDec(s) {
63
- if (!/^[A-Za-z0-9\-_]*$/.test(s)) {
64
- console.warn('[crypto] INVALID: jws: malformed base64url');
65
- return false;
66
- }
67
- const std = s.replace(/-/g, '+').replace(/_/g, '/');
68
- const pad = (4 - (std.length % 4)) % 4;
69
- return b64.toBytes(std + '='.repeat(pad));
70
- }
58
+ const _b64uEnc = b64.url.fromBytes;
59
+ const _decodeStrict = b64.url.toBytes;
71
60
 
72
61
  // ── string helpers ──────────────────────────────────────────────
73
62
 
@@ -130,43 +119,51 @@ export const jws = {
130
119
  * Verify a compact JWS. `key` is the HMAC secret (Uint8Array) for
131
120
  * HS*, or the Ed25519 public key (32 bytes) for EdDSA.
132
121
  *
133
- * Algorithm pinning: if `expectedAlg` is provided (string or array
134
- * of acceptable algs), the header `alg` field MUST be in the
135
- * allowlist - this prevents alg-confusion / alg-downgrade attacks
136
- * where an attacker substitutes the header to flip HS512 → HS256.
122
+ * Algorithm pinning: `expectedAlg` (an alg, or a non-empty array of
123
+ * acceptable algs) is required, and the header `alg` field MUST be
124
+ * in it - this prevents alg-confusion / alg-downgrade attacks where
125
+ * an attacker substitutes the header to flip HS512 → HS256, or MACs
126
+ * an HS256 token with an Ed25519 public key (RFC 8725 §3.1).
127
+ * Without it `verify` throws a `TypeError`: the caller's error, not
128
+ * the token's.
137
129
  *
138
130
  * `typ` pinning: if `expectedTyp` is provided, the header `typ`
139
131
  * field MUST equal it (defends against cross-protocol confusion).
140
132
  *
141
133
  * @param {string} token
142
134
  * @param {Uint8Array} key
143
- * @param {{expectedAlg?: string|string[], expectedTyp?: string}} [opts]
135
+ * @param {{expectedAlg: string|string[], expectedTyp?: string}} opts
144
136
  * @returns {{header:Object, payload:Uint8Array, claims?: Object}|false}
145
137
  */
146
138
  function verify(token, key, opts) {
139
+ /** @type {{expectedAlg?: string|string[], expectedTyp?: string}} */
147
140
  const o = opts || {};
141
+ const allowed = Array.isArray(o.expectedAlg) ? o.expectedAlg : [o.expectedAlg];
142
+ if (allowed.length === 0 || !allowed.every((a) => typeof a === 'string' && a !== '')) {
143
+ throw new TypeError('jws.verify: expectedAlg is required (an alg, or a non-empty array of algs)');
144
+ }
148
145
  const parts = String(token).split('.');
149
146
  if (parts.length !== 3) {
150
147
  console.warn('[crypto] INVALID: jws: token must have 3 parts');
151
148
  return false;
152
149
  }
153
150
  const [h64, p64, s64] = parts;
154
- const headerBytes = _b64uDec(h64);
155
- const payloadBytes = _b64uDec(p64);
156
- const sig = _b64uDec(s64);
157
- if (headerBytes === false || payloadBytes === false || sig === false) return false;
151
+ const headerBytes = _decodeStrict(h64);
152
+ const payloadBytes = _decodeStrict(p64);
153
+ const sig = _decodeStrict(s64);
154
+ if (headerBytes === false || payloadBytes === false || sig === false) {
155
+ console.warn('[crypto] INVALID: jws: malformed base64url');
156
+ return false;
157
+ }
158
158
 
159
159
  let header;
160
160
  try { header = JSON.parse(_bytesStr(headerBytes)); }
161
161
  catch { console.warn('[crypto] INVALID: jws: malformed header JSON'); return false; }
162
162
 
163
163
  const alg = header.alg;
164
- if (o.expectedAlg !== undefined) {
165
- const allowed = Array.isArray(o.expectedAlg) ? o.expectedAlg : [o.expectedAlg];
166
- if (!allowed.includes(alg)) {
167
- console.warn('[crypto] INVALID: jws: alg ' + alg + ' not in expectedAlg allowlist');
168
- return false;
169
- }
164
+ if (!allowed.includes(alg)) {
165
+ console.warn('[crypto] INVALID: jws: alg ' + alg + ' not in expectedAlg allowlist');
166
+ return false;
170
167
  }
171
168
  if (o.expectedTyp !== undefined && header.typ !== o.expectedTyp) {
172
169
  console.warn('[crypto] INVALID: jws: typ ' + header.typ + ' does not match expectedTyp ' + o.expectedTyp);
@@ -180,13 +177,15 @@ export const jws = {
180
177
  if (expected === false) return false;
181
178
  ok = _ctEq(expected, sig);
182
179
  } else if (alg === 'EdDSA') {
183
- ok = ed25519.verify(key, _strBytes(signingInput), sig);
180
+ ok = ed25519.verify(key, sig, _strBytes(signingInput));
184
181
  } else {
185
182
  console.warn('[crypto] INVALID: jws: unsupported alg ' + alg);
186
183
  return false;
187
184
  }
188
185
  if (!ok) {
189
- console.error('[crypto] CORRUPT: jws: signature verification failed');
186
+ // A failed check is an expected outcome, reported at warn
187
+ // level (the crypto logging policy, NIST_CONFORMANCE.md).
188
+ console.warn('[crypto] CORRUPT: jws: signature verification failed');
190
189
  return false;
191
190
  }
192
191
  return { header, payload: payloadBytes };
@@ -204,7 +203,7 @@ export const jws = {
204
203
  * `expectedAlg` / `expectedTyp` pinning as {@link verify}.
205
204
  * @param {string} token
206
205
  * @param {Uint8Array} key
207
- * @param {{expectedAlg?: string|string[], expectedTyp?: string}} [opts]
206
+ * @param {{expectedAlg: string|string[], expectedTyp?: string}} opts
208
207
  */
209
208
  function verifyJwt(token, key, opts) {
210
209
  const r = verify(token, key, opts);
@@ -214,9 +213,6 @@ export const jws = {
214
213
  return r;
215
214
  }
216
215
 
217
- return {
218
- sign, verify, signJwt, verifyJwt,
219
- _b64uEnc, _b64uDec
220
- };
216
+ return { sign, verify, signJwt, verifyJwt };
221
217
  }
222
218
  };
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -12,6 +12,8 @@
12
12
  * • SEC1 (RFC 5915) - `ECPrivateKey` (used inside PKCS#8 for EC)
13
13
  * • RFC 8410 - Ed25519 / X25519 wrappers (Ed448 / X448 NOT supported;
14
14
  * add `1.3.101.112`/`113` entries with `RAW_LEN = 57` to extend.)
15
+ * • PKCS#1 (RFC 8017 A.1) - `RSAPublicKey` / `RSAPrivateKey`, and RSA
16
+ * inside SPKI / PKCS#8 (rsaEncryption, NULL parameters)
15
17
  *
16
18
  * Curve OIDs supported:
17
19
  * • Ed25519 1.3.101.112
@@ -25,6 +27,10 @@
25
27
  * @typedef {{ d: Uint8Array, curveOid?: string, publicKey?: Uint8Array }} EcSec1Decoded
26
28
  * @typedef {{ curveOid: string, d: Uint8Array, publicKey?: Uint8Array }} EcPkcs8Decoded
27
29
  * @typedef {{ curveOid: string, point: Uint8Array }} EcSpkiDecoded
30
+ * @typedef {{ n: Uint8Array, e: Uint8Array }} RsaPublicKeyParts
31
+ * Unsigned big-endian integers (the shape `pkc/rsa.js` takes).
32
+ * @typedef {{ n: Uint8Array, e: Uint8Array, d: Uint8Array, p: Uint8Array, q: Uint8Array, dp: Uint8Array, dq: Uint8Array, qInv: Uint8Array }} RsaPrivateKeyParts
33
+ * A two-prime RSA private key, every integer unsigned big-endian.
28
34
  *
29
35
  */
30
36
 
@@ -42,6 +48,14 @@
42
48
  * @property {(der: Uint8Array) => (EcPkcs8Decoded|false)} decodePkcs8Ec Decode a PKCS#8 EC private key.
43
49
  * @property {(curveOid: string, uncompressedPoint: Uint8Array) => (Uint8Array|false)} encodeSpkiEc Wrap an uncompressed EC public key as SPKI.
44
50
  * @property {(der: Uint8Array) => (EcSpkiDecoded|false)} decodeSpkiEc Decode an EC SPKI.
51
+ * @property {(key: RsaPublicKeyParts) => (Uint8Array|false)} encodeRsaPublicKey Encode a PKCS#1 `RSAPublicKey`.
52
+ * @property {(der: Uint8Array) => (RsaPublicKeyParts|false)} decodeRsaPublicKey Decode a PKCS#1 `RSAPublicKey`.
53
+ * @property {(key: RsaPrivateKeyParts) => (Uint8Array|false)} encodeRsaPrivateKey Encode a PKCS#1 `RSAPrivateKey` (version 0).
54
+ * @property {(der: Uint8Array) => (RsaPrivateKeyParts|false)} decodeRsaPrivateKey Decode a two-prime PKCS#1 `RSAPrivateKey`.
55
+ * @property {(key: RsaPublicKeyParts) => (Uint8Array|false)} encodeSpkiRsa Wrap an RSA public key as SPKI.
56
+ * @property {(der: Uint8Array) => (RsaPublicKeyParts|false)} decodeSpkiRsa Decode an RSA SPKI.
57
+ * @property {(key: RsaPrivateKeyParts) => (Uint8Array|false)} encodePkcs8Rsa Wrap an RSA private key as PKCS#8.
58
+ * @property {(der: Uint8Array) => (RsaPrivateKeyParts|false)} decodePkcs8Rsa Decode an RSA PKCS#8 private key.
45
59
  */
46
60
 
47
61
  import { asn1 } from './asn1.js';
@@ -289,6 +303,166 @@ export const keyformat = {
289
303
  return { curveOid, point: new Uint8Array(bs.bytes) };
290
304
  }
291
305
 
306
+ // ── RSA (RFC 8017 A.1, RFC 3279 §2.3.1) ───────────────────────
307
+
308
+ const RSA_PRIV_FIELDS = ['n', 'e', 'd', 'p', 'q', 'dp', 'dq', 'qInv'];
309
+
310
+ /** @param {string} why @returns {false} */
311
+ function _rsaBad(why) {
312
+ console.warn('[crypto] INVALID: keyformat: RSA ' + why);
313
+ return false;
314
+ }
315
+
316
+ /**
317
+ * Parse `der` as exactly one SEQUENCE and return its children.
318
+ * @param {unknown} der
319
+ * @returns {import('./asn1.js').Asn1Node[]|false}
320
+ */
321
+ function _seq(der) {
322
+ if (!(der instanceof Uint8Array)) return false;
323
+ const top = asn1.parseOne(der, 0);
324
+ if (!top || top.tag !== 0x30 || top.next !== der.length) return false;
325
+ return asn1.parseChildren(top.value);
326
+ }
327
+
328
+ /**
329
+ * A non-negative INTEGER node as unsigned big-endian bytes (the DER
330
+ * sign byte dropped).
331
+ * @returns {Uint8Array|false}
332
+ */
333
+ function _uint(node) {
334
+ const raw = asn1.readInteger(node);
335
+ if (raw === false || raw.length === 0 || (raw[0] & 0x80)) return false;
336
+ let i = 0;
337
+ while (i < raw.length - 1 && raw[i] === 0) i++;
338
+ return new Uint8Array(raw.subarray(i));
339
+ }
340
+
341
+ /** Whether every named field is a non-empty `Uint8Array`. */
342
+ function _hasInts(key, fields) {
343
+ return !!key && fields.every((f) => key[f] instanceof Uint8Array && key[f].length > 0);
344
+ }
345
+
346
+ /** The `{rsaEncryption, NULL}` AlgorithmIdentifier. */
347
+ function _rsaAlgId() {
348
+ return _algId(OID.RSA, asn1.encodeNull());
349
+ }
350
+
351
+ /** Whether an AlgorithmIdentifier node is `{rsaEncryption, NULL}`. */
352
+ function _isRsaAlgId(node) {
353
+ if (!node || node.tag !== 0x30) return false;
354
+ const k = asn1.parseChildren(node.value);
355
+ return !!k && k.length === 2 && asn1.readOid(k[0]) === OID.RSA
356
+ && k[1].tag === 0x05 && k[1].length === 0;
357
+ }
358
+
359
+ /**
360
+ * Encode a PKCS#1 `RSAPublicKey ::= SEQUENCE { modulus, publicExponent }`.
361
+ * @param {RsaPublicKeyParts} key
362
+ * @returns {Uint8Array|false}
363
+ */
364
+ function encodeRsaPublicKey(key) {
365
+ if (!_hasInts(key, ['n', 'e'])) return _rsaBad('public key needs n and e');
366
+ return asn1.encodeSequence([asn1.encodeInteger(key.n), asn1.encodeInteger(key.e)]);
367
+ }
368
+
369
+ /**
370
+ * Decode a PKCS#1 `RSAPublicKey`.
371
+ * @param {Uint8Array} der
372
+ * @returns {RsaPublicKeyParts|false}
373
+ */
374
+ function decodeRsaPublicKey(der) {
375
+ const kids = _seq(der);
376
+ if (!kids || kids.length !== 2) return _rsaBad('RSAPublicKey needs exactly modulus + exponent');
377
+ const n = _uint(kids[0]);
378
+ const e = _uint(kids[1]);
379
+ if (!n || !e) return _rsaBad('RSAPublicKey integers malformed');
380
+ return { n, e };
381
+ }
382
+
383
+ /**
384
+ * Encode a two-prime PKCS#1 `RSAPrivateKey` (version 0, RFC 8017 A.1.2).
385
+ * @param {RsaPrivateKeyParts} key
386
+ * @returns {Uint8Array|false}
387
+ */
388
+ function encodeRsaPrivateKey(key) {
389
+ if (!_hasInts(key, RSA_PRIV_FIELDS)) {
390
+ return _rsaBad('private key needs n, e, d, p, q, dp, dq and qInv');
391
+ }
392
+ return asn1.encodeSequence([asn1.encodeInteger(0), ...RSA_PRIV_FIELDS.map((f) => asn1.encodeInteger(key[f]))]);
393
+ }
394
+
395
+ /**
396
+ * Decode a PKCS#1 `RSAPrivateKey`. A multi-prime key (version 1) is
397
+ * refused.
398
+ * @param {Uint8Array} der
399
+ * @returns {RsaPrivateKeyParts|false}
400
+ */
401
+ function decodeRsaPrivateKey(der) {
402
+ const kids = _seq(der);
403
+ if (!kids || kids.length !== 9) return _rsaBad('RSAPrivateKey needs version + 8 integers (two-prime)');
404
+ const version = asn1.readInteger(kids[0]);
405
+ if (!version || version.length !== 1 || version[0] !== 0) return _rsaBad('RSAPrivateKey version must be 0');
406
+ /** @type {Record<string, Uint8Array>} */
407
+ const out = {};
408
+ for (let i = 0; i < RSA_PRIV_FIELDS.length; i++) {
409
+ const v = _uint(kids[i + 1]);
410
+ if (!v) return _rsaBad('RSAPrivateKey integer ' + RSA_PRIV_FIELDS[i] + ' malformed');
411
+ out[RSA_PRIV_FIELDS[i]] = v;
412
+ }
413
+ return /** @type {RsaPrivateKeyParts} */ (/** @type {unknown} */ (out));
414
+ }
415
+
416
+ /**
417
+ * Wrap an RSA public key as a SubjectPublicKeyInfo (rsaEncryption).
418
+ * @param {RsaPublicKeyParts} key
419
+ * @returns {Uint8Array|false}
420
+ */
421
+ function encodeSpkiRsa(key) {
422
+ const pkcs1 = encodeRsaPublicKey(key);
423
+ if (pkcs1 === false) return false;
424
+ return asn1.encodeSequence([_rsaAlgId(), asn1.encodeBitString(pkcs1, 0)]);
425
+ }
426
+
427
+ /**
428
+ * Decode an RSA SubjectPublicKeyInfo.
429
+ * @param {Uint8Array} der
430
+ * @returns {RsaPublicKeyParts|false}
431
+ */
432
+ function decodeSpkiRsa(der) {
433
+ const kids = _seq(der);
434
+ if (!kids || kids.length !== 2 || !_isRsaAlgId(kids[0])) return _rsaBad('not an RSA SPKI (rsaEncryption, NULL)');
435
+ const bs = asn1.readBitString(kids[1]);
436
+ if (!bs || bs.unusedBits !== 0) return _rsaBad('SPKI subjectPublicKey malformed');
437
+ return decodeRsaPublicKey(bs.bytes);
438
+ }
439
+
440
+ /**
441
+ * Wrap an RSA private key as PKCS#8 (version 0, rsaEncryption).
442
+ * @param {RsaPrivateKeyParts} key
443
+ * @returns {Uint8Array|false}
444
+ */
445
+ function encodePkcs8Rsa(key) {
446
+ const pkcs1 = encodeRsaPrivateKey(key);
447
+ if (pkcs1 === false) return false;
448
+ return asn1.encodeSequence([asn1.encodeInteger(0), _rsaAlgId(), asn1.encodeOctetString(pkcs1)]);
449
+ }
450
+
451
+ /**
452
+ * Decode an RSA PKCS#8 private key.
453
+ * @param {Uint8Array} der
454
+ * @returns {RsaPrivateKeyParts|false}
455
+ */
456
+ function decodePkcs8Rsa(der) {
457
+ const kids = _seq(der);
458
+ if (!kids || kids.length !== 3) return _rsaBad('PKCS#8 needs exactly version + algId + privateKey');
459
+ const version = asn1.readInteger(kids[0]);
460
+ if (!version || version.length !== 1 || version[0] !== 0) return _rsaBad('PKCS#8 version must be 0');
461
+ if (!_isRsaAlgId(kids[1])) return _rsaBad('not an RSA PKCS#8 key (rsaEncryption, NULL)');
462
+ if (kids[2].tag !== 0x04) return _rsaBad('PKCS#8 privateKey is not an OCTET STRING');
463
+ return decodeRsaPrivateKey(kids[2].value);
464
+ }
465
+
292
466
  return {
293
467
  OID,
294
468
  // Edwards (Ed25519 / X25519)
@@ -297,7 +471,12 @@ export const keyformat = {
297
471
  // EC (P-256/384/521)
298
472
  encodeSec1, decodeSec1,
299
473
  encodePkcs8Ec, decodePkcs8Ec,
300
- encodeSpkiEc, decodeSpkiEc
474
+ encodeSpkiEc, decodeSpkiEc,
475
+ // RSA (PKCS#1, SPKI, PKCS#8)
476
+ encodeRsaPublicKey, decodeRsaPublicKey,
477
+ encodeRsaPrivateKey, decodeRsaPrivateKey,
478
+ encodeSpkiRsa, decodeSpkiRsa,
479
+ encodePkcs8Rsa, decodePkcs8Rsa
301
480
  };
302
481
  }
303
482
  };
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -38,7 +38,7 @@ Two surfaces:
38
38
  - **Continuous health tests (SP 800-90B)**: RCT (C=4) + APT (W=512,
39
39
  C=13), permanent latch-dead on failure.
40
40
 
41
- API: `random.factory(bitArray, aes, sha256)`; `_internal.makeDrbg()`
41
+ API: `random.factory(bitArray, aes, sha256)`; `internalOf(random).makeDrbg()`
42
42
  exposed for ACVP replay with controlled entropy (test-only,
43
43
  **out-of-band for production**).
44
44
 
@@ -109,10 +109,10 @@ Each vector executes the SP 800-90A §10.2.1 spec sequence:
109
109
  - [x] **SHA-256 folding** — additional input > 48 bytes folded to 32
110
110
  bytes (buffer bounding).
111
111
  - [x] **CTR_DRBG with df (derivation function, SP 800-90A §10.4.2)** —
112
- **Iteration H4**: `_makeDrbg({ aesKeyBits, df: true })` implements a full
112
+ `_makeDrbg({ aesKeyBits, df: true })` implements a full
113
113
  BCC + Block_Cipher_df. Allows entropy / nonce / perso of arbitrary
114
114
  length to be distilled to seedlen.
115
- - [x] **CTR_DRBG-AES-128/192** — **Iteration H4**: parametric `_makeDrbg({
115
+ - [x] **CTR_DRBG-AES-128/192** — parametric `_makeDrbg({
116
116
  aesKeyBits: 128|192|256, df })`. KEY_BYTES = aesKeyBits/8 and SEED_BYTES =
117
117
  KEY_BYTES + 16 derived at runtime. `ctrDRBG-1.0` ACVP vectors with
118
118
  predResistance=false validated byte-exact for 5 combos (AES-128/192 ×
@@ -148,7 +148,7 @@ Each vector executes the SP 800-90A §10.2.1 spec sequence:
148
148
  consistent 256-bit security strength. 90 ACVP vectors filtered out.
149
149
  - **HMAC_DRBG / Hash_DRBG** (SP 800-90A §10.1): not implemented.
150
150
  CTR_DRBG was chosen to reuse the already-validated AES block.
151
- - **`_internal.makeDrbg`**: test-only surface exposing the constructor
151
+ - **`internalOf(random).makeDrbg`**: test-only surface exposing the constructor
152
152
  without automatic seeding. Documented in a comment; **must not be
153
153
  called from application code** — the FIPS lifecycle (POST + RCT/APT +
154
154
  OS NRBG seeding) is only guaranteed via `drbg()`.
@@ -160,7 +160,7 @@ Each vector executes the SP 800-90A §10.2.1 spec sequence:
160
160
  ## Cross-references
161
161
 
162
162
  - Module: [`utils/random.js`](./random.js)
163
- - Tests: [`utils/random.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/utils/random.test.js) — **80 tests** (65 baseline + 15 iteration H4: CTR_DRBG-AES-{128,192} no-df + AES-{128,192,256} with-df, [first/mid/last] sub-sample by default, 140 under `CRYPTO_FULL=1`)
163
+ - Tests: [`utils/random.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/utils/random.test.js) — **80 tests** (65 baseline + 15 more: CTR_DRBG-AES-{128,192} no-df + AES-{128,192,256} with-df, [first/mid/last] sub-sample by default, 140 under `CRYPTO_FULL=1`)
164
164
  - ACVP draft: `references/NIST/ACVP/src/draft-vassilev-acvp-drbg.adoc`
165
165
  - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ctrDRBG-1.0/`
166
166
  - Underlying AES: [`../cipher/aes.acvp.md`](../cipher/aes.acvp.md)