@rightkit/qa 0.2.1 → 0.2.3

package/README.md

@@ -3,3 +3,12 @@
 Shared native QA primitives for Right Suite desktop apps. The package owns run locking, bearer-authenticated loopback control, deterministic evidence bundles, exact owned-process cleanup, and the guard that keeps development WebDriver access out of production builds.
 
 This package is intentionally private until the Windows and macOS phase gate passes. App repositories must never consume it through a Git, path, `file:`, `link:`, or `workspace:` dependency; adoption happens only after a registry version is published.
+
+## Chrome for Testing (`@rightkit/qa/chrome`)
+
+Web/CDP harnesses launch Chrome for Testing, never regular Google Chrome: on macOS each regular Chrome instance clones its app bundle under `<DARWIN_USER_TEMP_DIR>/../X/com.google.Chrome.code_sign_clone/`, and a killed instance leaks that clone. The native lane (`native.ts`, Tauri WebDriver) is unaffected.
+
+- `resolveChromeForTesting({ executablePath? })` resolves the explicit option, then `RIGHTKIT_CHROME_FOR_TESTING`, then `/Applications` and `~/Applications` app installs, then the newest Puppeteer (`~/.cache/puppeteer`, `PUPPETEER_CACHE_DIR`) and Playwright (`~/Library/Caches/ms-playwright`, `PLAYWRIGHT_BROWSERS_PATH`) builds. It throws `ChromeForTestingNotFoundError` with install instructions; it never falls back. `findChromeForTesting()` returns `{ path }` or `{ reason }` for test skips.
+- `launchChromeForTesting(options)` starts it in its own process group with a temp profile and returns `{ wsEndpoint, port, pid, profileDir, close() }`. Launch one browser per suite and open targets per test.
+- `close()` / `closeChromeGracefully()` sends CDP `Browser.close`, waits up to 5 s, sends SIGTERM to the process group (`taskkill /T` on Windows), waits again, sends SIGKILL only last, then removes the profile. It reports the step that ended the tree.
+- `codeSignCloneEntries()` lists the macOS clone entries so tests can assert that none appear.

package/dist/chrome.d.ts

@@ -0,0 +1 @@
+export * from '@rightkit/qa-chrome';

package/dist/chrome.js

@@ -0,0 +1 @@
+export * from '@rightkit/qa-chrome';

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './chrome.js';
 export * from './evidence.js';
 export * from './frames.js';
 export * from './guard.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from './chrome.js';
 export * from './evidence.js';
 export * from './frames.js';
 export * from './guard.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rightkit/qa",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Shared native QA runner, evidence, ownership, and release-backdoor guards for Right Suite apps.",
   "license": "MIT OR Apache-2.0",
   "type": "module",
@@ -13,6 +13,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./chrome": {
+      "types": "./dist/chrome.d.ts",
+      "import": "./dist/chrome.js"
     }
   },
   "files": [
@@ -23,6 +27,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
+    "@rightkit/qa-chrome": "0.1.0",
     "@wdio/cli": "9.27.1",
     "@wdio/local-runner": "9.27.1",
     "@wdio/mocha-framework": "9.27.1",