@rushstack/playwright-browser-tunnel 0.1.0

package/.rush/temp/chunked-rush-logs/playwright-browser-tunnel._phase_build.chunks.jsonl

@@ -0,0 +1,8 @@
+{"kind":"O","text":"Invoking: heft run --only build -- --clean --production\n"}
+{"kind":"O","text":" ---- build started ---- \n"}
+{"kind":"O","text":"[build:typescript] Using TypeScript version 5.8.2\n"}
+{"kind":"O","text":"[build:lint] Using ESLint version 9.37.0\n"}
+{"kind":"O","text":"[build:api-extractor] Using API Extractor version 7.55.5\n"}
+{"kind":"O","text":"[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2\n"}
+{"kind":"O","text":" ---- build finished (22.696s) ---- \n"}
+{"kind":"O","text":"\u001b[1m\u001b[32m-------------------- Finished (22.704s) --------------------\u001b[39m\u001b[22m\n"}

package/.rush/temp/operation/_phase_build/all.log

@@ -0,0 +1,8 @@
+Invoking: heft run --only build -- --clean --production
+ ---- build started ---- 
+[build:typescript] Using TypeScript version 5.8.2
+[build:lint] Using ESLint version 9.37.0
+[build:api-extractor] Using API Extractor version 7.55.5
+[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2
+ ---- build finished (22.696s) ---- 
+-------------------- Finished (22.704s) --------------------

package/.rush/temp/operation/_phase_build/log-chunks.jsonl

@@ -0,0 +1,8 @@
+{"kind":"O","text":"Invoking: heft run --only build -- --clean --production\n"}
+{"kind":"O","text":" ---- build started ---- \n"}
+{"kind":"O","text":"[build:typescript] Using TypeScript version 5.8.2\n"}
+{"kind":"O","text":"[build:lint] Using ESLint version 9.37.0\n"}
+{"kind":"O","text":"[build:api-extractor] Using API Extractor version 7.55.5\n"}
+{"kind":"O","text":"[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2\n"}
+{"kind":"O","text":" ---- build finished (22.696s) ---- \n"}
+{"kind":"O","text":"\u001b[1m\u001b[32m-------------------- Finished (22.704s) --------------------\u001b[39m\u001b[22m\n"}

package/.rush/temp/operation/_phase_build/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 23874.630682000017
+}

package/.rush/temp/rushstack+playwright-browser-tunnel-_phase_build-83a085f61cdc0a4bb81c20aa939830fc5b5cff2f.tar.log

@@ -0,0 +1,42 @@
+Start time: Sat Jan 24 2026 01:09:00 GMT+0000 (Coordinated Universal Time)
+Invoking "/usr/bin/tar -c -f /mnt/vss/_work/1/s/common/temp/build-cache/rushstack+playwright-browser-tunnel-_phase_build-83a085f61cdc0a4bb81c20aa939830fc5b5cff2f-a7eb0343c78a82a6.temp -z --files-from=-"
+
+======= BEGIN PROCESS INPUT ======
+.rush/temp/operation/_phase_build/all.log
+.rush/temp/operation/_phase_build/log-chunks.jsonl
+.rush/temp/operation/_phase_build/state.json
+dist/playwright-browser-tunnel.d.ts
+lib/HttpServer.d.ts
+lib/HttpServer.d.ts.map
+lib/HttpServer.js
+lib/HttpServer.js.map
+lib/LaunchOptionsValidator.d.ts
+lib/LaunchOptionsValidator.d.ts.map
+lib/LaunchOptionsValidator.js
+lib/LaunchOptionsValidator.js.map
+lib/PlaywrightBrowserTunnel.d.ts
+lib/PlaywrightBrowserTunnel.d.ts.map
+lib/PlaywrightBrowserTunnel.js
+lib/PlaywrightBrowserTunnel.js.map
+lib/index.d.ts
+lib/index.d.ts.map
+lib/index.js
+lib/index.js.map
+lib/tsdoc-metadata.json
+lib/tunneledBrowserConnection.d.ts
+lib/tunneledBrowserConnection.d.ts.map
+lib/tunneledBrowserConnection.js
+lib/tunneledBrowserConnection.js.map
+lib/utilities.d.ts
+lib/utilities.d.ts.map
+lib/utilities.js
+lib/utilities.js.map
+temp/build/lint/_eslint-5eVG3S6w.json
+temp/build/lint/lint.sarif
+temp/build/typescript/ts_l9Fw4VUO.json
+temp/playwright-browser-tunnel.api.md
+======== END PROCESS INPUT =======
+======= BEGIN PROCESS OUTPUT =======
+======== END PROCESS OUTPUT ========
+
+Exited with code "0"

package/.rush/temp/shrinkwrap-deps.json

