tabwright 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (599) hide show
  1. package/LICENSE +21 -0
  2. package/bin.js +4 -0
  3. package/dist/a11y-client.js +204 -0
  4. package/dist/agent-skills/tabwright/SKILL.md +119 -0
  5. package/dist/aria-snapshot.d.ts +262 -0
  6. package/dist/aria-snapshot.d.ts.map +1 -0
  7. package/dist/aria-snapshot.js +1256 -0
  8. package/dist/aria-snapshot.js.map +1 -0
  9. package/dist/aria-snapshot.test.d.ts +2 -0
  10. package/dist/aria-snapshot.test.d.ts.map +1 -0
  11. package/dist/aria-snapshot.test.js +270 -0
  12. package/dist/aria-snapshot.test.js.map +1 -0
  13. package/dist/aria-snapshot.unit.test.d.ts +2 -0
  14. package/dist/aria-snapshot.unit.test.d.ts.map +1 -0
  15. package/dist/aria-snapshot.unit.test.js +542 -0
  16. package/dist/aria-snapshot.unit.test.js.map +1 -0
  17. package/dist/assets/cursors/screen-studio/pointer-macos-tahoe-data-url.d.ts +5 -0
  18. package/dist/assets/cursors/screen-studio/pointer-macos-tahoe-data-url.d.ts.map +1 -0
  19. package/dist/assets/cursors/screen-studio/pointer-macos-tahoe-data-url.js +5 -0
  20. package/dist/assets/cursors/screen-studio/pointer-macos-tahoe-data-url.js.map +1 -0
  21. package/dist/bippy.js +894 -0
  22. package/dist/browser-config.d.ts +13 -0
  23. package/dist/browser-config.d.ts.map +1 -0
  24. package/dist/browser-config.js +126 -0
  25. package/dist/browser-config.js.map +1 -0
  26. package/dist/browser-install.d.ts +16 -0
  27. package/dist/browser-install.d.ts.map +1 -0
  28. package/dist/browser-install.js +238 -0
  29. package/dist/browser-install.js.map +1 -0
  30. package/dist/browser-launch.d.ts +17 -0
  31. package/dist/browser-launch.d.ts.map +1 -0
  32. package/dist/browser-launch.js +44 -0
  33. package/dist/browser-launch.js.map +1 -0
  34. package/dist/builtin-capabilities.d.ts +28 -0
  35. package/dist/builtin-capabilities.d.ts.map +1 -0
  36. package/dist/builtin-capabilities.js +2673 -0
  37. package/dist/builtin-capabilities.js.map +1 -0
  38. package/dist/capability-agent-skill.d.ts +60 -0
  39. package/dist/capability-agent-skill.d.ts.map +1 -0
  40. package/dist/capability-agent-skill.js +225 -0
  41. package/dist/capability-agent-skill.js.map +1 -0
  42. package/dist/capability-auth-state.d.ts +34 -0
  43. package/dist/capability-auth-state.d.ts.map +1 -0
  44. package/dist/capability-auth-state.js +157 -0
  45. package/dist/capability-auth-state.js.map +1 -0
  46. package/dist/capability-auth.d.ts +36 -0
  47. package/dist/capability-auth.d.ts.map +1 -0
  48. package/dist/capability-auth.js +198 -0
  49. package/dist/capability-auth.js.map +1 -0
  50. package/dist/capability-cli-confirmation.test.d.ts +2 -0
  51. package/dist/capability-cli-confirmation.test.d.ts.map +1 -0
  52. package/dist/capability-cli-confirmation.test.js +79 -0
  53. package/dist/capability-cli-confirmation.test.js.map +1 -0
  54. package/dist/capability-options.d.ts +20 -0
  55. package/dist/capability-options.d.ts.map +1 -0
  56. package/dist/capability-options.js +31 -0
  57. package/dist/capability-options.js.map +1 -0
  58. package/dist/capability-options.test.d.ts +2 -0
  59. package/dist/capability-options.test.d.ts.map +1 -0
  60. package/dist/capability-options.test.js +81 -0
  61. package/dist/capability-options.test.js.map +1 -0
  62. package/dist/capability-package.d.ts +27 -0
  63. package/dist/capability-package.d.ts.map +1 -0
  64. package/dist/capability-package.js +444 -0
  65. package/dist/capability-package.js.map +1 -0
  66. package/dist/capability-package.test.d.ts +2 -0
  67. package/dist/capability-package.test.d.ts.map +1 -0
  68. package/dist/capability-package.test.js +179 -0
  69. package/dist/capability-package.test.js.map +1 -0
  70. package/dist/capability-registry.d.ts +262 -0
  71. package/dist/capability-registry.d.ts.map +1 -0
  72. package/dist/capability-registry.js +931 -0
  73. package/dist/capability-registry.js.map +1 -0
  74. package/dist/capability-registry.test.d.ts +2 -0
  75. package/dist/capability-registry.test.d.ts.map +1 -0
  76. package/dist/capability-registry.test.js +1683 -0
  77. package/dist/capability-registry.test.js.map +1 -0
  78. package/dist/capability-runner.d.ts +99 -0
  79. package/dist/capability-runner.d.ts.map +1 -0
  80. package/dist/capability-runner.js +608 -0
  81. package/dist/capability-runner.js.map +1 -0
  82. package/dist/capability-search-relevance.test.d.ts +2 -0
  83. package/dist/capability-search-relevance.test.d.ts.map +1 -0
  84. package/dist/capability-search-relevance.test.js +67 -0
  85. package/dist/capability-search-relevance.test.js.map +1 -0
  86. package/dist/capability-studio.d.ts +11 -0
  87. package/dist/capability-studio.d.ts.map +1 -0
  88. package/dist/capability-studio.js +593 -0
  89. package/dist/capability-studio.js.map +1 -0
  90. package/dist/capability-studio.test.d.ts +2 -0
  91. package/dist/capability-studio.test.d.ts.map +1 -0
  92. package/dist/capability-studio.test.js +41 -0
  93. package/dist/capability-studio.test.js.map +1 -0
  94. package/dist/cdp-log.d.ts +19 -0
  95. package/dist/cdp-log.d.ts.map +1 -0
  96. package/dist/cdp-log.js +83 -0
  97. package/dist/cdp-log.js.map +1 -0
  98. package/dist/cdp-log.test.d.ts +2 -0
  99. package/dist/cdp-log.test.d.ts.map +1 -0
  100. package/dist/cdp-log.test.js +109 -0
  101. package/dist/cdp-log.test.js.map +1 -0
  102. package/dist/cdp-relay.d.ts +19 -0
  103. package/dist/cdp-relay.d.ts.map +1 -0
  104. package/dist/cdp-relay.js +2375 -0
  105. package/dist/cdp-relay.js.map +1 -0
  106. package/dist/cdp-session.d.ts +37 -0
  107. package/dist/cdp-session.d.ts.map +1 -0
  108. package/dist/cdp-session.js +36 -0
  109. package/dist/cdp-session.js.map +1 -0
  110. package/dist/cdp-types.d.ts +65 -0
  111. package/dist/cdp-types.d.ts.map +1 -0
  112. package/dist/cdp-types.js +91 -0
  113. package/dist/cdp-types.js.map +1 -0
  114. package/dist/channel-owner-inspect.test.d.ts +2 -0
  115. package/dist/channel-owner-inspect.test.d.ts.map +1 -0
  116. package/dist/channel-owner-inspect.test.js +75 -0
  117. package/dist/channel-owner-inspect.test.js.map +1 -0
  118. package/dist/chrome-discovery.d.ts +65 -0
  119. package/dist/chrome-discovery.d.ts.map +1 -0
  120. package/dist/chrome-discovery.js +173 -0
  121. package/dist/chrome-discovery.js.map +1 -0
  122. package/dist/chrome-discovery.test.d.ts +2 -0
  123. package/dist/chrome-discovery.test.d.ts.map +1 -0
  124. package/dist/chrome-discovery.test.js +41 -0
  125. package/dist/chrome-discovery.test.js.map +1 -0
  126. package/dist/clean-html.d.ts +11 -0
  127. package/dist/clean-html.d.ts.map +1 -0
  128. package/dist/clean-html.js +106 -0
  129. package/dist/clean-html.js.map +1 -0
  130. package/dist/cli-help.test.d.ts +2 -0
  131. package/dist/cli-help.test.d.ts.map +1 -0
  132. package/dist/cli-help.test.js +98 -0
  133. package/dist/cli-help.test.js.map +1 -0
  134. package/dist/cli.d.ts +3 -0
  135. package/dist/cli.d.ts.map +1 -0
  136. package/dist/cli.js +2709 -0
  137. package/dist/cli.js.map +1 -0
  138. package/dist/cloud-client.d.ts +56 -0
  139. package/dist/cloud-client.d.ts.map +1 -0
  140. package/dist/cloud-client.js +127 -0
  141. package/dist/cloud-client.js.map +1 -0
  142. package/dist/create-logger.d.ts +9 -0
  143. package/dist/create-logger.d.ts.map +1 -0
  144. package/dist/create-logger.js +27 -0
  145. package/dist/create-logger.js.map +1 -0
  146. package/dist/debugger-api.md +458 -0
  147. package/dist/debugger-examples-types.d.ts +24 -0
  148. package/dist/debugger-examples-types.d.ts.map +1 -0
  149. package/dist/debugger-examples-types.js +2 -0
  150. package/dist/debugger-examples-types.js.map +1 -0
  151. package/dist/debugger-examples.d.ts +6 -0
  152. package/dist/debugger-examples.d.ts.map +1 -0
  153. package/dist/debugger-examples.js +53 -0
  154. package/dist/debugger-examples.js.map +1 -0
  155. package/dist/debugger.d.ts +381 -0
  156. package/dist/debugger.d.ts.map +1 -0
  157. package/dist/debugger.js +630 -0
  158. package/dist/debugger.js.map +1 -0
  159. package/dist/diff-utils.d.ts +20 -0
  160. package/dist/diff-utils.d.ts.map +1 -0
  161. package/dist/diff-utils.js +50 -0
  162. package/dist/diff-utils.js.map +1 -0
  163. package/dist/diff-utils.test.d.ts +2 -0
  164. package/dist/diff-utils.test.d.ts.map +1 -0
  165. package/dist/diff-utils.test.js +137 -0
  166. package/dist/diff-utils.test.js.map +1 -0
  167. package/dist/doctor.d.ts +44 -0
  168. package/dist/doctor.d.ts.map +1 -0
  169. package/dist/doctor.js +246 -0
  170. package/dist/doctor.js.map +1 -0
  171. package/dist/doctor.test.d.ts +2 -0
  172. package/dist/doctor.test.d.ts.map +1 -0
  173. package/dist/doctor.test.js +208 -0
  174. package/dist/doctor.test.js.map +1 -0
  175. package/dist/editor-api.md +374 -0
  176. package/dist/editor-examples.d.ts +11 -0
  177. package/dist/editor-examples.d.ts.map +1 -0
  178. package/dist/editor-examples.js +124 -0
  179. package/dist/editor-examples.js.map +1 -0
  180. package/dist/editor.d.ts +203 -0
  181. package/dist/editor.d.ts.map +1 -0
  182. package/dist/editor.js +363 -0
  183. package/dist/editor.js.map +1 -0
  184. package/dist/env-compat.d.ts +2 -0
  185. package/dist/env-compat.d.ts.map +1 -0
  186. package/dist/env-compat.js +27 -0
  187. package/dist/env-compat.js.map +1 -0
  188. package/dist/executor.d.ts +229 -0
  189. package/dist/executor.d.ts.map +1 -0
  190. package/dist/executor.js +1465 -0
  191. package/dist/executor.js.map +1 -0
  192. package/dist/executor.unit.test.d.ts +2 -0
  193. package/dist/executor.unit.test.d.ts.map +1 -0
  194. package/dist/executor.unit.test.js +143 -0
  195. package/dist/executor.unit.test.js.map +1 -0
  196. package/dist/extension/_locales/en/messages.json +278 -0
  197. package/dist/extension/_locales/zh_CN/messages.json +256 -0
  198. package/dist/extension/assets/options-CYH96Lcx.css +1349 -0
  199. package/dist/extension/background.js +3994 -0
  200. package/dist/extension/icons/SolarCursorSquareBold.png +0 -0
  201. package/dist/extension/icons/icon-black-128.png +0 -0
  202. package/dist/extension/icons/icon-black-16.png +0 -0
  203. package/dist/extension/icons/icon-black-32.png +0 -0
  204. package/dist/extension/icons/icon-black-48.png +0 -0
  205. package/dist/extension/icons/icon-gray-128.png +0 -0
  206. package/dist/extension/icons/icon-gray-16.png +0 -0
  207. package/dist/extension/icons/icon-gray-32.png +0 -0
  208. package/dist/extension/icons/icon-gray-48.png +0 -0
  209. package/dist/extension/icons/icon-green-128.png +0 -0
  210. package/dist/extension/icons/icon-green-16.png +0 -0
  211. package/dist/extension/icons/icon-green-32.png +0 -0
  212. package/dist/extension/icons/icon-green-48.png +0 -0
  213. package/dist/extension/icons/tabwright-icon-black.png +0 -0
  214. package/dist/extension/icons/tabwright-icon-gray-disabled.png +0 -0
  215. package/dist/extension/icons/tabwright-icon-gray-disabled.svg +1 -0
  216. package/dist/extension/manifest.json +54 -0
  217. package/dist/extension/options.js +16145 -0
  218. package/dist/extension/rrweb-recorder.js +12952 -0
  219. package/dist/extension/src/options.html +165 -0
  220. package/dist/extension/src/prism-bash.min.js +1 -0
  221. package/dist/extension/src/prism.min.js +1 -0
  222. package/dist/extension/src/welcome.html +396 -0
  223. package/dist/extension-connection.test.d.ts +2 -0
  224. package/dist/extension-connection.test.d.ts.map +1 -0
  225. package/dist/extension-connection.test.js +708 -0
  226. package/dist/extension-connection.test.js.map +1 -0
  227. package/dist/extension-icon-warning.test.d.ts +2 -0
  228. package/dist/extension-icon-warning.test.d.ts.map +1 -0
  229. package/dist/extension-icon-warning.test.js +33 -0
  230. package/dist/extension-icon-warning.test.js.map +1 -0
  231. package/dist/ghost-browser.d.ts +62 -0
  232. package/dist/ghost-browser.d.ts.map +1 -0
  233. package/dist/ghost-browser.js +107 -0
  234. package/dist/ghost-browser.js.map +1 -0
  235. package/dist/ghost-cursor-client.js +374 -0
  236. package/dist/ghost-cursor-controller.d.ts +46 -0
  237. package/dist/ghost-cursor-controller.d.ts.map +1 -0
  238. package/dist/ghost-cursor-controller.js +98 -0
  239. package/dist/ghost-cursor-controller.js.map +1 -0
  240. package/dist/ghost-cursor.d.ts +27 -0
  241. package/dist/ghost-cursor.d.ts.map +1 -0
  242. package/dist/ghost-cursor.js +79 -0
  243. package/dist/ghost-cursor.js.map +1 -0
  244. package/dist/htmlrewrite.d.ts +8 -0
  245. package/dist/htmlrewrite.d.ts.map +1 -0
  246. package/dist/htmlrewrite.js +339 -0
  247. package/dist/htmlrewrite.js.map +1 -0
  248. package/dist/htmlrewrite.test.d.ts +2 -0
  249. package/dist/htmlrewrite.test.d.ts.map +1 -0
  250. package/dist/htmlrewrite.test.js +7975 -0
  251. package/dist/htmlrewrite.test.js.map +1 -0
  252. package/dist/index.d.ts +20 -0
  253. package/dist/index.d.ts.map +1 -0
  254. package/dist/index.js +11 -0
  255. package/dist/index.js.map +1 -0
  256. package/dist/kill-port.d.ts +29 -0
  257. package/dist/kill-port.d.ts.map +1 -0
  258. package/dist/kill-port.js +190 -0
  259. package/dist/kill-port.js.map +1 -0
  260. package/dist/kitty-graphics.d.ts +22 -0
  261. package/dist/kitty-graphics.d.ts.map +1 -0
  262. package/dist/kitty-graphics.js +71 -0
  263. package/dist/kitty-graphics.js.map +1 -0
  264. package/dist/kitty-graphics.test.d.ts +2 -0
  265. package/dist/kitty-graphics.test.d.ts.map +1 -0
  266. package/dist/kitty-graphics.test.js +125 -0
  267. package/dist/kitty-graphics.test.js.map +1 -0
  268. package/dist/locator-selector.test.d.ts +2 -0
  269. package/dist/locator-selector.test.d.ts.map +1 -0
  270. package/dist/locator-selector.test.js +98 -0
  271. package/dist/locator-selector.test.js.map +1 -0
  272. package/dist/mcp-client.d.ts +20 -0
  273. package/dist/mcp-client.d.ts.map +1 -0
  274. package/dist/mcp-client.js +56 -0
  275. package/dist/mcp-client.js.map +1 -0
  276. package/dist/mcp.d.ts +6 -0
  277. package/dist/mcp.d.ts.map +1 -0
  278. package/dist/mcp.js +511 -0
  279. package/dist/mcp.js.map +1 -0
  280. package/dist/on-mouse-action.test.d.ts +2 -0
  281. package/dist/on-mouse-action.test.d.ts.map +1 -0
  282. package/dist/on-mouse-action.test.js +180 -0
  283. package/dist/on-mouse-action.test.js.map +1 -0
  284. package/dist/options-page.test.d.ts +2 -0
  285. package/dist/options-page.test.d.ts.map +1 -0
  286. package/dist/options-page.test.js +773 -0
  287. package/dist/options-page.test.js.map +1 -0
  288. package/dist/package-paths.d.ts +4 -0
  289. package/dist/package-paths.d.ts.map +1 -0
  290. package/dist/package-paths.js +30 -0
  291. package/dist/package-paths.js.map +1 -0
  292. package/dist/page-markdown.d.ts +40 -0
  293. package/dist/page-markdown.d.ts.map +1 -0
  294. package/dist/page-markdown.js +181 -0
  295. package/dist/page-markdown.js.map +1 -0
  296. package/dist/performance-examples.d.ts +5 -0
  297. package/dist/performance-examples.d.ts.map +1 -0
  298. package/dist/performance-examples.js +112 -0
  299. package/dist/performance-examples.js.map +1 -0
  300. package/dist/performance-profiling.md +417 -0
  301. package/dist/playwright-import.d.ts +19 -0
  302. package/dist/playwright-import.d.ts.map +1 -0
  303. package/dist/playwright-import.js +40 -0
  304. package/dist/playwright-import.js.map +1 -0
  305. package/dist/popup-relocation.test.d.ts +7 -0
  306. package/dist/popup-relocation.test.d.ts.map +1 -0
  307. package/dist/popup-relocation.test.js +139 -0
  308. package/dist/popup-relocation.test.js.map +1 -0
  309. package/dist/product-paths.d.ts +9 -0
  310. package/dist/product-paths.d.ts.map +1 -0
  311. package/dist/product-paths.js +24 -0
  312. package/dist/product-paths.js.map +1 -0
  313. package/dist/product-paths.test.d.ts +2 -0
  314. package/dist/product-paths.test.d.ts.map +1 -0
  315. package/dist/product-paths.test.js +39 -0
  316. package/dist/product-paths.test.js.map +1 -0
  317. package/dist/prompt.md +1004 -0
  318. package/dist/protocol.d.ts +248 -0
  319. package/dist/protocol.d.ts.map +1 -0
  320. package/dist/protocol.js +59 -0
  321. package/dist/protocol.js.map +1 -0
  322. package/dist/protocol.test.d.ts +2 -0
  323. package/dist/protocol.test.d.ts.map +1 -0
  324. package/dist/protocol.test.js +31 -0
  325. package/dist/protocol.test.js.map +1 -0
  326. package/dist/react-source.d.ts +57 -0
  327. package/dist/react-source.d.ts.map +1 -0
  328. package/dist/react-source.js +254 -0
  329. package/dist/react-source.js.map +1 -0
  330. package/dist/readability.js +1674 -0
  331. package/dist/relay-client.d.ts +104 -0
  332. package/dist/relay-client.d.ts.map +1 -0
  333. package/dist/relay-client.js +426 -0
  334. package/dist/relay-client.js.map +1 -0
  335. package/dist/relay-client.test.d.ts +2 -0
  336. package/dist/relay-client.test.d.ts.map +1 -0
  337. package/dist/relay-client.test.js +305 -0
  338. package/dist/relay-client.test.js.map +1 -0
  339. package/dist/relay-core.test.d.ts +2 -0
  340. package/dist/relay-core.test.d.ts.map +1 -0
  341. package/dist/relay-core.test.js +1427 -0
  342. package/dist/relay-core.test.js.map +1 -0
  343. package/dist/relay-navigation.test.d.ts +2 -0
  344. package/dist/relay-navigation.test.d.ts.map +1 -0
  345. package/dist/relay-navigation.test.js +661 -0
  346. package/dist/relay-navigation.test.js.map +1 -0
  347. package/dist/relay-session.test.d.ts +2 -0
  348. package/dist/relay-session.test.d.ts.map +1 -0
  349. package/dist/relay-session.test.js +1121 -0
  350. package/dist/relay-session.test.js.map +1 -0
  351. package/dist/relay-state.d.ts +178 -0
  352. package/dist/relay-state.d.ts.map +1 -0
  353. package/dist/relay-state.js +346 -0
  354. package/dist/relay-state.js.map +1 -0
  355. package/dist/relay-state.test.d.ts +2 -0
  356. package/dist/relay-state.test.d.ts.map +1 -0
  357. package/dist/relay-state.test.js +594 -0
  358. package/dist/relay-state.test.js.map +1 -0
  359. package/dist/replay-ai-index.d.ts +99 -0
  360. package/dist/replay-ai-index.d.ts.map +1 -0
  361. package/dist/replay-ai-index.js +677 -0
  362. package/dist/replay-ai-index.js.map +1 -0
  363. package/dist/replay-ai-index.test.d.ts +2 -0
  364. package/dist/replay-ai-index.test.d.ts.map +1 -0
  365. package/dist/replay-ai-index.test.js +255 -0
  366. package/dist/replay-ai-index.test.js.map +1 -0
  367. package/dist/replay-cli.test.d.ts +2 -0
  368. package/dist/replay-cli.test.d.ts.map +1 -0
  369. package/dist/replay-cli.test.js +275 -0
  370. package/dist/replay-cli.test.js.map +1 -0
  371. package/dist/replay-eval.d.ts +44 -0
  372. package/dist/replay-eval.d.ts.map +1 -0
  373. package/dist/replay-eval.js +902 -0
  374. package/dist/replay-eval.js.map +1 -0
  375. package/dist/replay-handoff.d.ts +29 -0
  376. package/dist/replay-handoff.d.ts.map +1 -0
  377. package/dist/replay-handoff.js +83 -0
  378. package/dist/replay-handoff.js.map +1 -0
  379. package/dist/replay-handoff.test.d.ts +2 -0
  380. package/dist/replay-handoff.test.d.ts.map +1 -0
  381. package/dist/replay-handoff.test.js +123 -0
  382. package/dist/replay-handoff.test.js.map +1 -0
  383. package/dist/replay-workflow-compiler.d.ts +44 -0
  384. package/dist/replay-workflow-compiler.d.ts.map +1 -0
  385. package/dist/replay-workflow-compiler.js +601 -0
  386. package/dist/replay-workflow-compiler.js.map +1 -0
  387. package/dist/replay-workflow-compiler.test.d.ts +2 -0
  388. package/dist/replay-workflow-compiler.test.d.ts.map +1 -0
  389. package/dist/replay-workflow-compiler.test.js +223 -0
  390. package/dist/replay-workflow-compiler.test.js.map +1 -0
  391. package/dist/rrweb-recording-relay.d.ts +56 -0
  392. package/dist/rrweb-recording-relay.d.ts.map +1 -0
  393. package/dist/rrweb-recording-relay.js +299 -0
  394. package/dist/rrweb-recording-relay.js.map +1 -0
  395. package/dist/rrweb-recording-relay.test.d.ts +2 -0
  396. package/dist/rrweb-recording-relay.test.d.ts.map +1 -0
  397. package/dist/rrweb-recording-relay.test.js +85 -0
  398. package/dist/rrweb-recording-relay.test.js.map +1 -0
  399. package/dist/rrweb-recording.d.ts +104 -0
  400. package/dist/rrweb-recording.d.ts.map +1 -0
  401. package/dist/rrweb-recording.js +180 -0
  402. package/dist/rrweb-recording.js.map +1 -0
  403. package/dist/scoped-fs.d.ts +95 -0
  404. package/dist/scoped-fs.d.ts.map +1 -0
  405. package/dist/scoped-fs.js +358 -0
  406. package/dist/scoped-fs.js.map +1 -0
  407. package/dist/scoped-fs.test.d.ts +5 -0
  408. package/dist/scoped-fs.test.d.ts.map +1 -0
  409. package/dist/scoped-fs.test.js +73 -0
  410. package/dist/scoped-fs.test.js.map +1 -0
  411. package/dist/selector-generator.js +7378 -0
  412. package/dist/skill-stub.test.d.ts +2 -0
  413. package/dist/skill-stub.test.d.ts.map +1 -0
  414. package/dist/skill-stub.test.js +22 -0
  415. package/dist/skill-stub.test.js.map +1 -0
  416. package/dist/snapshot-tools.test.d.ts +2 -0
  417. package/dist/snapshot-tools.test.d.ts.map +1 -0
  418. package/dist/snapshot-tools.test.js +856 -0
  419. package/dist/snapshot-tools.test.js.map +1 -0
  420. package/dist/start-relay-server.d.ts +6 -0
  421. package/dist/start-relay-server.d.ts.map +1 -0
  422. package/dist/start-relay-server.js +57 -0
  423. package/dist/start-relay-server.js.map +1 -0
  424. package/dist/styles-api.md +124 -0
  425. package/dist/styles-examples.d.ts +8 -0
  426. package/dist/styles-examples.d.ts.map +1 -0
  427. package/dist/styles-examples.js +64 -0
  428. package/dist/styles-examples.js.map +1 -0
  429. package/dist/styles.d.ts +27 -0
  430. package/dist/styles.d.ts.map +1 -0
  431. package/dist/styles.js +231 -0
  432. package/dist/styles.js.map +1 -0
  433. package/dist/tabwright-agent-skill.d.ts +30 -0
  434. package/dist/tabwright-agent-skill.d.ts.map +1 -0
  435. package/dist/tabwright-agent-skill.js +74 -0
  436. package/dist/tabwright-agent-skill.js.map +1 -0
  437. package/dist/tabwright-agent-skill.test.d.ts +2 -0
  438. package/dist/tabwright-agent-skill.test.d.ts.map +1 -0
  439. package/dist/tabwright-agent-skill.test.js +51 -0
  440. package/dist/tabwright-agent-skill.test.js.map +1 -0
  441. package/dist/test-declarations.d.ts +13 -0
  442. package/dist/test-declarations.d.ts.map +1 -0
  443. package/dist/test-declarations.js +2 -0
  444. package/dist/test-declarations.js.map +1 -0
  445. package/dist/test-utils.d.ts +69 -0
  446. package/dist/test-utils.d.ts.map +1 -0
  447. package/dist/test-utils.js +448 -0
  448. package/dist/test-utils.js.map +1 -0
  449. package/dist/test-utils.test.d.ts +2 -0
  450. package/dist/test-utils.test.d.ts.map +1 -0
  451. package/dist/test-utils.test.js +55 -0
  452. package/dist/test-utils.test.js.map +1 -0
  453. package/dist/utils.d.ts +26 -0
  454. package/dist/utils.d.ts.map +1 -0
  455. package/dist/utils.js +60 -0
  456. package/dist/utils.js.map +1 -0
  457. package/dist/wait-for-page-load.d.ts +16 -0
  458. package/dist/wait-for-page-load.d.ts.map +1 -0
  459. package/dist/wait-for-page-load.js +146 -0
  460. package/dist/wait-for-page-load.js.map +1 -0
  461. package/dist/workflow-capability.d.ts +72 -0
  462. package/dist/workflow-capability.d.ts.map +1 -0
  463. package/dist/workflow-capability.js +316 -0
  464. package/dist/workflow-capability.js.map +1 -0
  465. package/dist/workflow-script-flow.test.d.ts +2 -0
  466. package/dist/workflow-script-flow.test.d.ts.map +1 -0
  467. package/dist/workflow-script-flow.test.js +285 -0
  468. package/dist/workflow-script-flow.test.js.map +1 -0
  469. package/package.json +80 -0
  470. package/src/__snapshots__/x.com.processed.html +1003 -0
  471. package/src/__snapshots__/x.com.processed.withStyles.html +2720 -0
  472. package/src/a11y-client.ts +241 -0
  473. package/src/agent-skills/conan-config/SKILL.md +141 -0
  474. package/src/agent-skills/conan-config/agents/openai.yaml +4 -0
  475. package/src/aria-snapshot.test.ts +311 -0
  476. package/src/aria-snapshot.ts +1681 -0
  477. package/src/aria-snapshot.unit.test.ts +615 -0
  478. package/src/aria-snapshots/github-interactive.txt +193 -0
  479. package/src/aria-snapshots/github-raw.txt +309 -0
  480. package/src/aria-snapshots/hackernews-interactive.txt +477 -0
  481. package/src/aria-snapshots/hackernews-raw.txt +428 -0
  482. package/src/aria-snapshots/prosemirror-interactive.txt +66 -0
  483. package/src/aria-snapshots/prosemirror-raw.txt +145 -0
  484. package/src/assets/aria-labels-hacker-news.png +0 -0
  485. package/src/assets/aria-labels-old-reddit.png +0 -0
  486. package/src/assets/cursors/screen-studio/pointer-macos-tahoe-data-url.ts +5 -0
  487. package/src/assets/cursors/screen-studio/pointer-macos-tahoe.svg +18 -0
  488. package/src/assets/x.com.html +32946 -0
  489. package/src/browser-config.ts +179 -0
  490. package/src/browser-install.ts +284 -0
  491. package/src/browser-launch.ts +75 -0
  492. package/src/builtin-capabilities.ts +2765 -0
  493. package/src/capability-agent-skill.ts +305 -0
  494. package/src/capability-auth-state.ts +197 -0
  495. package/src/capability-auth.ts +249 -0
  496. package/src/capability-cli-confirmation.test.ts +90 -0
  497. package/src/capability-options.test.ts +89 -0
  498. package/src/capability-options.ts +57 -0
  499. package/src/capability-package.test.ts +204 -0
  500. package/src/capability-package.ts +555 -0
  501. package/src/capability-registry.test.ts +1905 -0
  502. package/src/capability-registry.ts +1234 -0
  503. package/src/capability-runner.ts +801 -0
  504. package/src/capability-search-relevance.test.ts +73 -0
  505. package/src/capability-studio.test.ts +45 -0
  506. package/src/capability-studio.ts +641 -0
  507. package/src/cdp-log.test.ts +131 -0
  508. package/src/cdp-log.ts +112 -0
  509. package/src/cdp-relay.ts +2944 -0
  510. package/src/cdp-session.ts +77 -0
  511. package/src/cdp-types.ts +158 -0
  512. package/src/channel-owner-inspect.test.ts +94 -0
  513. package/src/chrome-discovery.test.ts +50 -0
  514. package/src/chrome-discovery.ts +220 -0
  515. package/src/clean-html.ts +141 -0
  516. package/src/cli-help.test.ts +123 -0
  517. package/src/cli.ts +3181 -0
  518. package/src/cloud-client.ts +179 -0
  519. package/src/create-logger.ts +38 -0
  520. package/src/debugger-examples-types.ts +16 -0
  521. package/src/debugger-examples.ts +66 -0
  522. package/src/debugger.ts +708 -0
  523. package/src/diff-utils.test.ts +152 -0
  524. package/src/diff-utils.ts +70 -0
  525. package/src/doctor.test.ts +244 -0
  526. package/src/doctor.ts +321 -0
  527. package/src/editor-examples.ts +158 -0
  528. package/src/editor.ts +426 -0
  529. package/src/env-compat.ts +28 -0
  530. package/src/executor.ts +1824 -0
  531. package/src/executor.unit.test.ts +168 -0
  532. package/src/extension-connection.test.ts +855 -0
  533. package/src/extension-icon-warning.test.ts +45 -0
  534. package/src/ghost-browser.ts +149 -0
  535. package/src/ghost-cursor-client.ts +494 -0
  536. package/src/ghost-cursor-controller.ts +129 -0
  537. package/src/ghost-cursor.ts +123 -0
  538. package/src/htmlrewrite.test.ts +8008 -0
  539. package/src/htmlrewrite.ts +390 -0
  540. package/src/index.ts +53 -0
  541. package/src/kill-port.ts +219 -0
  542. package/src/kitty-graphics.test.ts +139 -0
  543. package/src/kitty-graphics.ts +79 -0
  544. package/src/locator-selector.test.ts +119 -0
  545. package/src/mcp-client.ts +78 -0
  546. package/src/mcp.ts +629 -0
  547. package/src/on-mouse-action.test.ts +226 -0
  548. package/src/options-page.test.ts +839 -0
  549. package/src/package-paths.ts +38 -0
  550. package/src/page-markdown.ts +240 -0
  551. package/src/performance-examples.ts +186 -0
  552. package/src/playwright-import.ts +59 -0
  553. package/src/popup-relocation.test.ts +163 -0
  554. package/src/product-paths.test.ts +47 -0
  555. package/src/product-paths.ts +28 -0
  556. package/src/protocol.test.ts +52 -0
  557. package/src/protocol.ts +351 -0
  558. package/src/react-source.ts +379 -0
  559. package/src/relay-client.test.ts +375 -0
  560. package/src/relay-client.ts +572 -0
  561. package/src/relay-core.test.ts +1603 -0
  562. package/src/relay-navigation.test.ts +790 -0
  563. package/src/relay-session.test.ts +1375 -0
  564. package/src/relay-state.test.ts +729 -0
  565. package/src/relay-state.ts +561 -0
  566. package/src/replay-ai-index.test.ts +278 -0
  567. package/src/replay-ai-index.ts +872 -0
  568. package/src/replay-cli.test.ts +325 -0
  569. package/src/replay-eval.ts +1039 -0
  570. package/src/replay-handoff.test.ts +163 -0
  571. package/src/replay-handoff.ts +109 -0
  572. package/src/replay-workflow-compiler.test.ts +250 -0
  573. package/src/replay-workflow-compiler.ts +700 -0
  574. package/src/resource.md +409 -0
  575. package/src/rrweb-recording-relay.test.ts +99 -0
  576. package/src/rrweb-recording-relay.ts +400 -0
  577. package/src/rrweb-recording.ts +322 -0
  578. package/src/scoped-fs.test.ts +80 -0
  579. package/src/scoped-fs.ts +420 -0
  580. package/src/skill-stub.test.ts +24 -0
  581. package/src/skill.md +1413 -0
  582. package/src/snapshot-tools.test.ts +1017 -0
  583. package/src/snapshots/hacker-news-accessibility-full.md +81 -0
  584. package/src/snapshots/hacker-news-accessibility-interactive.md +43 -0
  585. package/src/snapshots/page-markdown-output.txt +16 -0
  586. package/src/snapshots/shadcn-ui-accessibility-full.md +201 -0
  587. package/src/snapshots/shadcn-ui-accessibility-interactive.md +109 -0
  588. package/src/start-relay-server.ts +69 -0
  589. package/src/styles-examples.ts +84 -0
  590. package/src/styles.ts +343 -0
  591. package/src/tabwright-agent-skill.test.ts +61 -0
  592. package/src/tabwright-agent-skill.ts +105 -0
  593. package/src/test-declarations.ts +13 -0
  594. package/src/test-utils.test.ts +70 -0
  595. package/src/test-utils.ts +566 -0
  596. package/src/utils.ts +78 -0
  597. package/src/wait-for-page-load.ts +198 -0
  598. package/src/workflow-capability.ts +417 -0
  599. package/src/workflow-script-flow.test.ts +388 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relay-state.js","sourceRoot":"","sources":["../src/relay-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=relay-state.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relay-state.test.d.ts","sourceRoot":"","sources":["../src/relay-state.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,594 @@
