@seanhogg/builderforce-webcontainers-core 2026.10.7 → 2026.10.9

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 (385) hide show
  1. package/dist/archive.d.ts +2 -0
  2. package/dist/archive.d.ts.map +1 -1
  3. package/dist/archive.js +6 -4
  4. package/dist/archive.js.map +1 -1
  5. package/dist/build.d.ts +6 -0
  6. package/dist/build.d.ts.map +1 -1
  7. package/dist/build.js +9 -1
  8. package/dist/build.js.map +1 -1
  9. package/dist/buildHost.d.ts +3 -0
  10. package/dist/buildHost.d.ts.map +1 -1
  11. package/dist/buildHost.js +25 -12
  12. package/dist/buildHost.js.map +1 -1
  13. package/dist/compileComponent.d.ts.map +1 -1
  14. package/dist/compileComponent.js +4 -1
  15. package/dist/compileComponent.js.map +1 -1
  16. package/dist/compileScript.d.ts +12 -4
  17. package/dist/compileScript.d.ts.map +1 -1
  18. package/dist/compileScript.js +26 -13
  19. package/dist/compileScript.js.map +1 -1
  20. package/dist/components.d.ts +5 -0
  21. package/dist/components.d.ts.map +1 -1
  22. package/dist/components.js.map +1 -1
  23. package/dist/detectProject.d.ts +2 -0
  24. package/dist/detectProject.d.ts.map +1 -1
  25. package/dist/detectProject.js +13 -7
  26. package/dist/detectProject.js.map +1 -1
  27. package/dist/devServer.d.ts +38 -4
  28. package/dist/devServer.d.ts.map +1 -1
  29. package/dist/devServer.js +140 -24
  30. package/dist/devServer.js.map +1 -1
  31. package/dist/devStyles.d.ts +27 -0
  32. package/dist/devStyles.d.ts.map +1 -0
  33. package/dist/devStyles.js +52 -0
  34. package/dist/devStyles.js.map +1 -0
  35. package/dist/hot/client.d.ts +33 -0
  36. package/dist/hot/client.d.ts.map +1 -0
  37. package/dist/hot/client.js +46 -0
  38. package/dist/hot/client.js.map +1 -0
  39. package/dist/hot/moduleGraph.d.ts +39 -0
  40. package/dist/hot/moduleGraph.d.ts.map +1 -0
  41. package/dist/hot/moduleGraph.js +69 -0
  42. package/dist/hot/moduleGraph.js.map +1 -0
  43. package/dist/hot/planUpdate.d.ts +33 -0
  44. package/dist/hot/planUpdate.d.ts.map +1 -0
  45. package/dist/hot/planUpdate.js +43 -0
  46. package/dist/hot/planUpdate.js.map +1 -0
  47. package/dist/hot/reactRefresh.d.ts +45 -0
  48. package/dist/hot/reactRefresh.d.ts.map +1 -0
  49. package/dist/hot/reactRefresh.js +86 -0
  50. package/dist/hot/reactRefresh.js.map +1 -0
  51. package/dist/html.d.ts +4 -8
  52. package/dist/html.d.ts.map +1 -1
  53. package/dist/html.js +15 -19
  54. package/dist/html.js.map +1 -1
  55. package/dist/index.d.ts +20 -1
  56. package/dist/index.d.ts.map +1 -1
  57. package/dist/index.js +12 -1
  58. package/dist/index.js.map +1 -1
  59. package/dist/installer/tree.d.ts.map +1 -1
  60. package/dist/installer/tree.js +22 -4
  61. package/dist/installer/tree.js.map +1 -1
  62. package/dist/installer/wasmBuilds.d.ts +27 -0
  63. package/dist/installer/wasmBuilds.d.ts.map +1 -0
  64. package/dist/installer/wasmBuilds.js +32 -0
  65. package/dist/installer/wasmBuilds.js.map +1 -0
  66. package/dist/node/builtins.d.ts +6 -1
  67. package/dist/node/builtins.d.ts.map +1 -1
  68. package/dist/node/builtins.js +15 -10
  69. package/dist/node/builtins.js.map +1 -1
  70. package/dist/node/childProcess.d.ts +3 -3
  71. package/dist/node/childProcess.d.ts.map +1 -1
  72. package/dist/node/childProcess.js +68 -16
  73. package/dist/node/childProcess.js.map +1 -1
  74. package/dist/node/crypto.d.ts.map +1 -1
  75. package/dist/node/crypto.js +5 -4
  76. package/dist/node/crypto.js.map +1 -1
  77. package/dist/node/esm.d.ts +7 -0
  78. package/dist/node/esm.d.ts.map +1 -1
  79. package/dist/node/esm.js +28 -2
  80. package/dist/node/esm.js.map +1 -1
  81. package/dist/node/fs/index.d.ts +3 -0
  82. package/dist/node/fs/index.d.ts.map +1 -1
  83. package/dist/node/fs/index.js +22 -106
  84. package/dist/node/fs/index.js.map +1 -1
  85. package/dist/node/fs/stdinFd.d.ts +10 -0
  86. package/dist/node/fs/stdinFd.d.ts.map +1 -0
  87. package/dist/node/fs/stdinFd.js +40 -0
  88. package/dist/node/fs/stdinFd.js.map +1 -0
  89. package/dist/node/fs/streams.d.ts +24 -0
  90. package/dist/node/fs/streams.d.ts.map +1 -0
  91. package/dist/node/fs/streams.js +144 -0
  92. package/dist/node/fs/streams.js.map +1 -0
  93. package/dist/node/fs/sync.d.ts +2 -0
  94. package/dist/node/fs/sync.d.ts.map +1 -1
  95. package/dist/node/fs/sync.js +17 -0
  96. package/dist/node/fs/sync.js.map +1 -1
  97. package/dist/node/globalObject.d.ts +25 -0
  98. package/dist/node/globalObject.d.ts.map +1 -0
  99. package/dist/node/globalObject.js +83 -0
  100. package/dist/node/globalObject.js.map +1 -0
  101. package/dist/node/http/client.d.ts +3 -1
  102. package/dist/node/http/client.d.ts.map +1 -1
  103. package/dist/node/http/client.js +74 -5
  104. package/dist/node/http/client.js.map +1 -1
  105. package/dist/node/http/index.d.ts.map +1 -1
  106. package/dist/node/http/index.js +6 -4
  107. package/dist/node/http/index.js.map +1 -1
  108. package/dist/node/http/messages.d.ts +87 -0
  109. package/dist/node/http/messages.d.ts.map +1 -0
  110. package/dist/node/http/messages.js +146 -0
  111. package/dist/node/http/messages.js.map +1 -0
  112. package/dist/node/http/server.d.ts +13 -98
  113. package/dist/node/http/server.d.ts.map +1 -1
  114. package/dist/node/http/server.js +41 -206
  115. package/dist/node/http/server.js.map +1 -1
  116. package/dist/node/http/serverResponse.d.ts +45 -0
  117. package/dist/node/http/serverResponse.d.ts.map +1 -0
  118. package/dist/node/http/serverResponse.js +96 -0
  119. package/dist/node/http/serverResponse.js.map +1 -0
  120. package/dist/node/http/upgradeSocket.d.ts +34 -0
  121. package/dist/node/http/upgradeSocket.d.ts.map +1 -0
  122. package/dist/node/http/upgradeSocket.js +73 -0
  123. package/dist/node/http/upgradeSocket.js.map +1 -0
  124. package/dist/node/ipc.d.ts +26 -0
  125. package/dist/node/ipc.d.ts.map +1 -0
  126. package/dist/node/ipc.js +76 -0
  127. package/dist/node/ipc.js.map +1 -0
  128. package/dist/node/loader.d.ts +2 -0
  129. package/dist/node/loader.d.ts.map +1 -1
  130. package/dist/node/loader.js +79 -14
  131. package/dist/node/loader.js.map +1 -1
  132. package/dist/node/misc.d.ts.map +1 -1
  133. package/dist/node/misc.js +20 -5
  134. package/dist/node/misc.js.map +1 -1
  135. package/dist/node/process.d.ts +2 -5
  136. package/dist/node/process.d.ts.map +1 -1
  137. package/dist/node/process.js +16 -11
  138. package/dist/node/process.js.map +1 -1
  139. package/dist/node/processExit.d.ts +13 -0
  140. package/dist/node/processExit.d.ts.map +1 -0
  141. package/dist/node/processExit.js +25 -0
  142. package/dist/node/processExit.js.map +1 -0
  143. package/dist/node/program.d.ts.map +1 -1
  144. package/dist/node/program.js +6 -5
  145. package/dist/node/program.js.map +1 -1
  146. package/dist/node/runtime.d.ts +6 -1
  147. package/dist/node/runtime.d.ts.map +1 -1
  148. package/dist/node/runtime.js +25 -17
  149. package/dist/node/runtime.js.map +1 -1
  150. package/dist/node/stream/readable.d.ts +2 -1
  151. package/dist/node/stream/readable.d.ts.map +1 -1
  152. package/dist/node/stream/readable.js +2 -1
  153. package/dist/node/stream/readable.js.map +1 -1
  154. package/dist/node/urlqs.d.ts +1 -1
  155. package/dist/node/urlqs.d.ts.map +1 -1
  156. package/dist/node/urlqs.js +11 -2
  157. package/dist/node/urlqs.js.map +1 -1
  158. package/dist/node/workerThreads.d.ts +31 -0
  159. package/dist/node/workerThreads.d.ts.map +1 -0
  160. package/dist/node/workerThreads.js +165 -0
  161. package/dist/node/workerThreads.js.map +1 -0
  162. package/dist/node/zlib.d.ts.map +1 -1
  163. package/dist/node/zlib.js +23 -2
  164. package/dist/node/zlib.js.map +1 -1
  165. package/dist/previewBridge.d.ts +42 -0
  166. package/dist/previewBridge.d.ts.map +1 -0
  167. package/dist/previewBridge.js +192 -0
  168. package/dist/previewBridge.js.map +1 -0
  169. package/dist/shell/ast.d.ts +101 -0
  170. package/dist/shell/ast.d.ts.map +1 -0
  171. package/dist/shell/ast.js +7 -0
  172. package/dist/shell/ast.js.map +1 -0
  173. package/dist/shell/builtins.d.ts +14 -0
  174. package/dist/shell/builtins.d.ts.map +1 -1
  175. package/dist/shell/builtins.js +87 -7
  176. package/dist/shell/builtins.js.map +1 -1
  177. package/dist/shell/compound.d.ts +30 -0
  178. package/dist/shell/compound.d.ts.map +1 -0
  179. package/dist/shell/compound.js +73 -0
  180. package/dist/shell/compound.js.map +1 -0
  181. package/dist/shell/context.d.ts.map +1 -1
  182. package/dist/shell/context.js +2 -2
  183. package/dist/shell/context.js.map +1 -1
  184. package/dist/shell/devHandoff.d.ts +10 -4
  185. package/dist/shell/devHandoff.d.ts.map +1 -1
  186. package/dist/shell/devHandoff.js +7 -5
  187. package/dist/shell/devHandoff.js.map +1 -1
  188. package/dist/shell/exec.d.ts +27 -6
  189. package/dist/shell/exec.d.ts.map +1 -1
  190. package/dist/shell/exec.js +133 -46
  191. package/dist/shell/exec.js.map +1 -1
  192. package/dist/shell/expand.d.ts +5 -1
  193. package/dist/shell/expand.d.ts.map +1 -1
  194. package/dist/shell/expand.js +7 -5
  195. package/dist/shell/expand.js.map +1 -1
  196. package/dist/shell/lineReader.d.ts +9 -0
  197. package/dist/shell/lineReader.d.ts.map +1 -0
  198. package/dist/shell/lineReader.js +42 -0
  199. package/dist/shell/lineReader.js.map +1 -0
  200. package/dist/shell/npm.js +2 -2
  201. package/dist/shell/npm.js.map +1 -1
  202. package/dist/shell/packageManagers.d.ts +20 -0
  203. package/dist/shell/packageManagers.d.ts.map +1 -0
  204. package/dist/shell/packageManagers.js +74 -0
  205. package/dist/shell/packageManagers.js.map +1 -0
  206. package/dist/shell/parse.d.ts +16 -66
  207. package/dist/shell/parse.d.ts.map +1 -1
  208. package/dist/shell/parse.js +244 -243
  209. package/dist/shell/parse.js.map +1 -1
  210. package/dist/shell/program.d.ts.map +1 -1
  211. package/dist/shell/program.js +7 -6
  212. package/dist/shell/program.js.map +1 -1
  213. package/dist/shell/testCommand.d.ts +9 -0
  214. package/dist/shell/testCommand.d.ts.map +1 -0
  215. package/dist/shell/testCommand.js +105 -0
  216. package/dist/shell/testCommand.js.map +1 -0
  217. package/dist/shell/tokenize.d.ts +25 -0
  218. package/dist/shell/tokenize.d.ts.map +1 -0
  219. package/dist/shell/tokenize.js +279 -0
  220. package/dist/shell/tokenize.js.map +1 -0
  221. package/dist/styleModules.d.ts +2 -5
  222. package/dist/styleModules.d.ts.map +1 -1
  223. package/dist/styleModules.js +23 -14
  224. package/dist/styleModules.js.map +1 -1
  225. package/dist/styles/compile.d.ts +18 -0
  226. package/dist/styles/compile.d.ts.map +1 -0
  227. package/dist/styles/compile.js +34 -0
  228. package/dist/styles/compile.js.map +1 -0
  229. package/dist/styles/compilers.d.ts +75 -0
  230. package/dist/styles/compilers.d.ts.map +1 -0
  231. package/dist/styles/compilers.js +77 -0
  232. package/dist/styles/compilers.js.map +1 -0
  233. package/dist/styles/cssModules.d.ts +40 -0
  234. package/dist/styles/cssModules.d.ts.map +1 -0
  235. package/dist/styles/cssModules.js +239 -0
  236. package/dist/styles/cssModules.js.map +1 -0
  237. package/dist/styles/imports.d.ts +37 -0
  238. package/dist/styles/imports.d.ts.map +1 -0
  239. package/dist/styles/imports.js +88 -0
  240. package/dist/styles/imports.js.map +1 -0
  241. package/dist/styles/languages.d.ts +13 -0
  242. package/dist/styles/languages.d.ts.map +1 -0
  243. package/dist/styles/languages.js +20 -0
  244. package/dist/styles/languages.js.map +1 -0
  245. package/dist/styles/packageStyles.d.ts +19 -0
  246. package/dist/styles/packageStyles.d.ts.map +1 -0
  247. package/dist/styles/packageStyles.js +32 -0
  248. package/dist/styles/packageStyles.js.map +1 -0
  249. package/dist/svelteCompiler.d.ts.map +1 -1
  250. package/dist/svelteCompiler.js +19 -2
  251. package/dist/svelteCompiler.js.map +1 -1
  252. package/dist/system/commands.d.ts +2 -0
  253. package/dist/system/commands.d.ts.map +1 -1
  254. package/dist/system/commands.js +18 -0
  255. package/dist/system/commands.js.map +1 -1
  256. package/dist/system/cookieJar.d.ts +59 -0
  257. package/dist/system/cookieJar.d.ts.map +1 -0
  258. package/dist/system/cookieJar.js +187 -0
  259. package/dist/system/cookieJar.js.map +1 -0
  260. package/dist/system/httpStream.d.ts +40 -0
  261. package/dist/system/httpStream.d.ts.map +1 -0
  262. package/dist/system/httpStream.js +156 -0
  263. package/dist/system/httpStream.js.map +1 -0
  264. package/dist/system/index.d.ts +11 -1
  265. package/dist/system/index.d.ts.map +1 -1
  266. package/dist/system/index.js +5 -0
  267. package/dist/system/index.js.map +1 -1
  268. package/dist/system/ipc.d.ts +33 -0
  269. package/dist/system/ipc.d.ts.map +1 -0
  270. package/dist/system/ipc.js +65 -0
  271. package/dist/system/ipc.js.map +1 -0
  272. package/dist/system/kernel.d.ts +10 -2
  273. package/dist/system/kernel.d.ts.map +1 -1
  274. package/dist/system/kernel.js +18 -6
  275. package/dist/system/kernel.js.map +1 -1
  276. package/dist/system/ports.d.ts +9 -4
  277. package/dist/system/ports.d.ts.map +1 -1
  278. package/dist/system/ports.js +21 -2
  279. package/dist/system/ports.js.map +1 -1
  280. package/dist/system/process.d.ts +3 -0
  281. package/dist/system/process.d.ts.map +1 -1
  282. package/dist/system/process.js +50 -26
  283. package/dist/system/process.js.map +1 -1
  284. package/dist/system/programs.d.ts +1 -1
  285. package/dist/system/programs.d.ts.map +1 -1
  286. package/dist/system/programs.js +2 -0
  287. package/dist/system/programs.js.map +1 -1
  288. package/dist/system/terminal.d.ts +10 -4
  289. package/dist/system/terminal.d.ts.map +1 -1
  290. package/dist/system/terminal.js +21 -13
  291. package/dist/system/terminal.js.map +1 -1
  292. package/dist/system/types.d.ts +65 -13
  293. package/dist/system/types.d.ts.map +1 -1
  294. package/dist/system/webSocketClient.d.ts +37 -0
  295. package/dist/system/webSocketClient.d.ts.map +1 -0
  296. package/dist/system/webSocketClient.js +152 -0
  297. package/dist/system/webSocketClient.js.map +1 -0
  298. package/dist/system/webSocketFrames.d.ts +39 -0
  299. package/dist/system/webSocketFrames.d.ts.map +1 -0
  300. package/dist/system/webSocketFrames.js +117 -0
  301. package/dist/system/webSocketFrames.js.map +1 -0
  302. package/dist/vueCompiler.d.ts.map +1 -1
  303. package/dist/vueCompiler.js +11 -8
  304. package/dist/vueCompiler.js.map +1 -1
  305. package/package.json +4 -1
  306. package/src/archive.ts +8 -4
  307. package/src/build.ts +13 -1
  308. package/src/buildHost.ts +23 -10
  309. package/src/compileComponent.ts +4 -1
  310. package/src/compileScript.ts +30 -11
  311. package/src/components.ts +5 -0
  312. package/src/detectProject.ts +13 -6
  313. package/src/devServer.ts +148 -23
  314. package/src/devStyles.ts +70 -0
  315. package/src/hot/client.ts +70 -0
  316. package/src/hot/moduleGraph.ts +90 -0
  317. package/src/hot/planUpdate.ts +66 -0
  318. package/src/hot/reactRefresh.ts +93 -0
  319. package/src/html.ts +17 -21
  320. package/src/index.ts +20 -1
  321. package/src/installer/tree.ts +22 -4
  322. package/src/installer/wasmBuilds.ts +45 -0
  323. package/src/node/builtins.ts +21 -12
  324. package/src/node/childProcess.ts +73 -20
  325. package/src/node/crypto.ts +5 -4
  326. package/src/node/esm.ts +26 -2
  327. package/src/node/fs/index.ts +26 -103
  328. package/src/node/fs/stdinFd.ts +44 -0
  329. package/src/node/fs/streams.ts +177 -0
  330. package/src/node/fs/sync.ts +15 -0
  331. package/src/node/globalObject.ts +82 -0
  332. package/src/node/http/client.ts +69 -6
  333. package/src/node/http/index.ts +6 -4
  334. package/src/node/http/messages.ts +150 -0
  335. package/src/node/http/server.ts +44 -206
  336. package/src/node/http/serverResponse.ts +105 -0
  337. package/src/node/http/upgradeSocket.ts +79 -0
  338. package/src/node/ipc.ts +91 -0
  339. package/src/node/loader.ts +78 -14
  340. package/src/node/misc.ts +19 -5
  341. package/src/node/process.ts +15 -8
  342. package/src/node/processExit.ts +21 -0
  343. package/src/node/program.ts +12 -9
  344. package/src/node/runtime.ts +29 -17
  345. package/src/node/stream/readable.ts +2 -1
  346. package/src/node/urlqs.ts +10 -2
  347. package/src/node/workerThreads.ts +198 -0
  348. package/src/node/zlib.ts +24 -2
  349. package/src/previewBridge.ts +194 -0
  350. package/src/shell/ast.ts +85 -0
  351. package/src/shell/builtins.ts +97 -7
  352. package/src/shell/compound.ts +89 -0
  353. package/src/shell/context.ts +2 -2
  354. package/src/shell/devHandoff.ts +16 -9
  355. package/src/shell/exec.ts +134 -45
  356. package/src/shell/expand.ts +8 -6
  357. package/src/shell/lineReader.ts +46 -0
  358. package/src/shell/npm.ts +2 -2
  359. package/src/shell/packageManagers.ts +75 -0
  360. package/src/shell/parse.ts +233 -236
  361. package/src/shell/program.ts +7 -6
  362. package/src/shell/testCommand.ts +105 -0
  363. package/src/shell/tokenize.ts +257 -0
  364. package/src/styleModules.ts +30 -14
  365. package/src/styles/compile.ts +43 -0
  366. package/src/styles/compilers.ts +143 -0
  367. package/src/styles/cssModules.ts +254 -0
  368. package/src/styles/imports.ts +125 -0
  369. package/src/styles/languages.ts +29 -0
  370. package/src/styles/packageStyles.ts +35 -0
  371. package/src/svelteCompiler.ts +20 -3
  372. package/src/system/commands.ts +17 -0
  373. package/src/system/cookieJar.ts +187 -0
  374. package/src/system/httpStream.ts +168 -0
  375. package/src/system/index.ts +28 -1
  376. package/src/system/ipc.ts +89 -0
  377. package/src/system/kernel.ts +22 -7
  378. package/src/system/ports.ts +23 -4
  379. package/src/system/process.ts +57 -30
  380. package/src/system/programs.ts +3 -1
  381. package/src/system/terminal.ts +34 -12
  382. package/src/system/types.ts +71 -13
  383. package/src/system/webSocketClient.ts +177 -0
  384. package/src/system/webSocketFrames.ts +118 -0
  385. package/src/vueCompiler.ts +11 -8