@@ -0,0 +1,104 @@
+{
+  "../../../apps/playwright-browser-tunnel": "../../../apps/playwright-browser-tunnel:VAFT2Uck1psUu/wgAGu6FEIRmrknNzLBuqYSnDfdQcE=:",
+  "@eslint-community/eslint-utils@4.9.1(eslint@9.37.0)": "@eslint-community/eslint-utils@4.9.1(eslint@9.37.0):pV7d94Vt5clzbavGnpkK+61F+5rS6yhGRWSY9HuA0As=:",
+  "@eslint-community/regexpp@4.12.2": "@eslint-community/regexpp@4.12.2:uyU80Ai40ZGDQuC92buVjo14SacTIk973Fr0MVtegFM=:",
+  "@eslint/config-array@0.21.1(supports-color@8.1.1)": "@eslint/config-array@0.21.1(supports-color@8.1.1):BjPPdCV5Gps4AZbqok+KhAPNwYuYHqaV7Ykl9pzMX+8=:",
+  "@eslint/config-helpers@0.4.2": "@eslint/config-helpers@0.4.2:OQdwP6BWyWIP2cHcj6QsSKp4aZLy4SIvBcCT09oBoBQ=:",
+  "@eslint/core@0.16.0": "@eslint/core@0.16.0:uzexS4qhmTDm8p5iApsOFpljpWgc7qKg9r9GGqrWzEE=:",
+  "@eslint/core@0.17.0": "@eslint/core@0.17.0:cHGqSr/9YApIhRP1zR3cifWv6FHEI/8z3xArH1WgAmE=:",
+  "@eslint/eslintrc@3.3.3(supports-color@8.1.1)": "@eslint/eslintrc@3.3.3(supports-color@8.1.1):ShwO2tSNyy1rB84VRfRN2uZ9v6C8pnoNqEGUth4xQAA=:",
+  "@eslint/js@9.37.0": "@eslint/js@9.37.0:1lHv+cylTPmaROJN1v+8t/cCOs2jawM8vupYMA3wfiw=:",
+  "@eslint/object-schema@2.1.7": "@eslint/object-schema@2.1.7:jSARpbAJ2LddSiVdJ/haY5BZQWoFbBzpJbgwBNzsK/Q=:",
+  "@eslint/plugin-kit@0.4.1": "@eslint/plugin-kit@0.4.1:U6S4UH9ougLAXu8snBF6KcGRAXOoHRNhy7UdpKr7P6M=:",
+  "@humanfs/core@0.19.1": "@humanfs/core@0.19.1:wVMMJ7xR7qZsFBWq1CxNkTDgR8snl9RoLZ4sH6O/HZM=:",
+  "@humanfs/node@0.16.7": "@humanfs/node@0.16.7:xINqZCR6kwIO6xT8DoNiqgB3td5hBnIvvaDgHS4UdEY=:",
+  "@humanwhocodes/module-importer@1.0.1": "@humanwhocodes/module-importer@1.0.1:fCoQC76P4Q2f226CjJ4vv5EpSL0Ainb2lbdIe97K1Rc=:",
+  "@humanwhocodes/retry@0.4.3": "@humanwhocodes/retry@0.4.3:dWob8oSma9FiVHp6V9fD4fB7S4qF4lhJOj7e6ZgdmOs=:",
+  "@playwright/test@1.56.1": "@playwright/test@1.56.1:pdUlT2QUyr1MoKBMsmPf1zstnjAlhS+SR4uhJlcPhtA=:",
+  "@types/estree@1.0.8": "@types/estree@1.0.8:727QzLEbjgy3FW8Yk/uPIap1d/zZp1OEZ2HILIT9sT0=:",
+  "@types/json-schema@7.0.15": "@types/json-schema@7.0.15:5S/TXvz5YP0wDZWCWUSdt1XDMkd9xx63ujRzhL/gHU4=:",
+  "@types/node@20.17.19": "@types/node@20.17.19:+6KIVq7zX8nA6B25Ngx73W26GCcLlrkrFk5GaNt15ho=:",
+  "@types/node@22.9.3": "@types/node@22.9.3:t0gtGlLs8WG40aHdH+VfugJr0QpnJsBHUeDRLsN/E8g=:",
+  "@types/semver@7.5.0": "@types/semver@7.5.0:cBnHv74/WywAe4Zc8V2nX4hcYm21FBnW+Vl+YpY+Hhs=:",
+  "@types/ws@8.5.5": "@types/ws@8.5.5:g2S9VjIbuP2mC6EXAo7J60f4Qi2dwQb38JH8iHn6cn8=:",
+  "acorn-jsx@5.3.2(acorn@8.15.0)": "acorn-jsx@5.3.2(acorn@8.15.0):fYH9IGa681Wprd2CRN1aUjancVsqumDOmywpFTf5AtI=:",
+  "acorn@8.15.0": "acorn@8.15.0:mx7eZhL1y7nHABvAD/MxE7xMMjwGbTabG8ZBsg09kTA=:",
+  "ajv@6.12.6": "ajv@6.12.6:Ryd2S/pDCZXGjaJ48IE14Vqa2/k+mLa4SA86apZM7p8=:",
+  "ansi-styles@4.3.0": "ansi-styles@4.3.0:ZWSFBwfXYCdLBmX2ZXoVqBWX7sfMR5ZmhLs9Hyh39XY=:",
+  "argparse@2.0.1": "argparse@2.0.1:CP2O+CSzekXy2j3jQ2OmDYinunOHtc5Csm3rkUFULc8=:",
+  "balanced-match@1.0.2": "balanced-match@1.0.2:gfGr4W+ea8r5s//ubOMelyZUtW6NYxDKRn7E320nT9E=:",
+  "brace-expansion@1.1.12": "brace-expansion@1.1.12:WZ7loigFQpKsxn/o3ZZyFCIEJvMvQqIiWubBtlXlQFE=:",
+  "callsites@3.1.0": "callsites@3.1.0:idWjoLeDJlAOwomjUQAaBzJpd4IMT3jWXtplCrKm6Ww=:",
+  "chalk@4.1.2": "chalk@4.1.2:Ye65wHsxO5agCiS0ku7VLLTcMR3e7m+jrhWtLo91SF4=:",
+  "color-convert@2.0.1": "color-convert@2.0.1:hZZd3CXw35XLVUEhmk6HzkHqcS6buTTuyYdCKAwTOK0=:",
+  "color-name@1.1.4": "color-name@1.1.4:Hgpi2Zjl2gtvUFUeFu42DzFvXVPruG3eFssCSCVbWE8=:",
+  "concat-map@0.0.1": "concat-map@0.0.1:GoKrPWMm+s3dcLfPBXyb8fDpbzIk2Y+KRd32fgfdNAM=:",
+  "cross-spawn@7.0.6": "cross-spawn@7.0.6:QjGdMcMYECyN5KGfM8tKE6N8fydsYKJWcjXEKd2LNC0=:",
+  "debug@4.4.3(supports-color@8.1.1)": "debug@4.4.3(supports-color@8.1.1):ANJDTwuR2ff7h9OW74kfn2QhH6QfrX46YyeOCgPXZ14=:",
+  "deep-is@0.1.4": "deep-is@0.1.4:9bzdBDlCEbKIHwMcLTgO5A7Cx9Qt2EvGWJ6rFD82XiU=:",
+  "escape-string-regexp@4.0.0": "escape-string-regexp@4.0.0:CPzYl7HWqJw841Bt4gVlED3dDts6LmLIZgDLWvZQwBY=:",
+  "eslint-scope@8.4.0": "eslint-scope@8.4.0:8sCuk/6sg3/iCXu4ikInhuUYyvcQoTXETHdBY6JCzr0=:",
+  "eslint-visitor-keys@3.4.3": "eslint-visitor-keys@3.4.3:JgR2rf9Jpzva8lFrKE+5yhxLwgC8qNXtm9LsuSBeAT8=:",
+  "eslint-visitor-keys@4.2.1": "eslint-visitor-keys@4.2.1:uyQNsuDcPZL1cJ29uclbt/ITeoMox36b0gbaWL8EB2E=:",
+  "eslint@9.37.0": "eslint@9.37.0:rk3skjy1IyyOhzGEhT2sq+UKUs3RmcUrWMaScHhroz0=:",
+  "espree@10.4.0": "espree@10.4.0:NLXs2uyUi7cK0j1u0OxWFDO6zYcblsb73pCi4SupIOE=:",
+  "esquery@1.7.0": "esquery@1.7.0:7lTtVBqirWgWzvUR2UO+6Vgzeyg40AnBbmtPEJHSYnI=:",
+  "esrecurse@4.3.0": "esrecurse@4.3.0:Uyo8CNm+VUgeJSS5C3ZgOky7Jzoy9NqvDpoJmqgzC1s=:",
+  "estraverse@5.3.0": "estraverse@5.3.0:00AEUywuhKDu6n0lVb10DR2UWrNOIvYuMGqHj0CdwnU=:",
+  "esutils@2.0.3": "esutils@2.0.3:aJX9PGT17yCKr7iAZ5tgGa3YKT3+hJEsQnqywiqu4Ls=:",
+  "fast-deep-equal@3.1.3": "fast-deep-equal@3.1.3:sQzlu0W93kExDoLpH+J9nRYeCD3IKRR56QR+L5402As=:",
+  "fast-json-stable-stringify@2.1.0": "fast-json-stable-stringify@2.1.0:K10zIkqqk5HN6fyP489Qokzz+PPha5DypCjM/vsSlHQ=:",
+  "fast-levenshtein@2.0.6": "fast-levenshtein@2.0.6:cj7tvs40k4b5TCsQAzLpftvxrNH656DEVTohBtwuznY=:",
+  "file-entry-cache@8.0.0": "file-entry-cache@8.0.0:SQqaU0bN18sw2FrNETBKmQ2diPepNTukqj8c1h6Z17M=:",
+  "find-up@5.0.0": "find-up@5.0.0:qGgTzQhtN9dzd8OFSODArCGrmz7K7p1ru5REFT+nuJM=:",
+  "flat-cache@4.0.1": "flat-cache@4.0.1:a+DWDtWKRdbcXR3b2WwRzt19oEmJI2bzSsPiFD4OftY=:",
+  "flatted@3.3.3": "flatted@3.3.3:n/tySR+oJ9GqN0MHUglQk6rKnm/pocLOndnVVqnwZX8=:",
+  "fsevents@2.3.2": "fsevents@2.3.2:bNXAkzb2IPp9wM21PQ4kmMBZQP1jfL1E0/P7aFe2MAE=:",
+  "glob-parent@6.0.2": "glob-parent@6.0.2:0p37uOI61LJEBi5J0LqvCZpybCryfpCHpgXAbdojSAU=:",
+  "globals@14.0.0": "globals@14.0.0:8M+Pg41xX4x7jxpJEHvAkp8r+p6TD38x0LOnrLneS38=:",
+  "has-flag@4.0.0": "has-flag@4.0.0:zgfmr3OsDLCMHlibU0ENn6OJauYzOf52DD0KUMi60HM=:",
+  "ignore@5.3.2": "ignore@5.3.2:yDHLBnXz3uWHnrTYakTFCNYHQ8taE2k5y6mSNt2aPIA=:",
+  "import-fresh@3.3.1": "import-fresh@3.3.1:V85oxEIxh/3C01hNHGqCBxZvLr0D/OsKG70pMGc2c0U=:",
+  "imurmurhash@0.1.4": "imurmurhash@0.1.4:Do4JJP58nt9bhIKZ6PdBxKNLuILFDd2QEH8LRaO9rvE=:",
+  "is-extglob@2.1.1": "is-extglob@2.1.1:AMteoIRG/AM61zOJM8SDhzp+j5Az1DLUiE+Xa0axHgc=:",
+  "is-glob@4.0.3": "is-glob@4.0.3:IV1BYKFvh0lG6Iv4rcSZbUF8fezvPI6gta6HezidaLA=:",
+  "isexe@2.0.0": "isexe@2.0.0:8n/cuvODXVLGPi7fczU6oeUOBtC1KPQg3RpBNdTdLPc=:",
+  "js-yaml@4.1.1": "js-yaml@4.1.1:U1+0lgDx+2f92l4id3YhAISRxaHOuGpc0d+LD6yKbrI=:",
+  "json-buffer@3.0.1": "json-buffer@3.0.1:KnG+FGWhYZ7WwE6FB1gTZ1x+vLjjpFK5hEP3osbgBos=:",
+  "json-schema-traverse@0.4.1": "json-schema-traverse@0.4.1:MmYShm+RH8i/sFAvj54xnWkkSkqqYi7EpDgoXnyqus4=:",
+  "json-stable-stringify-without-jsonify@1.0.1": "json-stable-stringify-without-jsonify@1.0.1:TDV4Iv8qj2BIUNgKi3LYEx9gKwYu2Azddhj50w6wTws=:",
+  "keyv@4.5.4": "keyv@4.5.4:IOAKQ0jOlet3hwxtEDYImR5HjaBV79JKkCnqiVDhjwM=:",
+  "levn@0.4.1": "levn@0.4.1:RV/RjN8oIKM36mly7RXqmmuZwnsfJvN9fuLBZK+Ht10=:",
+  "locate-path@6.0.0": "locate-path@6.0.0:E+wgrR8ZCmpCgttUQXSCTlPKs302KbvcF8qt5X/MbcU=:",
+  "lodash.merge@4.6.2": "lodash.merge@4.6.2:EXgcubv0+a/3dVPS5zFM1runKQWf9swiWEUu51lBRqw=:",
+  "lru-cache@6.0.0": "lru-cache@6.0.0:3AD1svQPW1+cP8N7PBlyo7Vbo2CBtRMgnBp+SQkY3Jo=:",
+  "minimatch@3.1.2": "minimatch@3.1.2:760dxYkpzsi3CWx9C5IcpXx924w+anGnFHkN6mxMxto=:",
+  "ms@2.1.3": "ms@2.1.3:xgLWg3kVMamVjHxNqBOX2ye0Wk7IMAMEzH0+Ih3GdAI=:",
+  "natural-compare@1.4.0": "natural-compare@1.4.0:TYI1bmKu+ZHaobZXs/B5hNXj1gFjP1MbXA/aTJrSvXk=:",
+  "optionator@0.9.4": "optionator@0.9.4:VXQcNvIxRkutRM+nV1xLnPEIz3OkO0yzxnaUtDpUbFE=:",
+  "p-limit@3.1.0": "p-limit@3.1.0:LdKRSSgTab016qRCjAyMxtMfWqqbZWRWjYN5Azfl13Q=:",
+  "p-locate@5.0.0": "p-locate@5.0.0:jSPkRsfoMWQdFIprhJqMLiq3pQVVMpAKDWCH+Jzzyhc=:",
+  "parent-module@1.0.1": "parent-module@1.0.1:7jcQBBr0dPfjyj7XXd1T3kplUES6v+rOhYu0x8cMK5I=:",
+  "path-exists@4.0.0": "path-exists@4.0.0:U8NGTjSfw+tTNMrI25cZA7Kr4QZlrBG6tOCKmu3WuJA=:",
+  "path-key@3.1.1": "path-key@3.1.1:G/7uS4scwsLV/mJitoXLEoSeLcbOLyC7mq3JaNY5L/Y=:",
+  "playwright-core@1.56.1": "playwright-core@1.56.1:KmvAlXcQEsa4yYhXi0planXfrk0mmtKVdJAqpcre1Vw=:",
+  "playwright@1.56.1": "playwright@1.56.1:pngkVuSZ2DV4D3e40SnraHTYxwxwx7oFNJlCuPUAh44=:",
+  "prelude-ls@1.2.1": "prelude-ls@1.2.1:77jm+R+stVYevlHR6mLJHVcOyB9clSWbWPCMOrhoFM4=:",
+  "punycode@2.3.1": "punycode@2.3.1:hBQ2kq3SCuY+AhrWXH8OhCuKpGtK75O10qdh6clgs7g=:",
+  "resolve-from@4.0.0": "resolve-from@4.0.0:DX1R0DdeDdDijEG++piS/gfwnUozHRPIUEeE+d9jpuk=:",
+  "semver@7.5.4": "semver@7.5.4:vr18fdeTHE/7/4+CZQKpQvhoyIF589eUll5uzzQA25I=:",
+  "shebang-command@2.0.0": "shebang-command@2.0.0:OLAZ6j51uPEAszP1K4Rex7GU7xSTv4E8umEZftOq2Ag=:",
+  "shebang-regex@3.0.0": "shebang-regex@3.0.0:ny+KjAiF2rsJrYeyelqno4XXRBhG1xbGdeGqew0SiFE=:",
+  "string-argv@0.3.2": "string-argv@0.3.2:+8yETLVj+NVram+4+d1tPctOQVhWroEJQkJhxH4XHKw=:",
+  "strip-json-comments@3.1.1": "strip-json-comments@3.1.1:b7Guud8xp0BNfyZNDrMqD/tnkn5cu9tjzD+P3X7OI9Y=:",
+  "supports-color@7.2.0": "supports-color@7.2.0:sYeXIOoG2x32GA0jy95SyyfTIGn4njaK3SOfylJNpbE=:",
+  "supports-color@8.1.1": "supports-color@8.1.1:IlKnJib+1wvgnU/NB8X/o14yZNJZAaN87xE6uQ0OU7I=:",
+  "type-check@0.4.0": "type-check@0.4.0:IVtRP5BW1I8SGLuymCsuyGHe6YzISs02l3ZaR/nY1kw=:",
+  "undici-types@6.19.8": "undici-types@6.19.8:M3UKXFY+kvTf3TQ0qq53jqwsCpwWEyI+A/MbyHL0rVU=:",
+  "uri-js@4.4.1": "uri-js@4.4.1:Q2BobLd4waRYnsj44SvcxeaDwkPIjLhPfH3BclqOaF4=:",
+  "which@2.0.2": "which@2.0.2:80HW1PmNzsNX+pyT6n7O+c62iDakyLL2/dI8hSmvNlk=:",
+  "word-wrap@1.2.5": "word-wrap@1.2.5:lNGZNaQ0hxB5pVG85e6u0w4w0K+uOJi6Y2P1fJqOqRo=:",
+  "ws@8.14.2": "ws@8.14.2:495eqSMGTG4fTLVkvOEGhqoXqAm0IjaxgWNMtJQIGyg=:",
+  "yallist@4.0.0": "yallist@4.0.0:g1l0JjkndK5+D0dThS2GGmGJkQ/MTilVWHNa5Je4fy4=:",
+  "yocto-queue@0.1.0": "yocto-queue@0.1.0:Dtxi56M74yiecaLhTY5kTZuzXvCHfjZlLQG4jzDqAAc=:"
+}

