@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
@@ -19,40 +19,49 @@ Strict DER serialisation for key formats (PKCS#8, SPKI, SEC1, JWK Key OPS) and s
19
19
 
20
20
  ```js
21
21
  const asn1 = runtime.resolve('asn1');
22
- // Returns: { encode, decode, oid, ... }
22
+ // Returns: { TAG, encodeInteger, encodeOctetString, encodeBitString, encodeNull, encodeOid,
23
+ // encodeSequence, encodeSet, encodeExplicit, encodeImplicit,
24
+ // parseOne, parseChildren, readInteger, readOid, readBitString }
23
25
  ```
24
26
 
25
- ## API (excerpt)
27
+ ## API
26
28
 
27
29
  | Method | Signature | Returns |
28
30
  |--------|-----------|---------|
29
- | `encode(value, type)` | — | DER bytes |
30
- | `decode(bytes)` | — | Tree `{type, length, value}` |
31
- | `oid(dotted)` | — | Encoded OID |
32
-
33
- Supported types: `INTEGER`, `OCTET STRING`, `BIT STRING`, `OID`, `SEQUENCE`, `SET`, `NULL`, `IA5String`, `UTF8String`, `OBJECT IDENTIFIER`, `BOOLEAN`.
31
+ | `TAG` | `{INTEGER, BIT_STRING, OCTET_STRING, NULL, OID, SEQUENCE, SET}` | Tag-byte constants |
32
+ | `encodeInteger(value)` | `(Uint8Array \| number[] \| number) => Uint8Array \| false` | An INTEGER TLV (minimal two's-complement) |
33
+ | `encodeOctetString(bytes)` | `(Uint8Array \| number[]) => Uint8Array \| false` | An OCTET STRING TLV |
34
+ | `encodeBitString(bytes, unusedBits)` | `(Uint8Array \| number[], number) => Uint8Array \| false` | A BIT STRING TLV |
35
+ | `encodeNull()` | `() => Uint8Array` | `05 00` |
36
+ | `encodeOid(dotted)` | `(string) => Uint8Array \| false` | An OBJECT IDENTIFIER TLV |
37
+ | `encodeSequence(items)` / `encodeSet(items)` | `(Uint8Array[]) => Uint8Array \| false` | A SEQUENCE / SET of encoded TLVs |
38
+ | `encodeExplicit(n, body)` | `(number, Uint8Array) => Uint8Array \| false` | `body` wrapped in context-specific `[n]` EXPLICIT |
39
+ | `encodeImplicit(n, tlv, constructed?)` | `(number, Uint8Array, boolean?) => Uint8Array` | `tlv` re-tagged as context-specific `[n]` IMPLICIT |
40
+ | `parseOne(buf, off)` | `(Uint8Array, number) => node \| false` | One TLV: `{tag, length, value, valueOff, next}` (`value` is a view into `buf`) |
41
+ | `parseChildren(value)` | `(Uint8Array) => node[] \| false` | The TLVs of a constructed value |
42
+ | `readInteger(node)` | `(node) => Uint8Array \| false` | The INTEGER's two's-complement bytes |
43
+ | `readOid(node)` | `(node) => string \| false` | The OID, dotted |
44
+ | `readBitString(node)` | `(node) => {unusedBits, bytes} \| false` | The BIT STRING's content |
34
45
 
35
46
  ## Examples
36
47
 
37
48
  ```js
38
49
  const { asn1, hex } = fw.runtime.resolveAll(['asn1', 'hex']);
39
50
 
40
- // ECDSA signature : SEQUENCE { INTEGER r, INTEGER s }
41
- const der = asn1.encode({
42
- type: 'SEQUENCE',
43
- value: [
44
- { type: 'INTEGER', value: rBytes },
45
- { type: 'INTEGER', value: sBytes }
46
- ]
47
- });
51
+ // ECDSA signature: SEQUENCE { INTEGER r, INTEGER s }
52
+ const der = asn1.encodeSequence([asn1.encodeInteger(rBytes), asn1.encodeInteger(sBytes)]);
48
53
  hex.fromBytes(der);
54
+
55
+ // and back
56
+ const seq = asn1.parseOne(der, 0);
57
+ const [r, s] = asn1.parseChildren(seq.value).map(asn1.readInteger);
49
58
  ```
50
59
 
51
60
  ## Worker Usage
52
61
 
53
62
  ```js
54
63
  const worker = fw.createWorker(
55
- function ({ libs, args }) { self.postMessage(libs.asn1.decode(args[0])); },
64
+ function ({ libs, args }) { self.postMessage(libs.asn1.parseOne(args[0], 0).tag); },
56
65
  { dependencies: ['asn1'], args: [derBytes] }
57
66
  );
58
67
  ```
@@ -27,15 +27,15 @@ const jws = runtime.resolve('jws');
27
27
  | Method | Signature | Returns |
28
28
  |--------|-----------|---------|
29
29
  | `sign(payload, alg, key, extraHeader?)` | `(Uint8Array, 'HS256'\|'HS512'\|'EdDSA', Uint8Array, Object?) => string \| false` | Compact JWS token |
30
- | `verify(token, key, opts?)` | `(string, Uint8Array, {expectedAlg?, expectedTyp?}) => {header, payload} \| false` | Verified result or `false` |
30
+ | `verify(token, key, opts)` | `(string, Uint8Array, {expectedAlg, expectedTyp?}) => {header, payload} \| false` | Verified result or `false`; throws `TypeError` without `expectedAlg` |
31
31
  | `signJwt(claims, alg, key)` | `(Object, string, Uint8Array) => string \| false` | Sign shortcut with `typ:'JWT'` |
32
- | `verifyJwt(token, key, opts?)` | `(string, Uint8Array, {expectedAlg?, expectedTyp?}) => {header, payload, claims} \| false` | Verify + parse JSON claims |
32
+ | `verifyJwt(token, key, opts)` | `(string, Uint8Array, {expectedAlg, expectedTyp?}) => {header, payload, claims} \| false` | Verify + parse JSON claims; throws `TypeError` without `expectedAlg` |
33
33
 
34
34
  ### `verify` / `verifyJwt` — options
35
35
 
36
36
  | Option | Type | Description |
37
37
  |--------|------|-------------|
38
- | `expectedAlg` | `string \| string[]` | Algorithm allowlist (anti-alg-confusion / downgrade) |
38
+ | `expectedAlg` | `string \| string[]` | **Required.** Algorithm allowlist (anti-alg-confusion / downgrade); a token whose header `alg` is not in it is refused (`false`) |
39
39
  | `expectedTyp` | `string` | Expected value of the `typ` field (anti-cross-protocol confusion) |
40
40
 
41
41
  ## Examples
@@ -82,7 +82,9 @@ const worker = fw.createWorker(
82
82
 
83
83
  ## Notes
84
84
 
85
- - **`verify` with `expectedAlg`**: always pass `expectedAlg` to prevent alg-confusion attacks (RFC 8725 §3.1) — e.g. an attacker flipping HS512→HS256 in the header.
85
+ - **`verify` requires `expectedAlg`** (RFC 8725 §3.1): the header must not choose the algorithm — an attacker could flip HS512→HS256, or sign an `HS256` token with an Ed25519 **public** key as the HMAC key, which verifies against that key when the header decides. Without `expectedAlg` (or with an empty one), `verify` and `verifyJwt` throw a `TypeError` before reading the token.
86
+ - **Canonical base64url only**: each part must be unpadded base64url (RFC 4648 §5) in its canonical form — a length of 1 mod 4, or non-zero unused bits in the last character, is refused (`false` + one `INVALID` warning per call). A token therefore has one spelling, and two tokens with the same bytes compare equal as strings.
87
+ - **Log levels**: a malformed token or a mismatched `alg`/`typ` warns `INVALID`; a signature that does not verify warns `CORRUPT` — an expected outcome, reported at warn level, never as `console.error`.
86
88
  - **`expectedTyp`**: use to prevent cross-protocol token reuse (e.g. a generic JWS token accepted as a JWT).
87
89
  - **HS384 not supported** — no `sha384` dependency declared in the factory; warns if attempted.
88
90
  - **alg='none'** not accepted (RFC 8725 §3.1) — returns `false` + `console.warn('INVALID')`.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: keyformat
3
3
  category: crypto/utils
4
- dependencies: [asn1, pem, bitArray]
4
+ dependencies: [asn1]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -9,11 +9,11 @@ status: complete
9
9
 
10
10
  # keyformat
11
11
 
12
- > EC / Ed25519 / X25519 key serialisation — PKCS#8 (PrivateKeyInfo) + SPKI + SEC1 (RFC 5915 / RFC 8410).
12
+ > RSA / EC / Ed25519 / X25519 key serialisation — PKCS#8, SPKI, SEC1, PKCS#1 (RFC 5915 / 8410 / 8017).
13
13
 
14
- **Module** `keyformat` | **Source** `packages/front/fw/src/crypto/utils/keyformat.js` | **Deps** `asn1`, `pem`, `bitArray` | **Worker-safe** yes
14
+ **Module** `keyformat` | **Source** `packages/front/fw/src/crypto/utils/keyformat.js` | **Deps** `asn1` | **Worker-safe** yes
15
15
 
16
- Round-trip for ECDSA (P-256/384/521), Ed25519, X25519 keys. Pivot format for interop with OpenSSL / WebCrypto / Node. RSA is not handled here (the `rsaKeygen` module returns `{n,e,d,p,q,dp,dq,qInv}` directly as Uint8Array).
16
+ Round-trip for RSA, ECDSA (P-256/384/521), Ed25519 and X25519 keys. Pivot format for interop with OpenSSL / WebCrypto / Node. RSA keys use the shapes [`rsaKeygen`](./rsaKeygen.md) returns and [`rsa`](../pkc/rsa.md) takes: `{ n, e }` and `{ n, e, d, p, q, dp, dq, qInv }`, unsigned big-endian `Uint8Array`s.
17
17
 
18
18
  ## Resolve
19
19
 
@@ -38,20 +38,29 @@ const keyformat = runtime.resolve('keyformat');
38
38
  | `encodeSec1` / `decodeSec1` | EC (P-256/384/521) — raw `ECPrivateKey` | RFC 5915 |
39
39
  | `encodePkcs8Ec` / `decodePkcs8Ec` | EC — PKCS#8 private key (wraps SEC1) | RFC 5208 + RFC 5915 |
40
40
  | `encodeSpkiEc` / `decodeSpkiEc` | EC — SPKI public key | RFC 5480 |
41
+ | `encodeRsaPublicKey` / `decodeRsaPublicKey` | RSA — PKCS#1 `RSAPublicKey` (`{ n, e }`) | RFC 8017 A.1.1 |
42
+ | `encodeRsaPrivateKey` / `decodeRsaPrivateKey` | RSA — PKCS#1 `RSAPrivateKey`, two-prime (version 0) | RFC 8017 A.1.2 |
43
+ | `encodeSpkiRsa` / `decodeSpkiRsa` | RSA — SPKI public key (rsaEncryption, NULL parameters) | RFC 3279 §2.3.1 |
44
+ | `encodePkcs8Rsa` / `decodePkcs8Rsa` | RSA — PKCS#8 private key (wraps PKCS#1) | RFC 5208 + RFC 8017 |
41
45
  | `OID` | OID constants (curves, algos) | — |
42
46
 
43
47
  ## Examples
44
48
 
45
49
  ```js
46
- const { keyformat, pem } = fw.runtime.resolveAll(['keyformat', 'pem']);
50
+ const { keyformat, pem, rsaKeygen } = fw.runtime.resolveAll(['keyformat', 'pem', 'rsaKeygen']);
47
51
 
48
- // Ed25519 → DER PKCS#8 → PEM
49
- const skBytes = keyformat.encodePkcs8Edwards({ oid: keyformat.OID.Ed25519, seed: secretKey });
50
- const skPem = pem.encode(skBytes, 'PRIVATE KEY');
52
+ // Ed25519: 32-byte seed → DER PKCS#8 → PEM
53
+ const skPem = pem.encode(keyformat.encodePkcs8Edwards(keyformat.OID.ED25519, seed), 'PRIVATE KEY');
51
54
 
52
- // PEM → Ed25519 (seed + optional publicKey)
53
- const back = keyformat.decodePkcs8Edwards(pem.decode(skPem));
54
- // → { oid, seed, publicKey? }
55
+ // PEM → Ed25519
56
+ const back = keyformat.decodePkcs8Edwards(pem.decode(skPem, 'PRIVATE KEY').bytes);
57
+ // → { oid: '1.3.101.112', seed }
58
+
59
+ // RSA: key pair → SPKI / PKCS#8 PEM, which OpenSSL and node read as is
60
+ const { publicKey, privateKey } = rsaKeygen.generate({ bits: 2048 });
61
+ const pubPem = pem.encode(keyformat.encodeSpkiRsa(publicKey), 'PUBLIC KEY');
62
+ const privPem = pem.encode(keyformat.encodePkcs8Rsa(privateKey), 'PRIVATE KEY');
63
+ const pub = keyformat.decodeSpkiRsa(pem.decode(pubPem, 'PUBLIC KEY').bytes); // { n, e }
55
64
  ```
56
65
 
57
66
  ## Worker Usage
@@ -59,18 +68,18 @@ const back = keyformat.decodePkcs8Edwards(pem.decode(skPem));
59
68
  ```js
60
69
  const worker = fw.createWorker(
61
70
  function ({ libs, args }) {
62
- self.postMessage(libs.keyformat.encodeSec1(args[0]));
71
+ self.postMessage(libs.keyformat.encodeSec1(args[0], args[1], args[2]));
63
72
  },
64
- { dependencies: ['keyformat'], args: [{ curveOid, d, publicKey }] }
73
+ { dependencies: ['keyformat'], args: [d, publicKey, curveOid] } // encodeSec1(d, pub?, curveOid?)
65
74
  );
66
75
  ```
67
76
 
68
77
  ## Notes
69
78
 
70
79
  - **Round-trip only**: no cryptographic key validation (e.g. point-on-curve check). Use `ecc.deserialize` after decode for subgroup check.
71
- - **OpenSSL compatibility** verified for Edwards (Ed25519/X25519) and EC.
80
+ - **OpenSSL compatibility** verified for Edwards (Ed25519/X25519) and EC; the RSA encodings are byte-identical to node's (`node:crypto` DER export, 2048 and 3072 bits).
72
81
  - **JWK** not supported (use an external converter if required).
73
- - **RSA**: not handled in this module — `rsaKeygen` returns the structure (`n, e, d, p, q, dp, dq, qInv`) directly; RSA PKCS#8/SPKI serialisation must be implemented separately if required.
82
+ - **RSA decoding is strict**: rsaEncryption with NULL parameters only, a two-prime private key only (a multi-prime version-1 key is refused), no trailing bytes; integers come back unsigned (the DER sign byte dropped). Encoding a private key needs all eight integers.
74
83
 
75
84
  ## See also
76
85
 
@@ -63,4 +63,4 @@ const worker = fw.createWorker(
63
63
 
64
64
  ## See also
65
65
 
66
- - [cbc](../mode/cbc.md), [aes_modes](./aes_modes.md), [aes_ctr](./aes_ctr.md) — consumers
66
+ - [cbc](../mode/cbc.md), [aes_modes](./aes_modes.md) — consumers
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: pem
3
3
  category: crypto/utils
4
- dependencies: []
4
+ dependencies: [b64]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > PEM (RFC 7468) — encode/decode between `Uint8Array` and `-----BEGIN/END LABEL-----` Base64.
13
13
 
14
- **Module** `pem` | **Source** `packages/front/fw/src/crypto/utils/pem.js` | **Deps** none | **Worker-safe** yes
14
+ **Module** `pem` | **Source** `packages/front/fw/src/crypto/utils/pem.js` | **Deps** `b64` | **Worker-safe** yes
15
15
 
16
16
  ## Resolve
17
17
 
@@ -25,7 +25,7 @@ const pem = runtime.resolve('pem');
25
25
  | Method | Signature | Returns |
26
26
  |--------|-----------|---------|
27
27
  | `encode(bytes, label)` | `(Uint8Array, string) => string` | PEM with BEGIN/END headers |
28
- | `decode(text, label?)` | `(string, string?) => Uint8Array \| false` | Bytes or `false` if invalid / label mismatch |
28
+ | `decode(text, label?)` | `(string, string?) => {label, bytes} \| false` | The first block's label and bytes, or `false` if invalid / label mismatch |
29
29
 
30
30
  ## Examples
31
31
 
@@ -19,8 +19,8 @@ The framework's sole randomness source. `Math.random` and `crypto.randomUUID` ar
19
19
 
20
20
  ```js
21
21
  const random = runtime.resolve('random');
22
- // Returns: { fill, float, int, bytes, words, bits, range, drbg,
23
- // health, isReady, selfTest, _internal }
22
+ // Returns: { fill, float, int, bytes, words, bits, drbg,
23
+ // health, isReady, selfTest }
24
24
  ```
25
25
 
26
26
  ## API
@@ -32,13 +32,12 @@ const random = runtime.resolve('random');
32
32
  | `bits(n)` | `(number) => bitArray \| false` | n random bits (SJCL bitArray) |
33
33
  | `int(min, max)` | `(number, number) => number` | Integer in [min, max] (rejection sampling, no modulo bias) |
34
34
  | `float()` | `() => number` | Float in [0, 1) |
35
- | `range(min, max)` | `(number, number) => number` | Float in [min, max) |
36
35
  | `fill(typedArray)` | `(TypedArray) => TypedArray` | In-place fill |
37
36
  | `drbg(options?)` | `({personalisation?, aesKeyBits?, df?}) => DrbgInstance \| false` | Dedicated CTR_DRBG instance |
38
37
  | `health` | `{feed, reset, isDead}` | Continuous health-tests SP 800-90B |
39
38
  | `isReady()` | `() => boolean` | `true` if `crypto.getRandomValues` is available |
40
39
  | `selfTest()` | `() => boolean` | Re-run the CTR_DRBG POST KAT |
41
- | `_internal.makeDrbg(opts?)` | — | Parametric builder (test-only) |
40
+ | `internalOf(random).makeDrbg(opts?)` | — | Parametric builder (test-only) |
42
41
 
43
42
  ### `drbg(options)`
44
43
 
@@ -21,7 +21,7 @@ All outputs are big-endian `Uint8Array`, compatible with the [`rsa`](../pkc/rsa.
21
21
 
22
22
  ```js
23
23
  const rsaKeygen = runtime.resolve('rsaKeygen');
24
- // Returns: { generate, generateProbablePrime, _internal }
24
+ // Returns: { generate, generateProbablePrime }
25
25
  ```
26
26
 
27
27
  ## API
@@ -30,7 +30,7 @@ const rsaKeygen = runtime.resolve('rsaKeygen');
30
30
  |--------|-----------|---------|
31
31
  | `generate(options?)` | `({bits?, e?, drbg?}) => {publicKey, privateKey} \| false` | RSA pair or `false` on error |
32
32
  | `generateProbablePrime(nbits, eBn, drbg)` | `(number, BN, DrbgInstance) => BN \| false` | Probable `nbits`-bit prime, coprime with `e` |
33
- | `_internal.{...}` | — | `millerRabin`, `smallPrimes`, `divmod`, `lcm`, `inverseModAny` (test/KAT only) |
33
+ | `internalOf(rsaKeygen).{...}` | — | `millerRabin`, `smallPrimes`, `divmod`, `lcm`, `inverseModAny` (test/KAT only) |
34
34
 
35
35
  ### `generate` options
36
36
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: totp
3
3
  category: crypto/utils
4
- dependencies: [hmac, random, base32]
4
+ dependencies: [hmac, random, base32, bitArray, sha256, sha512]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > TOTP RFC 6238 — time-based OTP generation, verification, and enrollment.
13
13
 
14
- **Module** `totp` | **Source** `packages/front/fw/src/crypto/utils/totp.js` | **Deps** `hmac`, `random`, `base32` | **Worker-safe** yes
14
+ **Module** `totp` | **Source** `packages/front/fw/src/crypto/utils/totp.js` | **Deps** `hmac`, `random`, `base32`, `bitArray`, `sha256`, `sha512` | **Worker-safe** yes
15
15
 
16
16
  Strict TOTP (RFC 6238) implementation built on HOTP (RFC 4226). Algorithm: HMAC-SHA-1/256/512 of the time counter T (8 bytes big-endian), dynamic truncation, modulo 10^digits. Includes enrollment helpers (random secret generation, `otpauth://` URI) compatible with standard authenticators (Google Authenticator, Authy, etc.).
17
17
 
@@ -41,8 +41,8 @@ const uuid = runtime.resolve('uuid');
41
41
 
42
42
  | Value | Output | Example |
43
43
  |-------|--------|---------|
44
- | `'compact'` (default) | 32 hex without dashes | `91c274f29a0d4ce69d5db2c3d4e5f607` |
45
- | `'rfc4122'` | 36-char canonical RFC 4122 §3 | `91c274f2-9a0d-4ce6-9d5d-b2c3d4e5f607` |
44
+ | `'rfc4122'` (`v4`'s default) | 36-char canonical RFC 4122 §3 | `91c274f2-9a0d-4ce6-9d5d-b2c3d4e5f607` |
45
+ | `'compact'` (`v1`'s default) | 32 hex without dashes | `91c274f29a0d4ce69d5db2c3d4e5f607` |
46
46
 
47
47
  ## Examples
48
48
 
@@ -59,8 +59,8 @@ uuid.v4(true); // Uint8Array(16)
59
59
  ### v1 time-based
60
60
 
61
61
  ```js
62
- uuid.v1(); // compact hex
63
- uuid.v1(false, false, 'rfc4122'); // canonical with dashes
62
+ uuid.v1(); // canonical with dashes
63
+ uuid.v1(false, false, 'compact'); // 32 hex, no dashes
64
64
  ```
65
65
 
66
66
  ### Validation with valid
@@ -86,7 +86,7 @@ const worker = fw.createWorker(
86
86
 
87
87
  - **Randomness source**: `crypto.getRandomValues` (Web Crypto `RandomSource`). Custom `prng` with automatic fallback to `crypto.getRandomValues` if the callback does not modify the buffer.
88
88
  - **v1 uses a random MAC** (multicast bit forced per RFC 4122 §4.5) — no hardware MAC accessible in the browser.
89
- - **Back-compat**: default `format='compact'` returns 32 hex without dashes, identical to the historical API of this framework.
89
+ - **Formats**: `v1()` and `v4()` return the canonical 8-4-4-4-12 string; `format = 'compact'` (the third argument) gives the 32 hex without dashes.
90
90
  - **v3 / v5 / v6 / v7 / v8 not implemented** — RFC 9562 §5.6-5.8; v7 (timestamp-sortable) would be useful for DB IDs.
91
91
  - Requires `globalThis.crypto.getRandomValues` — available in browsers, Node ≥ 19, Bun, Deno. Throws if absent.
92
92
 
@@ -0,0 +1,124 @@
1
+ ---
2
+ module: x509
3
+ category: crypto/utils
4
+ dependencies: [asn1, keyformat, pem, ed25519, ecc, sha256, bitArray]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # x509
11
+
12
+ > X.509 v3 certificates (RFC 5280) for Ed25519 and ECDSA P-256 keys — create, parse, verify, PEM.
13
+
14
+ **Module** `x509` | **Source** `packages/front/fw/src/crypto/utils/x509.js` | **Deps** `asn1`, `keyformat`, `pem`, `ed25519`, `ecc`, `sha256`, `bitArray` | **Worker-safe** yes
15
+
16
+ Builds and reads certificates whose key and signature are Ed25519 (RFC 8410: pure
17
+ Ed25519 over the TBS bytes) or ECDSA P-256 with SHA-256 (RFC 5758:
18
+ `ecdsa-with-SHA256`, DER `r, s`, RFC 6979 deterministic `k`). It checks one
19
+ signature; it does not validate a certification path.
20
+
21
+ ## Resolve
22
+
23
+ ```js
24
+ const x509 = runtime.resolve('x509');
25
+ // Returns: { create, parse, verify, toPem, fromPem }
26
+ ```
27
+
28
+ ## API
29
+
30
+ | Method | Signature | Returns |
31
+ |--------|-----------|---------|
32
+ | `create(spec, signer)` | `(X509Spec, X509Signer) => Uint8Array \| false` | The DER certificate; `false` on any malformed input |
33
+ | `parse(der)` | `(Uint8Array) => X509Parsed \| false` | The TBS fields |
34
+ | `verify(der, issuerPublicKey)` | `(Uint8Array, {alg, key}) => boolean` | `true` when that key signed the certificate |
35
+ | `toPem(der)` | `(Uint8Array) => string` | A `CERTIFICATE` PEM block |
36
+ | `fromPem(text)` | `(string) => Uint8Array \| false` | The DER of the first `CERTIFICATE` block |
37
+
38
+ ### `X509Spec`
39
+
40
+ | Field | Type | Notes |
41
+ |---|---|---|
42
+ | `subject` | `{ CN?, O?, OU?, L?, ST?, C? }` | At least one attribute, 1..64 characters each (UTF8String); `C` is two upper-case letters (PrintableString). Encoded in key order |
43
+ | `issuer` | same | Defaults to `subject`: a self-signed certificate |
44
+ | `serial` | `Uint8Array` | Unsigned big-endian, positive, at most 20 encoded octets (RFC 5280 § 4.1.2.2) |
45
+ | `notBefore`, `notAfter` | `Date` | `notBefore < notAfter`; UTCTime before 2050, GeneralizedTime from 2050; milliseconds dropped |
46
+ | `publicKey` | `{ alg: 'Ed25519', key }` \| `{ alg: 'ECDSA-P256', key }` | 32 bytes, or the 65-byte SEC1 uncompressed point (checked on the curve) |
47
+ | `extensions` | object, optional | See below |
48
+
49
+ ### `X509Signer`
50
+
51
+ | Field | Type | Notes |
52
+ |---|---|---|
53
+ | `alg` | `'Ed25519'` \| `'ECDSA-P256'` | The signature algorithm follows the signer's key |
54
+ | `privateKey` | `Uint8Array` | Ed25519: 64 bytes (seed ‖ public key, as `ed25519.keyPair` returns it). ECDSA P-256: the 32-byte scalar |
55
+ | `publicKey` | `Uint8Array`, optional | The issuer's public key; needed for `authorityKeyIdentifier` unless self-signed |
56
+
57
+ ### Extensions
58
+
59
+ | Key | Value | Critical |
60
+ |---|---|---|
61
+ | `basicConstraints` | `{ ca: boolean, pathLen?: number }` (`pathLen` only with `ca`) | yes |
62
+ | `keyUsage` | names: `digitalSignature`, `nonRepudiation`, `keyEncipherment`, `dataEncipherment`, `keyAgreement`, `keyCertSign`, `cRLSign`, `encipherOnly`, `decipherOnly` | yes |
63
+ | `extKeyUsage` | dotted OIDs, e.g. `1.3.6.1.5.5.7.3.1` (serverAuth), `1.3.6.1.5.5.7.3.4` (emailProtection) | no |
64
+ | `subjectAltName` | `{ dns?: string[], email?: string[] }` (ASCII) | no |
65
+ | `subjectKeyIdentifier` | `true` | no |
66
+ | `authorityKeyIdentifier` | `true` | no |
67
+
68
+ Key identifiers are the leftmost 160 bits of SHA-256 of the subjectPublicKey bits
69
+ (RFC 7093 § 2, method 1): fw has no SHA-1.
70
+
71
+ ### `X509Parsed`
72
+
73
+ `{ version, serial, signatureAlgorithm, issuer, subject, notBefore, notAfter, publicKey, extensions, tbs, signature }`.
74
+ `signatureAlgorithm` is `'Ed25519'`, `'ECDSA-SHA256'` or the dotted OID; a name
75
+ attribute fw does not name appears under its dotted OID, a repeated one as an
76
+ array; `publicKey` is `{ alg, key }` for the two supported keys and
77
+ `{ alg: <oid>, key: null, spki }` otherwise; `extensions` holds the six keys of the
78
+ table above (each with `critical`) and `other: [{ oid, critical, value }]`.
79
+
80
+ ## Examples
81
+
82
+ ```js
83
+ const { x509, ed25519, ecc } = fw.runtime.resolveAll(['x509', 'ed25519', 'ecc']);
84
+
85
+ // A self-signed Ed25519 certificate
86
+ const kp = ed25519.keyPair(seed); // seed: 32 random bytes
87
+ const der = x509.create({
88
+ subject: { CN: 'signer.example', O: 'Example', C: 'FR' },
89
+ serial: Uint8Array.of(0x01),
90
+ notBefore: new Date(), notAfter: new Date(Date.now() + 365 * 86400e3),
91
+ publicKey: { alg: 'Ed25519', key: kp.publicKey },
92
+ extensions: { basicConstraints: { ca: false }, keyUsage: ['digitalSignature', 'nonRepudiation'] },
93
+ }, { alg: 'Ed25519', privateKey: kp.privateKey });
94
+
95
+ x509.verify(der, { alg: 'Ed25519', key: kp.publicKey }); // true
96
+ const cert = x509.parse(der); // cert.subject.CN === 'signer.example'
97
+ const pemText = x509.toPem(der); // -----BEGIN CERTIFICATE----- …
98
+ ```
99
+
100
+ A CA issues a certificate by passing its own name as `issuer` and its own key as
101
+ `signer` (with `signer.publicKey` for `authorityKeyIdentifier`).
102
+
103
+ ## Worker Usage
104
+
105
+ ```js
106
+ const worker = fw.createWorker(
107
+ function ({ libs, args }) {
108
+ self.postMessage(libs.x509.parse(new Uint8Array(args[0])).subject);
109
+ },
110
+ { dependencies: ['x509'], args: [Array.from(der)] } // args are JSON: pass bytes as an array
111
+ );
112
+ ```
113
+
114
+ ## Notes
115
+
116
+ - **Interop measured**: certificates fw creates are read by `node:crypto`'s `X509Certificate` (fields, `ca`, `verify`, issuance) and `openssl x509 -text`; `openssl verify` accepts a fw CA and the leaf it issues; fw parses and verifies certificates `openssl req -x509` creates (Ed25519 and P-256).
117
+ - **Not claimed**: path validation (chains, revocation, name constraints, validity against a clock), RSA keys, CSRs.
118
+ - **No-throw**: malformed input returns `false` and logs `[crypto] INVALID: x509: …`.
119
+
120
+ ## See also
121
+
122
+ - [keyformat](./keyformat.md) — the SPKI encodings the certificate embeds
123
+ - [ed25519](../pkc/ed25519.md), [ecc](../pkc/ecc.md) — the signing primitives
124
+ - [pem](./pem.md) — the PEM armour
@@ -59,7 +59,7 @@ All methods resolve `false` (never throw) when a parameter is invalid (`[crypto]
59
59
 
60
60
  ### CTR counter / nonce note
61
61
 
62
- The frozen `aes_ctr` ABI consumes a **12-byte nonce**: the 16-byte counter block is `nonce(12) ‖ be32(0)` with the 32-bit block counter starting at `0` (J0-style). This matches the package KAT, which cross-checks against WebCrypto AES-CTR configured with `counter = nonce ‖ be32(0)`, `length: 32`. (The task plan's indicative ABI named a 16-byte full-width counter; the delivered binary — `targets.json` + `shims/aes.c` — is authoritative.)
62
+ The frozen `aes_ctr` ABI consumes a **12-byte nonce**: the 16-byte counter block is `nonce(12) ‖ be32(0)` with the 32-bit block counter starting at `0` (J0-style). This matches the package KAT, which cross-checks against WebCrypto AES-CTR configured with `counter = nonce ‖ be32(0)`, `length: 32`. (An earlier ABI draft named a 16-byte full-width counter; the delivered binary — `targets.json` + `shims/aes.c` — is authoritative.)
63
63
 
64
64
  ## Examples
65
65
 
@@ -37,7 +37,7 @@ const wasmArgon2 = runtime.resolve('wasmArgon2');
37
37
  | Field | Type | Meaning |
38
38
  |-------|------|---------|
39
39
  | `timeCost` | `number` | Passes `t` (≥ 1) |
40
- | `memoryKiB` | `number` | Memory cost `m` in KiB (≥ 8·`parallelism`) |
40
+ | `memoryKiB` | `number` | Memory cost `m` in KiB (≥ 8·`parallelism`, ≤ `1048576` — the 1 GiB ceiling) |
41
41
  | `parallelism` | `number` | Lanes `p` (≥ 1) |
42
42
  | `hashLen` | `number` | Output tag length in bytes (`4` .. `2^32-1`) |
43
43
  | `secret` | `Uint8Array` *(optional)* | Key `K` |
@@ -45,9 +45,9 @@ const wasmArgon2 = runtime.resolve('wasmArgon2');
45
45
 
46
46
  `hash`/`verify` resolve `false` (never throw) when:
47
47
 
48
- - a parameter is invalid (`[crypto] INVALID: …` logged): `timeCost < 1`, `parallelism < 1`, `memoryKiB < 8·parallelism`, `hashLen ∉ [4, 2^32-1]`, or `password`/`salt`/`secret`/`ad` not a `Uint8Array`;
48
+ - a parameter is invalid (`[crypto] INVALID: …` logged): `timeCost < 1`, `parallelism < 1`, `memoryKiB < 8·parallelism`, `memoryKiB > 1048576` (`[crypto] INVALID: wasmArgon2: memoryKiB above the ceiling of 1048576 KiB (1 GiB)`), `hashLen ∉ [4, 2^32-1]`, or `password`/`salt`/`secret`/`ad` not a `Uint8Array`;
49
49
  - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
50
- - the WASM call returns a non-zero status (`[crypto] FAIL: wasmArgon2.hash: argon2id_hash status <n>`).
50
+ - the WASM call returns a non-zero status (`[crypto] FAIL: wasmArgon2.hash: argon2id_hash status <n>`) — `-2` when the engine refuses to grow linear memory for the matrix (the page is out of memory below the ceiling).
51
51
 
52
52
  `verify` additionally returns `false` when `expected` is not a `Uint8Array`, when its length differs from the produced tag, or when the bytes differ.
53
53
 
@@ -96,7 +96,9 @@ const tag = await wasmArgon2.hash(
96
96
 
97
97
  ## Notes
98
98
 
99
- - **Memory-hard ⇒ the prime reason to reach for WASM here.** Choose `memoryKiB` as large as your environment allows (RFC 9106 §4 suggests `m = 2^21` KiB / 2 GiB for RAM-rich servers, `m = 2^16` KiB / 64 MiB when constrained; avoid `m < 2^15` / 32 MiB for password storage). The matrix is bounded by the package's WASM arena ceiling — an oversized `m'` surfaces as a non-zero status → `false`.
99
+ - **Memory-hard ⇒ the prime reason to reach for WASM here.** Choose `memoryKiB` as large as your environment allows (RFC 9106 §4 suggests `m = 2^16` KiB / 64 MiB when constrained; the OWASP Password Storage Cheat Sheet's floor is `m = 19456` KiB (19 MiB) with `t = 2`, `p = 1`, or `m = 47104` KiB (47 MiB) with `t = 1`, `p = 1` — both run here and match the pure-JS module byte for byte).
100
+ - **Accepted range and ceiling.** `8·parallelism ≤ memoryKiB ≤ 1048576` (1 GiB). The ceiling sits under the 4 GiB wasm32 limit and the browsers' practical per-page limit; RFC 9106's 2 GiB server profile is therefore out of reach of this binary (use a native implementation server-side). Above the ceiling `hash` refuses up front with the named `INVALID` error above, before touching the binary.
101
+ - **Linear memory grows and is not returned.** The block matrix (`m'` KiB) is not taken from the binary's 16 MiB scratch arena: the first call that needs it grows the module's linear memory, and a later, larger call extends it. WebAssembly memory never shrinks, so that memory stays allocated for the life of the loaded module (a later, smaller call reuses it); the matrix is zeroed after every call. A page that never hashes pays nothing.
100
102
  - **Not in WebCrypto.** `crypto.subtle` has no Argon2; this WASM tier (or the pure-JS [`argon2`](../hash/argon2.md)) is the only path.
101
103
  - **Scalar-only binary.** `wasmArgon2` forces `{ variant: 'scalar' }` when loading because the `argon2` target ships no SIMD build. Other `crypto/wasm/*` modules with a SIMD variant load it automatically via `wasmRuntime`.
102
104
  - **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view that could alias reused memory).
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  module: wasmMlKem
3
3
  category: crypto/wasm
4
+ dependencies: [wasmRuntime]
4
5
  returns: object
5
6
  worker-safe: true
6
7
  status: complete
@@ -29,7 +29,7 @@ const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
29
29
  | Method | Signature | Returns |
30
30
  |--------|-----------|---------|
31
31
  | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
32
- | `deriveBits` | `(password: Uint8Array, salt: Uint8Array, dkLen: number, iterations?: number, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | `dkLen`-byte derived key, or `false` on any failure |
32
+ | `deriveBits` | `(password: Uint8Array, salt: Uint8Array, lengthBits: number, iterations?: number, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | `lengthBits / 8`-byte derived key, or `false` on any failure |
33
33
 
34
34
  ### Parameter constraints
35
35
 
@@ -37,13 +37,13 @@ const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
37
37
  |-----------|---------|-----------|
38
38
  | `password` | — | `Uint8Array`; any byte length including `0` (empty password is valid per RFC 8018) |
39
39
  | `salt` | — | `Uint8Array`; any byte length (≥ 16 bytes recommended by SP 800-132) |
40
- | `dkLen` | — | Integer ≥ 1 (bytes) |
40
+ | `lengthBits` | — | A positive multiple of 8 (**bits**, as the pure and WebCrypto tiers) |
41
41
  | `iterations` | `600000` | Integer ≥ 1 (OWASP 2023 default for PBKDF2-HMAC-SHA-256) |
42
42
  | `hash` | `256` | One of `256` / `384` / `512` (selects HMAC-SHA-2 PRF) |
43
43
 
44
44
  `deriveBits` resolves `false` (never rejects) when:
45
45
 
46
- - a parameter is invalid: `password` or `salt` not a `Uint8Array`; `iterations < 1` or non-integer; `dkLen < 1` or non-integer; `hash ∉ {256, 384, 512}` — logged as `[crypto] INVALID: …`;
46
+ - a parameter is invalid: `password` or `salt` not a `Uint8Array`; `iterations < 1` or non-integer; `lengthBits` not a positive multiple of 8; `hash ∉ {256, 384, 512}` — logged as `[crypto] INVALID: …`;
47
47
  - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch — logged as `[crypto] FAIL: …` by `wasmRuntime.load`;
48
48
  - the WASM call returns a non-zero status (`WC_EBADPARAM = -1`).
49
49
 
@@ -56,7 +56,7 @@ const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
56
56
 
57
57
  const password = new TextEncoder().encode('my-passphrase');
58
58
  const salt = crypto.getRandomValues(new Uint8Array(16));
59
- const dk = await wasmPbkdf2.deriveBits(password, salt, 32);
59
+ const dk = await wasmPbkdf2.deriveBits(password, salt, 256); // 256 bits = 32 bytes
60
60
  // dk is a 32-byte Uint8Array, or false on failure.
61
61
  if (dk === false) {
62
62
  // WASM unavailable — fall back to webcrypto/pbkdf2 or hash/pbkdf2.
@@ -67,7 +67,7 @@ if (dk === false) {
67
67
 
68
68
  ```js
69
69
  // 100 000 iterations, HMAC-SHA-512, 64-byte output.
70
- const dk = await wasmPbkdf2.deriveBits(password, salt, 64, 100_000, 512);
70
+ const dk = await wasmPbkdf2.deriveBits(password, salt, 512, 100_000, 512);
71
71
  ```
72
72
 
73
73
  ### RFC 7914 §11 published vector (c=1, SHA-256)
@@ -75,7 +75,7 @@ const dk = await wasmPbkdf2.deriveBits(password, salt, 64, 100_000, 512);
75
75
  ```js
76
76
  const pw = new TextEncoder().encode('password');
77
77
  const salt = new TextEncoder().encode('salt');
78
- const dk = await wasmPbkdf2.deriveBits(pw, salt, 32, 1, 256);
78
+ const dk = await wasmPbkdf2.deriveBits(pw, salt, 256, 1, 256);
79
79
  // hex(dk) === '120fb6cffcf8b32c43e7225256c4f837a86548c92ccc35480805987cb70be17b'
80
80
  ```
81
81
 
@@ -87,8 +87,8 @@ const dk = await wasmPbkdf2.deriveBits(pw, salt, 32, 1, 256);
87
87
  const worker = fw.createWorker(() => {
88
88
  const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
89
89
  self.onmessage = async ({ data }) => {
90
- const { password, salt, dkLen } = data;
91
- const dk = await wasmPbkdf2.deriveBits(password, salt, dkLen);
90
+ const { password, salt, lengthBits } = data;
91
+ const dk = await wasmPbkdf2.deriveBits(password, salt, lengthBits);
92
92
  self.postMessage(dk);
93
93
  };
94
94
  });
@@ -102,7 +102,7 @@ await wasmRsa.verify(kp.publicKey, bad, msg, 'PSS', 256); // → false
102
102
  - **NIST-anchored.** The test suite verifies a genuine NIST RSA-SigGen-FIPS186-5 PKCS#1-v1.5 signature byte-for-byte against the delivered binary, plus OAEP/PSS/PKCS1 round-trips on a fixed NIST DecryptionPrimitive key.
103
103
  - **Scalar only.** The `rsa` target ships `rsa.scalar.wasm` (no SIMD build); the wrapper passes `{ variant: 'scalar' }` to `wasmRuntime.load`.
104
104
  - **Output is copied OUT** of WASM linear memory into fresh `Uint8Array`s (never a view that could alias reused memory).
105
- - **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
105
+ - **No-throw contract.** Every failure path resolves to `false`; nothing rejects. An OAEP decryption failure (a wrong key, a tampered ciphertext) logs `CORRUPT` at warn level, every other failure logs at `console.error`.
106
106
 
107
107
  ## See also
108
108