@@ -0,0 +1,187 @@
1
+ /**
2
+ * Cookies for virtual servers. A service worker cannot hand `Set-Cookie` to
3
+ * the browser (it is a forbidden header on a synthesized response), so the
4
+ * host keeps the jar itself: it stores what a server sets and sends it back as
5
+ * the `Cookie` header on later requests — per preview and per port, which is
6
+ * the origin a server would have had. Paths, `Max-Age`/`Expires` and deletion
7
+ * follow RFC 6265; `HttpOnly` cookies are stored and sent but never shown to
8
+ * page script; `Domain`, `Secure` and `SameSite` have nothing to choose between
9
+ * (every request goes to the one server) and are kept only as metadata.
10
+ */
11
+
12
+ export interface StoredCookie {
13
+ name: string;
14
+ value: string;
15
+ path: string;
16
+ /** Epoch ms; undefined for a session cookie (lives as long as the runtime). */
17
+ expires?: number;
18
+ httpOnly: boolean;
19
+ secure: boolean;
20
+ sameSite?: string;
21
+ }
22
+
23
+ /** RFC 6265 §5.1.4: the directory of the request path. */
24
+ export function defaultCookiePath(requestPath: string): string {
25
+ const path = requestPath.split('?')[0] ?? '/';
26
+ if (!path.startsWith('/')) return '/';
27
+ const slash = path.lastIndexOf('/');
28
+ return slash <= 0 ? '/' : path.slice(0, slash);
29
+ }
30
+
31
+ /** RFC 6265 §5.1.4 path-match. */
32
+ export function cookiePathMatches(cookiePath: string, requestPath: string): boolean {
33
+ const path = requestPath.split('?')[0] || '/';
34
+ if (path === cookiePath) return true;
35
+ if (!path.startsWith(cookiePath)) return false;
36
+ return cookiePath.endsWith('/') || path[cookiePath.length] === '/';
37
+ }
38
+
39
+ /** Parse one `Set-Cookie` value; undefined when malformed. `deleted` marks an already-expired cookie (a deletion). */
40
+ export function parseSetCookie(header: string, requestPath: string, now = Date.now()): (StoredCookie & { deleted: boolean }) | undefined {
41
+ const [pair = '', ...attributes] = header.split(';');
42
+ const eq = pair.indexOf('=');
43
+ if (eq < 0) return undefined;
44
+ const name = pair.slice(0, eq).trim();
45
+ if (!name) return undefined;
46
+ const cookie: StoredCookie & { deleted: boolean } = { name, value: pair.slice(eq + 1).trim(), path: defaultCookiePath(requestPath), httpOnly: false, secure: false, deleted: false };
47
+ let maxAge: number | undefined;
48
+ let expires: number | undefined;
49
+ for (const attribute of attributes) {
50
+ const i = attribute.indexOf('=');
51
+ const key = (i < 0 ? attribute : attribute.slice(0, i)).trim().toLowerCase();
52
+ const value = i < 0 ? '' : attribute.slice(i + 1).trim();
53
+ if (key === 'path' && value.startsWith('/')) cookie.path = value;
54
+ else if (key === 'max-age' && /^-?\d+$/.test(value)) maxAge = Number(value);
55
+ else if (key === 'expires') {
56
+ const at = Date.parse(value);
57
+ if (!Number.isNaN(at)) expires = at;
58
+ } else if (key === 'httponly') cookie.httpOnly = true;
59
+ else if (key === 'secure') cookie.secure = true;
60
+ else if (key === 'samesite') cookie.sameSite = value;
61
+ }
62
+ // Max-Age wins over Expires (§5.3 step 3).
63
+ if (maxAge !== undefined) cookie.expires = maxAge <= 0 ? 0 : now + maxAge * 1000;
64
+ else if (expires !== undefined) cookie.expires = expires;
65
+ cookie.deleted = cookie.expires !== undefined && cookie.expires <= now;
66
+ return cookie;
67
+ }
68
+
69
+ export class CookieJar {
70
+ private cookies: StoredCookie[] = [];
71
+ private readonly listeners = new Set<() => void>();
72
+
73
+ /** Store `Set-Cookie` values from a response to `requestPath`; returns whether anything changed. */
74
+ store(setCookie: string | readonly string[] | undefined, requestPath: string, now = Date.now()): boolean {
75
+ if (!setCookie) return false;
76
+ let changed = false;
77
+ for (const header of typeof setCookie === 'string' ? [setCookie] : setCookie) {
78
+ const cookie = parseSetCookie(header, requestPath, now);
79
+ if (cookie) changed = this.put(cookie, now, true) || changed;
80
+ }
81
+ if (changed) this.notify();
82
+ return changed;
83
+ }
84
+
85
+ /** A `document.cookie = '…'` assignment from a page at `pagePath`. Script cannot create or replace an `HttpOnly` cookie. */
86
+ setFromDocument(assignment: string, pagePath: string, now = Date.now()): boolean {
87
+ const cookie = parseSetCookie(assignment, pagePath, now);
88
+ if (!cookie || cookie.httpOnly) return false;
89
+ const changed = this.put(cookie, now, false);
90
+ if (changed) this.notify();
91
+ return changed;
92
+ }
93
+
94
+ /** The `Cookie` header for a request to `path`; undefined when no cookie applies. Longer paths first. */
95
+ header(path: string, now = Date.now()): string | undefined {
96
+ const text = this.matching(path, now, true);
97
+ return text || undefined;
98
+ }
99
+
100
+ /** What `document.cookie` reads on a page at `path`: the same cookies, minus `HttpOnly` ones. */
101
+ documentCookie(path: string, now = Date.now()): string {
102
+ return this.matching(path, now, false);
103
+ }
104
+
105
+ /** Every live cookie. */
106
+ list(now = Date.now()): StoredCookie[] {
107
+ this.expire(now);
108
+ return this.cookies.map((c) => ({ ...c }));
109
+ }
110
+
111
+ clear(): void {
112
+ if (!this.cookies.length) return;
113
+ this.cookies = [];
114
+ this.notify();
115
+ }
116
+
117
+ /** The jar changed (a server or a page set or deleted a cookie). */
118
+ onChange(listener: () => void): () => void {
119
+ this.listeners.add(listener);
120
+ return () => this.listeners.delete(listener);
121
+ }
122
+
123
+ private put(cookie: StoredCookie & { deleted: boolean }, now: number, fromHttp: boolean): boolean {
124
+ this.expire(now);
125
+ const index = this.cookies.findIndex((c) => c.name === cookie.name && c.path === cookie.path);
126
+ const existing = index < 0 ? undefined : this.cookies[index];
127
+ if (existing?.httpOnly && !fromHttp) return false;
128
+ const { deleted, ...stored } = cookie;
129
+ if (deleted) {
130
+ if (index < 0) return false;
131
+ this.cookies.splice(index, 1);
132
+ return true;
133
+ }
134
+ if (existing && existing.value === stored.value && existing.expires === stored.expires && existing.httpOnly === stored.httpOnly) return false;
135
+ if (index < 0) this.cookies.push(stored);
136
+ else this.cookies[index] = stored;
137
+ return true;
138
+ }
139
+
140
+ private matching(path: string, now: number, includeHttpOnly: boolean): string {
141
+ this.expire(now);
142
+ return this.cookies
143
+ .filter((c) => (includeHttpOnly || !c.httpOnly) && cookiePathMatches(c.path, path))
144
+ .sort((a, b) => b.path.length - a.path.length)
145
+ .map((c) => `${c.name}=${c.value}`)
146
+ .join('; ');
147
+ }
148
+
149
+ private expire(now: number): void {
150
+ const live = this.cookies.filter((c) => c.expires === undefined || c.expires > now);
151
+ if (live.length === this.cookies.length) return;
152
+ this.cookies = live;
153
+ this.notify();
154
+ }
155
+
156
+ private notify(): void {
157
+ for (const listener of this.listeners) listener();
158
+ }
159
+ }
160
+
161
+ /** One jar per virtual server port — what the preview host keeps for its runtime. */
162
+ export class PortCookieJars {
163
+ private readonly jars = new Map<number, CookieJar>();
164
+ private readonly listeners = new Set<(port: number) => void>();
165
+
166
+ jar(port: number): CookieJar {
167
+ let jar = this.jars.get(port);
168
+ if (!jar) {
169
+ jar = new CookieJar();
170
+ jar.onChange(() => {
171
+ for (const listener of this.listeners) listener(port);
172
+ });
173
+ this.jars.set(port, jar);
174
+ }
175
+ return jar;
176
+ }
177
+
178
+ /** Some port's jar changed. */
179
+ onChange(listener: (port: number) => void): () => void {
180
+ this.listeners.add(listener);
181
+ return () => this.listeners.delete(listener);
182
+ }
183
+
184
+ clear(): void {
185
+ for (const jar of this.jars.values()) jar.clear();
186
+ }
187
+ }
@@ -0,0 +1,168 @@
1
+ /**
2
+ * Building blocks for streamed HTTP between programs and hosts: a body stream
3
+ * fed by pushes (a server's `res.write`, chunks arriving over postMessage),
4
+ * buffering helpers for callers that want the whole response, and the in-memory
5
+ * byte pipe an upgraded connection runs over.
6
+ */
7
+ import type { ByteChannel, HttpResponseData, HttpResponseHead, HttpStreamResponse } from './types.js';
8
+
9
+ export interface PushStream {
10
+ readonly stream: ReadableStream<Uint8Array>;
11
+ /** Queue a chunk; ignored once the stream is closed or cancelled. */
12
+ push(chunk: Uint8Array): void;
13
+ end(): void;
14
+ /** End with an error: the reader sees a failed read (a truncated response). */
15
+ fail(error: unknown): void;
16
+ /** True once ended, failed or cancelled. */
17
+ readonly done: boolean;
18
+ }
19
+
20
+ /** A body stream fed from outside. `onCancel` runs when the reader hangs up before the end. */
21
+ export function pushStream(onCancel?: (reason: unknown) => void): PushStream {
22
+ let controller!: ReadableStreamDefaultController<Uint8Array>;
23
+ let done = false;
24
+ const stream = new ReadableStream<Uint8Array>({
25
+ start: (c) => void (controller = c),
26
+ cancel: (reason) => {
27
+ if (done) return;
28
+ done = true;
29
+ onCancel?.(reason);
30
+ },
31
+ });
32
+ return {
33
+ stream,
34
+ push(chunk) {
35
+ if (!done && chunk.byteLength) controller.enqueue(chunk);
36
+ },
37
+ end() {
38
+ if (done) return;
39
+ done = true;
40
+ controller.close();
41
+ },
42
+ fail(error) {
43
+ if (done) return;
44
+ done = true;
45
+ controller.error(error);
46
+ },
47
+ get done() {
48
+ return done;
49
+ },
50
+ };
51
+ }
52
+
53
+ /** A stream holding exactly `bytes`. */
54
+ export function bytesStream(bytes: Uint8Array): ReadableStream<Uint8Array> {
55
+ return new ReadableStream<Uint8Array>({
56
+ start(controller) {
57
+ if (bytes.byteLength) controller.enqueue(bytes);
58
+ controller.close();
59
+ },
60
+ });
61
+ }
62
+
63
+ /** A complete plain-text response (errors: nothing listening, the server exited). */
64
+ export function textResponse(status: number, text: string): HttpStreamResponse {
65
+ return { status, headers: { 'content-type': 'text/plain; charset=utf-8' }, body: bytesStream(new TextEncoder().encode(text)) };
66
+ }
67
+
68
+ /** Read a body stream to the end. */
69
+ export async function readBody(stream: ReadableStream<Uint8Array>): Promise<Uint8Array> {
70
+ const chunks: Uint8Array[] = [];
71
+ let length = 0;
72
+ const reader = stream.getReader();
73
+ for (;;) {
74
+ const { value, done } = await reader.read();
75
+ if (done) break;
76
+ chunks.push(value);
77
+ length += value.byteLength;
78
+ }
79
+ if (chunks.length === 1) return chunks[0]!;
80
+ const out = new Uint8Array(length);
81
+ let offset = 0;
82
+ for (const chunk of chunks) {
83
+ out.set(chunk, offset);
84
+ offset += chunk.byteLength;
85
+ }
86
+ return out;
87
+ }
88
+
89
+ /** Wait for a streamed response's whole body. */
90
+ export async function bufferResponse(response: HttpStreamResponse): Promise<HttpResponseData> {
91
+ return { ...headOf(response), body: await readBody(response.body) };
92
+ }
93
+
94
+ /** The status line and headers alone (plain data, safe to post). */
95
+ export function headOf(response: HttpResponseHead): HttpResponseHead {
96
+ return { status: response.status, statusText: response.statusText, headers: response.headers };
97
+ }
98
+
99
+ /**
100
+ * Feed a body stream to `sink` chunk by chunk. Returns a cancel that hangs up
101
+ * on the producer; `sink.end` gets the error message when the stream failed.
102
+ */
103
+ export function drainBody(stream: ReadableStream<Uint8Array>, sink: { chunk(data: Uint8Array): void; end(error?: string): void }): () => void {
104
+ const reader = stream.getReader();
105
+ let cancelled = false;
106
+ void (async () => {
107
+ try {
108
+ for (;;) {
109
+ const { value, done } = await reader.read();
110
+ if (done || cancelled) break;
111
+ sink.chunk(value);
112
+ }
113
+ if (!cancelled) sink.end();
114
+ } catch (error) {
115
+ if (!cancelled) sink.end(error instanceof Error ? error.message : String(error));
116
+ }
117
+ })();
118
+ return () => {
119
+ if (cancelled) return;
120
+ cancelled = true;
121
+ void reader.cancel().catch(() => undefined);
122
+ };
123
+ }
124
+
125
+ class ChannelEnd implements ByteChannel {
126
+ peer!: ChannelEnd;
127
+ closed = false;
128
+ private readonly data = new Set<(data: Uint8Array) => void>();
129
+ private readonly closes = new Set<() => void>();
130
+
131
+ send(data: Uint8Array): void {
132
+ if (this.closed) return;
133
+ const copy = new Uint8Array(data); // a copy (a Buffer's slice would be a view)
134
+ queueMicrotask(() => {
135
+ if (!this.peer.closed) for (const listener of this.peer.data) listener(copy);
136
+ });
137
+ }
138
+
139
+ close(): void {
140
+ if (this.closed) return;
141
+ this.closed = true;
142
+ // Delivered after any data already sent, like a FIN after the last segment.
143
+ queueMicrotask(() => {
144
+ if (this.peer.closed) return; // both hung up at once: neither needs telling
145
+ this.peer.closed = true;
146
+ for (const listener of this.peer.closes) listener();
147
+ });
148
+ }
149
+
150
+ onData(listener: (data: Uint8Array) => void): () => void {
151
+ this.data.add(listener);
152
+ return () => this.data.delete(listener);
153
+ }
154
+
155
+ onClose(listener: () => void): () => void {
156
+ this.closes.add(listener);
157
+ return () => this.closes.delete(listener);
158
+ }
159
+ }
160
+
161
+ /** Two connected ends: bytes sent on one arrive (asynchronously, in order) on the other. */
162
+ export function createChannelPair(): [ByteChannel, ByteChannel] {
163
+ const a = new ChannelEnd();
164
+ const b = new ChannelEnd();
165
+ a.peer = b;
166
+ b.peer = a;
167
+ return [a, b];
168
+ }
@@ -1,7 +1,34 @@
1
1
  export { Kernel, DEFAULT_ENV } from './kernel.js';
