@heojeongbo/wirestage 0.0.0-stage → 0.1.1

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 (489) hide show
  1. package/LICENSE +21 -0
  2. package/LICENSES.md +21 -0
  3. package/README.md +150 -2
  4. package/dist/app/playwright/index.d.ts +3 -0
  5. package/dist/app/playwright/index.d.ts.map +1 -0
  6. package/dist/app/playwright/index.js +2 -0
  7. package/dist/app/playwright/index.js.map +1 -0
  8. package/dist/app/playwright/lib/fixture.d.ts +61 -0
  9. package/dist/app/playwright/lib/fixture.d.ts.map +1 -0
  10. package/dist/app/playwright/lib/fixture.js +110 -0
  11. package/dist/app/playwright/lib/fixture.js.map +1 -0
  12. package/dist/connect.d.ts +7 -0
  13. package/dist/connect.d.ts.map +1 -0
  14. package/dist/connect.js +7 -0
  15. package/dist/connect.js.map +1 -0
  16. package/dist/entities/frame/@x/plugin.d.ts +9 -0
  17. package/dist/entities/frame/@x/plugin.d.ts.map +1 -0
  18. package/dist/entities/frame/@x/plugin.js +2 -0
  19. package/dist/entities/frame/@x/plugin.js.map +1 -0
  20. package/dist/entities/frame/index.d.ts +6 -0
  21. package/dist/entities/frame/index.d.ts.map +1 -0
  22. package/dist/entities/frame/index.js +4 -0
  23. package/dist/entities/frame/index.js.map +1 -0
  24. package/dist/entities/frame/lib/filter.d.ts +8 -0
  25. package/dist/entities/frame/lib/filter.d.ts.map +1 -0
  26. package/dist/entities/frame/lib/filter.js +62 -0
  27. package/dist/entities/frame/lib/filter.js.map +1 -0
  28. package/dist/entities/frame/lib/payload.d.ts +8 -0
  29. package/dist/entities/frame/lib/payload.d.ts.map +1 -0
  30. package/dist/entities/frame/lib/payload.js +42 -0
  31. package/dist/entities/frame/lib/payload.js.map +1 -0
  32. package/dist/entities/frame/lib/snapshot.d.ts +15 -0
  33. package/dist/entities/frame/lib/snapshot.d.ts.map +1 -0
  34. package/dist/entities/frame/lib/snapshot.js +90 -0
  35. package/dist/entities/frame/lib/snapshot.js.map +1 -0
  36. package/dist/entities/frame/lib/timeline.d.ts +23 -0
  37. package/dist/entities/frame/lib/timeline.d.ts.map +1 -0
  38. package/dist/entities/frame/lib/timeline.js +122 -0
  39. package/dist/entities/frame/lib/timeline.js.map +1 -0
  40. package/dist/entities/frame/model/frame.d.ts +182 -0
  41. package/dist/entities/frame/model/frame.d.ts.map +1 -0
  42. package/dist/entities/frame/model/frame.js +2 -0
  43. package/dist/entities/frame/model/frame.js.map +1 -0
  44. package/dist/entities/plugin/index.d.ts +9 -0
  45. package/dist/entities/plugin/index.d.ts.map +1 -0
  46. package/dist/entities/plugin/index.js +3 -0
  47. package/dist/entities/plugin/index.js.map +1 -0
  48. package/dist/entities/plugin/lib/define-plugin.d.ts +8 -0
  49. package/dist/entities/plugin/lib/define-plugin.d.ts.map +1 -0
  50. package/dist/entities/plugin/lib/define-plugin.js +9 -0
  51. package/dist/entities/plugin/lib/define-plugin.js.map +1 -0
  52. package/dist/entities/plugin/lib/named.d.ts +10 -0
  53. package/dist/entities/plugin/lib/named.d.ts.map +1 -0
  54. package/dist/entities/plugin/lib/named.js +17 -0
  55. package/dist/entities/plugin/lib/named.js.map +1 -0
  56. package/dist/entities/plugin/model/attachment.d.ts +18 -0
  57. package/dist/entities/plugin/model/attachment.d.ts.map +1 -0
  58. package/dist/entities/plugin/model/attachment.js +2 -0
  59. package/dist/entities/plugin/model/attachment.js.map +1 -0
  60. package/dist/entities/plugin/model/http.d.ts +135 -0
  61. package/dist/entities/plugin/model/http.d.ts.map +1 -0
  62. package/dist/entities/plugin/model/http.js +2 -0
  63. package/dist/entities/plugin/model/http.js.map +1 -0
  64. package/dist/entities/plugin/model/page.d.ts +100 -0
  65. package/dist/entities/plugin/model/page.d.ts.map +1 -0
  66. package/dist/entities/plugin/model/page.js +2 -0
  67. package/dist/entities/plugin/model/page.js.map +1 -0
  68. package/dist/entities/plugin/model/plugin.d.ts +83 -0
  69. package/dist/entities/plugin/model/plugin.d.ts.map +1 -0
  70. package/dist/entities/plugin/model/plugin.js +2 -0
  71. package/dist/entities/plugin/model/plugin.js.map +1 -0
  72. package/dist/entities/plugin/model/socket.d.ts +107 -0
  73. package/dist/entities/plugin/model/socket.d.ts.map +1 -0
  74. package/dist/entities/plugin/model/socket.js +2 -0
  75. package/dist/entities/plugin/model/socket.js.map +1 -0
  76. package/dist/entities/plugin/model/stream.d.ts +46 -0
  77. package/dist/entities/plugin/model/stream.d.ts.map +1 -0
  78. package/dist/entities/plugin/model/stream.js +2 -0
  79. package/dist/entities/plugin/model/stream.js.map +1 -0
  80. package/dist/features/connect/index.d.ts +5 -0
  81. package/dist/features/connect/index.d.ts.map +1 -0
  82. package/dist/features/connect/index.js +4 -0
  83. package/dist/features/connect/index.js.map +1 -0
  84. package/dist/features/connect/lib/calls.d.ts +9 -0
  85. package/dist/features/connect/lib/calls.d.ts.map +1 -0
  86. package/dist/features/connect/lib/calls.js +46 -0
  87. package/dist/features/connect/lib/calls.js.map +1 -0
  88. package/dist/features/connect/lib/client.d.ts +33 -0
  89. package/dist/features/connect/lib/client.d.ts.map +1 -0
  90. package/dist/features/connect/lib/client.js +147 -0
  91. package/dist/features/connect/lib/client.js.map +1 -0
  92. package/dist/features/connect/lib/create-connect.d.ts +14 -0
  93. package/dist/features/connect/lib/create-connect.d.ts.map +1 -0
  94. package/dist/features/connect/lib/create-connect.js +124 -0
  95. package/dist/features/connect/lib/create-connect.js.map +1 -0
  96. package/dist/features/connect/lib/faults.d.ts +18 -0
  97. package/dist/features/connect/lib/faults.d.ts.map +1 -0
  98. package/dist/features/connect/lib/faults.js +85 -0
  99. package/dist/features/connect/lib/faults.js.map +1 -0
  100. package/dist/features/connect/lib/protocol.d.ts +42 -0
  101. package/dist/features/connect/lib/protocol.d.ts.map +1 -0
  102. package/dist/features/connect/lib/protocol.js +228 -0
  103. package/dist/features/connect/lib/protocol.js.map +1 -0
  104. package/dist/features/connect/lib/record.d.ts +14 -0
  105. package/dist/features/connect/lib/record.d.ts.map +1 -0
  106. package/dist/features/connect/lib/record.js +36 -0
  107. package/dist/features/connect/lib/record.js.map +1 -0
  108. package/dist/features/connect/lib/recorder.d.ts +77 -0
  109. package/dist/features/connect/lib/recorder.d.ts.map +1 -0
  110. package/dist/features/connect/lib/recorder.js +209 -0
  111. package/dist/features/connect/lib/recorder.js.map +1 -0
  112. package/dist/features/connect/lib/rules.d.ts +51 -0
  113. package/dist/features/connect/lib/rules.d.ts.map +1 -0
  114. package/dist/features/connect/lib/rules.js +222 -0
  115. package/dist/features/connect/lib/rules.js.map +1 -0
  116. package/dist/features/connect/lib/serve.d.ts +10 -0
  117. package/dist/features/connect/lib/serve.d.ts.map +1 -0
  118. package/dist/features/connect/lib/serve.js +78 -0
  119. package/dist/features/connect/lib/serve.js.map +1 -0
  120. package/dist/features/connect/lib/status-of.d.ts +11 -0
  121. package/dist/features/connect/lib/status-of.d.ts.map +1 -0
  122. package/dist/features/connect/lib/status-of.js +22 -0
  123. package/dist/features/connect/lib/status-of.js.map +1 -0
  124. package/dist/features/connect/lib/stubs.d.ts +18 -0
  125. package/dist/features/connect/lib/stubs.d.ts.map +1 -0
  126. package/dist/features/connect/lib/stubs.js +174 -0
  127. package/dist/features/connect/lib/stubs.js.map +1 -0
  128. package/dist/features/connect/lib/universal.d.ts +19 -0
  129. package/dist/features/connect/lib/universal.d.ts.map +1 -0
  130. package/dist/features/connect/lib/universal.js +71 -0
  131. package/dist/features/connect/lib/universal.js.map +1 -0
  132. package/dist/features/connect/model/types.d.ts +247 -0
  133. package/dist/features/connect/model/types.d.ts.map +1 -0
  134. package/dist/features/connect/model/types.js +2 -0
  135. package/dist/features/connect/model/types.js.map +1 -0
  136. package/dist/features/rest/index.d.ts +5 -0
  137. package/dist/features/rest/index.d.ts.map +1 -0
  138. package/dist/features/rest/index.js +3 -0
  139. package/dist/features/rest/index.js.map +1 -0
  140. package/dist/features/rest/lib/calls.d.ts +8 -0
  141. package/dist/features/rest/lib/calls.d.ts.map +1 -0
  142. package/dist/features/rest/lib/calls.js +32 -0
  143. package/dist/features/rest/lib/calls.js.map +1 -0
  144. package/dist/features/rest/lib/create-rest.d.ts +8 -0
  145. package/dist/features/rest/lib/create-rest.d.ts.map +1 -0
  146. package/dist/features/rest/lib/create-rest.js +136 -0
  147. package/dist/features/rest/lib/create-rest.js.map +1 -0
  148. package/dist/features/rest/lib/path.d.ts +14 -0
  149. package/dist/features/rest/lib/path.d.ts.map +1 -0
  150. package/dist/features/rest/lib/path.js +58 -0
  151. package/dist/features/rest/lib/path.js.map +1 -0
  152. package/dist/features/rest/lib/reply.d.ts +25 -0
  153. package/dist/features/rest/lib/reply.d.ts.map +1 -0
  154. package/dist/features/rest/lib/reply.js +40 -0
  155. package/dist/features/rest/lib/reply.js.map +1 -0
  156. package/dist/features/rest/model/types.d.ts +74 -0
  157. package/dist/features/rest/model/types.d.ts.map +1 -0
  158. package/dist/features/rest/model/types.js +2 -0
  159. package/dist/features/rest/model/types.js.map +1 -0
  160. package/dist/features/sse/index.d.ts +4 -0
  161. package/dist/features/sse/index.d.ts.map +1 -0
  162. package/dist/features/sse/index.js +3 -0
  163. package/dist/features/sse/index.js.map +1 -0
  164. package/dist/features/sse/lib/create-sse.d.ts +9 -0
  165. package/dist/features/sse/lib/create-sse.d.ts.map +1 -0
  166. package/dist/features/sse/lib/create-sse.js +121 -0
  167. package/dist/features/sse/lib/create-sse.js.map +1 -0
  168. package/dist/features/sse/lib/encode.d.ts +8 -0
  169. package/dist/features/sse/lib/encode.d.ts.map +1 -0
  170. package/dist/features/sse/lib/encode.js +29 -0
  171. package/dist/features/sse/lib/encode.js.map +1 -0
  172. package/dist/features/sse/model/types.d.ts +68 -0
  173. package/dist/features/sse/model/types.d.ts.map +1 -0
  174. package/dist/features/sse/model/types.js +2 -0
  175. package/dist/features/sse/model/types.js.map +1 -0
  176. package/dist/features/webrtc/index.d.ts +3 -0
  177. package/dist/features/webrtc/index.d.ts.map +1 -0
  178. package/dist/features/webrtc/index.js +2 -0
  179. package/dist/features/webrtc/index.js.map +1 -0
  180. package/dist/features/webrtc/lib/create-webrtc.d.ts +9 -0
  181. package/dist/features/webrtc/lib/create-webrtc.d.ts.map +1 -0
  182. package/dist/features/webrtc/lib/create-webrtc.js +123 -0
  183. package/dist/features/webrtc/lib/create-webrtc.js.map +1 -0
  184. package/dist/features/webrtc/lib/rtc-page-module.d.ts +22 -0
  185. package/dist/features/webrtc/lib/rtc-page-module.d.ts.map +1 -0
  186. package/dist/features/webrtc/lib/rtc-page-module.js +161 -0
  187. package/dist/features/webrtc/lib/rtc-page-module.js.map +1 -0
  188. package/dist/features/webrtc/lib/to-frame.d.ts +9 -0
  189. package/dist/features/webrtc/lib/to-frame.d.ts.map +1 -0
  190. package/dist/features/webrtc/lib/to-frame.js +43 -0
  191. package/dist/features/webrtc/lib/to-frame.js.map +1 -0
  192. package/dist/features/webrtc/model/types.d.ts +70 -0
  193. package/dist/features/webrtc/model/types.d.ts.map +1 -0
  194. package/dist/features/webrtc/model/types.js +2 -0
  195. package/dist/features/webrtc/model/types.js.map +1 -0
  196. package/dist/features/websocket/index.d.ts +3 -0
  197. package/dist/features/websocket/index.d.ts.map +1 -0
  198. package/dist/features/websocket/index.js +2 -0
  199. package/dist/features/websocket/index.js.map +1 -0
  200. package/dist/features/websocket/lib/create-websocket.d.ts +9 -0
  201. package/dist/features/websocket/lib/create-websocket.d.ts.map +1 -0
  202. package/dist/features/websocket/lib/create-websocket.js +34 -0
  203. package/dist/features/websocket/lib/create-websocket.js.map +1 -0
  204. package/dist/features/websocket/lib/mock.d.ts +6 -0
  205. package/dist/features/websocket/lib/mock.d.ts.map +1 -0
  206. package/dist/features/websocket/lib/mock.js +96 -0
  207. package/dist/features/websocket/lib/mock.js.map +1 -0
  208. package/dist/features/websocket/lib/proxy.d.ts +9 -0
  209. package/dist/features/websocket/lib/proxy.d.ts.map +1 -0
  210. package/dist/features/websocket/lib/proxy.js +120 -0
  211. package/dist/features/websocket/lib/proxy.js.map +1 -0
  212. package/dist/features/websocket/lib/wire.d.ts +16 -0
  213. package/dist/features/websocket/lib/wire.d.ts.map +1 -0
  214. package/dist/features/websocket/lib/wire.js +46 -0
  215. package/dist/features/websocket/lib/wire.js.map +1 -0
  216. package/dist/features/websocket/model/types.d.ts +133 -0
  217. package/dist/features/websocket/model/types.d.ts.map +1 -0
  218. package/dist/features/websocket/model/types.js +2 -0
  219. package/dist/features/websocket/model/types.js.map +1 -0
  220. package/dist/index.d.ts +27 -0
  221. package/dist/index.d.ts.map +1 -0
  222. package/dist/index.js +16 -0
  223. package/dist/index.js.map +1 -0
  224. package/dist/playwright.d.ts +4 -0
  225. package/dist/playwright.d.ts.map +1 -0
  226. package/dist/playwright.js +2 -0
  227. package/dist/playwright.js.map +1 -0
  228. package/dist/rest.d.ts +3 -0
  229. package/dist/rest.d.ts.map +1 -0
  230. package/dist/rest.js +3 -0
  231. package/dist/rest.js.map +1 -0
  232. package/dist/shared/api/http-server/index.d.ts +3 -0
  233. package/dist/shared/api/http-server/index.d.ts.map +1 -0
  234. package/dist/shared/api/http-server/index.js +2 -0
  235. package/dist/shared/api/http-server/index.js.map +1 -0
  236. package/dist/shared/api/http-server/listen.d.ts +25 -0
  237. package/dist/shared/api/http-server/listen.d.ts.map +1 -0
  238. package/dist/shared/api/http-server/listen.js +44 -0
  239. package/dist/shared/api/http-server/listen.js.map +1 -0
  240. package/dist/shared/api/playwright/index.d.ts +2 -0
  241. package/dist/shared/api/playwright/index.d.ts.map +1 -0
  242. package/dist/shared/api/playwright/index.js +2 -0
  243. package/dist/shared/api/playwright/index.js.map +1 -0
  244. package/dist/shared/api/playwright/ports.d.ts +126 -0
  245. package/dist/shared/api/playwright/ports.d.ts.map +1 -0
  246. package/dist/shared/api/playwright/ports.js +11 -0
  247. package/dist/shared/api/playwright/ports.js.map +1 -0
  248. package/dist/shared/api/stream-server/index.d.ts +3 -0
  249. package/dist/shared/api/stream-server/index.d.ts.map +1 -0
  250. package/dist/shared/api/stream-server/index.js +2 -0
  251. package/dist/shared/api/stream-server/index.js.map +1 -0
  252. package/dist/shared/api/stream-server/stream-server.d.ts +45 -0
  253. package/dist/shared/api/stream-server/stream-server.d.ts.map +1 -0
  254. package/dist/shared/api/stream-server/stream-server.js +167 -0
  255. package/dist/shared/api/stream-server/stream-server.js.map +1 -0
  256. package/dist/shared/lib/async/arrivals.d.ts +31 -0
  257. package/dist/shared/lib/async/arrivals.d.ts.map +1 -0
  258. package/dist/shared/lib/async/arrivals.js +57 -0
  259. package/dist/shared/lib/async/arrivals.js.map +1 -0
  260. package/dist/shared/lib/async/async-queue.d.ts +23 -0
  261. package/dist/shared/lib/async/async-queue.d.ts.map +1 -0
  262. package/dist/shared/lib/async/async-queue.js +80 -0
  263. package/dist/shared/lib/async/async-queue.js.map +1 -0
  264. package/dist/shared/lib/async/deferred.d.ts +12 -0
  265. package/dist/shared/lib/async/deferred.d.ts.map +1 -0
  266. package/dist/shared/lib/async/deferred.js +34 -0
  267. package/dist/shared/lib/async/deferred.js.map +1 -0
  268. package/dist/shared/lib/async/index.d.ts +8 -0
  269. package/dist/shared/lib/async/index.d.ts.map +1 -0
  270. package/dist/shared/lib/async/index.js +5 -0
  271. package/dist/shared/lib/async/index.js.map +1 -0
  272. package/dist/shared/lib/async/run-all.d.ts +8 -0
  273. package/dist/shared/lib/async/run-all.d.ts.map +1 -0
  274. package/dist/shared/lib/async/run-all.js +22 -0
  275. package/dist/shared/lib/async/run-all.js.map +1 -0
  276. package/dist/shared/lib/bytes/bytes.d.ts +18 -0
  277. package/dist/shared/lib/bytes/bytes.d.ts.map +1 -0
  278. package/dist/shared/lib/bytes/bytes.js +48 -0
  279. package/dist/shared/lib/bytes/bytes.js.map +1 -0
  280. package/dist/shared/lib/bytes/index.d.ts +3 -0
  281. package/dist/shared/lib/bytes/index.d.ts.map +1 -0
  282. package/dist/shared/lib/bytes/index.js +2 -0
  283. package/dist/shared/lib/bytes/index.js.map +1 -0
  284. package/dist/shared/lib/clock/clock.d.ts +29 -0
  285. package/dist/shared/lib/clock/clock.d.ts.map +1 -0
  286. package/dist/shared/lib/clock/clock.js +85 -0
  287. package/dist/shared/lib/clock/clock.js.map +1 -0
  288. package/dist/shared/lib/clock/index.d.ts +3 -0
  289. package/dist/shared/lib/clock/index.d.ts.map +1 -0
  290. package/dist/shared/lib/clock/index.js +2 -0
  291. package/dist/shared/lib/clock/index.js.map +1 -0
  292. package/dist/shared/lib/cookies/index.d.ts +3 -0
  293. package/dist/shared/lib/cookies/index.d.ts.map +1 -0
  294. package/dist/shared/lib/cookies/index.js +2 -0
  295. package/dist/shared/lib/cookies/index.js.map +1 -0
  296. package/dist/shared/lib/cookies/set-cookie.d.ts +22 -0
  297. package/dist/shared/lib/cookies/set-cookie.d.ts.map +1 -0
  298. package/dist/shared/lib/cookies/set-cookie.js +89 -0
  299. package/dist/shared/lib/cookies/set-cookie.js.map +1 -0
  300. package/dist/shared/lib/envelope/envelope.d.ts +50 -0
  301. package/dist/shared/lib/envelope/envelope.d.ts.map +1 -0
  302. package/dist/shared/lib/envelope/envelope.js +111 -0
  303. package/dist/shared/lib/envelope/envelope.js.map +1 -0
  304. package/dist/shared/lib/envelope/index.d.ts +3 -0
  305. package/dist/shared/lib/envelope/index.d.ts.map +1 -0
  306. package/dist/shared/lib/envelope/index.js +2 -0
  307. package/dist/shared/lib/envelope/index.js.map +1 -0
  308. package/dist/shared/lib/errors/index.d.ts +3 -0
  309. package/dist/shared/lib/errors/index.d.ts.map +1 -0
  310. package/dist/shared/lib/errors/index.js +2 -0
  311. package/dist/shared/lib/errors/index.js.map +1 -0
  312. package/dist/shared/lib/errors/wirestage-error.d.ts +28 -0
  313. package/dist/shared/lib/errors/wirestage-error.d.ts.map +1 -0
  314. package/dist/shared/lib/errors/wirestage-error.js +16 -0
  315. package/dist/shared/lib/errors/wirestage-error.js.map +1 -0
  316. package/dist/shared/lib/id/id.d.ts +10 -0
  317. package/dist/shared/lib/id/id.d.ts.map +1 -0
  318. package/dist/shared/lib/id/id.js +26 -0
  319. package/dist/shared/lib/id/id.js.map +1 -0
  320. package/dist/shared/lib/id/index.d.ts +2 -0
  321. package/dist/shared/lib/id/index.d.ts.map +1 -0
  322. package/dist/shared/lib/id/index.js +2 -0
  323. package/dist/shared/lib/id/index.js.map +1 -0
  324. package/dist/shared/lib/logger/index.d.ts +3 -0
  325. package/dist/shared/lib/logger/index.d.ts.map +1 -0
  326. package/dist/shared/lib/logger/index.js +2 -0
  327. package/dist/shared/lib/logger/index.js.map +1 -0
  328. package/dist/shared/lib/logger/logger.d.ts +46 -0
  329. package/dist/shared/lib/logger/logger.d.ts.map +1 -0
  330. package/dist/shared/lib/logger/logger.js +67 -0
  331. package/dist/shared/lib/logger/logger.js.map +1 -0
  332. package/dist/shared/lib/match/index.d.ts +3 -0
  333. package/dist/shared/lib/match/index.d.ts.map +1 -0
  334. package/dist/shared/lib/match/index.js +2 -0
  335. package/dist/shared/lib/match/index.js.map +1 -0
  336. package/dist/shared/lib/match/url-matcher.d.ts +27 -0
  337. package/dist/shared/lib/match/url-matcher.d.ts.map +1 -0
  338. package/dist/shared/lib/match/url-matcher.js +88 -0
  339. package/dist/shared/lib/match/url-matcher.js.map +1 -0
  340. package/dist/sse.d.ts +3 -0
  341. package/dist/sse.d.ts.map +1 -0
  342. package/dist/sse.js +3 -0
  343. package/dist/sse.js.map +1 -0
  344. package/dist/webrtc.d.ts +3 -0
  345. package/dist/webrtc.d.ts.map +1 -0
  346. package/dist/webrtc.js +3 -0
  347. package/dist/webrtc.js.map +1 -0
  348. package/dist/websocket.d.ts +3 -0
  349. package/dist/websocket.d.ts.map +1 -0
  350. package/dist/websocket.js +3 -0
  351. package/dist/websocket.js.map +1 -0
  352. package/dist/widgets/stage/index.d.ts +3 -0
  353. package/dist/widgets/stage/index.d.ts.map +1 -0
  354. package/dist/widgets/stage/index.js +2 -0
  355. package/dist/widgets/stage/index.js.map +1 -0
  356. package/dist/widgets/stage/lib/attached-context.d.ts +10 -0
  357. package/dist/widgets/stage/lib/attached-context.d.ts.map +1 -0
  358. package/dist/widgets/stage/lib/attached-context.js +2 -0
  359. package/dist/widgets/stage/lib/attached-context.js.map +1 -0
  360. package/dist/widgets/stage/lib/create-stage.d.ts +12 -0
  361. package/dist/widgets/stage/lib/create-stage.d.ts.map +1 -0
  362. package/dist/widgets/stage/lib/create-stage.js +250 -0
  363. package/dist/widgets/stage/lib/create-stage.js.map +1 -0
  364. package/dist/widgets/stage/lib/http-router.d.ts +44 -0
  365. package/dist/widgets/stage/lib/http-router.d.ts.map +1 -0
  366. package/dist/widgets/stage/lib/http-router.js +696 -0
  367. package/dist/widgets/stage/lib/http-router.js.map +1 -0
  368. package/dist/widgets/stage/lib/page-host.d.ts +36 -0
  369. package/dist/widgets/stage/lib/page-host.d.ts.map +1 -0
  370. package/dist/widgets/stage/lib/page-host.js +240 -0
  371. package/dist/widgets/stage/lib/page-host.js.map +1 -0
  372. package/dist/widgets/stage/lib/page-runtime.d.ts +93 -0
  373. package/dist/widgets/stage/lib/page-runtime.d.ts.map +1 -0
  374. package/dist/widgets/stage/lib/page-runtime.js +247 -0
  375. package/dist/widgets/stage/lib/page-runtime.js.map +1 -0
  376. package/dist/widgets/stage/lib/reads.d.ts +21 -0
  377. package/dist/widgets/stage/lib/reads.d.ts.map +1 -0
  378. package/dist/widgets/stage/lib/reads.js +97 -0
  379. package/dist/widgets/stage/lib/reads.js.map +1 -0
  380. package/dist/widgets/stage/lib/response-stream.d.ts +23 -0
  381. package/dist/widgets/stage/lib/response-stream.d.ts.map +1 -0
  382. package/dist/widgets/stage/lib/response-stream.js +108 -0
  383. package/dist/widgets/stage/lib/response-stream.js.map +1 -0
  384. package/dist/widgets/stage/lib/socket-router.d.ts +25 -0
  385. package/dist/widgets/stage/lib/socket-router.d.ts.map +1 -0
  386. package/dist/widgets/stage/lib/socket-router.js +233 -0
  387. package/dist/widgets/stage/lib/socket-router.js.map +1 -0
  388. package/dist/widgets/stage/model/stage.d.ts +88 -0
  389. package/dist/widgets/stage/model/stage.d.ts.map +1 -0
  390. package/dist/widgets/stage/model/stage.js +2 -0
  391. package/dist/widgets/stage/model/stage.js.map +1 -0
  392. package/package.json +140 -5
  393. package/src/app/playwright/index.ts +7 -0
  394. package/src/app/playwright/lib/fixture.ts +201 -0
  395. package/src/connect.ts +6 -0
  396. package/src/entities/frame/@x/plugin.ts +8 -0
  397. package/src/entities/frame/index.ts +19 -0
  398. package/src/entities/frame/lib/filter.ts +58 -0
  399. package/src/entities/frame/lib/payload.ts +42 -0
  400. package/src/entities/frame/lib/snapshot.ts +105 -0
  401. package/src/entities/frame/lib/timeline.ts +147 -0
  402. package/src/entities/frame/model/frame.ts +191 -0
  403. package/src/entities/plugin/index.ts +36 -0
  404. package/src/entities/plugin/lib/define-plugin.ts +12 -0
  405. package/src/entities/plugin/lib/named.ts +21 -0
  406. package/src/entities/plugin/model/attachment.ts +18 -0
  407. package/src/entities/plugin/model/http.ts +156 -0
  408. package/src/entities/plugin/model/page.ts +110 -0
  409. package/src/entities/plugin/model/plugin.ts +96 -0
  410. package/src/entities/plugin/model/socket.ts +113 -0
  411. package/src/entities/plugin/model/stream.ts +46 -0
  412. package/src/features/connect/index.ts +23 -0
  413. package/src/features/connect/lib/calls.ts +58 -0
  414. package/src/features/connect/lib/client.ts +203 -0
  415. package/src/features/connect/lib/create-connect.ts +164 -0
  416. package/src/features/connect/lib/faults.ts +132 -0
  417. package/src/features/connect/lib/protocol.ts +321 -0
  418. package/src/features/connect/lib/record.ts +48 -0
  419. package/src/features/connect/lib/recorder.ts +306 -0
  420. package/src/features/connect/lib/rules.ts +385 -0
  421. package/src/features/connect/lib/serve.ts +114 -0
  422. package/src/features/connect/lib/status-of.ts +20 -0
  423. package/src/features/connect/lib/stubs.ts +282 -0
  424. package/src/features/connect/lib/universal.ts +100 -0
  425. package/src/features/connect/model/types.ts +305 -0
  426. package/src/features/rest/index.ts +23 -0
  427. package/src/features/rest/lib/calls.ts +31 -0
  428. package/src/features/rest/lib/create-rest.ts +169 -0
  429. package/src/features/rest/lib/path.ts +70 -0
  430. package/src/features/rest/lib/reply.ts +74 -0
  431. package/src/features/rest/model/types.ts +113 -0
  432. package/src/features/sse/index.ts +10 -0
  433. package/src/features/sse/lib/create-sse.ts +129 -0
  434. package/src/features/sse/lib/encode.ts +28 -0
  435. package/src/features/sse/model/types.ts +72 -0
  436. package/src/features/webrtc/index.ts +6 -0
  437. package/src/features/webrtc/lib/create-webrtc.ts +149 -0
  438. package/src/features/webrtc/lib/rtc-page-module.ts +189 -0
  439. package/src/features/webrtc/lib/to-frame.ts +63 -0
  440. package/src/features/webrtc/model/types.ts +80 -0
  441. package/src/features/websocket/index.ts +15 -0
  442. package/src/features/websocket/lib/create-websocket.ts +41 -0
  443. package/src/features/websocket/lib/mock.ts +114 -0
  444. package/src/features/websocket/lib/proxy.ts +153 -0
  445. package/src/features/websocket/lib/wire.ts +78 -0
  446. package/src/features/websocket/model/types.ts +134 -0
  447. package/src/index.ts +111 -0
  448. package/src/playwright.ts +8 -0
  449. package/src/rest.ts +2 -0
  450. package/src/shared/api/http-server/index.ts +2 -0
  451. package/src/shared/api/http-server/listen.ts +71 -0
  452. package/src/shared/api/playwright/index.ts +17 -0
  453. package/src/shared/api/playwright/ports.ts +150 -0
  454. package/src/shared/api/stream-server/index.ts +7 -0
  455. package/src/shared/api/stream-server/stream-server.ts +254 -0
  456. package/src/shared/lib/async/arrivals.ts +91 -0
  457. package/src/shared/lib/async/async-queue.ts +101 -0
  458. package/src/shared/lib/async/deferred.ts +38 -0
  459. package/src/shared/lib/async/index.ts +11 -0
  460. package/src/shared/lib/async/run-all.ts +19 -0
  461. package/src/shared/lib/bytes/bytes.ts +53 -0
  462. package/src/shared/lib/bytes/index.ts +9 -0
  463. package/src/shared/lib/clock/clock.ts +114 -0
  464. package/src/shared/lib/clock/index.ts +2 -0
  465. package/src/shared/lib/cookies/index.ts +2 -0
  466. package/src/shared/lib/cookies/set-cookie.ts +105 -0
  467. package/src/shared/lib/envelope/envelope.ts +133 -0
  468. package/src/shared/lib/envelope/index.ts +9 -0
  469. package/src/shared/lib/errors/index.ts +5 -0
  470. package/src/shared/lib/errors/wirestage-error.ts +50 -0
  471. package/src/shared/lib/id/id.ts +29 -0
  472. package/src/shared/lib/id/index.ts +1 -0
  473. package/src/shared/lib/logger/index.ts +12 -0
  474. package/src/shared/lib/logger/logger.ts +126 -0
  475. package/src/shared/lib/match/index.ts +6 -0
  476. package/src/shared/lib/match/url-matcher.ts +107 -0
  477. package/src/sse.ts +2 -0
  478. package/src/webrtc.ts +2 -0
  479. package/src/websocket.ts +2 -0
  480. package/src/widgets/stage/index.ts +9 -0
  481. package/src/widgets/stage/lib/attached-context.ts +10 -0
  482. package/src/widgets/stage/lib/create-stage.ts +307 -0
  483. package/src/widgets/stage/lib/http-router.ts +954 -0
  484. package/src/widgets/stage/lib/page-host.ts +375 -0
  485. package/src/widgets/stage/lib/page-runtime.ts +314 -0
  486. package/src/widgets/stage/lib/reads.ts +128 -0
  487. package/src/widgets/stage/lib/response-stream.ts +139 -0
  488. package/src/widgets/stage/lib/socket-router.ts +300 -0
  489. package/src/widgets/stage/model/stage.ts +110 -0