package/CHANGELOG.json

@@ -0,0 +1,17 @@
+{
+  "name": "@rushstack/playwright-browser-tunnel",
+  "entries": [
+    {
+      "version": "0.1.0",
+      "tag": "@rushstack/playwright-browser-tunnel_v0.1.0",
+      "date": "Sat, 24 Jan 2026 01:13:02 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Introduce CLI based tool to launch a remote browser provider for Playwright."
+          }
+        ]
+      }
+    }
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log - @rushstack/playwright-browser-tunnel
+
+This log was last generated on Sat, 24 Jan 2026 01:13:02 GMT and should not be manually modified.
+
+## 0.1.0
+Sat, 24 Jan 2026 01:13:02 GMT
+
+### Minor changes
+
+- Introduce CLI based tool to launch a remote browser provider for Playwright.
+

package/README.md

@@ -0,0 +1,128 @@
+
+# @rushstack/playwright-browser-tunnel
+
+Run a Playwright browser server in one environment and drive it from another environment by forwarding Playwright’s WebSocket traffic through a tunnel.
+
+This package is intended for remote development / CI scenarios (for example: Codespaces, devcontainers, or a separate “browser host” machine) where you want tests to run “here” but the actual browser process to run “there”.
+
+## Relationship to the Playwright on Codespaces VS Code extension
+
+This package is the core tunneling/runtime layer used by the **Playwright on Codespaces** VS Code extension (located at [vscode-extensions/playwright-on-codespaces-vscode-extension](../../vscode-extensions/playwright-on-codespaces-vscode-extension)).
+
+In a typical Codespaces workflow:
+
+- Your **tests** run inside the Codespace and call `tunneledBrowserConnection()`.
+- `tunneledBrowserConnection()` starts a WebSocket server (by default on port `3000`) that a browser host can attach to.
+- The VS Code extension runs on the **UI side** and starts a `PlaywrightTunnel` which connects to `ws://127.0.0.1:3000`.
+	- In Codespaces, this works when port `3000` is forwarded to your local machine (VS Code port forwarding makes the remote port reachable as `localhost:3000`).
+- Once connected, the extension hosts the actual Playwright browser process locally, while your tests continue to run remotely.
+
+The extension provides a UI wrapper around this library (start/stop commands, status bar state, and logs), while `@rushstack/playwright-browser-tunnel` provides the underlying protocol forwarding and browser lifecycle management.
+
+### Detecting whether the VS Code extension is present
+
+Some remote test fixtures want to detect whether the **Playwright on Codespaces** extension is installed/active (for example, to skip local-browser-only scenarios when the extension isn’t available).
+
+The extension writes a marker file named `.playwright-codespaces-extension-installed.txt` into the remote environment’s `os.tmpdir()` using VS Code’s remote filesystem APIs.
+
+On the remote side, `isExtensionInstalledAsync()` checks for that marker file and returns `true` if it exists:
+
+```ts
+import { isExtensionInstalledAsync } from '@rushstack/playwright-browser-tunnel';
+
+if (!(await isExtensionInstalledAsync())) {
+	throw new Error('Playwright on Codespaces extension is not installed/active in this environment');
+}
+```
+
+
+## Requirements
+
+- Node.js `>= 20` (see `engines` in `package.json`)
+- A compatible Playwright version (this package is built/tested with Playwright `1.56.x`)
+
+## Exports
+
+From [src/index.ts](src/index.ts):
+
+- `PlaywrightTunnel` (class)
+- `IPlaywrightTunnelOptions` (type)
+- `TunnelStatus` (type)
+- `BrowserNames` (type)
+- `tunneledBrowserConnection()` (function)
+- `tunneledBrowser()` (function)
+- `IDisposableTunneledBrowserConnection` (type)
+- `isExtensionInstalledAsync()` (function)
+
+## Usage
+
+There are two pieces:
+
+1) **Browser host**: run a `PlaywrightTunnel` to launch the real browser server and forward messages.
+2) **Test runner**: create a local endpoint via `tunneledBrowserConnection()` that your Playwright client can connect to (it forwards to the browser host).
+
+### 1) Browser host: run the tunnel
+
+Use `PlaywrightTunnel` in the environment where you want the browser process to run.
+
+```ts
+import { ConsoleTerminalProvider, Terminal, TerminalProviderSeverity } from '@rushstack/terminal';
+import { PlaywrightTunnel } from '@rushstack/playwright-browser-tunnel';
+import path from 'node:path';
+import os from 'node:os';
+
+const terminalProvider = new ConsoleTerminalProvider();
+const terminal = new Terminal(terminalProvider);
+
+const tunnel = new PlaywrightTunnel({
+	mode: 'wait-for-incoming-connection',
+	listenPort: 3000,
+	tmpPath: path.join(os.tmpdir(), 'playwright-browser-tunnel'),
+	terminal,
+	onStatusChange: (status) => terminal.writeLine(`status: ${status}`)
+});
+
+await tunnel.startAsync({ keepRunning: true });
+```
+
+Notes:
+
+- `mode: 'wait-for-incoming-connection'` starts a WebSocket server and waits for the other side to connect.
+- `mode: 'poll-connection'` repeatedly attempts to connect to a WebSocket endpoint you provide (`wsEndpoint`).
+- `tmpPath` is used as a working directory to install the requested `playwright-core` version and run its CLI.
+
+### 2) Test runner: create a local endpoint to connect()
+
+Use `tunneledBrowserConnection()` in the environment where your tests run.
+
+It starts:
+
+- a **remote** WebSocket server (port `3000`) that the browser host connects to
+- a **local** WebSocket endpoint (random port) that your Playwright client connects to
+
+```ts
+import { tunneledBrowserConnection } from '@rushstack/playwright-browser-tunnel';
+import playwright from 'playwright-core';
+
+using connection = await tunneledBrowserConnection();
+
+// Build the connect URL with query parameters consumed by the local proxy.
+const url = new URL(connection.remoteEndpoint);
+url.searchParams.set('browser', 'chromium');
+url.searchParams.set('launchOptions', JSON.stringify({ headless: true }));
+
+const browser = await playwright.chromium.connect(url.toString());
+// ...run tests...
+await browser.close();
+```
+
+## Development
+
+- Build: `rush build --to playwright-browser-tunnel`
+- Demo script (if configured): `rushx demo`
+
+## Troubleshooting
+
+- If the tunnel is stuck in `waiting-for-connection`, ensure the counterpart process is reachable and ports are forwarded correctly.
+- If browser installation is slow/repeated, ensure `tmpPath` is stable and writable for the host environment.
+