1
+ /**
2
+ * Unit tests for relay state transitions.
3
+ * Data-in / data-out transitions for the unified extension map.
4
+ */
5
+ import { describe, test, expect, beforeAll, afterAll } from 'vitest';
6
+ import * as relayState from './relay-state.js';
7
+ import { CURRENT_EXTENSION_FEATURES } from './protocol.js';
8
+ // ---------------------------------------------------------------------------
9
+ // Helpers
10
+ // ---------------------------------------------------------------------------
11
+ function emptyState() {
12
+ return {
13
+ extensions: new Map(),
14
+ playwrightClients: new Map(),
15
+ };
16
+ }
17
+ function fakeWs() {
18
+ return {};
19
+ }
20
+ function makeTargetInfo(overrides = {}) {
21
+ return {
22
+ targetId: 'target-1',
23
+ type: 'page',
24
+ title: 'Test Page',
25
+ url: 'https://example.com',
26
+ attached: true,
27
+ canAccessOpener: false,
28
+ ...overrides,
29
+ };
30
+ }
31
+ function stateWithExtension(extensionId = 'ext-1', info = { browser: 'Chrome' }, stableKey = 'profile:chrome-1') {
32
+ return relayState.addExtension(emptyState(), { id: extensionId, info, stableKey, ws: fakeWs() });
33
+ }
34
+ // ---------------------------------------------------------------------------
35
+ // createRelayStore
36
+ // ---------------------------------------------------------------------------
37
+ describe('createRelayStore', () => {
38
+ test('creates store with empty maps', () => {
39
+ const store = relayState.createRelayStore();
40
+ const state = store.getState();
41
+ expect(state.extensions.size).toBe(0);
42
+ expect(state.playwrightClients.size).toBe(0);
43
+ });
44
+ });
45
+ describe('buildStableExtensionKey', () => {
46
+ test('uses install id before account identity so same-account profiles stay separate', () => {
47
+ const profiles = ['profile-a-install', 'profile-b-install'].map((installId) => {
48
+ return relayState.buildStableExtensionKey({
49
+ browser: 'Chrome',
50
+ email: 'tommy@example.com',
51
+ id: 'same-google-account-id',
52
+ installId,
53
+ }, 'connection-fallback');
54
+ });
55
+ expect(profiles).toMatchInlineSnapshot(`
56
+ [
57
+ "install:Chrome:profile-a-install",
58
+ "install:Chrome:profile-b-install",
59
+ ]
60
+ `);
61
+ });
62
+ test('falls back to account identity for older extensions without install ids', () => {
63
+ const key = relayState.buildStableExtensionKey({ browser: 'Chrome', email: 'tommy@example.com', id: 'google-account-id' }, 'connection-fallback');
64
+ expect(key).toMatchInlineSnapshot(`"profile:google-account-id"`);
65
+ });
66
+ });
67
+ describe('getExtensionNegotiationStatus', () => {
68
+ test('distinguishes legacy, limited, and ready feature handshakes', () => {
69
+ expect(relayState.getExtensionNegotiationStatus({ browser: 'Chrome' })).toEqual({
70
+ connectionHealth: 'legacy',
71
+ missingFeatures: [],
72
+ });
73
+ expect(relayState.getExtensionNegotiationStatus({ browser: 'Chrome', features: ['heartbeat-v1'] })).toMatchObject({
74
+ connectionHealth: 'limited',
75
+ missingFeatures: expect.arrayContaining(['rrweb-recording-v1']),
76
+ });
77
+ expect(relayState.getExtensionNegotiationStatus({
78
+ browser: 'Chrome',
79
+ features: [...CURRENT_EXTENSION_FEATURES],
80
+ })).toEqual({ connectionHealth: 'ready', missingFeatures: [] });
81
+ });
82
+ });
83
+ // ---------------------------------------------------------------------------
84
+ // addExtension / removeExtension
85
+ // ---------------------------------------------------------------------------
86
+ describe('addExtension', () => {
87
+ test('adds extension to empty state', () => {
88
+ const before = emptyState();
89
+ const after = relayState.addExtension(before, {
90
+ id: 'ext-1',
91
+ info: { browser: 'Chrome', protocolVersion: 1, features: ['heartbeat-v1'] },
92
+ stableKey: 'profile:chrome-1',
93
+ ws: fakeWs(),
94
+ });
95
+ expect(after.extensions.size).toBe(1);
96
+ const ext = after.extensions.get('ext-1');
97
+ expect(ext.stableKey).toBe('profile:chrome-1');
98
+ expect(ext.connectedTargets.size).toBe(0);
99
+ expect(ext.ws).toBeTruthy();
100
+ expect(ext.messageId).toBe(0);
101
+ expect(ext.pendingRequests.size).toBe(0);
102
+ expect(ext.pingInterval).toBeNull();
103
+ expect(ext.lastPongAt).toBeNull();
104
+ expect(ext.info).toMatchObject({ protocolVersion: 1, features: ['heartbeat-v1'] });
105
+ // Original unchanged (immutable)
106
+ expect(before.extensions.size).toBe(0);
107
+ });
108
+ test('adding extension with same stableKey keeps old entry (removed on socket close)', () => {
109
+ const s1 = relayState.addExtension(emptyState(), {
110
+ id: 'ext-old',
111
+ info: { browser: 'Chrome' },
112
+ stableKey: 'profile:chrome-1',
113
+ ws: fakeWs(),
114
+ });
115
+ const s2 = relayState.addExtension(s1, {
116
+ id: 'ext-new',
117
+ info: { browser: 'Chrome', email: 'test@example.com' },
118
+ stableKey: 'profile:chrome-1',
119
+ ws: fakeWs(),
120
+ });
121
+ // Both coexist — old stays routable until its socket closes
122
+ expect(s2.extensions.size).toBe(2);
123
+ expect(s2.extensions.has('ext-old')).toBe(true);
124
+ expect(s2.extensions.has('ext-new')).toBe(true);
125
+ // findExtensionByStableKey returns newest
126
+ expect(relayState.findExtensionByStableKey(s2, 'profile:chrome-1')?.id).toBe('ext-new');
127
+ // Original unchanged
128
+ expect(s1.extensions.size).toBe(1);
129
+ });
130
+ test('allows multiple extensions with different stableKeys', () => {
131
+ let state = emptyState();
132
+ state = relayState.addExtension(state, { id: 'ext-1', info: { browser: 'Chrome' }, stableKey: 'profile:a', ws: fakeWs() });
133
+ state = relayState.addExtension(state, { id: 'ext-2', info: { browser: 'Firefox' }, stableKey: 'profile:b', ws: fakeWs() });
134
+ expect(state.extensions.size).toBe(2);
135
+ });
136
+ });
137
+ describe('removeExtension', () => {
138
+ test('removes existing extension', () => {
139
+ const before = stateWithExtension('ext-1');
140
+ const after = relayState.removeExtension(before, { extensionId: 'ext-1' });
141
+ expect(after.extensions.size).toBe(0);
142
+ // Original unchanged
143
+ expect(before.extensions.size).toBe(1);
144
+ });
145
+ test('no-op for nonexistent extension', () => {
146
+ const before = stateWithExtension('ext-1');
147
+ const after = relayState.removeExtension(before, { extensionId: 'ext-999' });
148
+ expect(after).toBe(before); // Same reference — no allocation
149
+ });
150
+ test('also removes playwright clients bound to the extension', () => {
151
+ let state = stateWithExtension('ext-1');
152
+ state = relayState.addPlaywrightClient(state, { id: 'c1', extensionId: 'ext-1', ws: fakeWs() });
153
+ state = relayState.addPlaywrightClient(state, { id: 'c2', extensionId: 'ext-1', ws: fakeWs() });
154
+ state = relayState.addPlaywrightClient(state, { id: 'c3', extensionId: 'ext-2', ws: fakeWs() });
155
+ const after = relayState.removeExtension(state, { extensionId: 'ext-1' });
156
+ expect(after.extensions.size).toBe(0);
157
+ expect(after.playwrightClients.size).toBe(1);
158
+ expect(after.playwrightClients.has('c3')).toBe(true);
159
+ });
160
+ });
161
+ // ---------------------------------------------------------------------------
162
+ // addPlaywrightClient / removePlaywrightClient
163
+ // ---------------------------------------------------------------------------
164
+ describe('addPlaywrightClient', () => {
165
+ test('adds client with ws handle', () => {
166
+ const before = emptyState();
167
+ const ws = fakeWs();
168
+ const after = relayState.addPlaywrightClient(before, { id: 'client-1', extensionId: 'ext-1', ws });
169
+ expect(after.playwrightClients.size).toBe(1);
170
+ const client = after.playwrightClients.get('client-1');
171
+ expect(client.extensionId).toBe('ext-1');
172
+ expect(client.ws).toBe(ws);
173
+ expect(before.playwrightClients.size).toBe(0);
174
+ });
175
+ });
176
+ describe('removePlaywrightClient', () => {
177
+ test('removes client', () => {
178
+ const before = relayState.addPlaywrightClient(emptyState(), { id: 'c1', extensionId: null, ws: fakeWs() });
179
+ const after = relayState.removePlaywrightClient(before, { clientId: 'c1' });
180
+ expect(after.playwrightClients.size).toBe(0);
181
+ expect(before.playwrightClients.size).toBe(1);
182
+ });
183
+ test('no-op for nonexistent client', () => {
184
+ const before = emptyState();
185
+ const after = relayState.removePlaywrightClient(before, { clientId: 'nope' });
186
+ expect(after).toBe(before);
187
+ });
188
+ });
189
+ describe('extension heartbeat', () => {
190
+ test('keeps a responsive extension connected', () => {
191
+ let state = stateWithExtension('ext-1');
192
+ state = relayState.updateExtensionIO(state, { extensionId: 'ext-1', lastPongAt: 10_000 });
193
+ expect(relayState.hasExtensionHeartbeatExpired({
194
+ lastPongAt: state.extensions.get('ext-1')?.lastPongAt ?? null,
195
+ now: 24_999,
196
+ })).toBe(false);
197
+ });
198
+ test('expires an extension after a pong becomes stale', () => {
199
+ expect(relayState.hasExtensionHeartbeatExpired({
200
+ lastPongAt: 10_000,
201
+ now: 25_001,
202
+ })).toBe(true);
203
+ });
204
+ test('keeps legacy extensions that have never sent pong connected', () => {
205
+ expect(relayState.hasExtensionHeartbeatExpired({
206
+ lastPongAt: null,
207
+ now: Number.MAX_SAFE_INTEGER,
208
+ })).toBe(false);
209
+ });
210
+ });
211
+ describe('extension I/O fields', () => {
212
+ test('adds and removes pending extension requests', () => {
213
+ let state = stateWithExtension('ext-1');
214
+ const pending = {
215
+ resolve: (_result) => {
216
+ return;
217
+ },
218
+ reject: (_error) => {
219
+ return;
220
+ },
221
+ };
222
+ state = relayState.addExtensionPendingRequest(state, {
223
+ extensionId: 'ext-1',
224
+ requestId: 7,
225
+ pendingRequest: pending,
226
+ });
227
+ expect(state.extensions.get('ext-1')?.pendingRequests.get(7)).toBe(pending);
228
+ state = relayState.removeExtensionPendingRequest(state, { extensionId: 'ext-1', requestId: 7 });
229
+ expect(state.extensions.get('ext-1')?.pendingRequests.has(7)).toBe(false);
230
+ });
231
+ test('updateExtensionIO updates ws, pingInterval, and lastPongAt', () => {
232
+ let state = stateWithExtension('ext-1');
233
+ expect(state.extensions.get('ext-1')?.pingInterval).toBeNull();
234
+ expect(state.extensions.get('ext-1')?.lastPongAt).toBeNull();
235
+ const interval = setInterval(() => { }, 99999);
236
+ try {
237
+ state = relayState.updateExtensionIO(state, { extensionId: 'ext-1', pingInterval: interval });
238
+ expect(state.extensions.get('ext-1')?.pingInterval).toBe(interval);
239
+ state = relayState.updateExtensionIO(state, { extensionId: 'ext-1', lastPongAt: 1234 });
240
+ expect(state.extensions.get('ext-1')?.lastPongAt).toBe(1234);
241
+ state = relayState.updateExtensionIO(state, { extensionId: 'ext-1', pingInterval: null });
242
+ expect(state.extensions.get('ext-1')?.pingInterval).toBeNull();
243
+ }
244
+ finally {
245
+ clearInterval(interval);
246
+ }
247
+ });
248
+ test('playwright client ws handle is co-located with state', () => {
249
+ let state = emptyState();
250
+ const ws = fakeWs();
251
+ state = relayState.addPlaywrightClient(state, { id: 'c1', extensionId: null, ws });
252
+ expect(state.playwrightClients.get('c1')?.ws).toBe(ws);
253
+ state = relayState.removePlaywrightClient(state, { clientId: 'c1' });
254
+ expect(state.playwrightClients.size).toBe(0);
255
+ });
256
+ });
257
+ describe('rebindClientsToExtension', () => {
258
+ test('rebinds all clients from old extension to successor extension', () => {
259
+ let state = stateWithExtension('ext-old');
260
+ state = relayState.addExtension(state, {
261
+ id: 'ext-new',
262
+ info: { browser: 'Chrome' },
263
+ stableKey: 'profile:chrome-1',
264
+ ws: fakeWs(),
265
+ });
266
+ state = relayState.addPlaywrightClient(state, { id: 'c1', extensionId: 'ext-old', ws: fakeWs() });
267
+ state = relayState.addPlaywrightClient(state, { id: 'c2', extensionId: 'ext-old', ws: fakeWs() });
268
+ state = relayState.addPlaywrightClient(state, { id: 'c3', extensionId: 'ext-new', ws: fakeWs() });
269
+ const after = relayState.rebindClientsToExtension(state, {
270
+ fromExtensionId: 'ext-old',
271
+ toExtensionId: 'ext-new',
272
+ });
273
+ expect(after.playwrightClients.get('c1')?.extensionId).toBe('ext-new');
274
+ expect(after.playwrightClients.get('c2')?.extensionId).toBe('ext-new');
275
+ expect(after.playwrightClients.get('c3')?.extensionId).toBe('ext-new');
276
+ });
277
+ });
278
+ // ---------------------------------------------------------------------------
279
+ // addTarget / removeTarget / removeTargetByCrash
280
+ // ---------------------------------------------------------------------------
281
+ describe('addTarget', () => {
282
+ test('adds target to extension', () => {
283
+ const before = stateWithExtension('ext-1');
284
+ const targetInfo = makeTargetInfo();
285
+ const after = relayState.addTarget(before, {
286
+ extensionId: 'ext-1',
287
+ sessionId: 'pw-tab-1',
288
+ targetId: 'target-1',
289
+ targetInfo,
290
+ });
291
+ const ext = after.extensions.get('ext-1');
292
+ expect(ext.connectedTargets.size).toBe(1);
293
+ expect(ext.connectedTargets.get('pw-tab-1')?.targetId).toBe('target-1');
294
+ // Original unchanged
295
+ expect(before.extensions.get('ext-1').connectedTargets.size).toBe(0);
296
+ });
297
+ test('no-op if extension does not exist', () => {
298
+ const before = emptyState();
299
+ const after = relayState.addTarget(before, {
300
+ extensionId: 'ext-nope',
301
+ sessionId: 'pw-tab-1',
302
+ targetId: 'target-1',
303
+ targetInfo: makeTargetInfo(),
304
+ });
305
+ expect(after).toBe(before);
306
+ });
307
+ test('preserves existing frameIds on update', () => {
308
+ let state = stateWithExtension('ext-1');
309
+ state = relayState.addTarget(state, {
310
+ extensionId: 'ext-1',
311
+ sessionId: 'pw-tab-1',
312
+ targetId: 'target-1',
313
+ targetInfo: makeTargetInfo(),
314
+ existingFrameIds: new Set(['frame-A']),
315
+ });
316
+ // Update the same target with new targetInfo but no explicit frameIds
317
+ state = relayState.addTarget(state, {
318
+ extensionId: 'ext-1',
319
+ sessionId: 'pw-tab-1',
320
+ targetId: 'target-1',
321
+ targetInfo: makeTargetInfo({ url: 'https://updated.com' }),
322
+ });
323
+ const target = state.extensions.get('ext-1').connectedTargets.get('pw-tab-1');
324
+ expect(target.targetInfo.url).toBe('https://updated.com');
325
+ expect(target.frameIds.has('frame-A')).toBe(true);
326
+ });
327
+ });
328
+ describe('removeTarget', () => {
329
+ test('removes target by sessionId', () => {
330
+ let state = stateWithExtension('ext-1');
331
+ state = relayState.addTarget(state, {
332
+ extensionId: 'ext-1',
333
+ sessionId: 'pw-tab-1',
334
+ targetId: 'target-1',
335
+ targetInfo: makeTargetInfo(),
336
+ });
337
+ const after = relayState.removeTarget(state, { extensionId: 'ext-1', sessionId: 'pw-tab-1' });
338
+ expect(after.extensions.get('ext-1').connectedTargets.size).toBe(0);
339
+ });
340
+ test('no-op if target does not exist', () => {
341
+ const before = stateWithExtension('ext-1');
342
+ const after = relayState.removeTarget(before, { extensionId: 'ext-1', sessionId: 'pw-tab-nope' });
343
+ expect(after).toBe(before);
344
+ });
345
+ });
346
+ describe('removeTargetByCrash', () => {
347
+ test('removes target by targetId', () => {
348
+ let state = stateWithExtension('ext-1');
349
+ state = relayState.addTarget(state, {
350
+ extensionId: 'ext-1',
351
+ sessionId: 'pw-tab-1',
352
+ targetId: 'target-1',
353
+ targetInfo: makeTargetInfo(),
354
+ });
355
+ const after = relayState.removeTargetByCrash(state, { extensionId: 'ext-1', targetId: 'target-1' });
356
+ expect(after.extensions.get('ext-1').connectedTargets.size).toBe(0);
357
+ });
358
+ test('no-op if targetId not found', () => {
359
+ const before = stateWithExtension('ext-1');
360
+ const after = relayState.removeTargetByCrash(before, { extensionId: 'ext-1', targetId: 'nope' });
361
+ expect(after).toBe(before);
362
+ });
363
+ });
364
+ // ---------------------------------------------------------------------------
365
+ // updateTargetInfo
366
+ // ---------------------------------------------------------------------------
367
+ describe('updateTargetInfo', () => {
368
+ test('updates targetInfo matched by targetId', () => {
369
+ let state = stateWithExtension('ext-1');
370
+ state = relayState.addTarget(state, {
371
+ extensionId: 'ext-1',
372
+ sessionId: 'pw-tab-1',
373
+ targetId: 'target-1',
374
+ targetInfo: makeTargetInfo({ title: 'Old Title' }),
375
+ });
376
+ const newInfo = makeTargetInfo({ title: 'New Title' });
377
+ const after = relayState.updateTargetInfo(state, { extensionId: 'ext-1', targetInfo: newInfo });
378
+ expect(after.extensions.get('ext-1').connectedTargets.get('pw-tab-1').targetInfo.title).toBe('New Title');
379
+ // Original unchanged
380
+ expect(state.extensions.get('ext-1').connectedTargets.get('pw-tab-1').targetInfo.title).toBe('Old Title');
381
+ });
382
+ });
383
+ // ---------------------------------------------------------------------------
384
+ // addFrameId / removeFrameId
385
+ // ---------------------------------------------------------------------------
386
+ describe('addFrameId', () => {
387
+ test('adds frameId to target', () => {
388
+ let state = stateWithExtension('ext-1');
389
+ state = relayState.addTarget(state, {
390
+ extensionId: 'ext-1',
391
+ sessionId: 'pw-tab-1',
392
+ targetId: 'target-1',
393
+ targetInfo: makeTargetInfo(),
394
+ });
395
+ const after = relayState.addFrameId(state, { extensionId: 'ext-1', sessionId: 'pw-tab-1', frameId: 'frame-1' });
396
+ expect(after.extensions.get('ext-1').connectedTargets.get('pw-tab-1').frameIds.has('frame-1')).toBe(true);
397
+ });
398
+ test('no-op if frameId already present', () => {
399
+ let state = stateWithExtension('ext-1');
400
+ state = relayState.addTarget(state, {
401
+ extensionId: 'ext-1',
402
+ sessionId: 'pw-tab-1',
403
+ targetId: 'target-1',
404
+ targetInfo: makeTargetInfo(),
405
+ });
406
+ state = relayState.addFrameId(state, { extensionId: 'ext-1', sessionId: 'pw-tab-1', frameId: 'frame-1' });
407
+ const after = relayState.addFrameId(state, { extensionId: 'ext-1', sessionId: 'pw-tab-1', frameId: 'frame-1' });
408
+ expect(after).toBe(state); // Same reference
409
+ });
410
+ });
411
+ describe('removeFrameId', () => {
412
+ test('removes frameId from owning target', () => {
413
+ let state = stateWithExtension('ext-1');
414
+ state = relayState.addTarget(state, {
415
+ extensionId: 'ext-1',
416
+ sessionId: 'pw-tab-1',
417
+ targetId: 'target-1',
418
+ targetInfo: makeTargetInfo(),
419
+ });
420
+ state = relayState.addFrameId(state, { extensionId: 'ext-1', sessionId: 'pw-tab-1', frameId: 'frame-1' });
421
+ const after = relayState.removeFrameId(state, { extensionId: 'ext-1', frameId: 'frame-1' });
422
+ expect(after.extensions.get('ext-1').connectedTargets.get('pw-tab-1').frameIds.has('frame-1')).toBe(false);
423
+ });
424
+ test('no-op if frameId not found', () => {
425
+ const before = stateWithExtension('ext-1');
426
+ const after = relayState.removeFrameId(before, { extensionId: 'ext-1', frameId: 'nope' });
427
+ expect(after).toBe(before);
428
+ });
429
+ });
430
+ // ---------------------------------------------------------------------------
431
+ // updateTargetUrl
432
+ // ---------------------------------------------------------------------------
433
+ describe('updateTargetUrl', () => {
434
+ test('frameNavigated on top-level frame updates URL and title', () => {
435
+ let state = stateWithExtension('ext-1');
436
+ state = relayState.addTarget(state, {
437
+ extensionId: 'ext-1',
438
+ sessionId: 'pw-tab-1',
439
+ targetId: 'target-1',
440
+ targetInfo: makeTargetInfo({ url: 'https://old.com', title: 'Old' }),
441
+ });
442
+ const after = relayState.updateTargetUrl(state, {
443
+ extensionId: 'ext-1',
444
+ sessionId: 'pw-tab-1',
445
+ url: 'https://new.com',
446
+ title: 'New Page',
447
+ });
448
+ const target = after.extensions.get('ext-1').connectedTargets.get('pw-tab-1');
449
+ expect(target.targetInfo.url).toBe('https://new.com');
450
+ expect(target.targetInfo.title).toBe('New Page');
451
+ });
452
+ test('navigatedWithinDocument updates URL only (no title)', () => {
453
+ let state = stateWithExtension('ext-1');
454
+ state = relayState.addTarget(state, {
455
+ extensionId: 'ext-1',
456
+ sessionId: 'pw-tab-1',
457
+ targetId: 'target-1',
458
+ targetInfo: makeTargetInfo({ url: 'https://example.com', title: 'Keep This' }),
459
+ });
460
+ const after = relayState.updateTargetUrl(state, {
461
+ extensionId: 'ext-1',
462
+ sessionId: 'pw-tab-1',
463
+ url: 'https://example.com/new-path',
464
+ });
465
+ const target = after.extensions.get('ext-1').connectedTargets.get('pw-tab-1');
466
+ expect(target.targetInfo.url).toBe('https://example.com/new-path');
467
+ expect(target.targetInfo.title).toBe('Keep This');
468
+ });
469
+ test('no-op if target does not exist', () => {
470
+ const before = stateWithExtension('ext-1');
471
+ const after = relayState.updateTargetUrl(before, {
472
+ extensionId: 'ext-1',
473
+ sessionId: 'pw-tab-nope',
474
+ url: 'https://example.com',
475
+ });
476
+ expect(after).toBe(before);
477
+ });
478
+ });
479
+ // ---------------------------------------------------------------------------
480
+ // Derivation helpers
481
+ // ---------------------------------------------------------------------------
482
+ describe('findExtensionByStableKey', () => {
483
+ test('finds extension by stableKey', () => {
484
+ const state = stateWithExtension('ext-1', { browser: 'Chrome' }, 'profile:chrome-1');
485
+ const found = relayState.findExtensionByStableKey(state, 'profile:chrome-1');
486
+ expect(found?.id).toBe('ext-1');
487
+ });
488
+ test('returns undefined if not found', () => {
489
+ const state = emptyState();
490
+ expect(relayState.findExtensionByStableKey(state, 'profile:nope')).toBeUndefined();
491
+ });
492
+ });
493
+ describe('findExtensionIdByCdpSession', () => {
494
+ test('finds extension owning a CDP sessionId', () => {
495
+ let state = stateWithExtension('ext-1');
496
+ state = relayState.addTarget(state, {
497
+ extensionId: 'ext-1',
498
+ sessionId: 'pw-tab-1',
499
+ targetId: 'target-1',
500
+ targetInfo: makeTargetInfo(),
501
+ });
502
+ expect(relayState.findExtensionIdByCdpSession(state, 'pw-tab-1')).toBe('ext-1');
503
+ });
504
+ test('returns null if session not found', () => {
505
+ const state = stateWithExtension('ext-1');
506
+ expect(relayState.findExtensionIdByCdpSession(state, 'pw-tab-nope')).toBeNull();
507
+ });
508
+ });
509
+ // ---------------------------------------------------------------------------
510
+ // Zustand store integration
511
+ // ---------------------------------------------------------------------------
512
+ describe('store.setState with transitions', () => {
513
+ test('setState updates store atomically', () => {
514
+ const store = relayState.createRelayStore();
515
+ store.setState((s) => {
516
+ return relayState.addExtension(s, { id: 'ext-1', info: { browser: 'Chrome' }, stableKey: 'profile:1', ws: fakeWs() });
517
+ });
518
+ expect(store.getState().extensions.size).toBe(1);
519
+ });
520
+ test('chained transitions compose correctly', () => {
521
+ const store = relayState.createRelayStore();
522
+ store.setState((s) => {
523
+ let next = relayState.addExtension(s, { id: 'ext-1', info: {}, stableKey: 'k1', ws: fakeWs() });
524
+ next = relayState.addTarget(next, {
525
+ extensionId: 'ext-1',
526
+ sessionId: 'pw-tab-1',
527
+ targetId: 'target-1',
528
+ targetInfo: makeTargetInfo(),
529
+ });
530
+ next = relayState.addPlaywrightClient(next, { id: 'c1', extensionId: 'ext-1', ws: fakeWs() });
531
+ return next;
532
+ });
533
+ const state = store.getState();
534
+ expect(state.extensions.get('ext-1').connectedTargets.size).toBe(1);
535
+ expect(state.playwrightClients.size).toBe(1);
536
+ });
537
+ });
538
+ // ---------------------------------------------------------------------------
539
+ // DNS rebinding protection — Host header validation
540
+ // Node.js fetch/undici treats Host as a forbidden header, so we use the raw
541
+ // http module to send requests with arbitrary Host values.
542
+ // ---------------------------------------------------------------------------
543
+ import http from 'node:http';
544
+ function httpGet({ port, path, host }) {
545
+ return new Promise((resolve, reject) => {
546
+ const req = http.request({ hostname: '127.0.0.1', port, path, method: 'GET', headers: { Host: host } }, (res) => {
547
+ let body = '';
548
+ res.on('data', (chunk) => {
549
+ body += chunk.toString();
550
+ });
551
+ res.on('end', () => {
552
+ resolve({ status: res.statusCode, body });
553
+ });
554
+ });
555
+ req.on('error', reject);
556
+ req.end();
557
+ });
558
+ }
559
+ describe('Host header validation (DNS rebinding protection)', () => {
560
+ let server = null;
561
+ const TEST_PORT = 19996;
562
+ beforeAll(async () => {
563
+ const { startTabwrightCDPRelayServer } = await import('./cdp-relay.js');
564
+ server = await startTabwrightCDPRelayServer({ port: TEST_PORT });
565
+ });
566
+ afterAll(async () => {
567
+ server?.close();
568
+ server = null;
569
+ });
570
+ test('rejects requests with non-localhost Host header', async () => {
571
+ // DNS rebinding: evil.com resolves to 127.0.0.1
572
+ const res = await httpGet({ port: TEST_PORT, path: '/', host: 'evil.com' });
573
+ expect(res.status).toBe(403);
574
+ expect(res.body).toContain('Invalid Host header');
575
+ // With port suffix
576
+ const res2 = await httpGet({ port: TEST_PORT, path: '/version', host: 'evil.com:19996' });
577
+ expect(res2.status).toBe(403);
578
+ });
579
+ test('allows requests with localhost Host headers', async () => {
580
+ const localhostVariants = [
581
+ `localhost:${TEST_PORT}`,
582
+ `127.0.0.1:${TEST_PORT}`,
583
+ `[::1]:${TEST_PORT}`,
584
+ 'localhost',
585
+ '127.0.0.1',
586
+ 'LOCALHOST',
587
+ ];
588
+ for (const hostValue of localhostVariants) {
589
+ const res = await httpGet({ port: TEST_PORT, path: '/', host: hostValue });
590
+ expect(res.status, `Expected 200 for Host: ${hostValue}`).toBe(200);
591
+ }
592
+ });
593
+ });
594
+ //# sourceMappingURL=relay-state.test.js.map