@rehearsal-labs/retest 0.1.0 → 0.3.0

package/dist/browser/builds.js

@@ -1,7 +1,7 @@
 import { closeSync, constants, fstatSync, lstatSync, openSync, readSync } from 'node:fs';
 import { createHash } from 'node:crypto';
 import { access, lstat, readdir, readlink } from 'node:fs/promises';
-import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { basename, dirname, isAbsolute, join, posix, relative, resolve, sep, win32 } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { folderChecksum, nativePins, pinKey, readBuildRecord } from "../native/executors.js";
 import { errorMessage } from "../protocol/failures.js";
@@ -13,6 +13,8 @@ export const buildEngines = ['chromium', 'firefox', 'webkit', 'electron', 'webdr
 const chromiumVersion = '153.0.8010.12';
 const chromeForTesting = 'https://storage.googleapis.com/chrome-for-testing-public';
 const macChrome = 'chrome-mac-arm64/Google Chrome for Testing.app';
+const firefoxReleases = 'https://archive.mozilla.org/pub/firefox/releases';
+const electronReleases = 'https://github.com/electron/electron/releases/download';
 // Authorized Linux archive observations, retained beside the pin table without adding unsupported install pins.
 // Firefox 133.0.3: https://archive.mozilla.org/pub/firefox/releases/133.0.3/linux-x86_64/en-US/firefox-133.0.3.tar.bz2
 // 89_495_132 bytes; SHA-256 43713e238d0153fdbf1ab46dd76c6b01ab83fae197b5dc3a95087f51907ba44d.
@@ -76,6 +78,7 @@ function executorPin(engine) {
  * The tested set. Chromium is Chrome for Testing, from Google; Firefox is Mozilla's release; WebKit is Playwright's
  * automation build, the only WebKit build with the inspector pipe Retest drives; Electron is the release its fixture app
  * runs on; the two native executors are built from their pinned commits. Only Chromium is pinned for Linux x64; its archive has been inspected, without a Linux browser execution claim.
+ * Windows x64 has Chromium, Firefox and Electron, from the same releases, and no WebKit build.
  */
 export const pinnedBuilds = [
     {
@@ -114,23 +117,58 @@ export const pinnedBuilds = [
         },
         provenance: 'Archive size and checksum, executable and both licence files read from the Google publisher download. Linux browser execution and installation remain unverified.',
     },
+    {
+        kind: 'archive',
+        engine: 'chromium',
+        title: 'Chrome for Testing',
+        version: chromiumVersion,
+        platform: 'win-x64',
+        archive: { format: 'zip', url: `${chromeForTesting}/${chromiumVersion}/win64/chrome-win64.zip`, size: 205_123_748, sha256: '415968b02065d4a9e2c10b85f0ae9f489b8fba500e94d9d0a7b7c4852a7234c1' },
+        executable: { path: 'chrome-win64/chrome.exe', sha256: '9b07943f834485b43c9d54caea2951c78715f9f07070a80ab6658465ebd3e711' },
+        files: [],
+        licences: {
+            inspected: true,
+            files: [
+                { path: 'chrome-win64/ABOUT', title: "the build's notice, which names chrome://credits, where the licences compiled into the browser are listed", licence: 'BSD-3-Clause and the licences at chrome://credits', sha256: '122b32f3ee3f1e8d65c774f5257fc6cc2127b666148ced0ce2efa3ea57e1d93c', published: true },
+            ],
+        },
+        provenance: 'Archive size and checksum, executable and notice read from the Google publisher download of 21 October 2026, here and on a Windows Server 2025 machine, whose own tar.exe unpacks the same files as unzip and libarchive bsdtar do on macOS. The Windows build carries no Widevine module, so there is no Widevine licence to pin. Installed by retest install and run on Windows Server 2025 x64, on a GitHub windows-2025 runner, in the 0.3.0 CI matrix.',
+    },
     {
         kind: 'archive',
         engine: 'firefox',
         title: 'Firefox',
-        version: '133.0.3',
-        build: '20241209150345',
+        version: '158.0.1',
+        build: '20261019185856',
         platform: 'mac-arm64',
-        archive: { format: 'dmg', app: 'Firefox.app', url: 'https://archive.mozilla.org/pub/firefox/releases/133.0.3/mac/en-US/Firefox%20133.0.3.dmg', size: 154_008_053, sha256: '9ceb4fa2120228f287e6c654cef7898b4cce0a659270056276b8884581267d3b', checksums: 'https://archive.mozilla.org/pub/firefox/releases/133.0.3/SHA256SUMS' },
-        executable: { path: 'Firefox.app/Contents/MacOS/firefox', sha256: '363eae026f4f5b3a8549f6a9c96a269754094ef12afc5f02cdffbcb4bcbf389c' },
+        archive: { format: 'dmg', app: 'Firefox.app', url: `${firefoxReleases}/158.0.1/mac/en-US/Firefox%20158.0.1.dmg`, size: 165_038_147, sha256: '1d7aa96b51fc9110185047de18228ac87238fba5e42bba53c9d696f88878cba6', checksums: `${firefoxReleases}/158.0.1/SHA256SUMS` },
+        executable: { path: 'Firefox.app/Contents/MacOS/firefox', sha256: '0b406e1d7c88d48c13f6389e05f22dedcb6ab99f06e539150a49e4ba995d0386' },
         files: [],
         licences: {
             inspected: true,
             files: [
-                { path: 'Firefox.app/Contents/Resources/omni.ja', title: "the archive that holds Firefox's about:license page, chrome/toolkit/content/global/license.html", licence: 'MPL-2.0 and the licences at about:license', sha256: '1ecdc0a4f6de9f562b24417cdaff4d2f17474d51572e65bbc4c7489cf4025c38', published: true },
+                { path: 'Firefox.app/Contents/Resources/omni.ja', title: "the archive that holds Firefox's about:license page, chrome/toolkit/content/global/license.html", licence: 'MPL-2.0 and the licences at about:license', sha256: 'dbfea026a6155b5c8794f55b2e54b19b0120353379a18e343dad381aa84228f5', published: true },
             ],
         },
-        provenance: 'Version, build id, executable and omni.ja checksums originally read from the signed en-US Firefox 133.0.3 in /Applications. The Mozilla disk-image download carries the same executable and omni.ja. The image holds Firefox.app at its root, copied to Firefox.app under the installed build. The archive size and checksum pinned above were measured from that download, which unpacked as the pin describes. Mozilla SHA256SUMS was not fetched for this pin.',
+        provenance: "Archive size and checksum from Mozilla's download of 22 October 2026, which matched the release's SHA256SUMS. The image holds Firefox.app at its root, copied to Firefox.app under the installed build. Executable and omni.ja checksums read from the mounted image; its application.ini names Firefox 158.0.1 build 20261019185856.",
+    },
+    {
+        kind: 'archive',
+        engine: 'firefox',
+        title: 'Firefox',
+        version: '158.0.1',
+        build: '20261019185856',
+        platform: 'win-x64',
+        archive: { format: 'exe', folder: 'core', url: `${firefoxReleases}/158.0.1/win64/en-US/Firefox%20Setup%20158.0.1.exe`, size: 94_890_968, sha256: '3259a2f8508e58cf2e383b6c99bfc64d6ddc86d1407b7c2f86f660af955b5d10', checksums: `${firefoxReleases}/158.0.1/SHA256SUMS` },
+        executable: { path: 'core/firefox.exe', sha256: '76732d4e43c864194660c671c52ecf4bad89e43b666d9a0acf89cd4b692ced9b' },
+        files: [],
+        licences: {
+            inspected: true,
+            files: [
+                { path: 'core/omni.ja', title: "the archive that holds Firefox's about:license page, chrome/toolkit/content/global/license.html", licence: 'MPL-2.0 and the licences at about:license', sha256: '42f976ac57103698320728a9c134ec8e710ab9a3c48d127ea3e115e1b3b211c3', published: true },
+            ],
+        },
+        provenance: "Archive size and checksum from Mozilla's download of 22 October 2026, which matched the release's SHA256SUMS. Mozilla publishes no zip of a Windows release, only this installer: a 7-Zip archive behind a self-extracting stub that Retest never runs. The archive holds setup.exe and the core folder, which is the whole of Firefox and is unpacked alone. Executable and omni.ja checksums read from that folder as libarchive bsdtar unpacked it on macOS, and the same bytes again after retest install unpacked it with tar.exe on a Windows Server 2025 machine; its application.ini names Firefox 158.0.1 build 20261019185856.",
     },
     {
         kind: 'archive',
@@ -171,6 +209,25 @@ export const pinnedBuilds = [
         treeSha256: 'f94a2b748b5f3e41b0ff1938ebd02052bb8af4cf037c2d24d21ffd51c5f7d7b4',
         provenance: "Archive size and checksum from a download of the official release, which matched the release's SHASUMS256.txt; executable, licence and tree checksums read from that archive unpacked with ditto in ~/Library/Caches/retest-proofs/electron/44.5.1.",
     },
+    {
+        kind: 'archive',
+        engine: 'electron',
+        title: 'Electron',
+        version: '44.5.1',
+        platform: 'win-x64',
+        archive: { format: 'zip', url: `${electronReleases}/v44.5.1/electron-v44.5.1-win32-x64.zip`, size: 157_998_329, sha256: '9b382492dcfee91f8f9e92c91f7972550a1b95d2299cac72279dab33a600d7db', checksums: `${electronReleases}/v44.5.1/SHASUMS256.txt` },
+        executable: { path: 'electron.exe', sha256: '49b61a030a520fc36a4b8fa5cce53fb4e935a7bdbbe4b80e9222f598e49cc7fa' },
+        files: [],
+        licences: {
+            inspected: true,
+            files: [
+                { path: 'LICENSE', title: "Electron's licence", licence: 'MIT', sha256: '5154e165bd6c2cc0cfbcd8916498c7abab0497923bafcd5cb07673fe8480087d', published: true },
+                { path: 'LICENSES.chromium.html', title: 'the licences of Chromium and the libraries compiled into it', licence: 'BSD-3-Clause and the licences it lists', sha256: '7b328b8c7463ac9bfc7dc648c751533517c8441a0b5b21047d6c0b2620e60d70', published: true },
+            ],
+        },
+        treeSha256: '0a50669f7461801821ab9d01ee2193748d36f45b6235bcfd648ed9a44a175e30',
+        provenance: "Archive size and checksum from a download of the official release on 21 October 2026, which matched the release's SHASUMS256.txt, here and on a Windows Server 2025 machine. Executable, licence and tree checksums read on that machine from the archive unpacked with its own tar.exe; unzip and libarchive bsdtar on macOS unpack the same files. Installed by retest install and run on Windows Server 2025 x64, on a GitHub windows-2025 runner, in the 0.3.0 CI matrix.",
+    },
     executorPin('webdriveragent'),
     executorPin('mac2'),
 ];
@@ -184,11 +241,14 @@ export function buildPlatform(platform = process.platform, arch = process.arch)
         return 'mac-arm64';
     if (platform === 'linux' && arch === 'x64')
         return 'linux-x64';
+    if (platform === 'win32' && arch === 'x64')
+        return 'win-x64';
     return undefined;
 }
-/** @example describePlatform('linux-x64') // 'Linux x64' */
+const platformNames = { 'mac-arm64': 'macOS arm64', 'linux-x64': 'Linux x64', 'win-x64': 'Windows x64' };
+/** @example describePlatform('win-x64') // 'Windows x64' */
 export function describePlatform(platform) {
-    return platform === 'mac-arm64' ? 'macOS arm64' : 'Linux x64';
+    return platformNames[platform];
 }
 /**
  * The pin of one engine for one platform, if Retest pins one.
@@ -198,6 +258,16 @@ export function describePlatform(platform) {
 export function findPin(engine, platform, pins = pinnedBuilds) {
     return pins.find((pin) => pin.engine === engine && pin.platform === platform);
 }
+/**
+ * Why there is no pin of an engine for a platform, as one sentence for `retest install` to refuse with.
+ *
+ * @example unpinnedMessage('webkit', 'win-x64') // 'Retest does not run WebKit on Windows, so there is no WebKit build to install.'
+ */
+export function unpinnedMessage(engine, platform) {
+    if (engine === 'webkit' && platform === 'win-x64')
+        return 'Retest does not run WebKit on Windows, so there is no WebKit build to install.';
+    return `Retest pins no ${engine} build for ${describePlatform(platform)}.`;
+}
 /** @example describePin(findPin('electron', 'mac-arm64')) // 'Electron 44.5.1' */
 export function describePin(pin) {
     const build = pin.kind === 'archive' && pin.build !== undefined ? ` (build ${pin.build})` : '';
@@ -275,17 +345,46 @@ export function readBundledLicence(file) {
 }
 /**
  * The cache folders under the user's cache folder: `~/Library/Caches/retest` on macOS, `$XDG_CACHE_HOME/retest` or
- * `~/.cache/retest` on Linux. Undefined without an absolute `HOME`, since there is then no user cache folder.
+ * `~/.cache/retest` on Linux, `%LOCALAPPDATA%\retest` on Windows. Undefined without an absolute `HOME`, or on Windows
+ * an absolute `LOCALAPPDATA`, since there is then no user cache folder. Paths are written as `platform` writes them.
  *
  * @example cacheFolders({ HOME: '/Users/ada' }, 'darwin')?.browsers // '/Users/ada/Library/Caches/retest/browsers'
+ * @example cacheFolders({ LOCALAPPDATA: 'C:\\Users\\ada\\AppData\\Local' }, 'win32')?.browsers // 'C:\\Users\\ada\\AppData\\Local\\retest\\browsers'
  */
 export function cacheFolders(env, platform = process.platform) {
+    if (platform === 'win32') {
+        const local = environmentVariable(env, cacheVariable(platform), platform);
+        if (local === undefined || !win32.isAbsolute(local))
+            return undefined;
+        return { browsers: win32.join(local, 'retest', 'browsers'), executors: win32.join(local, 'retest', 'native-executors') };
+    }
     const home = env['HOME'];
-    if (home === undefined || !isAbsolute(home))
+    if (home === undefined || !posix.isAbsolute(home))
         return undefined;
     const xdg = env['XDG_CACHE_HOME'];
-    const root = platform === 'darwin' ? join(home, 'Library', 'Caches') : xdg !== undefined && isAbsolute(xdg) ? xdg : join(home, '.cache');
-    return { browsers: join(root, 'retest', 'browsers'), executors: join(root, 'retest', 'native-executors') };
+    const root = platform === 'darwin' ? posix.join(home, 'Library', 'Caches') : xdg !== undefined && posix.isAbsolute(xdg) ? xdg : posix.join(home, '.cache');
+    return { browsers: posix.join(root, 'retest', 'browsers'), executors: posix.join(root, 'retest', 'native-executors') };
+}
+/**
+ * The variable `cacheFolders` finds the user's cache folder from, for a message to name when it is not set.
+ *
+ * @example cacheVariable('win32') // 'LOCALAPPDATA'
+ */
+export function cacheVariable(platform = process.platform) {
+    return platform === 'win32' ? 'LOCALAPPDATA' : 'HOME';
+}
+/**
+ * An environment variable as the system reads it: by its exact name, and on Windows, where names differ only in case
+ * for the same variable, by any spelling of it. `process.env` already reads so on Windows; a copy of it does not.
+ *
+ * @example environmentVariable({ ProgramFiles: 'C:\\Program Files' }, 'PROGRAMFILES', 'win32') // 'C:\\Program Files'
+ */
+export function environmentVariable(env, name, platform = process.platform) {
+    const exact = env[name];
+    if (exact !== undefined || platform !== 'win32')
+        return exact;
+    const wanted = name.toUpperCase();
+    return Object.entries(env).find(([key]) => key.toUpperCase() === wanted)?.[1];
 }
 /**
  * The folder one pin's build is installed in. A browser or Electron build is named after its engine, version and
@@ -315,7 +414,7 @@ const installedRecordSchema = s.object({
     schemaVersion: s.literal(1),
     engine: s.enum(['chromium', 'firefox', 'webkit', 'electron']),
     version: s.string(),
-    platform: s.enum(['mac-arm64', 'linux-x64']),
+    platform: s.enum(['mac-arm64', 'linux-x64', 'win-x64']),
     source: s.string(),
     sourceCode: s.optional(s.object({ repository: s.string(), revision: s.string(), patches: s.string() })),
     fetchedFrom: s.string(),
@@ -483,7 +582,7 @@ export async function inspectBuilds(platform, folders, options = {}, pins = pinn
  * `retest install` refuses. The message names the folder, what is wrong and how to fix it. Nothing is downloaded,
  * and nothing is thrown: a folder that cannot be read is damaged.
  *
- * @example await installedBuild('firefox', process.env) // { state: 'damaged', message: 'Firefox 133.0.3 … in … is not usable: …' }
+ * @example await installedBuild('firefox', process.env) // { state: 'damaged', message: 'Firefox 158.0.1 … in … is not usable: …' }
  */
 export async function installedBuild(engine, env, options = {}) {
     const platform = 'platform' in options ? options.platform : buildPlatform();
@@ -511,7 +610,7 @@ export async function installedBuild(engine, env, options = {}) {
  * installed as its pin and record say; undefined otherwise, which a damaged build is too. A driver that must tell a
  * damaged build from a missing one asks `installedBuild`. A target's own `executablePath` always wins over it.
  *
- * @example await installedExecutable('firefox', process.env) // '/Users/ada/Library/Caches/retest/browsers/firefox-133.0.3-mac-arm64/build/Firefox.app/Contents/MacOS/firefox'
+ * @example await installedExecutable('firefox', process.env) // '/Users/ada/Library/Caches/retest/browsers/firefox-158.0.1-mac-arm64/build/Firefox.app/Contents/MacOS/firefox'
  */
 export async function installedExecutable(engine, env, options = {}) {
     const build = await installedBuild(engine, env, options);

package/dist/browser/cdp/connection.d.ts

@@ -51,6 +51,12 @@ export declare class CdpConnection {
      * @example const session = await connection.attach(targetId)
      */
     attach(targetId: string, options?: SendOptions): Promise<CdpSession>;
+    /**
+     * Takes on a flat session the browser attached by itself, as `Target.setAutoAttach` does, named in its
+     * `Target.attachedToTarget` event. Call it while that event is handled, so no event of the session's arrives first.
+     * @example const session = connection.adopt(sessionId)
+     */
+    adopt(sessionId: string): CdpSession;
     /** Ends the connection. Every waiting command rejects with a `CdpDisconnectedError`. */
     close(): void;
 }

package/dist/browser/cdp/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/browser/cdp/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAehE,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAA;CAClD,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAa,CAAA;AAc/C,2DAA2D;AAC3D,qBAAa,aAAa;;gBAWZ,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB;IAkB5D,qCAAqC;IACrC,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E;;;OAGG;IACH,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAInE,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAI5D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAMpE,wFAAwF;IACxF,KAAK,IAAI,IAAI;CAkKd"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/browser/cdp/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAehE,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAA;CAClD,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAa,CAAA;AAc/C,2DAA2D;AAC3D,qBAAa,aAAa;;gBAWZ,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB;IAkB5D,qCAAqC;IACrC,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E;;;OAGG;IACH,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAInE,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAI5D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAMpE;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAIpC,wFAAwF;IACxF,KAAK,IAAI,IAAI;CAkKd"}

package/dist/browser/cdp/connection.js

@@ -62,6 +62,14 @@ export class CdpConnection {
     attach(targetId, options) {
         return this.#send(this.#root, ATTACH_METHOD, { targetId, flatten: true }, options, (result) => this.#openSession(result));
     }
+    /**
+     * Takes on a flat session the browser attached by itself, as `Target.setAutoAttach` does, named in its
+     * `Target.attachedToTarget` event. Call it while that event is handled, so no event of the session's arrives first.
+     * @example const session = connection.adopt(sessionId)
+     */
+    adopt(sessionId) {
+        return this.#openSession({ sessionId });
+    }
     /** Ends the connection. Every waiting command rejects with a `CdpDisconnectedError`. */
     close() {
         this.#transport.close();

package/dist/browser/cdp/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/browser/cdp/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,iEAAiE;IACjE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,sDAAsD;IACtD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAA;IACnC,KAAK,IAAI,IAAI,CAAA;CACd;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAA;AAMpE,6EAA6E;AAC7E,qBAAa,aAAc,YAAW,SAAS;;gBAUjC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,WAAW;IAiB/C,qFAAqF;IACrF,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAUzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAgBnC,KAAK,IAAI,IAAI;CAqDd"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/browser/cdp/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,iEAAiE;IACjE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,sDAAsD;IACtD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAA;IACnC,KAAK,IAAI,IAAI,CAAA;CACd;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAA;AAMpE,6EAA6E;AAC7E,qBAAa,aAAc,YAAW,SAAS;;gBAUjC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,WAAW;IAkB/C,qFAAqF;IACrF,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAUzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAgBnC,KAAK,IAAI,IAAI;CAqDd"}

package/dist/browser/cdp/transport.js

@@ -12,20 +12,20 @@ export class PipeTransport {
     constructor({ readable, writable }) {
         this.#readable = readable;
         this.#writable = writable;
+        // A pipe that closes without Retest closing it means the browser went, whichever of its two ends Node hears of first,
+        // so a killed browser is told of in one sentence however the ends race.
         readable.on('end', () => this.#end('the browser closed the pipe'));
         readable.on('close', () => this.#end('the browser closed the pipe'));
         readable.on('error', (error) => this.#end(`reading from the browser failed: ${error.message}`));
-        writable.on('close', () => this.#end('the pipe to the browser closed'));
+        writable.on('close', () => this.#end('the browser closed the pipe'));
         writable.on('error', (error) => this.#end(`writing to the browser failed: ${error.message}`));
         writable.on('drain', () => {
             this.#blocked = false;
             this.#flush();
         });
         // A stream that ended before this point never emits its events again.
-        if (readable.destroyed || readable.readableEnded)
+        if (readable.destroyed || readable.readableEnded || writable.destroyed || writable.writableEnded)
             this.#end('the browser closed the pipe');
-        else if (writable.destroyed || writable.writableEnded)
-            this.#end('the pipe to the browser closed');
     }
     /** Starts reading. Nothing is read before this, so no message can arrive unheard. */
     listen(handlers) {

package/dist/browser/checked-state.d.ts

@@ -1,10 +1,10 @@
 import type { ActionIntent } from './element-queries.ts';
-import type { IsolatedWorld } from './isolated-world.ts';
+import type { PageWorld } from './isolated-world.ts';
 import type { Deadline } from '../protocol/deadline.ts';
 import type { Failure } from '../protocol/failures.ts';
 import type { LocatorRecipe } from '../protocol/locator.ts';
 export type CheckedStateOptions = {
-    world: IsolatedWorld;
+    world: PageWorld;
     locator: LocatorRecipe;
     intent: Extract<ActionIntent, {
         action: 'check' | 'uncheck';

package/dist/browser/checked-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checked-state.d.ts","sourceRoot":"","sources":["../../src/browser/checked-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAM3D,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,aAAa,CAAA;IACpB,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC,CAAA;IAC9D,4DAA4D;IAC5D,GAAG,EAAE,OAAO,GAAG,SAAS,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;CACnB,CAAA;AAKD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAgBpI"}
+{"version":3,"file":"checked-state.d.ts","sourceRoot":"","sources":["../../src/browser/checked-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAM3D,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC,CAAA;IAC9D,4DAA4D;IAC5D,GAAG,EAAE,OAAO,GAAG,SAAS,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;CACnB,CAAA;AAKD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAgBpI"}

package/dist/browser/chromium-process.d.ts

@@ -70,10 +70,17 @@ export declare class ChromiumProcess {
      */
     gone(): Promise<void>;
     /**
-     * Reads descendants while their launched parent is still present: when the connection drops and before asking the
-     * parent to quit. A helper recorded early is still owned after its parent dies.
+     * Reads descendants while their launched parent is still present, holding the thread, as a process made from a
+     * child no owner has read yet does. A helper recorded early is still owned after its parent dies.
      */
     recordDescendants(deadline?: Deadline): void;
+    /**
+     * `recordDescendants` from a reading begun now that does not hold the thread, within `deadline`, as a close reads
+     * before it asks the browser to quit. A reading that fails is kept, as one that holds the thread is.
+     *
+     * @example await chromium.recordDescendantsNow(new Deadline(5000))
+     */
+    recordDescendantsNow(deadline: Deadline): Promise<void>;
     /**
      * `recordDescendants` from a reading taken without holding the thread, as after each new page, whose renderer the
      * browser has just started. A process-table reading takes tens of milliseconds, which a page open would otherwise wait.
@@ -105,4 +112,27 @@ export declare function stillThereMessage(groupId: number, stats: () => readonly
 export declare function signalGroup(pgid: number, signal: NodeJS.Signals | 0): boolean;
 /** Signals a descendant only after this process recorded it beneath the launched browser. */
 export declare function signalRecordedProcess(browserPid: number, pid: number, signal: NodeJS.Signals): void;
+/**
+ * Waits for the output to close. A timer can fire before I/O that is already waiting has been read, when the main thread
+ * was busy with other work such as synchronous process readings, so the clock alone is no proof the output is still
+ * open: on a busy host every healthy close failed so. When the bound passes, waiting I/O is read first, then the output
+ * is judged by whether anything can still write to it. Once nothing can, Retest's own writing gets its own bound.
+ * If a writer remains after verified owned shutdown, an output with safe reader finish support may stop its local
+ * readers and flush accepted bytes and queued writes within that same writing bound. This does not claim remote
+ * EOF or collect bytes an inherited writer sends later. An output without this support still fails and is canceled.
+ */
+export declare function outputWithin(output: BrowserOutput, timeoutMs: number, confirmedGone: () => Promise<boolean>): Promise<string[]>;
+/** How long an exit hook on Windows asks again to remove a folder whose processes it confirmed gone. */
+export declare const exitRemovalMs: number;
+/**
+ * Removes a folder from an exit hook on Windows, where a folder whose files processes just ended were using refuses
+ * removal for a moment after they left their job, and the synchronous removal does not wait: it is asked again, a poll
+ * apart, until the deadline.
+ */
+export declare function removeOnceFree(folder: string, deadline: Deadline): void;
+/**
+ * Whether a group is gone, for an exit hook, which cannot await. Processes just sent SIGKILL are still exiting when they
+ * are first read, so the group is read again, a poll apart, until it is gone or the deadline passes.
+ */
+export declare function groupEndsNow(ownership: OwnedProcessGroup, deadline: Deadline): boolean;
 //# sourceMappingURL=chromium-process.d.ts.map

package/dist/browser/chromium-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chromium-process.d.ts","sourceRoot":"","sources":["../../src/browser/chromium-process.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chromium-process.d.ts","sourceRoot":"","sources":["../../src/browser/chromium-process.ts"],"names":[],"mappings":"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"}

package/dist/browser/chromium-process.js

@@ -2,15 +2,17 @@ import { spawn } from 'node:child_process';
 import { once } from 'node:events';
 import { rmSync } from 'node:fs';
 import { mkdir, open, rm } from 'node:fs/promises';
-import { dirname } from 'node:path';
+import { basename, dirname } from 'node:path';
 import { Readable, Writable } from 'node:stream';
 import { setTimeout as sleep } from 'node:timers/promises';
 import { Deadline } from "../protocol/deadline.js";
 import { maxTimeout } from "../protocol/timeouts.js";
 import { errorMessage } from "../protocol/failures.js";
+import { withoutVariables } from "../shared/environment.js";
 import { errorCode } from "../shared/error-code.js";
 import { onlyUnreaped, procStats } from "../shared/unreaped-group.js";
 import { OwnedProcessGroup, unverifiedMembersProblem } from "../shared/process-ownership.js";
+import { holdLaunch, launchesHeldByJob, prepareOwnedLaunch } from "../shared/process-system.js";
 import { closeGraceMs, LaunchError } from "./contract.js";
 import { writeRedactedLog } from "./redacted-log.js";
 const pollMs = 25;
@@ -86,7 +88,10 @@ export class ChromiumProcess {
                 resolve(this.#exit);
             });
         });
-        this.recordDescendants();
+        // A launch hands over the owner it has just read. Reading it again at once found nothing new, and on a loaded host
+        // that second reading outlasted its second and failed the browser's close however cleanly it later ended.
+        if (!this.#ownership.captured)
+            this.recordDescendants();
         this.#lastResort = () => killAtExit(this.#ownership, profile);
         process.on('exit', this.#lastResort);
     }
@@ -116,12 +121,21 @@ export class ChromiumProcess {
         await this.#output.closed;
     }
     /**
-     * Reads descendants while their launched parent is still present: when the connection drops and before asking the
-     * parent to quit. A helper recorded early is still owned after its parent dies.
+     * Reads descendants while their launched parent is still present, holding the thread, as a process made from a
+     * child no owner has read yet does. A helper recorded early is still owned after its parent dies.
      */
     recordDescendants(deadline = new Deadline(closeGraceMs)) {
         this.#keep(this.#ownership.capture(deadline));
     }
+    /**
+     * `recordDescendants` from a reading begun now that does not hold the thread, within `deadline`, as a close reads
+     * before it asks the browser to quit. A reading that fails is kept, as one that holds the thread is.
+     *
+     * @example await chromium.recordDescendantsNow(new Deadline(5000))
+     */
+    async recordDescendantsNow(deadline) {
+        this.#keep(await this.#ownership.captureAsync(deadline));
+    }
     /**
      * `recordDescendants` from a reading taken without holding the thread, as after each new page, whose renderer the
      * browser has just started. A process-table reading takes tens of milliseconds, which a page open would otherwise wait.
@@ -240,6 +254,22 @@ export function stillThereMessage(groupId, stats, timeoutMs = closeGraceMs) {
  * @example signalGroup(browser.pid, 0) // true while any browser process is still there
  */
 export function signalGroup(pgid, signal) {
+    // Windows has no process group to send signal 0 to: a launch held here is asked through its job, and one held by
+    // another process only by its own pid.
+    if (signal === 0 && launchesHeldByJob) {
+        const owner = ownedGroups.get(pgid);
+        if (owner !== undefined)
+            return owner.remains();
+        try {
+            process.kill(pgid, 0);
+            return true;
+        }
+        catch (error) {
+            if (errorCode(error) === 'ESRCH')
+                return false;
+            throw error;
+        }
+    }
     if (signal !== 0) {
         const owner = ownedGroups.get(pgid);
         if (owner === undefined)
@@ -277,18 +307,33 @@ async function spawnInGroup(options) {
     const log = await openLog(options.logFile);
     let logHandedOn = false;
     try {
-        const hidden = new Set(options.hiddenVariables);
         // Output to redact comes through Retest; any other goes straight to the log.
         const outputMode = redact === undefined && redactStream === undefined ? log.fd : 'pipe';
-        const child = spawn(options.executable, options.args, {
-            env: Object.fromEntries(Object.entries(process.env).filter(([name]) => !hidden.has(name))),
-            detached: true,
-            stdio: ['ignore', outputMode, outputMode, 'pipe', 'pipe'],
-        });
+        try {
+            prepareOwnedLaunch();
+        }
+        catch (error) {
+            throw new LaunchError(`Cannot start ${options.executable}: ${errorMessage(error)}`, { cause: error });
+        }
+        let child;
+        try {
+            child = spawn(options.executable, options.args, {
+                env: withoutVariables(process.env, options.hiddenVariables),
+                detached: true,
+                stdio: ['ignore', outputMode, outputMode, 'pipe', 'pipe'],
+            });
+        }
+        catch (error) {
+            // Windows refuses a program whose access list denies this user running it at the spawn itself, with EPERM; the
+            // check before the launch cannot see that there, as it sees a mode on macOS and Linux.
+            const refused = errorCode(error) === 'EPERM' || errorCode(error) === 'EACCES';
+            throw new LaunchError(refused ? `${options.executable} is not executable. Allow it to run, or pass another browser.` : `Cannot start ${options.executable}: ${errorMessage(error)}`, { cause: error });
+        }
         await once(child, 'spawn').catch((error) => {
             throw new LaunchError(`Cannot start ${options.executable}: ${errorMessage(error)}`, { cause: error });
         });
-        const ownership = new OwnedProcessGroup(child.pid ?? 0);
+        // Every process of the browser carries its profile's folder in its command line.
+        const ownership = holdLaunch(child, options.profile === undefined ? {} : { marker: basename(options.profile) });
         const ownershipProblems = ownership.capture();
         const [, , , writable, readable] = child.stdio;
         if (!(writable instanceof Writable) || !(readable instanceof Readable)) {
@@ -354,7 +399,7 @@ async function spawnInGroup(options) {
  * readers and flush accepted bytes and queued writes within that same writing bound. This does not claim remote
  * EOF or collect bytes an inherited writer sends later. An output without this support still fails and is canceled.
  */
-async function outputWithin(output, timeoutMs, confirmedGone) {
+export async function outputWithin(output, timeoutMs, confirmedGone) {
     const first = await settledWithin(output.closed, timeoutMs);
     if (first !== undefined)
         return first;
@@ -404,7 +449,8 @@ async function openLog(logFile) {
         throw new LaunchError(`Cannot open the browser log ${logFile}: ${errorMessage(error)}`, { cause: error });
     }
 }
-// A fresh reading is taken before the deadline is asked, so a group that ended while the host was busy reads as ended.
+// Each look reads the group, or waits for a reading already under way, before the deadline is asked, so a group that
+// ended while the host was busy reads as ended.
 async function groupEnds(ownership, grace, { ref = true, deadline = grace } = {}) {
     while (await ownership.remainsAsync(deadline)) {
         if (grace.expired || deadline.reached || deadline.signal?.aborted === true)
@@ -413,21 +459,53 @@ async function groupEnds(ownership, grace, { ref = true, deadline = grace } = {}
     }
     return true;
 }
+/** How long an exit hook on Windows asks again to remove a folder whose processes it confirmed gone. */
+export const exitRemovalMs = 2 * closeGraceMs;
 // Runs while the Retest process exits, when a failure can neither be awaited nor reported.
 function killAtExit(ownership, profile) {
     try {
         const deadline = new Deadline(closeGraceMs);
         ownership.signalNow('SIGKILL', deadline);
-        if (profile !== undefined && groupEndsNow(ownership, deadline))
+        if (profile === undefined || !groupEndsNow(ownership, deadline))
+            return;
+        // On Windows the end and its confirmation are runs of retest-supervisor, which a slow host can spend most of the
+        // bound on, and the folder refuses removal for up to a second after its processes left their job, as a scanner
+        // holds what they wrote; the removal gets a bound of its own, so a profile whose processes are confirmed gone is
+        // removed.
+        if (launchesHeldByJob)
+            removeOnceFree(profile, new Deadline(exitRemovalMs));
+        else
             rmSync(profile, { recursive: true, force: true, maxRetries: 3 });
     }
     catch {
         // Throwing here would replace the exit code Retest chose.
     }
 }
-// `groupEnds` for an exit hook, which cannot await. Processes just sent SIGKILL are still exiting when `ps` first reads
-// them, so the group is read again, a poll apart, until it is gone or the deadline passes.
-function groupEndsNow(ownership, deadline) {
+/**
+ * Removes a folder from an exit hook on Windows, where a folder whose files processes just ended were using refuses
+ * removal for a moment after they left their job, and the synchronous removal does not wait: it is asked again, a poll
+ * apart, until the deadline.
+ */
+export function removeOnceFree(folder, deadline) {
+    const pause = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));
+    for (;;) {
+        try {
+            rmSync(folder, { recursive: true, force: true });
+            return;
+        }
+        catch (error) {
+            const code = errorCode(error);
+            if ((code !== 'EPERM' && code !== 'EBUSY' && code !== 'ENOTEMPTY') || deadline.expired)
+                throw error;
+            Atomics.wait(pause, 0, 0, Math.min(pollMs, deadline.remainingMs));
+        }
+    }
+}
+/**
+ * Whether a group is gone, for an exit hook, which cannot await. Processes just sent SIGKILL are still exiting when they
+ * are first read, so the group is read again, a poll apart, until it is gone or the deadline passes.
+ */
+export function groupEndsNow(ownership, deadline) {
     const pause = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));
     while (ownership.remains(deadline)) {
         if (deadline.expired)