@@ -0,0 +1,696 @@
1
+ import { toBuffer, toBytes, utf8 } from "../../../shared/lib/bytes/index.js";
2
+ import { WirestageError } from "../../../shared/lib/errors/index.js";
3
+ import { compileUrlMatcher } from "../../../shared/lib/match/index.js";
4
+ import { createResponseStream } from "./response-stream.js";
5
+ /**
6
+ * Playwright's abort codes. Keyed by the contract's type, so the two cannot
7
+ * drift: a code missing here, or one too many, does not compile.
8
+ */
9
+ const ABORT_CODES = {
10
+ aborted: true,
11
+ accessdenied: true,
12
+ addressunreachable: true,
13
+ blockedbyclient: true,
14
+ blockedbyresponse: true,
15
+ connectionaborted: true,
16
+ connectionclosed: true,
17
+ connectionfailed: true,
18
+ connectionrefused: true,
19
+ connectionreset: true,
20
+ internetdisconnected: true,
21
+ namenotresolved: true,
22
+ timedout: true,
23
+ failed: true,
24
+ };
25
+ /** RFC 9110's `token`: what a header name may be made of. */
26
+ const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
27
+ /** A host whose http pages are secure contexts. */
28
+ const LOOPBACK_HOST = /^(localhost|.+\.localhost|127(\.\d{1,3}){3}|\[::1\])$/;
29
+ /** A loopback address, as Chromium reports the server of a response. */
30
+ const LOOPBACK_ADDRESS = /^(127\.|::ffff:127\.|\[?::1\]?$)/;
31
+ /**
32
+ * Refuse a header Chromium refuses: a name that is not a token, a value
33
+ * with a line break or NUL. Playwright reports such an answer sent while
34
+ * Chromium never sends it, and the request hangs.
35
+ */
36
+ function checkHeader(name, value) {
37
+ if (!HEADER_NAME.test(name))
38
+ throw new WirestageError("INVALID_ARGUMENT", `${JSON.stringify(name)} is not a valid header name`);
39
+ if (/[\r\n\0]/.test(value))
40
+ throw new WirestageError("INVALID_ARGUMENT", `the value of header "${name}" has a line break or NUL in it`);
41
+ }
42
+ /**
43
+ * A fulfill's headers, as Chromium takes them. A value may carry several,
44
+ * one per line: Playwright sends `set-cookie` as a header line each, and
45
+ * any other header is folded into one value, `, `-separated, as HTTP joins
46
+ * repeated header lines.
47
+ */
48
+ function fulfillHeaders(headers = {}) {
49
+ const sent = {};
50
+ for (const [name, value] of Object.entries(headers)) {
51
+ const values = value.split("\n");
52
+ for (const each of values)
53
+ checkHeader(name, each);
54
+ sent[name] =
55
+ name.toLowerCase() === "set-cookie" ? value : values.join(", ");
56
+ }
57
+ return sent;
58
+ }
59
+ /** Where a `continue` goes: relative to the request, in its scheme. */
60
+ function continueUrl(target, request) {
61
+ const url = new URL(target, request);
62
+ if (url.protocol !== request.protocol)
63
+ throw new WirestageError("INVALID_ARGUMENT", `continue cannot change the scheme (${request.protocol} to ${url.protocol}): Playwright rewrites a URL within its scheme only`);
64
+ return url.href;
65
+ }
66
+ /** Whether a page at `url` is a secure context: https, or http on loopback. */
67
+ const isSecure = ({ protocol, hostname }) => protocol === "https:" ||
68
+ (protocol === "http:" && LOOPBACK_HOST.test(hostname));
69
+ /** A request the browser reports failed, with its error text. */
70
+ const networkFault = (error) => ({
71
+ kind: "fault",
72
+ direction: "none",
73
+ source: "network",
74
+ meta: { reason: "network", error },
75
+ });
76
+ /** A live stream whose request never reached the stream server. */
77
+ const unreached = (error) => ({
78
+ kind: "fault",
79
+ direction: "none",
80
+ source: "stub",
81
+ meta: { reason: "unreached", error },
82
+ });
83
+ /** How a stream that ran its course is on record. */
84
+ const endOf = (end) => end === "cut"
85
+ ? {
86
+ kind: "fault",
87
+ direction: "none",
88
+ source: "stub",
89
+ meta: { reason: "cut" },
90
+ }
91
+ : {
92
+ kind: "lifecycle",
93
+ direction: "none",
94
+ // The page let go of it, or the stub ended it.
95
+ source: end === "cancelled" ? "page" : "stub",
96
+ meta: { event: "close", end },
97
+ };
98
+ const messageOf = (error) => error instanceof Error ? error.message : String(error);
99
+ /**
100
+ * Turns HTTP rules into ONE Playwright route per attached context and runs
101
+ * the chain itself: the newest rule that matches decides, and a `fallback`
102
+ * hands the request to the next.
103
+ *
104
+ * Running the chain here, rather than as one Playwright route per rule, is
105
+ * what makes a request one exchange however many rules see it: they share a
106
+ * view and a correlation id, `times` is claimed without an await between the
107
+ * check and the count, and a rule that passed a request on hears about the
108
+ * network's answer only when the network really gave one.
109
+ */
110
+ export function createHttpRouter(deps) {
111
+ /** Active rules, oldest first. */
112
+ const entries = [];
113
+ const attachments = new Map();
114
+ const routes = new Map();
115
+ const pending = new WeakMap();
116
+ /** Live streams whose request the browser has not brought yet. */
117
+ const unclaimed = new Map();
118
+ /** Live streams the stream server is serving. */
119
+ const serving = new Set();
120
+ /** Where each frame's document came from, as its navigation reported. */
121
+ const documents = new WeakMap();
122
+ /** Responses being read off the browser, on their way to the timeline. */
123
+ const settling = new Set();
124
+ /**
125
+ * The origin a live stream from `frame` needs `local-network-access`
126
+ * for, if any. Chromium's Local Network Access stops a page it cannot
127
+ * place in an address space — any page a route fulfilled — from reaching
128
+ * the loopback stream server unless its origin holds the permission. A
129
+ * page a loopback server really served needs none, and one that is not a
130
+ * secure context is refused loopback, granted or not.
131
+ */
132
+ const grantFor = (frame) => {
133
+ // A service worker's request has no frame, and a frame that has shown
134
+ // no document yet no URL: neither has an origin to grant.
135
+ if (frame === undefined || !URL.canParse(frame.url()))
136
+ return undefined;
137
+ const url = new URL(frame.url());
138
+ if (!isSecure(url))
139
+ return undefined;
140
+ const document = documents.get(frame);
141
+ return document?.origin === url.origin && document.loopback
142
+ ? undefined
143
+ : url.origin;
144
+ };
145
+ /**
146
+ * Granted per stream, to that page's origin alone: Playwright merges it
147
+ * with the grants the test made for that origin, and a test that cleared
148
+ * its permissions has it back with the next stream. A browser without
149
+ * the permission refuses it, and then needs none.
150
+ */
151
+ const allowLocalNetwork = async ({ attachment, frame, }) => {
152
+ const origin = grantFor(frame);
153
+ if (origin === undefined)
154
+ return;
155
+ try {
156
+ await attachment.context.grantPermissions?.(["local-network-access"], {
157
+ origin,
158
+ });
159
+ }
160
+ catch (error) {
161
+ deps.log.debug("local-network-access not granted", { origin }, error);
162
+ }
163
+ };
164
+ /** Note where a frame's document came from, for `grantFor`. */
165
+ const noteDocument = async (request) => {
166
+ try {
167
+ const frame = request.frame();
168
+ const server = await (await request.response())?.serverAddr();
169
+ documents.set(frame, {
170
+ origin: new URL(request.url()).origin,
171
+ loopback: server != null && LOOPBACK_ADDRESS.test(server.ipAddress),
172
+ });
173
+ }
174
+ catch (error) {
175
+ // A service worker's document has no frame, a closed page no answer.
176
+ deps.log.debug("could not tell where a document came from", { url: request.url() }, error);
177
+ }
178
+ };
179
+ /** The frame and the page a request came from; a service worker's has neither. */
180
+ const senderOf = (request) => {
181
+ try {
182
+ const frame = request.frame();
183
+ return { frame, page: deps.pageId(frame.page()) };
184
+ }
185
+ catch {
186
+ // Service-worker requests have no frame.
187
+ return {};
188
+ }
189
+ };
190
+ const createView = async (request, attachment, url, page) => {
191
+ let body;
192
+ let correlation;
193
+ const getBody = () => {
194
+ body ??= toBytes(request.postDataBuffer() ?? new Uint8Array(0));
195
+ return body;
196
+ };
197
+ return {
198
+ get correlation() {
199
+ correlation ??= deps.correlation();
200
+ return correlation;
201
+ },
202
+ method: request.method(),
203
+ url,
204
+ headers: await request.allHeaders(),
205
+ page,
206
+ context: attachment.id,
207
+ resourceType: request.resourceType(),
208
+ body: getBody,
209
+ text: () => utf8(getBody()),
210
+ json: () => JSON.parse(utf8(getBody())),
211
+ };
212
+ };
213
+ const append = ({ view }, protocol, endpoint, frame) => deps.timeline.append({
214
+ ...frame,
215
+ protocol,
216
+ endpoint,
217
+ page: view.page,
218
+ context: view.context,
219
+ correlation: view.correlation,
220
+ });
221
+ /** End the exchange for every protocol that recorded its request. */
222
+ const close = (exchange, frame) => {
223
+ for (const [protocol, endpoint] of exchange.recorded)
224
+ append(exchange, protocol, endpoint, frame);
225
+ };
226
+ /**
227
+ * A rule's URL test, which is the caller's code when the rule was given a
228
+ * predicate. Playwright calls this for every request of the context, so
229
+ * one that throws would break them all: it counts as "no match" instead.
230
+ */
231
+ const wants = (entry, url) => {
232
+ try {
233
+ return entry.matchesUrl(url);
234
+ }
235
+ catch (error) {
236
+ deps.log.error("rule's URL matcher failed", { rule: entry.rule.label, url: url.href }, error);
237
+ return false;
238
+ }
239
+ };
240
+ /** The rule's name for the request; the path when it has none to give. */
241
+ const nameOf = ({ rule }, view) => {
242
+ try {
243
+ return rule.endpoint?.(view) ?? view.url.pathname;
244
+ }
245
+ catch {
246
+ // Reached only while reporting a rule that already failed.
247
+ return view.url.pathname;
248
+ }
249
+ };
250
+ const retire = (entry) => {
251
+ if (!entry.active)
252
+ return;
253
+ entry.active = false;
254
+ entries.splice(entries.indexOf(entry), 1);
255
+ };
256
+ /**
257
+ * Whether `entry` takes the request, and its decision if so. The checks
258
+ * and the count are one synchronous step: two requests in flight cannot
259
+ * both take the last of a rule's `times`.
260
+ */
261
+ const decide = async (entry, exchange) => {
262
+ const { rule } = entry;
263
+ const { view } = exchange;
264
+ if (!entry.active)
265
+ return undefined;
266
+ if (entry.methods !== undefined && !entry.methods.has(view.method))
267
+ return undefined;
268
+ if (rule.match !== undefined && !rule.match(view))
269
+ return undefined;
270
+ entry.hits += 1;
271
+ if (entry.remaining !== undefined && --entry.remaining === 0)
272
+ retire(entry);
273
+ if (rule.record !== false && !exchange.recorded.has(rule.protocol)) {
274
+ const endpoint = rule.endpoint?.(view) ?? view.url.pathname;
275
+ exchange.recorded.set(rule.protocol, endpoint);
276
+ append(exchange, rule.protocol, endpoint, {
277
+ kind: "request",
278
+ direction: "out",
279
+ source: "page",
280
+ data: () => view.body(),
281
+ meta: {
282
+ method: view.method,
283
+ url: view.url.href,
284
+ headers: view.headers,
285
+ },
286
+ });
287
+ }
288
+ return rule.handle(view);
289
+ };
290
+ /** The request goes to the network: remember who wants to hear the answer. */
291
+ const track = (exchange) => {
292
+ if (exchange.recorded.size > 0 ||
293
+ exchange.passed.some(({ rule }) => rule.onPassthroughResponse !== undefined ||
294
+ rule.onPassthroughFailure !== undefined))
295
+ pending.set(exchange.request, exchange);
296
+ };
297
+ /** A request that outlived its context fails for that reason alone. */
298
+ const levelOf = ({ attachment }) => attachments.has(attachment) ? "error" : "debug";
299
+ /** What the page is told of a rule that failed; the app may display it. */
300
+ const failureBody = ({ rule }, error) => `wirestage: rule "${rule.label}" failed: ${messageOf(error)}`;
301
+ /** Say which rule failed: in the log, and on the timeline. */
302
+ const report = (exchange, entry, error) => {
303
+ const { rule } = entry;
304
+ deps.log[levelOf(exchange)]("rule failed", { rule: rule.label, url: exchange.view.url.href }, error);
305
+ append(exchange, rule.protocol, nameOf(entry, exchange.view), {
306
+ kind: "fault",
307
+ direction: "none",
308
+ source: "stub",
309
+ meta: { reason: "rule-error", error: messageOf(error) },
310
+ });
311
+ };
312
+ /**
313
+ * Serve a live stream once the browser has brought its request to the
314
+ * stream server. A rule that throws there is a rule that failed, as a
315
+ * throwing `fulfill` is — not the page letting go.
316
+ */
317
+ const serveStream = (outcome, exchange, entry) => async (request, response) => {
318
+ const served = createResponseStream(request, response, (end, failed) => {
319
+ serving.delete(served);
320
+ // A rule that failed is on record as its error, not as an end.
321
+ if (!failed)
322
+ close(exchange, endOf(end));
323
+ });
324
+ serving.add(served);
325
+ try {
326
+ await outcome.open(served.stream);
327
+ }
328
+ catch (error) {
329
+ if (served.fail(failureBody(entry, error)))
330
+ report(exchange, entry, error);
331
+ // It was over first, and is on record as such: a write into a
332
+ // connection the page let go of, or one the rule ended.
333
+ else
334
+ deps.log.debug("a stream's rule failed after the stream was over", { rule: entry.rule.label }, error);
335
+ }
336
+ };
337
+ /**
338
+ * Wait for the browser to bring a redirected stream to the stream
339
+ * server. Until it does, the session holds a place on a listener and the
340
+ * exchange has no end — and a page that let go first, while the rule
341
+ * decided or just after the redirect, never comes: Playwright takes the
342
+ * redirect all the same. Given up when the request fails, the context is
343
+ * detached, or `timeoutMs` passes.
344
+ */
345
+ const awaitBrowser = (exchange, session) => {
346
+ const release = (frame) => {
347
+ session.dispose();
348
+ close(exchange, frame);
349
+ };
350
+ const failure = exchange.request.failure();
351
+ if (failure !== null) {
352
+ // It failed while the rule decided or the redirect was made.
353
+ release(networkFault(failure.errorText));
354
+ return;
355
+ }
356
+ const deadline = new AbortController();
357
+ const settle = (frame) => {
358
+ unclaimed.delete(exchange.request);
359
+ deadline.abort();
360
+ if (frame !== undefined)
361
+ release(frame);
362
+ };
363
+ unclaimed.set(exchange.request, {
364
+ attachment: exchange.attachment,
365
+ settle,
366
+ });
367
+ void deps.clock.sleep(deps.timeoutMs, deadline.signal).then(() => {
368
+ deps.log.warn("a live stream's request never reached the stream server, and was given up", { url: exchange.view.url.href, timeoutMs: deps.timeoutMs });
369
+ settle(unreached(`the browser did not bring the request to the stream server within ${deps.timeoutMs} ms`));
370
+ },
371
+ // It came, failed or was detached first.
372
+ () => undefined);
373
+ };
374
+ const execute = {
375
+ async fulfill(outcome, exchange) {
376
+ const status = outcome.status ?? 200;
377
+ const headers = fulfillHeaders(outcome.headers);
378
+ const body = outcome.body === undefined ? undefined : toBytes(outcome.body);
379
+ await exchange.route.fulfill(body === undefined
380
+ ? { status, headers }
381
+ : { status, headers, body: toBuffer(body) });
382
+ close(exchange, {
383
+ kind: "response",
384
+ direction: "in",
385
+ source: "stub",
386
+ ...(body === undefined ? {} : { data: body }),
387
+ meta: { status, headers },
388
+ });
389
+ },
390
+ async stream(outcome, exchange, entry) {
391
+ let claimed = false;
392
+ const serve = serveStream(outcome, exchange, entry);
393
+ const session = await deps.streams.open((request, response) => {
394
+ claimed = true;
395
+ unclaimed.get(exchange.request)?.settle();
396
+ return serve(request, response);
397
+ }, { secure: exchange.view.url.protocol === "https:" });
398
+ await allowLocalNetwork(exchange);
399
+ try {
400
+ await exchange.route.continue({ url: session.url });
401
+ }
402
+ catch (error) {
403
+ session.dispose();
404
+ throw error;
405
+ }
406
+ // The browser may come before Playwright says the redirect is made.
407
+ if (!claimed)
408
+ awaitBrowser(exchange, session);
409
+ },
410
+ async continue(outcome, exchange, entry) {
411
+ const url = outcome.url === undefined
412
+ ? undefined
413
+ : continueUrl(outcome.url, exchange.view.url);
414
+ for (const [name, value] of Object.entries(outcome.headers ?? {}))
415
+ checkHeader(name, value);
416
+ exchange.passed.push(entry);
417
+ track(exchange);
418
+ await exchange.route.continue({
419
+ ...(url === undefined ? {} : { url }),
420
+ ...(outcome.method === undefined ? {} : { method: outcome.method }),
421
+ ...(outcome.headers === undefined
422
+ ? {}
423
+ : { headers: { ...outcome.headers } }),
424
+ ...(outcome.body === undefined
425
+ ? {}
426
+ : { postData: toBuffer(toBytes(outcome.body)) }),
427
+ });
428
+ },
429
+ async abort(outcome, exchange) {
430
+ const error = outcome.error ?? "failed";
431
+ if (!Object.hasOwn(ABORT_CODES, error))
432
+ throw new WirestageError("INVALID_ARGUMENT", `"${error}" is not an abort error code; Playwright takes ${Object.keys(ABORT_CODES).join(", ")}`);
433
+ await exchange.route.abort(error);
434
+ close(exchange, {
435
+ kind: "fault",
436
+ direction: "none",
437
+ source: "stub",
438
+ meta: { reason: "abort", error },
439
+ });
440
+ },
441
+ };
442
+ /**
443
+ * A throwing stub is a bug in the test, as is an answer Playwright or
444
+ * Chromium would refuse, and a stream that cannot open is a setup
445
+ * problem. Either way answer 500 so the page sees an error instead of
446
+ * hanging, and say which rule failed — in the log AND in the body the app
447
+ * may display.
448
+ */
449
+ const fail = async (exchange, entry, error) => {
450
+ report(exchange, entry, error);
451
+ await exchange.route
452
+ .fulfill({
453
+ status: 500,
454
+ headers: { "content-type": "text/plain; charset=utf-8" },
455
+ body: failureBody(entry, error),
456
+ })
457
+ .catch((secondary) => {
458
+ // The route took an answer before the failure, and Playwright
459
+ // takes no other: the page waits for good.
460
+ deps.log[levelOf(exchange)]("could not answer a failed rule: the request is left without an answer", { rule: entry.rule.label, url: exchange.view.url.href }, secondary);
461
+ });
462
+ };
463
+ const dispatch = async (attachment, route, request) => {
464
+ const url = new URL(request.url());
465
+ // Newest first. A snapshot: a rule added while this request is being
466
+ // decided does not join its chain.
467
+ const chain = entries.filter((entry) => wants(entry, url)).reverse();
468
+ if (chain.length === 0)
469
+ return route.fallback();
470
+ const sender = senderOf(request);
471
+ const exchange = {
472
+ view: await createView(request, attachment, url, sender.page),
473
+ attachment,
474
+ route,
475
+ request,
476
+ frame: sender.frame,
477
+ recorded: new Map(),
478
+ passed: [],
479
+ };
480
+ for (const entry of chain) {
481
+ try {
482
+ const outcome = await decide(entry, exchange);
483
+ if (outcome === undefined)
484
+ continue;
485
+ if (outcome.type === "fallback") {
486
+ exchange.passed.push(entry);
487
+ continue;
488
+ }
489
+ // The table has an executor for every answer; the cast is only
490
+ // because TypeScript cannot tie `outcome` to its own key.
491
+ await execute[outcome.type](outcome, exchange, entry);
492
+ }
493
+ catch (error) {
494
+ await fail(exchange, entry, error);
495
+ }
496
+ return;
497
+ }
498
+ track(exchange);
499
+ await route.fallback();
500
+ };
501
+ const onRoute = async (attachment, route, request) => {
502
+ try {
503
+ await dispatch(attachment, route, request);
504
+ }
505
+ catch (error) {
506
+ // Reading the request or handing it on failed: the page or context
507
+ // closed under it. Never rejected to Playwright, where it would
508
+ // surface as an unhandled rejection in whichever test runs next.
509
+ const level = attachments.has(attachment) ? "warn" : "debug";
510
+ deps.log[level]("request abandoned", { url: request.url() }, error);
511
+ }
512
+ };
513
+ const ensureRoute = async (attachment) => {
514
+ let installing = routes.get(attachment);
515
+ if (installing === undefined) {
516
+ const installed = {
517
+ predicate: (url) => entries.some((entry) => wants(entry, url)),
518
+ handler: (route, request) => onRoute(attachment, route, request),
519
+ };
520
+ installing = attachment.context
521
+ .route(installed.predicate, installed.handler)
522
+ .then(() => installed);
523
+ routes.set(attachment, installing);
524
+ // A failed install must not be remembered as done.
525
+ installing.catch(() => routes.delete(attachment));
526
+ }
527
+ await installing;
528
+ };
529
+ /** One observer failing must not starve the others, nor the timeline. */
530
+ const notify = (entry, call) => {
531
+ try {
532
+ call(entry.rule);
533
+ }
534
+ catch (error) {
535
+ deps.log.error("passthrough observer failed", { rule: entry.rule.label }, error);
536
+ }
537
+ };
538
+ /** Record the network's answer to a request a rule passed on. */
539
+ const record = async (exchange, request) => {
540
+ try {
541
+ const response = await request.response();
542
+ if (response === null)
543
+ return;
544
+ const body = await response.body().then((buffer) => toBytes(buffer), () => undefined);
545
+ const passthrough = {
546
+ status: response.status(),
547
+ headers: response.headers(),
548
+ body,
549
+ };
550
+ close(exchange, {
551
+ kind: "response",
552
+ direction: "in",
553
+ source: "network",
554
+ ...(body === undefined ? {} : { data: body }),
555
+ meta: { status: passthrough.status, headers: passthrough.headers },
556
+ });
557
+ for (const entry of exchange.passed)
558
+ notify(entry, (rule) => rule.onPassthroughResponse?.(passthrough, exchange.view));
559
+ }
560
+ catch (error) {
561
+ deps.log.warn("could not read a passed-through response", { url: exchange.view.url.href }, error);
562
+ }
563
+ };
564
+ /** Whether a finished request was passed on, and its recording if so. */
565
+ const onFinished = (request) => {
566
+ const exchange = pending.get(request);
567
+ if (exchange === undefined)
568
+ return undefined;
569
+ pending.delete(request);
570
+ return record(exchange, request);
571
+ };
572
+ /**
573
+ * `reading`, as long as a read waits for it. Reading a body is a round
574
+ * trip to the page, which a dialog holds up until it closes: a read waits
575
+ * as long as a page is given to answer, then goes on, and the response
576
+ * reaches the timeline when its body does.
577
+ */
578
+ const bounded = (reading, url) => {
579
+ const waiting = new AbortController();
580
+ return Promise.race([
581
+ reading,
582
+ deps.clock.sleep(deps.timeoutMs, waiting.signal).then(() => deps.log.warn("a response did not hand over its body in time; reads go on without it until it does (is a dialog open?)", { url, timeoutMs: deps.timeoutMs }),
583
+ // The body came first.
584
+ () => undefined),
585
+ ]).finally(() => waiting.abort());
586
+ };
587
+ const onFailed = (request) => {
588
+ const error = request.failure()?.errorText;
589
+ // A live stream the page let go of before the browser could bring it.
590
+ unclaimed.get(request)?.settle(networkFault(error));
591
+ const exchange = pending.get(request);
592
+ if (exchange === undefined)
593
+ return;
594
+ pending.delete(request);
595
+ close(exchange, networkFault(error));
596
+ for (const entry of exchange.passed)
597
+ notify(entry, (rule) => rule.onPassthroughFailure?.(error, exchange.view));
598
+ };
599
+ return {
600
+ async add(rule) {
601
+ if (rule.times !== undefined &&
602
+ (!Number.isInteger(rule.times) || rule.times < 1))
603
+ throw new WirestageError("INVALID_ARGUMENT", `rule "${rule.label}": times must be a positive integer, got ${rule.times}`);
604
+ const methods = rule.method === undefined
605
+ ? undefined
606
+ : new Set((typeof rule.method === "string"
607
+ ? [rule.method]
608
+ : rule.method).map((m) => m.toUpperCase()));
609
+ const entry = {
610
+ rule,
611
+ matchesUrl: compileUrlMatcher(rule.url),
612
+ methods,
613
+ remaining: rule.times,
614
+ hits: 0,
615
+ active: true,
616
+ };
617
+ entries.push(entry);
618
+ try {
619
+ await Promise.all([...attachments.keys()].map(ensureRoute));
620
+ }
621
+ catch (error) {
622
+ // Half-installed is worse than not installed: the caller got an
623
+ // error, so the rule must not answer anywhere.
624
+ retire(entry);
625
+ throw error;
626
+ }
627
+ return {
628
+ get hits() {
629
+ return entry.hits;
630
+ },
631
+ get active() {
632
+ return entry.active;
633
+ },
634
+ async remove() {
635
+ retire(entry);
636
+ },
637
+ };
638
+ },
639
+ async attach(attachment) {
640
+ const own = {
641
+ finished: (request) => {
642
+ if (request.resourceType() === "document")
643
+ void noteDocument(request);
644
+ const reading = onFinished(request);
645
+ if (reading === undefined)
646
+ return;
647
+ const waiting = bounded(reading, request.url());
648
+ settling.add(waiting);
649
+ void waiting.then(() => settling.delete(waiting));
650
+ },
651
+ failed: onFailed,
652
+ };
653
+ attachments.set(attachment, own);
654
+ attachment.context.on("requestfinished", own.finished);
655
+ attachment.context.on("requestfailed", own.failed);
656
+ // Routing turns the browser's HTTP cache off and puts every request
657
+ // through Playwright, so a stage with no rules installs nothing.
658
+ if (entries.length > 0)
659
+ await ensureRoute(attachment);
660
+ },
661
+ async detach(attachment) {
662
+ const own = attachments.get(attachment);
663
+ if (own === undefined)
664
+ return;
665
+ attachments.delete(attachment);
666
+ attachment.context.off("requestfinished", own.finished);
667
+ attachment.context.off("requestfailed", own.failed);
668
+ // Nothing brings these now, and each holds a place on a listener.
669
+ for (const waiting of [...unclaimed.values()])
670
+ if (waiting.attachment === attachment)
671
+ waiting.settle(unreached("the context was detached first"));
672
+ const installing = routes.get(attachment);
673
+ routes.delete(attachment);
674
+ if (installing === undefined)
675
+ return;
676
+ try {
677
+ const { predicate, handler } = await installing;
678
+ await attachment.context.unroute(predicate, handler);
679
+ }
680
+ catch (error) {
681
+ // A context that closed first has no route left to remove.
682
+ deps.log.debug("unroute failed", { context: attachment.id }, error);
683
+ }
684
+ },
685
+ async settle() {
686
+ await Promise.all([
687
+ ...settling,
688
+ // A stream the stub ended or cut is on its way to the timeline.
689
+ ...[...serving]
690
+ .filter((served) => served.closing)
691
+ .map((served) => served.stream.closed),
692
+ ]);
693
+ },
694
+ };
695
+ }
696
+ //# sourceMappingURL=http-router.js.map