@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,815 +1,862 @@
1
- // Copyright (c) 2026 AwaCloud SAS
2
- // Author: Matthieu Bouilloux
3
- // SPDX-License-Identifier: Apache-2.0
4
-
5
- /**
6
- * @fileoverview ZIP archive creation and extraction factory.
7
- *
8
- * Supports ZIP and ZIP64 format (for archives > 4 GB) with DEFLATE compression
9
- * (method 8) and store (method 0) ISO/IEC 21320-1. File entries can be plain `Uint8Array` or
10
- * `[Uint8Array, PerFileOptions]` tuples. Directory objects are flattened with
11
- * a trailing `/` path separator.
12
- *
13
- * ## API
14
- *
15
- * | Method | Returns |
16
- * |---|---|
17
- * | `zipSync(files, opts?)` | `Uint8Array` - synchronous archive creation |
18
- * | `unzipSync(data, opts?)` | `{ [path]: Uint8Array }` - synchronous extraction |
19
- * | `zip(files, opts?)` | `Promise<Uint8Array>` |
20
- * | `unzip(data, opts?)` | `Promise<{ [path]: Uint8Array }>` |
21
- *
22
- * ## Files argument
23
- *
24
- * ```js
25
- * {
26
- * 'file.txt': data, // Uint8Array
27
- * 'archive/big.bin': [data, { level: 0 }], // with per-file options
28
- * 'subdir/': {}, // directory entry
29
- * }
30
- * ```
31
- *
32
- * ## Per-file options
33
- *
34
- * `{ level?: 0–9, mtime?: number|Date, comment?: string, extra?: object }`
35
- *
36
- * Set `level: 0` to store without compression.
37
- *
38
- * ## Deterministic / reproducible archives (BL-28)
39
- *
40
- * `opts.mtime` (writer-level default) also accepts `number|Date`, on both
41
- * write paths: `zipSync`/`zip`'s `opts` argument and `ZipStream`'s
42
- * constructor `opts`. It seeds every entry that does not supply its own
43
- * `p.mtime` (per-entry `mtime` always wins). Fixing the writer-level
44
- * `mtime` makes two writes of an identical payload byte-identical —
45
- * without it, each entry's timestamp defaults to `Date.now()` and bytes
46
- * differ run to run. Valid range is 1980-2099 (MS-DOS date/time,
47
- * 2-second resolution); outside it throws error code 10, fixed mtime
48
- * included. This module only provides the option — a caller composing on
49
- * top of `zip` (e.g. a document-format writer) must thread its own fixed
50
- * `mtime` through to claim reproducible output.
51
- *
52
- * ## Extraction options
53
- *
54
- * `{ filter?: ({ name, size, originalSize, compression }) => boolean }`
55
- *
56
- */
57
-
58
- /**
59
- * Writer returned by `ZipStream.openEntry(...)`.
60
- * @typedef {object} ZipEntryWriter
61
- * @property {(chunk: Uint8Array, final?: boolean) => void} push
62
- */
63
-
64
- /**
65
- * Streaming ZIP archive writer instance shape.
66
- * @typedef {object} ZipStreamInstance
67
- * @property {((chunk: Uint8Array, isFinal: boolean) => void)|null} ondata
68
- * @property {(name: string, data: Uint8Array|[Uint8Array, object], opts?: object) => void} add
69
- * @property {(name: string, opts?: object) => ZipEntryWriter} openEntry
70
- * @property {() => void} finalize
71
- */
72
-
73
- /**
74
- * Constructor for `ZipStream`.
75
- * @typedef {new (opts?: object|((chunk: Uint8Array, isFinal: boolean) => void), ondata?: (chunk: Uint8Array, isFinal: boolean) => void) => ZipStreamInstance} ZipStreamCtor
76
- */
77
-
78
- /**
79
- * Streaming ZIP reader instance shape.
80
- * @typedef {object} ZipStreamReaderInstance
81
- * @property {((name: string, data: Uint8Array, isFinal: boolean) => void)|null} onfile
82
- * @property {(chunk: Uint8Array, final?: boolean) => void} push
83
- */
84
-
85
- /**
86
- * Constructor for `ZipStreamReader`.
87
- * @typedef {new (opts?: object|((name: string, data: Uint8Array, isFinal: boolean) => void), onfile?: (name: string, data: Uint8Array, isFinal: boolean) => void) => ZipStreamReaderInstance} ZipStreamReaderCtor
88
- */
89
-
90
- /**
91
- * Public surface of `zip.factory(...)`.
92
- * @typedef {object} ZipApi
93
- * @property {(files: object, opts?: object) => Uint8Array} zipSync
94
- * @property {(data: Uint8Array, opts?: object) => Object<string, Uint8Array>} unzipSync
95
- * @property {(files: object, opts?: object) => Promise<Uint8Array>} zip
96
- * @property {(data: Uint8Array, opts?: object) => Promise<Object<string, Uint8Array>>} unzip
97
- * @property {ZipStreamCtor} ZipStream
98
- * @property {ZipStreamReaderCtor} ZipStreamReader
99
- */
100
-
101
- import { deflate } from './deflate.js';
102
- import { crc32 } from '../calc/crc32.js';
103
-
104
- export const zip = {
105
- name: 'zip',
106
- version: '1.0.0',
107
- type: 'fw.io.compress',
108
- dependencies: ['deflate', 'crc32'],
109
- deps: [deflate, crc32],
110
-
111
- /**
112
- * @param {{ deflateSync, inflateSync, deflate, inflate, DeflateStream, InflateStream }} deflateModule
113
- * @param {new() => {append: function(Uint8Array): void, get: function(): number}} Crc32 - constructor returned by crc32.factory()
114
- * @returns {ZipApi}
115
- */
116
- factory(deflateModule, Crc32) {
117
-
118
- const { deflateSync, inflateSync, DeflateStream } = deflateModule;
119
-
120
- // --- String ↔ Uint8Array helpers ---
121
-
122
- // Native encoder/decoder (universal in modern environments)
123
- const _te = typeof TextEncoder !== 'undefined' && new TextEncoder();
124
- const _td = typeof TextDecoder !== 'undefined' && new TextDecoder();
125
-
126
- function _strToU8(str) {
127
- if (_te) return _te.encode(str);
128
- // Fallback: manual UTF-8 for non-ASCII
129
- const a = [];
130
- for (let i = 0; i < str.length; ++i) {
131
- let c = str.charCodeAt(i);
132
- if (c < 0x80) {
133
- a.push(c);
134
- } else if (c < 0x800) {
135
- a.push(0xC0 | (c >> 6), 0x80 | (c & 0x3F));
136
- } else if (c > 0xD7FF && c < 0xE000) {
137
- c = 0x10000 + (((c & 0x3FF) << 10) | (str.charCodeAt(++i) & 0x3FF));
138
- a.push(0xF0 | (c >> 18), 0x80 | ((c >> 12) & 0x3F), 0x80 | ((c >> 6) & 0x3F), 0x80 | (c & 0x3F));
139
- } else {
140
- a.push(0xE0 | (c >> 12), 0x80 | ((c >> 6) & 0x3F), 0x80 | (c & 0x3F));
141
- }
142
- }
143
- return new Uint8Array(a);
144
- }
145
-
146
- // Decode bytes as UTF-8 (utf8=true) or Latin-1 (utf8=false)
147
- function _u8ToStr(d, utf8) {
148
- if (!utf8) {
149
- // Latin-1: one char per byte
150
- let r = '';
151
- for (let i = 0; i < d.length; i += 16384)
152
- r += String.fromCharCode(...d.subarray(i, i + 16384));
153
- return r;
154
- }
155
- if (_td) return _td.decode(d);
156
- // Fallback manual decode
157
- let r = '';
158
- for (let i = 0; i < d.length;) {
159
- const b = d[i++];
160
- if (b < 0x80) { r += String.fromCharCode(b); }
161
- else if (b < 0xE0) { r += String.fromCharCode(((b & 0x1F) << 6) | (d[i++] & 0x3F)); }
162
- else if (b < 0xF0) { r += String.fromCharCode(((b & 0x0F) << 12) | ((d[i++] & 0x3F) << 6) | (d[i++] & 0x3F)); }
163
- else {
164
- let cp = ((b & 0x07) << 18) | ((d[i++] & 0x3F) << 12) | ((d[i++] & 0x3F) << 6) | (d[i++] & 0x3F);
165
- cp -= 0x10000;
166
- r += String.fromCharCode(0xD800 | (cp >> 10), 0xDC00 | (cp & 0x3FF));
167
- }
168
- }
169
- return r;
170
- }
171
-
172
- // True when the string contains no characters outside Latin-1
173
- function _isUTF8(str) {
174
- for (let i = 0; i < str.length; ++i) if (str.charCodeAt(i) > 127) return true;
175
- return false;
176
- }
177
-
178
- // --- Byte-level helpers ---
179
-
180
- function _r16(d, b) { return d[b] | (d[b + 1] << 8); }
181
- function _r32(d, b) { return (d[b] | (d[b + 1] << 8) | (d[b + 2] << 16) | (d[b + 3] << 24)) >>> 0; }
182
- function _r64(d, b) { return _r32(d, b) + _r32(d, b + 4) * 4294967296; }
183
-
184
- function _w16(d, b, v) { d[b] = v & 0xFF; d[b + 1] = (v >> 8) & 0xFF; }
185
- function _w32(d, b, v) { d[b] = v & 0xFF; d[b + 1] = (v >> 8) & 0xFF; d[b + 2] = (v >> 16) & 0xFF; d[b + 3] = (v >>> 24) & 0xFF; }
186
-
187
- // --- MS-DOS date/time encoding ---
188
-
189
- function _dosDateTime(mtime) {
190
- const d = new Date(mtime ?? Date.now());
191
- const y = d.getFullYear() - 1980;
192
- if (y < 0 || y > 119) {
193
- const e = new Error('date not in range 1980-2099');
194
- // @ts-ignore - Error.code is a non-standard but widely-used extension
195
- e.code = 10;
196
- throw e;
197
- }
198
- return (y << 25) | ((d.getMonth() + 1) << 21) | (d.getDate() << 16)
199
- | (d.getHours() << 11) | (d.getMinutes() << 5) | (d.getSeconds() >> 1);
200
- }
201
-
202
- // Deflate bit flag from level
203
- function _dbf(l) { return l === 1 ? 3 : l < 6 ? 2 : l === 9 ? 1 : 0; }
204
-
205
- // --- Extra field helpers ---
206
-
207
- function _exfl(ex) {
208
- let le = 0;
209
- if (ex) for (const k in ex) {
210
- const l = ex[k].length;
211
- // @ts-ignore - Error.code is a non-standard but widely-used extension
212
- if (l > 65535) { const e = new Error('extra field too long'); e.code = 9; throw e; }
213
- le += l + 4;
214
- }
215
- return le;
216
- }
217
-
218
- function _writeExtra(d, b, ex) {
219
- if (!ex) return b;
220
- for (const k in ex) {
221
- const exf = ex[k];
222
- _w16(d, b, +k); _w16(d, b + 2, exf.length);
223
- d.set(exf, b + 4);
224
- b += 4 + exf.length;
225
- }
226
- return b;
227
- }
228
-
229
- // --- Local file header (PK\x03\x04) ---
230
-
231
- function _localHeaderSize(fnLen, exLen) {
232
- return 30 + fnLen + exLen;
233
- }
234
-
235
- function _writeLocalHeader(d, b, fn, fnBytes, u, compression, dosTime, crc, cSize, uSize, ex) {
236
- _w32(d, b, 0x04034B50); b += 4; // signature
237
- d[b] = 20; b += 2; // version needed
238
- d[b] = (compression < 0 && 8); d[b + 1] = u && 8; b += 2; // flags: data descriptor, UTF-8
239
- _w16(d, b, compression & 0xFFFF); b += 2; // compression method
240
- _w32(d, b, dosTime); b += 4; // last mod
241
- if (compression >= 0) {
242
- _w32(d, b, crc); b += 4; // CRC-32
243
- _w32(d, b, cSize); b += 4; // compressed size
244
- _w32(d, b, uSize); b += 4; // uncompressed size
245
- } else {
246
- b += 12; // will be filled by data descriptor
247
- }
248
- _w16(d, b, fnBytes.length); b += 2; // filename length
249
- _w16(d, b, _exfl(ex)); b += 2; // extra length
250
- d.set(fnBytes, b); b += fnBytes.length;
251
- return _writeExtra(d, b, ex);
252
- }
253
-
254
- // --- Central directory entry (PK\x01\x02) ---
255
-
256
- function _centralEntrySize(fnLen, exLen, comLen) {
257
- return 46 + fnLen + exLen + comLen;
258
- }
259
-
260
- function _writeCentralEntry(d, b, fnBytes, u, compression, dosTime, crc, cSize, uSize, localOffset, ex, comment) {
261
- _w32(d, b, 0x02014B50); b += 4; // signature
262
- d[b] = 20; d[b + 1] = 0; b += 2; // version made by
263
- d[b] = 20; b += 2; // version needed
264
- d[b] = _dbf(compression) << 1; d[b + 1] = u && 8; b += 2; // flags
265
- _w16(d, b, compression < 0 ? 0 : compression & 0xFFFF); b += 2;
266
- _w32(d, b, dosTime); b += 4;
267
- _w32(d, b, crc); b += 4;
268
- _w32(d, b, compression < 0 ? (-compression - 2) : cSize); b += 4;
269
- _w32(d, b, uSize); b += 4;
270
- _w16(d, b, fnBytes.length); b += 2;
271
- const exl = _exfl(ex);
272
- _w16(d, b, exl); b += 2;
273
- const coml = comment ? comment.length : 0;
274
- _w16(d, b, coml); b += 2;
275
- b += 2; // disk number start
276
- b += 2; // internal attributes
277
- b += 4; // external attributes
278
- _w32(d, b, localOffset); b += 4;
279
- d.set(fnBytes, b); b += fnBytes.length;
280
- b = _writeExtra(d, b, ex);
281
- if (comment) { d.set(comment, b); b += coml; }
282
- return b;
283
- }
284
-
285
- // --- End of central directory (PK\x05\x06) ---
286
-
287
- function _writeEOCD(o, b, entryCount, cdSize, cdOffset) {
288
- _w32(o, b, 0x06054B50); b += 4;
289
- b += 4; // disk number + start disk
290
- _w16(o, b, entryCount); b += 2;
291
- _w16(o, b, entryCount); b += 2;
292
- _w32(o, b, cdSize); b += 4;
293
- _w32(o, b, cdOffset);
294
- // comment length field (2 bytes, value 0): implicitly zero in output buffer
295
- }
296
-
297
- // --- ZIP64 extra field reader ---
298
-
299
- function _z64e(d, b) {
300
- while (_r16(d, b) !== 1) b += 4 + _r16(d, b + 2);
301
- return [_r64(d, b + 12), _r64(d, b + 4), _r64(d, b + 20)];
302
- }
303
-
304
- // Local file header data offset (skip local header)
305
- function _slzh(d, b) {
306
- return b + 30 + _r16(d, b + 26) + _r16(d, b + 28);
307
- }
308
-
309
- // Read central directory entry, return [compression, cSize, uSize, name, nextOffset, localOffset]
310
- function _readCDE(d, b, zip64) {
311
- const fnl = _r16(d, b + 28);
312
- const utf8 = (_r16(d, b + 8) & 0x800) !== 0;
313
- const fn = _u8ToStr(d.subarray(b + 46, b + 46 + fnl), utf8);
314
- const es = b + 46 + fnl;
315
- const bs = _r32(d, b + 20);
316
- const [sc, su, off] = zip64 && bs === 0xFFFFFFFF
317
- ? _z64e(d, es)
318
- : [bs, _r32(d, b + 24), _r32(d, b + 42)];
319
- return [_r16(d, b + 10), sc, su, fn, es + _r16(d, b + 30) + _r16(d, b + 32), off];
320
- }
321
-
322
- // --- Flatten nested directory structure ---
323
-
324
- function _flatten(d, prefix, out, defaultOpts) {
325
- for (const k in d) {
326
- const val = d[k];
327
- const name = prefix + k;
328
- let data = val, opts = defaultOpts;
329
- if (Array.isArray(val)) { opts = Object.assign({}, defaultOpts, val[1]); data = val[0]; }
330
- if (data instanceof Uint8Array) {
331
- out[name] = [data, opts];
332
- } else {
333
- out[name + '/'] = [new Uint8Array(0), opts];
334
- _flatten(data, name + '/', out, defaultOpts);
335
- }
336
- }
337
- }
338
-
339
- // --- Synchronous API ---
340
-
341
- /**
342
- * Create a ZIP archive synchronously.
343
- *
344
- * @param {object} files - `{ path: Uint8Array | [Uint8Array, opts] | object }`
345
- * @param {object} [opts] - default per-file options
346
- * @returns {Uint8Array}
347
- */
348
- function zipSync(files, opts = {}) {
349
- const flat = {};
350
- _flatten(files, '', flat, opts);
351
-
352
- const entries = [];
353
- let dataLen = 0;
354
- let cdLen = 0;
355
-
356
- for (const fn in flat) {
357
- const [file, p] = flat[fn];
358
- const compression = (p.level === 0) ? 0 : 8;
359
- const fnBytes = _strToU8(fn);
360
- const fnLen = fnBytes.length;
361
- // @ts-ignore - Error.code is a non-standard but widely-used extension
362
- if (fnLen > 65535) { const e = new Error('filename too long'); e.code = 11; throw e; }
363
- const comBytes = p.comment ? _strToU8(p.comment) : null;
364
- const exl = _exfl(p.extra);
365
- const u = _isUTF8(fn) || (comBytes && _isUTF8(p.comment));
366
- const dosTime = _dosDateTime(p.mtime);
367
-
368
- const crc = new Crc32();
369
- crc.append(file);
370
-
371
- const compressed = compression ? deflateSync(file, p) : file;
372
- const cSize = compressed.length;
373
- const uSize = file.length;
374
- const crcVal = crc.get();
375
-
376
- const localHdrLen = _localHeaderSize(fnLen, exl);
377
- entries.push({ fnBytes, u, compression, dosTime, crcVal, cSize, uSize,
378
- compressed, localHdrLen, p, comBytes, exl, localOffset: dataLen });
379
-
380
- dataLen += localHdrLen + cSize;
381
- cdLen += _centralEntrySize(fnLen, exl, comBytes ? comBytes.length : 0);
382
- }
383
-
384
- const out = new Uint8Array(dataLen + cdLen + 22);
385
- let pos = 0, cdPos = dataLen;
386
-
387
- for (const e of entries) {
388
- // Write local header + data
389
- pos = _writeLocalHeader(out, pos, null, e.fnBytes, e.u, e.compression,
390
- e.dosTime, e.crcVal, e.cSize, e.uSize, e.p.extra);
391
- out.set(e.compressed, pos); pos += e.cSize;
392
-
393
- // Write central directory entry
394
- cdPos = _writeCentralEntry(out, cdPos, e.fnBytes, e.u, e.compression,
395
- e.dosTime, e.crcVal, e.cSize, e.uSize, e.localOffset, e.p.extra, e.comBytes);
396
- }
397
-
398
- _writeEOCD(out, cdPos, entries.length, cdLen, dataLen);
399
- return out;
400
- }
401
-
402
- // Reject paths that would escape the extraction root: any `..`
403
- // segment or an absolute path (POSIX `/`, Windows drive letter, or
404
- // Windows UNC `\\`). Default-on per ZIP-slip mitigation; callers can
405
- // opt out with `{ safe: false }`.
406
- function _isUnsafePath(name) {
407
- if (!name) return false;
408
- // Absolute POSIX
409
- if (name.charCodeAt(0) === 0x2F) return true;
410
- // Absolute Windows: `C:` or `\\server`
411
- if (/^[A-Za-z]:[\\/]/.test(name)) return true;
412
- if (name.startsWith('\\\\')) return true;
413
- // Normalise separators then look for `..` segments.
414
- const segs = name.split(/[\\/]/);
415
- for (const s of segs) if (s === '..') return true;
416
- return false;
417
- }
418
-
419
- /**
420
- * Extract a ZIP archive synchronously.
421
- *
422
- * @param {Uint8Array} data
423
- * @param {object} [opts] - `{ filter?: fn }`
424
- * @returns {{ [path: string]: Uint8Array }}
425
- */
426
- function unzipSync(data, opts = {}) {
427
- /** @type {{ [path: string]: Uint8Array }} */
428
- const result = {};
429
- const safe = opts.safe !== false;
430
-
431
- // Locate end-of-central-directory record
432
- let e = data.length - 22;
433
- while (_r32(data, e) !== 0x06054B50) {
434
- if (!e || data.length - e > 65558) {
435
- const err = new Error('invalid zip data');
436
- // @ts-ignore - Error.code is a non-standard but widely-used extension
437
- err.code = 13;
438
- throw err;
439
- }
440
- --e;
441
- }
442
-
443
- let entryCount = _r16(data, e + 8);
444
- if (!entryCount) return result;
445
-
446
- let cdOffset = _r32(data, e + 16);
447
- let zip64 = cdOffset === 0xFFFFFFFF || entryCount === 0xFFFF;
448
-
449
- if (zip64) {
450
- // ZIP64 end-of-central-directory locator at e-12
451
- const ze = _r32(data, e - 12);
452
- if (_r32(data, ze) === 0x06064B50) {
453
- entryCount = _r32(data, ze + 32);
454
- cdOffset = _r64(data, ze + 48);
455
- }
456
- }
457
-
458
- const fltr = opts.filter;
459
- let o = cdOffset;
460
-
461
- for (let i = 0; i < entryCount; ++i) {
462
- const [cmp, cSize, uSize, fn, nextOff, localOff] = _readCDE(data, o, zip64);
463
- o = nextOff;
464
- const dataStart = _slzh(data, localOff);
465
-
466
- if (safe && _isUnsafePath(fn)) {
467
- const err = new Error('zip-slip: unsafe entry path "' + fn + '"');
468
- // @ts-ignore - Error.code is a non-standard but widely-used extension
469
- err.code = 15;
470
- throw err;
471
- }
472
-
473
- if (fltr && !fltr({ name: fn, size: cSize, originalSize: uSize, compression: cmp })) continue;
474
-
475
- if (cmp === 0) {
476
- result[fn] = new Uint8Array(data.subarray(dataStart, dataStart + cSize));
477
- } else if (cmp === 8) {
478
- result[fn] = inflateSync(data.subarray(dataStart, dataStart + cSize), {
479
- out: new Uint8Array(uSize),
480
- });
481
- } else {
482
- const err = new Error('unknown compression type ' + cmp);
483
- // @ts-ignore - Error.code is a non-standard but widely-used extension
484
- err.code = 14;
485
- throw err;
486
- }
487
- }
488
-
489
- return result;
490
- }
491
-
492
- // === Streaming ZIP writer helpers ===
493
-
494
- // Local file header written with data descriptor flag (bit 3).
495
- // CRC32 / cSize / uSize are 0 - the data descriptor record after the
496
- // compressed data carries the real values.
497
- function _writeLocalHeaderDD(d, b, fnBytes, u, method, dosTime, ex) {
498
- _w32(d, b, 0x04034B50); b += 4;
499
- d[b] = 20; b += 2; // version needed: 2.0
500
- d[b] = 8; d[b + 1] = (u ? 8 : 0); b += 2; // flags: bit3=DD, bit11=UTF-8
501
- _w16(d, b, method); b += 2; // compression method (0 or 8)
502
- _w32(d, b, dosTime); b += 4; // last mod date/time
503
- b += 12; // CRC32=0, cSize=0, uSize=0
504
- _w16(d, b, fnBytes.length); b += 2;
505
- _w16(d, b, _exfl(ex)); b += 2;
506
- d.set(fnBytes, b); b += fnBytes.length;
507
- return _writeExtra(d, b, ex);
508
- }
509
-
510
- // Data descriptor record (PK\x07\x08 + CRC32 + cSize + uSize).
511
- // Written immediately after the compressed data for streaming entries.
512
- function _writeDataDescriptor(d, b, crc, cSize, uSize) {
513
- _w32(d, b, 0x08074B50); b += 4;
514
- _w32(d, b, crc); b += 4;
515
- _w32(d, b, cSize); b += 4;
516
- _w32(d, b, uSize); b += 4;
517
- return b;
518
- }
519
-
520
- // === Streaming ZIP Writer ===
521
-
522
- /**
523
- * Streaming ZIP archive writer.
524
- *
525
- * Emits archive bytes progressively as files are added, enabling
526
- * download-while-creating use cases without buffering the whole archive.
527
- * Each file entry (whether added via `add` or `openEntry`) is written as
528
- * it arrives; the Central Directory and EOCD are emitted by `finalize()`.
529
- *
530
- * For entries added via `openEntry`, a data descriptor record
531
- * (PK\x07\x08) is written after the compressed data so that CRC32 and
532
- * sizes do not need to be known in advance.
533
- *
534
- * ## Usage
535
- *
536
- * ```js
537
- * const zs = new ZipStream({ level: 6 }, (chunk, final) => send(chunk));
538
- *
539
- * // Complete file (all bytes available now)
540
- * zs.add('readme.txt', textBytes);
541
- *
542
- * // Large file streamed in chunks
543
- * const entry = zs.openEntry('big.bin');
544
- * entry.push(chunk1, false);
545
- * entry.push(chunk2, true); // ← final chunk of this file
546
- *
547
- * zs.finalize(); // emits Central Directory + EOCD
548
- * ```
549
- *
550
- * Only one entry may be open at a time. Do not call `add`, `openEntry`,
551
- * or `finalize` while an `openEntry` writer is still active.
552
- *
553
- * @param {object|function} [opts] - default per-entry options, or `ondata`
554
- * @param {function} [ondata] - callback(chunk: Uint8Array, isFinal: boolean)
555
- */
556
- function ZipStream(opts, ondata) {
557
- if (typeof opts === 'function') { ondata = opts; opts = {}; }
558
- this.ondata = ondata || null;
559
- this._opts = opts || {};
560
- this._off = 0; // bytes emitted to the consumer so far
561
- this._entries = []; // metadata for the Central Directory
562
- this._active = null; // non-null while an openEntry writer is live
563
- }
564
-
565
- ZipStream.prototype._emit = function(chunk, final) {
566
- this._off += chunk.length;
567
- if (this.ondata) this.ondata(chunk, !!final);
568
- };
569
-
570
- /**
571
- * Add a complete file entry synchronously.
572
- *
573
- * All of the file's bytes must be available at call time.
574
- *
575
- * @param {string} name
576
- * @param {Uint8Array|[Uint8Array, object]} data - file content or `[content, perFileOpts]`
577
- * @param {object} [opts] - per-entry options (merged with constructor opts)
578
- */
579
- ZipStream.prototype.add = function(name, data, opts) {
580
- if (this._active) throw new Error('ZipStream: an entry is still open');
581
- if (Array.isArray(data)) { opts = Object.assign({}, data[1], opts); data = data[0]; }
582
- const p = Object.assign({}, this._opts, opts);
583
- const fnBytes = _strToU8(name);
584
- // @ts-ignore - Error.code is a non-standard but widely-used extension
585
- if (fnBytes.length > 65535) { const e = new Error('filename too long'); e.code = 11; throw e; }
586
- const u = _isUTF8(name);
587
- const method = p.level === 0 ? 0 : 8;
588
- const dosTime = _dosDateTime(p.mtime);
589
- const exl = _exfl(p.extra);
590
- const localHdrLen = _localHeaderSize(fnBytes.length, exl);
591
- const localOffset = this._off;
592
-
593
- const crc = new Crc32(); crc.append(data);
594
- const crcVal = crc.get();
595
- const compressed = method ? deflateSync(data, p) : data;
596
- const cSize = compressed.length;
597
- const uSize = data.length;
598
-
599
- const out = new Uint8Array(localHdrLen + cSize);
600
- _writeLocalHeader(out, 0, null, fnBytes, u, method, dosTime, crcVal, cSize, uSize, p.extra);
601
- out.set(compressed, localHdrLen);
602
- this._emit(out, false);
603
-
604
- const comBytes = p.comment ? _strToU8(p.comment) : null;
605
- this._entries.push({ fnBytes, u, method, dosTime, crcVal, cSize, uSize, localOffset, extra: p.extra, comBytes });
606
- };
607
-
608
- /**
609
- * Begin a streaming file entry.
610
- *
611
- * Returns a writer whose `push(chunk, final)` method accepts file content
612
- * chunks. The archive stream receives compressed bytes as they are produced.
613
- * Call `push(lastChunk, true)` to close the entry before using the `ZipStream`
614
- * again.
615
- *
616
- * Because sizes are unknown at header-write time, the local file header has
617
- * zeros for CRC32/sizes and a data descriptor record is emitted after the
618
- * compressed data.
619
- *
620
- * @param {string} name
621
- * @param {object} [opts] - per-entry options (merged with constructor opts)
622
- * @returns {{ push(chunk: Uint8Array, final?: boolean): void }}
623
- */
624
- ZipStream.prototype.openEntry = function(name, opts) {
625
- if (this._active) throw new Error('ZipStream: an entry is still open');
626
- const p = Object.assign({}, this._opts, opts);
627
- const fnBytes = _strToU8(name);
628
- // @ts-ignore - Error.code is a non-standard but widely-used extension
629
- if (fnBytes.length > 65535) { const e = new Error('filename too long'); e.code = 11; throw e; }
630
- const u = _isUTF8(name);
631
- const method = p.level === 0 ? 0 : 8;
632
- const dosTime = _dosDateTime(p.mtime);
633
- const exl = _exfl(p.extra);
634
- const localHdrLen = _localHeaderSize(fnBytes.length, exl);
635
- const localOffset = this._off;
636
-
637
- // Emit local file header immediately (DD mode - sizes are 0 for now)
638
- const hdr = new Uint8Array(localHdrLen);
639
- _writeLocalHeaderDD(hdr, 0, fnBytes, u, method, dosTime, p.extra);
640
- this._emit(hdr, false);
641
-
642
- const crc = new Crc32();
643
- let cSize = 0;
644
- let uSize = 0;
645
- const self = this;
646
- const comBytes = p.comment ? _strToU8(p.comment) : null;
647
-
648
- // Set up DeflateStream for DEFLATE entries. Called synchronously per push.
649
- let ds = null;
650
- if (method === 8) {
651
- ds = new DeflateStream(p, function(chunk, dfinal) {
652
- cSize += chunk.length;
653
- self._emit(chunk, false);
654
- if (dfinal) {
655
- // Emit data descriptor (PK\x07\x08) then record the CD entry
656
- const dd = new Uint8Array(16);
657
- _writeDataDescriptor(dd, 0, crc.get(), cSize, uSize);
658
- self._emit(dd, false);
659
- self._entries.push({ fnBytes, u, method, dosTime, crcVal: crc.get(), cSize, uSize, localOffset, extra: p.extra, comBytes });
660
- self._active = null;
661
- }
662
- });
663
- }
664
-
665
- const state = { done: false };
666
- this._active = state;
667
-
668
- return {
669
- /**
670
- * @param {Uint8Array} chunk
671
- * @param {boolean} [final=false]
672
- */
673
- push(chunk, final) {
674
- if (state.done) throw new Error('ZipStream entry already finalized');
675
- final = !!final;
676
- crc.append(chunk);
677
- uSize += chunk.length;
678
- if (method === 0) {
679
- // Store mode: emit raw bytes directly
680
- cSize += chunk.length;
681
- self._emit(chunk, false);
682
- if (final) {
683
- const dd = new Uint8Array(16);
684
- _writeDataDescriptor(dd, 0, crc.get(), cSize, uSize);
685
- self._emit(dd, false);
686
- self._entries.push({ fnBytes, u, method, dosTime, crcVal: crc.get(), cSize, uSize, localOffset, extra: p.extra, comBytes });
687
- self._active = null;
688
- state.done = true;
689
- }
690
- } else {
691
- // DEFLATE mode: feed chunk to DeflateStream
692
- // The DeflateStream callback handles emit + DD + CD entry registration
693
- ds.push(chunk, final);
694
- if (final) state.done = true;
695
- }
696
- }
697
- };
698
- };
699
-
700
- /**
701
- * Finalise the archive.
702
- *
703
- * Emits the Central Directory and End-of-Central-Directory record.
704
- * `ondata` is called with `isFinal = true` on this last chunk.
705
- *
706
- * Must be called after all entries have been added and any open `openEntry`
707
- * writer has received its final `push`.
708
- */
709
- ZipStream.prototype.finalize = function() {
710
- if (this._active) throw new Error('ZipStream: an entry is still open');
711
- const cdOffset = this._off;
712
- let cdLen = 0;
713
- for (const e of this._entries) {
714
- cdLen += _centralEntrySize(e.fnBytes.length, _exfl(e.extra), e.comBytes ? e.comBytes.length : 0);
715
- }
716
- const out = new Uint8Array(cdLen + 22);
717
- let pos = 0;
718
- for (const e of this._entries) {
719
- pos = _writeCentralEntry(out, pos, e.fnBytes, e.u, e.method, e.dosTime, e.crcVal, e.cSize, e.uSize, e.localOffset, e.extra, e.comBytes);
720
- }
721
- _writeEOCD(out, pos, this._entries.length, cdLen, cdOffset);
722
- this._emit(out, true);
723
- };
724
-
725
- // === Streaming ZIP Reader ===
726
-
727
- /**
728
- * Streaming ZIP reader.
729
- *
730
- * Buffers all pushed chunks and extracts the archive when `push(chunk, true)`
731
- * is called. The `onfile` callback receives each extracted file.
732
- *
733
- * Note: ZIP's Central Directory is at the end of the archive, so extraction
734
- * cannot begin before the final byte arrives. This class provides a
735
- * push-based interface consistent with the other streaming APIs while
736
- * absorbing that constraint internally.
737
- *
738
- * @param {object|function} [opts] - extraction options or `onfile` callback
739
- * @param {function} [onfile] - callback(name: string, data: Uint8Array, isFinal: boolean)
740
- */
741
- function ZipStreamReader(opts, onfile) {
742
- if (typeof opts === 'function') { onfile = opts; opts = {}; }
743
- this.onfile = onfile || null;
744
- this._opts = opts || {};
745
- this._buf = [];
746
- this._bufLen = 0;
747
- }
748
-
749
- /**
750
- * @param {Uint8Array} chunk
751
- * @param {boolean} [final=false]
752
- */
753
- ZipStreamReader.prototype.push = function(chunk, final) {
754
- this._buf.push(chunk);
755
- this._bufLen += chunk.length;
756
- if (!final) return;
757
-
758
- // Reassemble and extract
759
- const combined = new Uint8Array(this._bufLen);
760
- let off = 0;
761
- for (const c of this._buf) { combined.set(c, off); off += c.length; }
762
- this._buf = null;
763
-
764
- const files = unzipSync(combined, this._opts);
765
- if (this.onfile) {
766
- const names = Object.keys(files);
767
- for (let i = 0; i < names.length; ++i) {
768
- this.onfile(names[i], files[names[i]], i === names.length - 1);
769
- }
770
- }
771
- };
772
-
773
- // Async wrappers (microtask-deferred)
774
- const _mt = typeof queueMicrotask === 'function'
775
- ? queueMicrotask
776
- : fn => Promise.resolve().then(fn);
777
-
778
- /**
779
- * Asynchronously create a ZIP archive.
780
- *
781
- * @param {object} files
782
- * @param {object} [opts]
783
- * @returns {Promise<Uint8Array>}
784
- */
785
- function zipAsync(files, opts = {}) {
786
- return new Promise((resolve, reject) => {
787
- _mt(() => { try { resolve(zipSync(files, opts)); } catch (e) { reject(e); } });
788
- });
789
- }
790
-
791
- /**
792
- * Asynchronously extract a ZIP archive.
793
- *
794
- * @param {Uint8Array} data
795
- * @param {object} [opts]
796
- * @returns {Promise<{ [path: string]: Uint8Array }>}
797
- */
798
- function unzipAsync(data, opts = {}) {
799
- return new Promise((resolve, reject) => {
800
- _mt(() => { try { resolve(unzipSync(data, opts)); } catch (e) { reject(e); } });
801
- });
802
- }
803
-
804
- return {
805
- zipSync,
806
- unzipSync,
807
- zip: zipAsync,
808
- unzip: unzipAsync,
809
- // @ts-ignore - ZipStream is a constructor function matching ZipStreamCtor; TS can't verify function-as-constructor
810
- ZipStream,
811
- // @ts-ignore - ZipStreamReader is a constructor function matching ZipStreamReaderCtor; TS can't verify function-as-constructor
812
- ZipStreamReader,
813
- };
814
- }
815
- };
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview ZIP archive creation and extraction factory.
7
+ *
8
+ * Supports ZIP and ZIP64 format (for archives > 4 GB) with DEFLATE compression
9
+ * (method 8) and store (method 0) ISO/IEC 21320-1. File entries can be plain `Uint8Array` or
10
+ * `[Uint8Array, PerFileOptions]` tuples. Directory objects are flattened with
11
+ * a trailing `/` path separator.
12
+ *
13
+ * ## API
14
+ *
15
+ * | Method | Returns |
16
+ * |---|---|
17
+ * | `zipSync(files, opts?)` | `Uint8Array` - synchronous archive creation |
18
+ * | `unzipSync(data, opts?)` | `{ [path]: Uint8Array }` - synchronous extraction |
19
+ * | `zip(files, opts?)` | `Promise<Uint8Array>` |
20
+ * | `unzip(data, opts?)` | `Promise<{ [path]: Uint8Array }>` |
21
+ *
22
+ * ## Files argument
23
+ *
24
+ * ```js
25
+ * {
26
+ * 'file.txt': data, // Uint8Array
27
+ * 'archive/big.bin': [data, { level: 0 }], // with per-file options
28
+ * 'subdir/': {}, // directory entry
29
+ * }
30
+ * ```
31
+ *
32
+ * ## Per-file options
33
+ *
34
+ * `{ level?: 0–9, mtime?: number|Date, comment?: string, extra?: object }`
35
+ *
36
+ * Set `level: 0` to store without compression.
37
+ *
38
+ * ## Deterministic / reproducible archives
39
+ *
40
+ * `opts.mtime` (writer-level default) also accepts `number|Date`, on both
41
+ * write paths: `zipSync`/`zip`'s `opts` argument and `ZipStream`'s
42
+ * constructor `opts`. It seeds every entry that does not supply its own
43
+ * `p.mtime` (per-entry `mtime` always wins). Fixing the writer-level
44
+ * `mtime` makes two writes of an identical payload byte-identical —
45
+ * without it, each entry's timestamp defaults to `Date.now()` and bytes
46
+ * differ run to run. Valid range is 1980-2099 (MS-DOS date/time,
47
+ * 2-second resolution); outside it throws error code 10, fixed mtime
48
+ * included. This module only provides the option — a caller composing on
49
+ * top of `zip` (e.g. a document-format writer) must thread its own fixed
50
+ * `mtime` through to claim reproducible output.
51
+ *
52
+ * ## Extraction options
53
+ *
54
+ * `{ filter?: ({ name, size, originalSize, compression }) => boolean }`
55
+ *
56
+ */
57
+
58
+ /**
59
+ * Writer returned by `ZipStream.openEntry(...)`.
60
+ * @typedef {object} ZipEntryWriter
61
+ * @property {(chunk: Uint8Array, final?: boolean) => void} push
62
+ */
63
+
64
+ /**
65
+ * Streaming ZIP archive writer instance shape.
66
+ * @typedef {object} ZipStreamInstance
67
+ * @property {((chunk: Uint8Array, isFinal: boolean) => void)|null} ondata
68
+ * @property {(name: string, data: Uint8Array|[Uint8Array, object], opts?: object) => void} add
69
+ * @property {(name: string, opts?: object) => ZipEntryWriter} openEntry
70
+ * @property {() => void} finalize
71
+ */
72
+
73
+ /**
74
+ * Constructor for `ZipStream`.
75
+ * @typedef {new (opts?: object|((chunk: Uint8Array, isFinal: boolean) => void), ondata?: (chunk: Uint8Array, isFinal: boolean) => void) => ZipStreamInstance} ZipStreamCtor
76
+ */
77
+
78
+ /**
79
+ * Streaming ZIP reader instance shape.
80
+ * @typedef {object} ZipStreamReaderInstance
81
+ * @property {((name: string, data: Uint8Array, isFinal: boolean) => void)|null} onfile
82
+ * @property {(chunk: Uint8Array, final?: boolean) => void} push
83
+ */
84
+
85
+ /**
86
+ * Constructor for `ZipStreamReader`.
87
+ * @typedef {new (opts?: object|((name: string, data: Uint8Array, isFinal: boolean) => void), onfile?: (name: string, data: Uint8Array, isFinal: boolean) => void) => ZipStreamReaderInstance} ZipStreamReaderCtor
88
+ */
89
+
90
+ /**
91
+ * Public surface of `zip.factory(...)`.
92
+ * @typedef {object} ZipApi
93
+ * @property {(files: object, opts?: object) => Uint8Array} zipSync
94
+ * @property {(data: Uint8Array, opts?: object) => Object<string, Uint8Array>} unzipSync
95
+ * @property {(files: object, opts?: object) => Promise<Uint8Array>} zip
96
+ * @property {(data: Uint8Array, opts?: object) => Promise<Object<string, Uint8Array>>} unzip
97
+ * @property {ZipStreamCtor} ZipStream
98
+ * @property {ZipStreamReaderCtor} ZipStreamReader
99
+ */
100
+
101
+ import { deflate } from './deflate.js';
102
+ import { crc32 } from '../calc/crc32.js';
103
+
104
+ export const zip = {
105
+ name: 'zip',
106
+ version: '1.0.0',
107
+ type: 'fw.io.compress',
108
+ dependencies: ['deflate', 'crc32'],
109
+ deps: [deflate, crc32],
110
+
111
+ /**
112
+ * @param {{ deflateSync, inflateSync, deflate, inflate, DeflateStream, InflateStream }} deflateModule
113
+ * @param {new() => {append: function(Uint8Array): void, get: function(): number}} Crc32 - constructor returned by crc32.factory()
114
+ * @returns {ZipApi}
115
+ */
116
+ factory(deflateModule, Crc32) {
117
+
118
+ const { deflateSync, inflateSync, DeflateStream } = deflateModule;
119
+
120
+ // --- String ↔ Uint8Array helpers ---
121
+
122
+ // Native encoder/decoder (universal in modern environments)
123
+ const _te = typeof TextEncoder !== 'undefined' && new TextEncoder();
124
+ const _td = typeof TextDecoder !== 'undefined' && new TextDecoder();
125
+
126
+ function _strToU8(str) {
127
+ if (_te) return _te.encode(str);
128
+ // Fallback: manual UTF-8 for non-ASCII
129
+ const a = [];
130
+ for (let i = 0; i < str.length; ++i) {
131
+ let c = str.charCodeAt(i);
132
+ if (c < 0x80) {
133
+ a.push(c);
134
+ } else if (c < 0x800) {
135
+ a.push(0xC0 | (c >> 6), 0x80 | (c & 0x3F));
136
+ } else if (c > 0xD7FF && c < 0xE000) {
137
+ c = 0x10000 + (((c & 0x3FF) << 10) | (str.charCodeAt(++i) & 0x3FF));
138
+ a.push(0xF0 | (c >> 18), 0x80 | ((c >> 12) & 0x3F), 0x80 | ((c >> 6) & 0x3F), 0x80 | (c & 0x3F));
139
+ } else {
140
+ a.push(0xE0 | (c >> 12), 0x80 | ((c >> 6) & 0x3F), 0x80 | (c & 0x3F));
141
+ }
142
+ }
143
+ return new Uint8Array(a);
144
+ }
145
+
146
+ // Decode bytes as UTF-8 (utf8=true) or Latin-1 (utf8=false)
147
+ function _u8ToStr(d, utf8) {
148
+ if (!utf8) {
149
+ // Latin-1: one char per byte
150
+ let r = '';
151
+ for (let i = 0; i < d.length; i += 16384)
152
+ r += String.fromCharCode(...d.subarray(i, i + 16384));
153
+ return r;
154
+ }
155
+ if (_td) return _td.decode(d);
156
+ // Fallback manual decode
157
+ let r = '';
158
+ for (let i = 0; i < d.length;) {
159
+ const b = d[i++];
160
+ if (b < 0x80) { r += String.fromCharCode(b); }
161
+ else if (b < 0xE0) { r += String.fromCharCode(((b & 0x1F) << 6) | (d[i++] & 0x3F)); }
162
+ else if (b < 0xF0) { r += String.fromCharCode(((b & 0x0F) << 12) | ((d[i++] & 0x3F) << 6) | (d[i++] & 0x3F)); }
163
+ else {
164
+ let cp = ((b & 0x07) << 18) | ((d[i++] & 0x3F) << 12) | ((d[i++] & 0x3F) << 6) | (d[i++] & 0x3F);
165
+ cp -= 0x10000;
166
+ r += String.fromCharCode(0xD800 | (cp >> 10), 0xDC00 | (cp & 0x3FF));
167
+ }
168
+ }
169
+ return r;
170
+ }
171
+
172
+ // True when the string contains no characters outside Latin-1
173
+ function _isUTF8(str) {
174
+ for (let i = 0; i < str.length; ++i) if (str.charCodeAt(i) > 127) return true;
175
+ return false;
176
+ }
177
+
178
+ // --- Byte-level helpers ---
179
+
180
+ function _r16(d, b) { return d[b] | (d[b + 1] << 8); }
181
+ function _r32(d, b) { return (d[b] | (d[b + 1] << 8) | (d[b + 2] << 16) | (d[b + 3] << 24)) >>> 0; }
182
+ function _r64(d, b) { return _r32(d, b) + _r32(d, b + 4) * 4294967296; }
183
+
184
+ function _w16(d, b, v) { d[b] = v & 0xFF; d[b + 1] = (v >> 8) & 0xFF; }
185
+ function _w32(d, b, v) { d[b] = v & 0xFF; d[b + 1] = (v >> 8) & 0xFF; d[b + 2] = (v >> 16) & 0xFF; d[b + 3] = (v >>> 24) & 0xFF; }
186
+
187
+ // --- MS-DOS date/time encoding ---
188
+
189
+ function _dosDateTime(mtime) {
190
+ const d = new Date(mtime ?? Date.now());
191
+ const y = d.getFullYear() - 1980;
192
+ if (y < 0 || y > 119) {
193
+ const e = new Error('date not in range 1980-2099');
194
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
195
+ e.code = 'EBADDATE'; e.errno = 10;
196
+ throw e;
197
+ }
198
+ return (y << 25) | ((d.getMonth() + 1) << 21) | (d.getDate() << 16)
199
+ | (d.getHours() << 11) | (d.getMinutes() << 5) | (d.getSeconds() >> 1);
200
+ }
201
+
202
+ // Deflate bit flag from level
203
+ function _dbf(l) { return l === 1 ? 3 : l < 6 ? 2 : l === 9 ? 1 : 0; }
204
+
205
+ // --- Extra field helpers ---
206
+
207
+ function _exfl(ex) {
208
+ let le = 0;
209
+ if (ex) for (const k in ex) {
210
+ const l = ex[k].length;
211
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
212
+ if (l > 65535) { const e = new Error('extra field too long'); e.code = 'EEXTRATOOLONG'; e.errno = 9; throw e; }
213
+ le += l + 4;
214
+ }
215
+ return le;
216
+ }
217
+
218
+ function _writeExtra(d, b, ex) {
219
+ if (!ex) return b;
220
+ for (const k in ex) {
221
+ const exf = ex[k];
222
+ _w16(d, b, +k); _w16(d, b + 2, exf.length);
223
+ d.set(exf, b + 4);
224
+ b += 4 + exf.length;
225
+ }
226
+ return b;
227
+ }
228
+
229
+ // --- Local file header (PK\x03\x04) ---
230
+
231
+ function _localHeaderSize(fnLen, exLen) {
232
+ return 30 + fnLen + exLen;
233
+ }
234
+
235
+ function _writeLocalHeader(d, b, fn, fnBytes, u, compression, dosTime, crc, cSize, uSize, ex) {
236
+ _w32(d, b, 0x04034B50); b += 4; // signature
237
+ d[b] = 20; b += 2; // version needed
238
+ d[b] = (compression < 0 && 8); d[b + 1] = u && 8; b += 2; // flags: data descriptor, UTF-8
239
+ _w16(d, b, compression & 0xFFFF); b += 2; // compression method
240
+ _w32(d, b, dosTime); b += 4; // last mod
241
+ if (compression >= 0) {
242
+ _w32(d, b, crc); b += 4; // CRC-32
243
+ _w32(d, b, cSize); b += 4; // compressed size
244
+ _w32(d, b, uSize); b += 4; // uncompressed size
245
+ } else {
246
+ b += 12; // will be filled by data descriptor
247
+ }
248
+ _w16(d, b, fnBytes.length); b += 2; // filename length
249
+ _w16(d, b, _exfl(ex)); b += 2; // extra length
250
+ d.set(fnBytes, b); b += fnBytes.length;
251
+ return _writeExtra(d, b, ex);
252
+ }
253
+
254
+ // --- Central directory entry (PK\x01\x02) ---
255
+
256
+ function _centralEntrySize(fnLen, exLen, comLen) {
257
+ return 46 + fnLen + exLen + comLen;
258
+ }
259
+
260
+ function _writeCentralEntry(d, b, fnBytes, u, compression, dosTime, crc, cSize, uSize, localOffset, ex, comment) {
261
+ _w32(d, b, 0x02014B50); b += 4; // signature
262
+ d[b] = 20; d[b + 1] = 0; b += 2; // version made by
263
+ d[b] = 20; b += 2; // version needed
264
+ d[b] = _dbf(compression) << 1; d[b + 1] = u && 8; b += 2; // flags
265
+ _w16(d, b, compression < 0 ? 0 : compression & 0xFFFF); b += 2;
266
+ _w32(d, b, dosTime); b += 4;
267
+ _w32(d, b, crc); b += 4;
268
+ _w32(d, b, compression < 0 ? (-compression - 2) : cSize); b += 4;
269
+ _w32(d, b, uSize); b += 4;
270
+ _w16(d, b, fnBytes.length); b += 2;
271
+ const exl = _exfl(ex);
272
+ _w16(d, b, exl); b += 2;
273
+ const coml = comment ? comment.length : 0;
274
+ _w16(d, b, coml); b += 2;
275
+ b += 2; // disk number start
276
+ b += 2; // internal attributes
277
+ b += 4; // external attributes
278
+ _w32(d, b, localOffset); b += 4;
279
+ d.set(fnBytes, b); b += fnBytes.length;
280
+ b = _writeExtra(d, b, ex);
281
+ if (comment) { d.set(comment, b); b += coml; }
282
+ return b;
283
+ }
284
+
285
+ // --- End of central directory (PK\x05\x06) ---
286
+
287
+ function _writeEOCD(o, b, entryCount, cdSize, cdOffset) {
288
+ _w32(o, b, 0x06054B50); b += 4;
289
+ b += 4; // disk number + start disk
290
+ _w16(o, b, entryCount); b += 2;
291
+ _w16(o, b, entryCount); b += 2;
292
+ _w32(o, b, cdSize); b += 4;
293
+ _w32(o, b, cdOffset);
294
+ // comment length field (2 bytes, value 0): implicitly zero in output buffer
295
+ }
296
+
297
+ // --- ZIP64 extra field reader ---
298
+
299
+ function _z64e(d, b) {
300
+ while (_r16(d, b) !== 1) b += 4 + _r16(d, b + 2);
301
+ return [_r64(d, b + 12), _r64(d, b + 4), _r64(d, b + 20)];
302
+ }
303
+
304
+ // Local file header data offset (skip local header)
305
+ function _slzh(d, b) {
306
+ return b + 30 + _r16(d, b + 26) + _r16(d, b + 28);
307
+ }
308
+
309
+ // Read central directory entry, return [compression, cSize, uSize, name, nextOffset, localOffset]
310
+ function _readCDE(d, b, zip64) {
311
+ const fnl = _r16(d, b + 28);
312
+ const utf8 = (_r16(d, b + 8) & 0x800) !== 0;
313
+ // `\` becomes `/` (D25): APPNOTE 4.4.17 allows forward slashes only,
314
+ // and .NET Framework's ZipFile.CreateFromDirectory writes `\`;
315
+ // Info-ZIP, 7-Zip and CPython present such names with `/` too.
316
+ const fn = _u8ToStr(d.subarray(b + 46, b + 46 + fnl), utf8).replace(/\\/g, '/');
317
+ const es = b + 46 + fnl;
318
+ const bs = _r32(d, b + 20);
319
+ const [sc, su, off] = zip64 && bs === 0xFFFFFFFF
320
+ ? _z64e(d, es)
321
+ : [bs, _r32(d, b + 24), _r32(d, b + 42)];
322
+ return [_r16(d, b + 10), sc, su, fn, es + _r16(d, b + 30) + _r16(d, b + 32), off, _r32(d, b + 16) >>> 0];
323
+ }
324
+
325
+ // --- Flatten nested directory structure ---
326
+
327
+ /**
328
+ * Set an own enumerable property, `__proto__` included: assigning
329
+ * `obj.__proto__ = v` would replace the object's prototype with a
330
+ * decoded value instead of storing it. Every other key assigns.
331
+ */
332
+ function _setOwn(obj, key, value) {
333
+ if (key === '__proto__') {
334
+ Object.defineProperty(obj, key, { value, writable: true, enumerable: true, configurable: true });
335
+ } else {
336
+ obj[key] = value;
337
+ }
338
+ }
339
+
340
+ function _flatten(d, prefix, out, defaultOpts) {
341
+ for (const k in d) {
342
+ const val = d[k];
343
+ const name = prefix + k;
344
+ let data = val, opts = defaultOpts;
345
+ if (Array.isArray(val)) { opts = Object.assign({}, defaultOpts, val[1]); data = val[0]; }
346
+ if (data instanceof Uint8Array) {
347
+ _setOwn(out, name, [data, opts]);
348
+ } else {
349
+ _setOwn(out, name + '/', [new Uint8Array(0), opts]);
350
+ _flatten(data, name + '/', out, defaultOpts);
351
+ }
352
+ }
353
+ }
354
+
355
+ // --- Synchronous API ---
356
+
357
+ /**
358
+ * Create a ZIP archive synchronously.
359
+ *
360
+ * @param {object} files - `{ path: Uint8Array | [Uint8Array, opts] | object }`
361
+ * @param {object} [opts] - default per-file options
362
+ * @returns {Uint8Array}
363
+ */
364
+ function zipSync(files, opts = {}) {
365
+ const flat = {};
366
+ _flatten(files, '', flat, opts);
367
+
368
+ const entries = [];
369
+ let dataLen = 0;
370
+ let cdLen = 0;
371
+
372
+ for (const fn in flat) {
373
+ const [file, p] = flat[fn];
374
+ const compression = (p.level === 0) ? 0 : 8;
375
+ const fnBytes = _strToU8(fn);
376
+ const fnLen = fnBytes.length;
377
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
378
+ if (fnLen > 65535) { const e = new Error('filename too long'); e.code = 'ENAMETOOLONG'; e.errno = 11; throw e; }
379
+ const comBytes = p.comment ? _strToU8(p.comment) : null;
380
+ const exl = _exfl(p.extra);
381
+ const u = _isUTF8(fn) || (comBytes && _isUTF8(p.comment));
382
+ const dosTime = _dosDateTime(p.mtime);
383
+
384
+ const crc = new Crc32();
385
+ crc.append(file);
386
+
387
+ const compressed = compression ? deflateSync(file, p) : file;
388
+ const cSize = compressed.length;
389
+ const uSize = file.length;
390
+ const crcVal = crc.get();
391
+
392
+ const localHdrLen = _localHeaderSize(fnLen, exl);
393
+ entries.push({ fnBytes, u, compression, dosTime, crcVal, cSize, uSize,
394
+ compressed, localHdrLen, p, comBytes, exl, localOffset: dataLen });
395
+
396
+ dataLen += localHdrLen + cSize;
397
+ cdLen += _centralEntrySize(fnLen, exl, comBytes ? comBytes.length : 0);
398
+ }
399
+
400
+ const out = new Uint8Array(dataLen + cdLen + 22);
401
+ let pos = 0, cdPos = dataLen;
402
+
403
+ for (const e of entries) {
404
+ // Write local header + data
405
+ pos = _writeLocalHeader(out, pos, null, e.fnBytes, e.u, e.compression,
406
+ e.dosTime, e.crcVal, e.cSize, e.uSize, e.p.extra);
407
+ out.set(e.compressed, pos); pos += e.cSize;
408
+
409
+ // Write central directory entry
410
+ cdPos = _writeCentralEntry(out, cdPos, e.fnBytes, e.u, e.compression,
411
+ e.dosTime, e.crcVal, e.cSize, e.uSize, e.localOffset, e.p.extra, e.comBytes);
412
+ }
413
+
414
+ _writeEOCD(out, cdPos, entries.length, cdLen, dataLen);
415
+ return out;
416
+ }
417
+
418
+ // Reject paths that would escape the extraction root: any `..`
419
+ // segment or an absolute path (POSIX `/`, Windows drive letter, or
420
+ // Windows UNC `\\`). Default-on per ZIP-slip mitigation; callers can
421
+ // opt out with `{ safe: false }`.
422
+ function _isUnsafePath(name) {
423
+ if (!name) return false;
424
+ // Absolute POSIX
425
+ if (name.charCodeAt(0) === 0x2F) return true;
426
+ // Absolute Windows: `C:` or `\\server`
427
+ if (/^[A-Za-z]:[\\/]/.test(name)) return true;
428
+ if (name.startsWith('\\\\')) return true;
429
+ // Normalise separators then look for `..` segments.
430
+ const segs = name.split(/[\\/]/);
431
+ for (const s of segs) if (s === '..') return true;
432
+ return false;
433
+ }
434
+
435
+ /**
436
+ * Extract a ZIP archive synchronously.
437
+ *
438
+ * `maxOutput` caps the bytes extracted over every entry: each entry's
439
+ * declared size is checked against what is left BEFORE its buffer is
440
+ * allocated, and code 7 is thrown past it. Each entry's CRC-32 and
441
+ * size are checked (code 16 on a mismatch); `verify: false` skips
442
+ * the check.
443
+ *
444
+ * @param {Uint8Array} data
445
+ * @param {object} [opts] - `{ filter?: fn, safe?: boolean, verify?: boolean, maxOutput?: number }`
446
+ * @returns {{ [path: string]: Uint8Array }}
447
+ */
448
+ function unzipSync(data, opts = {}) {
449
+ /** @type {{ [path: string]: Uint8Array }} */
450
+ const result = Object.create(null); // null prototype: no inherited key collides with a decoded one (D9 G7)
451
+ const safe = opts.safe !== false;
452
+ const cap = opts.maxOutput === undefined || opts.maxOutput === null ? Infinity : opts.maxOutput;
453
+ if (cap !== Infinity && !(Number.isSafeInteger(cap) && cap >= 0)) {
454
+ throw new RangeError('maxOutput must be a non-negative integer');
455
+ }
456
+ let extracted = 0;
457
+
458
+ // Locate end-of-central-directory record
459
+ let e = data.length - 22;
460
+ while (_r32(data, e) !== 0x06054B50) {
461
+ if (!e || data.length - e > 65558) {
462
+ const err = new Error('invalid zip data');
463
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
464
+ err.code = 'EBADFORMAT'; err.errno = 13;
465
+ throw err;
466
+ }
467
+ --e;
468
+ }
469
+
470
+ let entryCount = _r16(data, e + 8);
471
+ if (!entryCount) return result;
472
+
473
+ let cdOffset = _r32(data, e + 16);
474
+ let zip64 = cdOffset === 0xFFFFFFFF || entryCount === 0xFFFF;
475
+
476
+ if (zip64) {
477
+ // ZIP64 end-of-central-directory locator at e-12
478
+ const ze = _r32(data, e - 12);
479
+ if (_r32(data, ze) === 0x06064B50) {
480
+ entryCount = _r32(data, ze + 32);
481
+ cdOffset = _r64(data, ze + 48);
482
+ }
483
+ }
484
+
485
+ const fltr = opts.filter;
486
+ let o = cdOffset;
487
+
488
+ for (let i = 0; i < entryCount; ++i) {
489
+ const [cmp, cSize, uSize, fn, nextOff, localOff, crcExpected] = _readCDE(data, o, zip64);
490
+ o = nextOff;
491
+ const dataStart = _slzh(data, localOff);
492
+
493
+ if (safe && _isUnsafePath(fn)) {
494
+ const err = new Error('zip-slip: unsafe entry path "' + fn + '"');
495
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
496
+ err.code = 'EUNSAFEPATH'; err.errno = 15;
497
+ throw err;
498
+ }
499
+
500
+ if (fltr && !fltr({ name: fn, size: cSize, originalSize: uSize, compression: cmp })) continue;
501
+
502
+ const outSize = cmp === 0 ? cSize : uSize;
503
+ if (outSize > cap - extracted) {
504
+ const err = new Error('zip: output limit exceeded (maxOutput) at "' + fn + '"');
505
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
506
+ err.code = 'EMAXOUT'; err.errno = 7;
507
+ throw err;
508
+ }
509
+ extracted += outSize;
510
+
511
+ if (cmp === 0) {
512
+ _setOwn(result, fn, new Uint8Array(data.subarray(dataStart, dataStart + cSize)));
513
+ } else if (cmp === 8) {
514
+ _setOwn(result, fn, inflateSync(data.subarray(dataStart, dataStart + cSize), {
515
+ out: new Uint8Array(uSize),
516
+ }));
517
+ } else {
518
+ const err = new Error('unknown compression type ' + cmp);
519
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
520
+ err.code = 'EBADMETHOD'; err.errno = 14;
521
+ throw err;
522
+ }
523
+
524
+ if (opts.verify !== false) {
525
+ const c = new Crc32();
526
+ c.append(result[fn]);
527
+ if (c.get() !== crcExpected || result[fn].length !== uSize) {
528
+ const err = new Error('zip: incorrect data check (CRC-32 or size mismatch) for "' + fn + '"');
529
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
530
+ err.code = 'ECHECKSUM'; err.errno = 16;
531
+ throw err;
532
+ }
533
+ }
534
+ }
535
+
536
+ return result;
537
+ }
538
+
539
+ // === Streaming ZIP writer helpers ===
540
+
541
+ // Local file header written with data descriptor flag (bit 3).
542
+ // CRC32 / cSize / uSize are 0 - the data descriptor record after the
543
+ // compressed data carries the real values.
544
+ function _writeLocalHeaderDD(d, b, fnBytes, u, method, dosTime, ex) {
545
+ _w32(d, b, 0x04034B50); b += 4;
546
+ d[b] = 20; b += 2; // version needed: 2.0
547
+ d[b] = 8; d[b + 1] = (u ? 8 : 0); b += 2; // flags: bit3=DD, bit11=UTF-8
548
+ _w16(d, b, method); b += 2; // compression method (0 or 8)
549
+ _w32(d, b, dosTime); b += 4; // last mod date/time
550
+ b += 12; // CRC32=0, cSize=0, uSize=0
551
+ _w16(d, b, fnBytes.length); b += 2;
552
+ _w16(d, b, _exfl(ex)); b += 2;
553
+ d.set(fnBytes, b); b += fnBytes.length;
554
+ return _writeExtra(d, b, ex);
555
+ }
556
+
557
+ // Data descriptor record (PK\x07\x08 + CRC32 + cSize + uSize).
558
+ // Written immediately after the compressed data for streaming entries.
559
+ function _writeDataDescriptor(d, b, crc, cSize, uSize) {
560
+ _w32(d, b, 0x08074B50); b += 4;
561
+ _w32(d, b, crc); b += 4;
562
+ _w32(d, b, cSize); b += 4;
563
+ _w32(d, b, uSize); b += 4;
564
+ return b;
565
+ }
566
+
567
+ // === Streaming ZIP Writer ===
568
+
569
+ /**
570
+ * Streaming ZIP archive writer.
571
+ *
572
+ * Emits archive bytes progressively as files are added, enabling
573
+ * download-while-creating use cases without buffering the whole archive.
574
+ * Each file entry (whether added via `add` or `openEntry`) is written as
575
+ * it arrives; the Central Directory and EOCD are emitted by `finalize()`.
576
+ *
577
+ * For entries added via `openEntry`, a data descriptor record
578
+ * (PK\x07\x08) is written after the compressed data so that CRC32 and
579
+ * sizes do not need to be known in advance.
580
+ *
581
+ * ## Usage
582
+ *
583
+ * ```js
584
+ * const zs = new ZipStream({ level: 6 }, (chunk, final) => send(chunk));
585
+ *
586
+ * // Complete file (all bytes available now)
587
+ * zs.add('readme.txt', textBytes);
588
+ *
589
+ * // Large file streamed in chunks
590
+ * const entry = zs.openEntry('big.bin');
591
+ * entry.push(chunk1, false);
592
+ * entry.push(chunk2, true); // ← final chunk of this file
593
+ *
594
+ * zs.finalize(); // emits Central Directory + EOCD
595
+ * ```
596
+ *
597
+ * Only one entry may be open at a time. Do not call `add`, `openEntry`,
598
+ * or `finalize` while an `openEntry` writer is still active.
599
+ *
600
+ * @param {object|function} [opts] - default per-entry options, or `ondata`
601
+ * @param {function} [ondata] - callback(chunk: Uint8Array, isFinal: boolean)
602
+ */
603
+ function ZipStream(opts, ondata) {
604
+ if (typeof opts === 'function') { ondata = opts; opts = {}; }
605
+ this.ondata = ondata || null;
606
+ this._opts = opts || {};
607
+ this._off = 0; // bytes emitted to the consumer so far
608
+ this._entries = []; // metadata for the Central Directory
609
+ this._active = null; // non-null while an openEntry writer is live
610
+ }
611
+
612
+ ZipStream.prototype._emit = function(chunk, final) {
613
+ this._off += chunk.length;
614
+ if (this.ondata) this.ondata(chunk, !!final);
615
+ };
616
+
617
+ /**
618
+ * Add a complete file entry synchronously.
619
+ *
620
+ * All of the file's bytes must be available at call time.
621
+ *
622
+ * @param {string} name
623
+ * @param {Uint8Array|[Uint8Array, object]} data - file content or `[content, perFileOpts]`
624
+ * @param {object} [opts] - per-entry options (merged with constructor opts)
625
+ */
626
+ ZipStream.prototype.add = function(name, data, opts) {
627
+ if (this._active) throw new Error('ZipStream: an entry is still open');
628
+ if (Array.isArray(data)) { opts = Object.assign({}, data[1], opts); data = data[0]; }
629
+ const p = Object.assign({}, this._opts, opts);
630
+ const fnBytes = _strToU8(name);
631
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
632
+ if (fnBytes.length > 65535) { const e = new Error('filename too long'); e.code = 'ENAMETOOLONG'; e.errno = 11; throw e; }
633
+ const u = _isUTF8(name);
634
+ const method = p.level === 0 ? 0 : 8;
635
+ const dosTime = _dosDateTime(p.mtime);
636
+ const exl = _exfl(p.extra);
637
+ const localHdrLen = _localHeaderSize(fnBytes.length, exl);
638
+ const localOffset = this._off;
639
+
640
+ const crc = new Crc32(); crc.append(data);
641
+ const crcVal = crc.get();
642
+ const compressed = method ? deflateSync(data, p) : data;
643
+ const cSize = compressed.length;
644
+ const uSize = data.length;
645
+
646
+ const out = new Uint8Array(localHdrLen + cSize);
647
+ _writeLocalHeader(out, 0, null, fnBytes, u, method, dosTime, crcVal, cSize, uSize, p.extra);
648
+ out.set(compressed, localHdrLen);
649
+ this._emit(out, false);
650
+
651
+ const comBytes = p.comment ? _strToU8(p.comment) : null;
652
+ this._entries.push({ fnBytes, u, method, dosTime, crcVal, cSize, uSize, localOffset, extra: p.extra, comBytes });
653
+ };
654
+
655
+ /**
656
+ * Begin a streaming file entry.
657
+ *
658
+ * Returns a writer whose `push(chunk, final)` method accepts file content
659
+ * chunks. The archive stream receives compressed bytes as they are produced.
660
+ * Call `push(lastChunk, true)` to close the entry before using the `ZipStream`
661
+ * again.
662
+ *
663
+ * Because sizes are unknown at header-write time, the local file header has
664
+ * zeros for CRC32/sizes and a data descriptor record is emitted after the
665
+ * compressed data.
666
+ *
667
+ * @param {string} name
668
+ * @param {object} [opts] - per-entry options (merged with constructor opts)
669
+ * @returns {{ push(chunk: Uint8Array, final?: boolean): void }}
670
+ */
671
+ ZipStream.prototype.openEntry = function(name, opts) {
672
+ if (this._active) throw new Error('ZipStream: an entry is still open');
673
+ const p = Object.assign({}, this._opts, opts);
674
+ const fnBytes = _strToU8(name);
675
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
676
+ if (fnBytes.length > 65535) { const e = new Error('filename too long'); e.code = 'ENAMETOOLONG'; e.errno = 11; throw e; }
677
+ const u = _isUTF8(name);
678
+ const method = p.level === 0 ? 0 : 8;
679
+ const dosTime = _dosDateTime(p.mtime);
680
+ const exl = _exfl(p.extra);
681
+ const localHdrLen = _localHeaderSize(fnBytes.length, exl);
682
+ const localOffset = this._off;
683
+
684
+ // Emit local file header immediately (DD mode - sizes are 0 for now)
685
+ const hdr = new Uint8Array(localHdrLen);
686
+ _writeLocalHeaderDD(hdr, 0, fnBytes, u, method, dosTime, p.extra);
687
+ this._emit(hdr, false);
688
+
689
+ const crc = new Crc32();
690
+ let cSize = 0;
691
+ let uSize = 0;
692
+ const self = this;
693
+ const comBytes = p.comment ? _strToU8(p.comment) : null;
694
+
695
+ // Set up DeflateStream for DEFLATE entries. Called synchronously per push.
696
+ let ds = null;
697
+ if (method === 8) {
698
+ ds = new DeflateStream(p, function(chunk, dfinal) {
699
+ cSize += chunk.length;
700
+ self._emit(chunk, false);
701
+ if (dfinal) {
702
+ // Emit data descriptor (PK\x07\x08) then record the CD entry
703
+ const dd = new Uint8Array(16);
704
+ _writeDataDescriptor(dd, 0, crc.get(), cSize, uSize);
705
+ self._emit(dd, false);
706
+ self._entries.push({ fnBytes, u, method, dosTime, crcVal: crc.get(), cSize, uSize, localOffset, extra: p.extra, comBytes });
707
+ self._active = null;
708
+ }
709
+ });
710
+ }
711
+
712
+ const state = { done: false };
713
+ this._active = state;
714
+
715
+ return {
716
+ /**
717
+ * @param {Uint8Array} chunk
718
+ * @param {boolean} [final=false]
719
+ */
720
+ push(chunk, final) {
721
+ if (state.done) throw new Error('ZipStream entry already finalized');
722
+ final = !!final;
723
+ crc.append(chunk);
724
+ uSize += chunk.length;
725
+ if (method === 0) {
726
+ // Store mode: emit raw bytes directly
727
+ cSize += chunk.length;
728
+ self._emit(chunk, false);
729
+ if (final) {
730
+ const dd = new Uint8Array(16);
731
+ _writeDataDescriptor(dd, 0, crc.get(), cSize, uSize);
732
+ self._emit(dd, false);
733
+ self._entries.push({ fnBytes, u, method, dosTime, crcVal: crc.get(), cSize, uSize, localOffset, extra: p.extra, comBytes });
734
+ self._active = null;
735
+ state.done = true;
736
+ }
737
+ } else {
738
+ // DEFLATE mode: feed chunk to DeflateStream
739
+ // The DeflateStream callback handles emit + DD + CD entry registration
740
+ ds.push(chunk, final);
741
+ if (final) state.done = true;
742
+ }
743
+ }
744
+ };
745
+ };
746
+
747
+ /**
748
+ * Finalise the archive.
749
+ *
750
+ * Emits the Central Directory and End-of-Central-Directory record.
751
+ * `ondata` is called with `isFinal = true` on this last chunk.
752
+ *
753
+ * Must be called after all entries have been added and any open `openEntry`
754
+ * writer has received its final `push`.
755
+ */
756
+ ZipStream.prototype.finalize = function() {
757
+ if (this._active) throw new Error('ZipStream: an entry is still open');
758
+ const cdOffset = this._off;
759
+ let cdLen = 0;
760
+ for (const e of this._entries) {
761
+ cdLen += _centralEntrySize(e.fnBytes.length, _exfl(e.extra), e.comBytes ? e.comBytes.length : 0);
762
+ }
763
+ const out = new Uint8Array(cdLen + 22);
764
+ let pos = 0;
765
+ for (const e of this._entries) {
766
+ pos = _writeCentralEntry(out, pos, e.fnBytes, e.u, e.method, e.dosTime, e.crcVal, e.cSize, e.uSize, e.localOffset, e.extra, e.comBytes);
767
+ }
768
+ _writeEOCD(out, pos, this._entries.length, cdLen, cdOffset);
769
+ this._emit(out, true);
770
+ };
771
+
772
+ // === Streaming ZIP Reader ===
773
+
774
+ /**
775
+ * Streaming ZIP reader.
776
+ *
777
+ * Buffers all pushed chunks and extracts the archive when `push(chunk, true)`
778
+ * is called. The `onfile` callback receives each extracted file.
779
+ *
780
+ * Note: ZIP's Central Directory is at the end of the archive, so extraction
781
+ * cannot begin before the final byte arrives. This class provides a
782
+ * push-based interface consistent with the other streaming APIs while
783
+ * absorbing that constraint internally.
784
+ *
785
+ * @param {object|function} [opts] - extraction options or `onfile` callback
786
+ * @param {function} [onfile] - callback(name: string, data: Uint8Array, isFinal: boolean)
787
+ */
788
+ function ZipStreamReader(opts, onfile) {
789
+ if (typeof opts === 'function') { onfile = opts; opts = {}; }
790
+ this.onfile = onfile || null;
791
+ this._opts = opts || {};
792
+ this._buf = [];
793
+ this._bufLen = 0;
794
+ }
795
+
796
+ /**
797
+ * @param {Uint8Array} chunk
798
+ * @param {boolean} [final=false]
799
+ */
800
+ ZipStreamReader.prototype.push = function(chunk, final) {
801
+ this._buf.push(chunk);
802
+ this._bufLen += chunk.length;
803
+ if (!final) return;
804
+
805
+ // Reassemble and extract
806
+ const combined = new Uint8Array(this._bufLen);
807
+ let off = 0;
808
+ for (const c of this._buf) { combined.set(c, off); off += c.length; }
809
+ this._buf = null;
810
+
811
+ const files = unzipSync(combined, this._opts);
812
+ if (this.onfile) {
813
+ const names = Object.keys(files);
814
+ for (let i = 0; i < names.length; ++i) {
815
+ this.onfile(names[i], files[names[i]], i === names.length - 1);
816
+ }
817
+ }
818
+ };
819
+
820
+ // Async wrappers (microtask-deferred)
821
+ const _mt = typeof queueMicrotask === 'function'
822
+ ? queueMicrotask
823
+ : fn => Promise.resolve().then(fn);
824
+
825
+ /**
826
+ * Asynchronously create a ZIP archive.
827
+ *
828
+ * @param {object} files
829
+ * @param {object} [opts]
830
+ * @returns {Promise<Uint8Array>}
831
+ */
832
+ function zipAsync(files, opts = {}) {
833
+ return new Promise((resolve, reject) => {
834
+ _mt(() => { try { resolve(zipSync(files, opts)); } catch (e) { reject(e); } });
835
+ });
836
+ }
837
+
838
+ /**
839
+ * Asynchronously extract a ZIP archive.
840
+ *
841
+ * @param {Uint8Array} data
842
+ * @param {object} [opts]
843
+ * @returns {Promise<{ [path: string]: Uint8Array }>}
844
+ */
845
+ function unzipAsync(data, opts = {}) {
846
+ return new Promise((resolve, reject) => {
847
+ _mt(() => { try { resolve(unzipSync(data, opts)); } catch (e) { reject(e); } });
848
+ });
849
+ }
850
+
851
+ return {
852
+ zipSync,
853
+ unzipSync,
854
+ zip: zipAsync,
855
+ unzip: unzipAsync,
856
+ // @ts-ignore - ZipStream is a constructor function matching ZipStreamCtor; TS can't verify function-as-constructor
857
+ ZipStream,
858
+ // @ts-ignore - ZipStreamReader is a constructor function matching ZipStreamReaderCtor; TS can't verify function-as-constructor
859
+ ZipStreamReader,
860
+ };
861
+ }
862
+ };