package/config/api-extractor.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+
+  "mainEntryPointFilePath": "<projectFolder>/lib/index.d.ts",
+
+  "apiReport": {
+    "enabled": true,
+    "reportFolder": "../../../common/reviews/api"
+  },
+
+  "docModel": {
+    "enabled": true,
+    "apiJsonFilePath": "../../../common/temp/api/<unscopedPackageName>.api.json"
+  },
+
+  "dtsRollup": {
+    "enabled": true
+  }
+}

package/config/rig.json

@@ -0,0 +1,7 @@
+{
+  // The "rig.json" file directs tools to look for their config files in an external package.
+  // Documentation for this system: https://www.npmjs.com/package/@rushstack/rig-package
+  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+
+  "rigPackageName": "local-node-rig"
+}

package/dist/playwright-browser-tunnel.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Run a Playwright browser server in one environment and drive it from another environment by
+ * forwarding Playwright's WebSocket traffic through a tunnel.
+ *
+ * @remarks
+ * This package is intended for remote development and CI scenarios (for example: Codespaces,
+ * devcontainers, or a separate "browser host" machine) where you want tests to run in one
+ * environment but the actual browser process to run in another.
+ *
+ * The package provides two main APIs:
+ * - {@link PlaywrightTunnel} - Run on the browser host to launch the real browser server and forward messages
+ * - {@link tunneledBrowserConnection} - Run on the test runner to create a local endpoint that your Playwright client can connect to
+ *
+ * @packageDocumentation
+ */
+
+import type { Browser } from 'playwright-core';
+import { ITerminal } from '@rushstack/terminal';
+import type { LaunchOptions } from 'playwright-core';
+import semver from 'semver';
+
+/**
+ * Allowed Playwright browser names.
+ * @beta
+ */
+export declare type BrowserName = 'chromium' | 'firefox' | 'webkit';
+
+/**
+ * Creates a Playwright Browser instance connected via a tunneled WebSocket connection.
+ * @beta
+ */
+export declare function createTunneledBrowserAsync(browserName: BrowserName, launchOptions: LaunchOptions, logger?: ITerminal, port?: number): Promise<IDisposableTunneledBrowser>;
+
+/**
+ * The filename used to indicate that the Playwright on Codespaces extension is installed.
+ * @beta
+ */
+export declare const EXTENSION_INSTALLED_FILENAME: string;
+
+/**
+ * Normalizes an error to a string for logging purposes.
+ * @beta
+ */
+export declare function getNormalizedErrorString(error: unknown): string;
+
+/**
+ * Disposable handle returned by {@link createTunneledBrowserAsync}.
+ * @beta
+ */
+export declare interface IDisposableTunneledBrowser {
+    /**
+     * The connected Playwright Browser instance.
+     */
+    browser: Browser;
+    /**
+     * Async dispose method that closes the browser connection.
+     * Called automatically when using `await using` syntax.
+     */
+    [Symbol.asyncDispose]: () => Promise<void>;
+}
+
+/**
+ * Disposable handle returned by {@link tunneledBrowserConnection}.
+ * @beta
+ */
+export declare interface IDisposableTunneledBrowserConnection {
+    /**
+     * The WebSocket endpoint URL that the local Playwright client should connect to.
+     */
+    remoteEndpoint: string;
+    /**
+     * Dispose method that closes the WebSocket servers.
+     * Called automatically when using `using` syntax.
+     */
+    [Symbol.dispose]: () => void;
+    /**
+     * Promise that resolves when the remote WebSocket server closes.
+     */
+    closePromise: Promise<void>;
+}
+
+/**
+ * Handshake data exchanged during the initial WebSocket connection.
+ * @beta
+ */
+export declare interface IHandshake {
+    action: 'handshake';
+    browserName: BrowserName;
+    launchOptions: LaunchOptions;
+    playwrightVersion: semver.SemVer;
+}
+
+/**
+ * Interface for the allowlist configuration stored in the user's local file system.
+ * @beta
+ */
+export declare interface ILaunchOptionsAllowlist {
+    /**
+     * Set of launch option keys that the user has explicitly allowed.
+     * These bypass the default security restrictions.
+     */
+    allowedOptions: string[];
+    /**
+     * Version of the allowlist format, for future compatibility.
+     */
+    version: number;
+}
+
+/**
+ * Result of validating launch options against the allowlist.
+ * @beta
+ */
+export declare interface ILaunchOptionsValidationResult {
+    /**
+     * Whether the launch options are valid and allowed.
+     */
+    isValid: boolean;
+    /**
+     * Launch options that were denied due to security restrictions.
+     */
+    deniedOptions: Array<keyof LaunchOptions>;
+    /**
+     * Filtered launch options with denied properties removed.
+     */
+    filteredOptions: LaunchOptions;
+    /**
+     * Warning messages about denied options.
+     */
+    warnings: string[];
+}
+
+/**
+ * Options for configuring a {@link PlaywrightTunnel} instance.
+ * @beta
+ */
+export declare type IPlaywrightTunnelOptions = {
+    terminal: ITerminal;
+    onStatusChange: (status: TunnelStatus) => void;
+    playwrightInstallPath: string;
+    /**
+     * Optional callback invoked before launching the browser server.
+     * Receives the handshake data including launch options.
+     * If the callback returns false, the browser server launch will be aborted.
+     * This allows the client to prompt the user for approval before starting.
+     */
+    onBeforeLaunch?: (handshake: IHandshake) => Promise<boolean> | boolean;
+} & ({
+    mode: 'poll-connection';
+    wsEndpoint: string;
+} | {
+    mode: 'wait-for-incoming-connection';
+    listenPort: number;
+});
+
+/**
+ * Helper to determine if the Playwright on Codespaces extension is installed. This check's for the
+ * existence of a well-known file in the OS temp directory.
+ * @beta
+ */
+export declare function isExtensionInstalledAsync(): Promise<boolean>;
+
+/**
+ * The filename used to store the launch options allowlist.
+ * Stored in the user's home directory/.playwright-browser-tunnel folder.
+ * @beta
+ */
+export declare const LAUNCH_OPTIONS_ALLOWLIST_FILENAME: string;
+
+/**
+ * Validates Playwright launch options against security allowlists.
+ * Provides utilities for managing client-side allowlist configuration.
+ * @beta
+ */
+export declare class LaunchOptionsValidator {
+    private static readonly _allowlistVersion;
+    /**
+     * Gets the path to the allowlist file in the user's local preferences folder.
+     * This follows the pattern of playwright-browser-installed.txt but stores in user's home directory.
+     */
+    static getAllowlistFilePath(): string;
+    /**
+     * Reads the allowlist from the user's local file system.
+     * Returns an empty allowlist if the file doesn't exist or is invalid.
+     */
+    static readAllowlistAsync(): Promise<ILaunchOptionsAllowlist>;
+    /**
+     * Writes the allowlist to the user's local file system.
+     */
+    static writeAllowlistAsync(allowlist: ILaunchOptionsAllowlist): Promise<void>;
+    /**
+     * Validates launch options against the security allowlist.
+     * All launch options are denied by default unless explicitly allowed by the user.
+     *
+     * @param launchOptions - The launch options to validate
+     * @param terminal - Optional terminal for logging warnings
+     * @returns Validation result with filtered options and warnings
+     */
+    static validateLaunchOptionsAsync(launchOptions: LaunchOptions, terminal?: ITerminal): Promise<ILaunchOptionsValidationResult>;
+    /**
+     * Adds an option to the allowlist.
+     */
+    static addToAllowlistAsync(option: keyof LaunchOptions): Promise<void>;
+    /**
+     * Removes an option from the allowlist.
+     */
+    static removeFromAllowlistAsync(option: keyof LaunchOptions): Promise<void>;
+    /**
+     * Clears the entire allowlist.
+     */
+    static clearAllowlistAsync(): Promise<void>;
+    /**
+     * Gets a human-readable description of the allowlist security model.
+     */
+    static getAllowlistDescription(): string;
+}
+
+/**
+ * Hosts a Playwright browser server and forwards traffic over a WebSocket tunnel.
+ * @beta
+ */
+export declare class PlaywrightTunnel {
+    private readonly _terminal;
+    private readonly _onStatusChange;
+    private readonly _onBeforeLaunch?;
+    private readonly _playwrightBrowsersInstalled;
+    private readonly _wsEndpoint;
+    private readonly _listenPort;
+    private readonly _playwrightInstallPath;
+    private _status;
+    private _initWsPromise?;
+    private _keepRunning;
+    private _ws?;
+    private _mode;
+    private _pendingConnectionAttempt?;
+    private _pollInterval?;
+    constructor(options: IPlaywrightTunnelOptions);
+    get status(): TunnelStatus;
+    private set status(value);
+    waitForCloseAsync(): Promise<void>;
+    startAsync(options?: {
+        keepRunning?: boolean;
+    }): Promise<void>;
+    stopAsync(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    cleanTempFilesAsync(): Promise<void>;
+    private _runCommandAsync;
+    private _installPlaywrightCoreAsync;
+    private _installPlaywrightBrowsersAsync;
+    private _tryConnectAsync;
+    private _pollConnectionAsync;
+    private _waitForIncomingConnectionAsync;
+    private _setupPlaywrightAsync;
+    private _getPlaywrightBrowserServerProxyAsync;
+    private _validateHandshake;
+    private _setupForwardingAsync;
+    /**
+     * Initializes the Playwright browser tunnel by establishing a WebSocket connection
+     * and setting up the browser server.
+     * Returns when the handshake is complete and the browser server is running.
+     */
+    private _initPlaywrightBrowserTunnelAsync;
+}
+
+/**
+ * Creates a tunneled WebSocket endpoint that a local Playwright client can connect to.
+ * @beta
+ */
+export declare function tunneledBrowserConnection(logger: ITerminal, port?: number): Promise<IDisposableTunneledBrowserConnection>;
+
+/**
+ * Status values reported by {@link PlaywrightTunnel}.
+ * @beta
+ */
+export declare type TunnelStatus = 'waiting-for-connection' | 'browser-server-running' | 'stopped' | 'setting-up-browser-server' | 'error';
+
+export { }

package/eslint.config.js

@@ -0,0 +1,18 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+const nodeTrustedToolProfile = require('local-node-rig/profiles/default/includes/eslint/flat/profile/node-trusted-tool');
+const friendlyLocalsMixin = require('local-node-rig/profiles/default/includes/eslint/flat/mixins/friendly-locals');
+
+module.exports = [
+  ...nodeTrustedToolProfile,
+  ...friendlyLocalsMixin,
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parserOptions: {
+        tsconfigRootDir: __dirname
+      }
+    }
+  }
+];