2
2
  export type { KernelOptions } from './kernel.js';
3
- export type { System, Program, ProgramContext, ProgramIO, TerminalPort, ProcessOptions, ChildHandle, HttpRequestData, HttpResponseData, HttpHandler } from './types.js';
3
+ export type {
4
+ System,
5
+ Program,
6
+ ProgramContext,
7
+ ProgramIO,
8
+ TerminalPort,
9
+ ProcessOptions,
10
+ ChildHandle,
11
+ HttpRequestData,
12
+ HttpResponseHead,
13
+ HttpResponseData,
14
+ HttpStreamResponse,
15
+ HttpHandler,
16
+ ByteChannel,
17
+ UpgradeHandler,
18
+ ThreadInfo,
19
+ StdioChunk,
20
+ } from './types.js';
21
+ export { createIpcEndpoint, createIpcPair } from './ipc.js';
22
+ export type { IpcEndpoint } from './ipc.js';
4
23
  export { PortRegistry, parsePortPath } from './ports.js';
24
+ export { pushStream, bytesStream, textResponse, readBody, bufferResponse, headOf, drainBody, createChannelPair } from './httpStream.js';
25
+ export type { PushStream } from './httpStream.js';
26
+ export { connectWebSocket } from './webSocketClient.js';
27
+ export type { WebSocketConnection, WebSocketConnectOptions, WebSocketCloseInfo } from './webSocketClient.js';
28
+ export { FrameDecoder, Opcode, encodeFrame, encodeClosePayload, decodeClosePayload, webSocketAccept, webSocketKey, WEBSOCKET_GUID } from './webSocketFrames.js';
29
+ export type { WebSocketFrame } from './webSocketFrames.js';
30
+ export { CookieJar, PortCookieJars, parseSetCookie, defaultCookiePath, cookiePathMatches } from './cookieJar.js';
31
+ export type { StoredCookie } from './cookieJar.js';
5
32
  export type { PortEvent } from './ports.js';
6
33
  export { runProgram, runArguments, toRuntimeProcess, allocatePid } from './process.js';
7
34
  export type { RuntimeProcess, RunProgramOptions } from './process.js';
@@ -0,0 +1,89 @@
1
+ /**
2
+ * A message channel between a process and the parent that started it — what
3
+ * `child_process.fork()` opens (`child.send` ↔ `process.send`) and what a
4
+ * `worker_threads` Worker talks over (`worker.postMessage` ↔ `parentPort`).
5
+ *
6
+ * One endpoint shape for every hop: in-process (the core kernel), and relayed
7
+ * through the page between process Workers (the browser runtime). Messages are
8
+ * structured-cloned, as Node's `serialization: 'advanced'` does, and delivered
9
+ * asynchronously. Messages that arrive before the receiver subscribes wait for
10
+ * it — a child attaching its `process.on('message')` while its module loads
11
+ * still gets what the parent sent right after `fork()`.
12
+ */
13
+ export interface IpcEndpoint {
14
+ send(message: unknown): void;
15
+ onMessage(listener: (message: unknown) => void): () => void;
16
+ /** Close the channel; both ends hear `onDisconnect`. */
17
+ disconnect(): void;
18
+ onDisconnect(listener: () => void): () => void;
19
+ readonly connected: boolean;
20
+ }
21
+
22
+ /**
23
+ * An endpoint whose sends go out through `post` and whose incoming traffic the
24
+ * owner feeds in: `receive(message)` for a message, `closed()` when the far end
25
+ * went away. `onClose` runs once when THIS end disconnects (to tell the far end).
26
+ */
27
+ export function createIpcEndpoint(post: (message: unknown) => void, onClose: () => void = () => undefined) {
28
+ const listeners = new Set<(message: unknown) => void>();
29
+ const disconnectListeners = new Set<() => void>();
30
+ let backlog: unknown[] = [];
31
+ let connected = true;
32
+
33
+ const close = (notifyFarEnd: boolean) => {
34
+ if (!connected) return;
35
+ connected = false;
36
+ backlog = [];
37
+ if (notifyFarEnd) onClose();
38
+ queueMicrotask(() => disconnectListeners.forEach((listener) => listener()));
39
+ };
40
+
41
+ const endpoint: IpcEndpoint = {
42
+ send(message) {
43
+ if (!connected) throw Object.assign(new Error('Channel closed'), { code: 'ERR_IPC_CHANNEL_CLOSED' });
44
+ post(structuredClone(message));
45
+ },
46
+ onMessage(listener) {
47
+ listeners.add(listener);
48
+ if (backlog.length) {
49
+ const waiting = backlog;
50
+ backlog = [];
51
+ queueMicrotask(() => waiting.forEach((message) => listener(message)));
52
+ }
53
+ return () => listeners.delete(listener);
54
+ },
55
+ disconnect: () => close(true),
56
+ onDisconnect(listener) {
57
+ disconnectListeners.add(listener);
58
+ return () => disconnectListeners.delete(listener);
59
+ },
60
+ get connected() {
61
+ return connected;
62
+ },
63
+ };
64
+
65
+ return {
66
+ endpoint,
67
+ receive(message: unknown) {
68
+ if (!connected) return;
69
+ if (!listeners.size) backlog.push(message);
70
+ else queueMicrotask(() => listeners.forEach((listener) => listener(message)));
71
+ },
72
+ closed: () => close(false),
73
+ };
74
+ }
75
+
76
+ /** Two endpoints wired to each other, in one realm: the parent's and the child's. */
77
+ export function createIpcPair(): [IpcEndpoint, IpcEndpoint] {
78
+ // eslint-disable-next-line prefer-const -- each side's `post` reaches the other, created after it
79
+ let child: ReturnType<typeof createIpcEndpoint>;
80
+ const parent = createIpcEndpoint(
81
+ (message) => child.receive(message),
82
+ () => child.closed(),
83
+ );
84
+ child = createIpcEndpoint(
85
+ (message) => parent.receive(message),
86
+ () => parent.closed(),
87
+ );
88
+ return [parent.endpoint, child.endpoint];
89
+ }
@@ -7,11 +7,12 @@
7
7
  */
8
8
  import { VirtualFileSystem } from '../vfs.js';
9
9
  import type { PackageCache } from '../installer/registry.js';
10
- import type { ChildHandle, HttpRequestData, HttpResponseData, Program, ProcessOptions, System } from './types.js';
10
+ import type { ByteChannel, ChildHandle, HttpRequestData, HttpResponseData, HttpStreamResponse, Program, ProcessOptions, System } from './types.js';
11
11
  import { PortRegistry } from './ports.js';
12
12
  import { ServerEvents } from './serverEvents.js';
13
- import { commandNotFound, resolveCommand } from './commands.js';
13
+ import { commandNotFound, resolveCommand, SYSTEM_BIN_DIRS } from './commands.js';
14
14
  import { runArguments, runProgram, toRuntimeProcess, type RuntimeProcess } from './process.js';
15
+ import { createIpcPair } from './ipc.js';
15
16
 
16
17
  export interface KernelOptions {
17
18
  fs?: VirtualFileSystem;
@@ -28,7 +29,7 @@ export interface KernelOptions {
28
29
  }
29
30
 
30
31
  export const DEFAULT_ENV: Record<string, string> = {
31
- PATH: '/usr/local/bin:/usr/bin:/bin',
32
+ PATH: SYSTEM_BIN_DIRS.join(':'),
32
33
  HOME: '/home/user',
33
34
  USER: 'user',
34
35
  SHELL: '/bin/bfsh',
@@ -55,7 +56,7 @@ export class Kernel {
55
56
  fs: this.fs,
56
57
  fetch: options.fetch ?? ((input, init) => globalThis.fetch(input, init)),
57
58
  spawn: (command, args, spawnOptions) => this.spawnChild(command, args, spawnOptions),
58
- listen: (port, handler) => this.ports.listen(port, handler),
59
+ listen: (port, handler, upgrade) => this.ports.listen(port, handler, upgrade),
59
60
  loopback: (port, request) => this.ports.request(port, request),
60
61
  serverUrl,
61
62
  announceServer: (port, url) => this.servers.announce({ port, url }),
@@ -79,11 +80,25 @@ export class Kernel {
79
80
  const env = { ...this.env, ...options.env };
80
81
  const resolved = resolveCommand(this.fs, this.options.programs, command, args, cwd, env);
81
82
  if (!resolved) throw commandNotFound(command);
82
- return runProgram({ program: resolved.program, args: resolved.args, system: this.system, cwd, env, terminal: options.terminal });
83
+ const [parentEnd, childEnd] = options.ipc ? createIpcPair() : [];
84
+ const child = runProgram({ program: resolved.program, args: resolved.args, system: this.system, cwd, env, terminal: options.terminal, thread: options.thread, channel: childEnd });
85
+ return parentEnd ? { ...child, ipc: parentEnd } : child;
83
86
  }
84
87
 
85
- /** Send an HTTP request to a virtual server (what the preview service worker does in the browser). */
88
+ /** Send an HTTP request to a virtual server (what the preview service worker does in the browser); resolves with the whole response. */
86
89
  request(port: number, request: Partial<HttpRequestData> & { url: string }): Promise<HttpResponseData | undefined> {
87
- return this.ports.request(port, { method: 'GET', headers: {}, body: null, ...request });
90
+ return this.ports.requestBuffered(port, withDefaults(request));
91
+ }
92
+
93
+ /** {@link request}, resolving at the head with the body streaming (Server-Sent Events, chunked progress). */
94
+ requestStream(port: number, request: Partial<HttpRequestData> & { url: string }): Promise<HttpStreamResponse | undefined> {
95
+ return this.ports.request(port, withDefaults(request));
96
+ }
97
+
98
+ /** Open an upgraded connection (a WebSocket, via `connectWebSocket`); undefined when nothing on `port` takes upgrades. */
99
+ upgrade(port: number, request: Partial<HttpRequestData> & { url: string }): ByteChannel | undefined {
100
+ return this.ports.upgrade(port, withDefaults(request));
88
101
  }
89
102
  }
103
+
104
+ const withDefaults = (request: Partial<HttpRequestData> & { url: string }): HttpRequestData => ({ method: 'GET', headers: {}, body: null, ...request });
@@ -4,7 +4,8 @@
4
4
  * in one process is reachable from another (`fetch('http://localhost:3000')`)
5
5
  * and from the preview service worker (`/__bfwc/<id>/__port/3000/`).
6
6
  */
7
- import type { HttpHandler, HttpRequestData, HttpResponseData } from './types.js';
7
+ import type { ByteChannel, HttpHandler, HttpRequestData, HttpResponseData, HttpStreamResponse, UpgradeHandler } from './types.js';
8
+ import { bufferResponse, createChannelPair } from './httpStream.js';
8
9
 
9
10
  export interface PortEvent {
10
11
  type: 'open' | 'close';
@@ -15,10 +16,11 @@ const EPHEMERAL_START = 49152;
15
16
 
16
17
  export class PortRegistry {
17
18
  private readonly handlers = new Map<number, HttpHandler>();
19
+ private readonly upgrades = new Map<number, UpgradeHandler>();
18
20
  private readonly listeners = new Set<(event: PortEvent) => void>();
19
21
  private nextEphemeral = EPHEMERAL_START;
20
22
 
21
- listen(port: number, handler: HttpHandler): { port: number; close(): void } {
23
+ listen(port: number, handler: HttpHandler, upgrade?: UpgradeHandler): { port: number; close(): void } {
22
24
  let actual = port;
23
25
  if (!actual) {
24
26
  while (this.handlers.has(this.nextEphemeral)) this.nextEphemeral++;
@@ -28,6 +30,7 @@ export class PortRegistry {
28
30
  throw Object.assign(new Error(`listen EADDRINUSE: address already in use :::${actual}`), { code: 'EADDRINUSE', errno: -98, syscall: 'listen', address: '::', port: actual });
29
31
  }
30
32
  this.handlers.set(actual, handler);
33
+ if (upgrade) this.upgrades.set(actual, upgrade);
31
34
  this.emit({ type: 'open', port: actual });
32
35
  let open = true;
33
36
  return {
@@ -36,6 +39,7 @@ export class PortRegistry {
36
39
  if (!open || this.handlers.get(actual) !== handler) return;
37
40
  open = false;
38
41
  this.handlers.delete(actual);
42
+ this.upgrades.delete(actual);
39
43
  this.emit({ type: 'close', port: actual });
40
44
  },
41
45
  };
@@ -49,12 +53,27 @@ export class PortRegistry {
49
53
  return [...this.handlers.keys()].sort((a, b) => a - b);
50
54
  }
51
55
 
52
- /** Dispatch to the server on `port`; undefined when nothing listens there. */
53
- async request(port: number, request: HttpRequestData): Promise<HttpResponseData | undefined> {
56
+ /** Dispatch to the server on `port`; resolves with the head as soon as it is written, the body streaming. Undefined when nothing listens there. */
57
+ async request(port: number, request: HttpRequestData): Promise<HttpStreamResponse | undefined> {
54
58
  const handler = this.handlers.get(port);
55
59
  return handler ? handler(request) : undefined;
56
60
  }
57
61
 
62
+ /** {@link request}, waiting for the whole body. */
63
+ async requestBuffered(port: number, request: HttpRequestData): Promise<HttpResponseData | undefined> {
64
+ const response = await this.request(port, request);
65
+ return response && bufferResponse(response);
66
+ }
67
+
68
+ /** Open an upgraded connection to the server on `port`; returns the client end, or undefined when nothing there takes upgrades. */
69
+ upgrade(port: number, request: HttpRequestData): ByteChannel | undefined {
70
+ const upgrade = this.upgrades.get(port);
71
+ if (!upgrade) return undefined;
72
+ const [client, server] = createChannelPair();
73
+ upgrade(request, server);
74
+ return client;
75
+ }
76
+
58
77
  watch(listener: (event: PortEvent) => void): () => void {
59
78
  this.listeners.add(listener);
60
79
  return () => this.listeners.delete(listener);