browser-commander 0.23.0 → 0.25.0

package/.jscpd-baseline.json

@@ -8,9 +8,11 @@
     "04b28d01d0bb47dc": 1,
     "04f605be138bc350": 1,
     "0796d358ad2562c3": 1,
+    "08e28c7706cdddd6": 1,
     "090a69d9528e4cdb": 1,
     "09694dc8fb9d683c": 1,
     "0a3459aad03492bb": 1,
+    "0ae281facb3c28dd": 1,
     "0b48b63049c42591": 1,
     "0b8c71391c107a5e": 1,
     "0ba2d165b56db0b3": 1,
@@ -18,19 +20,18 @@
     "0caa402c4eae32d8": 1,
     "0fd23be8410c2c95": 1,
     "0fe4f3b5e5e939b3": 1,
-    "1019ebbe7f07a5ad": 1,
-    "119f429fe4d23e4a": 1,
+    "126a1cfe8f2264ce": 1,
     "1273365073edd790": 1,
-    "1296adc3c3128048": 1,
     "13c4b58d3ea0719b": 1,
     "14beedf656e57fba": 1,
     "150c8efe188ac225": 1,
     "16340a16ed52849e": 1,
+    "16e58ea67d8ef4e8": 1,
     "17c26c0db2d35ad1": 1,
     "193b46c0e7f72053": 1,
+    "19ff70fc80fad524": 1,
     "1ad4dc7e19a77f68": 1,
     "1c1baf1bc8ea0eae": 1,
-    "1cbd39b416a2b94b": 1,
     "1d61f5c49f12d2dc": 1,
     "1ef570563d4e5a08": 1,
     "1f2104c950b12a30": 1,
@@ -39,10 +40,11 @@
     "22755b35701c5bb6": 1,
     "2296c06fa00da254": 1,
     "229b903386b17538": 1,
+    "22cbd954358d25f8": 1,
+    "230bfe57cfda164d": 1,
     "2357ae472525f6bf": 1,
     "2394170c8a2a0e9a": 1,
     "23d2486c0e269b77": 1,
-    "24b29d9d78441dbd": 1,
     "266893ea7a511fe4": 1,
     "266b9cb95f783cdf": 1,
     "26bb09996580437c": 1,
@@ -53,27 +55,28 @@
     "2c0f8b5c6f28420b": 1,
     "2d2d6fd6c7c0f30d": 1,
     "2e70be24d2268673": 1,
-    "2f4c9810eae87d6f": 1,
+    "2e75ebb5fafa33a5": 1,
     "2f9e15467cc2f12a": 1,
     "30da9d4e83f1c939": 1,
     "3101802d3ea65339": 1,
+    "326f1ff9016e1e37": 1,
     "33357ce94e07cc4b": 1,
     "35cf2769645f3234": 1,
     "37bd4114d0089f49": 1,
-    "39eaada6d1879f4a": 1,
+    "39cf8134a7fdaa31": 1,
     "3a9f1672ecc1d55b": 1,
     "3adca52a3f04837c": 1,
     "3c1017def7b3216c": 1,
-    "3da23cbee214a1a5": 1,
-    "3dced48baf70eb36": 1,
+    "3c5cb4b62d3739e3": 1,
     "3fa2ebbb416120f0": 1,
     "3fe61c0a7772f18b": 1,
     "406fed8e5b39aafd": 1,
     "40aa2953f783819c": 1,
     "418db56376cc23bd": 1,
+    "421bb16fafde32a7": 1,
     "441570d51d6f70a4": 1,
     "457c71f32f53833d": 1,
-    "46e3f58cfb14a43a": 1,
+    "4715a17d690865ee": 1,
     "4b0d3cc5c27227e7": 1,
     "4c3b94caa28045d0": 1,
     "4e090d6bb30e6551": 1,
@@ -84,29 +87,28 @@
     "520a28ee2ced56c2": 1,
     "53519ec61a6ba319": 1,
     "53f7e3f3e444a37d": 1,
-    "5587ec0cdb7b96e6": 1,
+    "55fd990468b1fd0f": 1,
     "562ebfb882d4aa8f": 1,
     "56b5df15ee61887d": 1,
     "56b7675e4ce57335": 1,
-    "56d45d447baad2fd": 1,
     "56deee57166c4369": 1,
     "578ab1469dc998ec": 1,
+    "57aa3b487de27c90": 1,
     "57c410b183671eec": 1,
-    "57e313e36a5ce81d": 1,
+    "5825f31d55b82fae": 1,
     "58c08b8242c875ec": 1,
     "58c1ca12d4d2b50f": 1,
     "5a09e2677334ba05": 1,
-    "5ae9b1430fc38daf": 1,
-    "602bfd129bba900e": 1,
+    "5b5d3f792532356c": 1,
+    "5ba2f3218754f04c": 1,
+    "60052da86e7bb241": 1,
     "608e1dd27138ec6f": 1,
-    "6098544c77ff17a2": 1,
     "60d0c58a01fc8746": 1,
     "61ae5da6cc003836": 1,
     "61bcadcd8dc9f63e": 1,
     "63ff613b1780c67a": 1,
     "642cc89ed49f8a21": 1,
     "6479c3604c153ec4": 1,
-    "6699064d6e8e09ba": 1,
     "66fb97eebd7ff0dc": 1,
     "67a95e428b8fa31c": 1,
     "6880d620e0e67229": 1,
@@ -127,7 +129,7 @@
     "760d9925f6e3ca85": 1,
     "7623a3eea4680be4": 1,
     "771db68809cce310": 1,
-    "771ddbb36a118cbb": 1,
+    "77793566535b942e": 1,
     "779517ed59b39aa6": 1,
     "7850ccac58d09216": 1,
     "785d557d0683185b": 1,
@@ -137,78 +139,90 @@
     "799dc9940577a15e": 1,
     "79e705499ddaf44b": 1,
     "7e6bad380644f9b0": 1,
+    "80cc77491cde09e5": 1,
+    "80f564fe45f6b315": 1,
     "81a56c10bfd42e39": 1,
     "837ba752ecdaf052": 1,
-    "8549c997a472cb6c": 1,
     "86646647aab19e39": 1,
     "8678919f1350f154": 1,
     "86aae81b1aa0d21b": 1,
     "87484a2744e09748": 1,
-    "876d2c8edfc8c40a": 1,
     "8b013ac20e436d76": 1,
     "8c2b1408886c1db1": 1,
+    "8e55579a412bc058": 1,
     "8ec18cdbd4a96518": 1,
+    "901317bc4d7d30d0": 1,
     "91049efadc65169b": 1,
     "9134185980de8a17": 1,
     "916833bafca4fa63": 1,
     "91a538e4a0c28f25": 1,
     "92ddafa7e65be7eb": 1,
     "94821a4d1b745dfd": 1,
+    "961e3cc731bbc9fe": 1,
     "97c5a112fdde7be8": 1,
     "990d87f21678fa96": 1,
     "9a72b1c2f22156ca": 1,
     "9b6ef4df04562546": 1,
-    "9ee57dcd5e7a6691": 1,
+    "9e049e3eefca1869": 1,
     "9fbb8296259dedbe": 1,
+    "9fe73b5b918293fe": 1,
     "a0183465782b0b15": 1,
+    "a11079d40b28716c": 1,
+    "a133391f90bd1a28": 1,
     "a1e3a3a13b27dba4": 1,
     "a1ef39a15701c2b5": 1,
     "a2a00d268fb2cee4": 1,
-    "a305c6cac16f3af5": 1,
+    "a36f66312d5bfbf8": 1,
     "a4c8498d4f2d2191": 1,
+    "a5298242b5439858": 1,
     "a6ad7ab6c05656dc": 1,
     "a6ffab1aacd00af6": 1,
     "a78d76908162699e": 1,
     "a9bd4ffef6da5faf": 1,
-    "a9d71c2e50f1b832": 1,
     "acc95d694eb2f581": 1,
     "ad4cfa76daa1b6fc": 1,
     "ad50b48938af8aef": 1,
-    "adae1329361a81a1": 1,
     "ae477ba64bafba3f": 1,
     "aee1e5c65f783848": 1,
     "aee45e8b58c2d87f": 1,
     "af702b20ebd45ef2": 1,
     "af9d6a2f4eba146e": 1,
     "b010686af23efa90": 1,
-    "b2a0686231220c8a": 1,
     "b35ff46c365dcd18": 1,
     "b41581af204af40e": 1,
     "b71fa5250da28739": 1,
     "b740ecac685a15fe": 1,
     "b8c2d21f2a26f77d": 1,
+    "ba675900dc4211b1": 1,
     "bb269582b94ed42d": 1,
     "bb3e6d0f7e7edccd": 1,
+    "bb5b0c8d22c9667a": 1,
     "bc9115be3a462930": 1,
     "bd0ae42c13d5b4f9": 1,
-    "bd6c62a6e1c6a071": 1,
+    "bd17b166d89cb709": 1,
     "bdb8ca169be36b80": 1,
     "bdcd11c2bfb5fde0": 1,
     "be0900fb3e87164e": 1,
     "bf452b9431c092ad": 1,
     "c0b027bebd7bd737": 1,
     "c189fe5122a7dc91": 1,
+    "c225b9d7d519303e": 1,
     "c2c155adbcb46f3c": 1,
     "c30737d62069fc02": 1,
+    "c32010db539b4efb": 1,
     "c3c3569357673af8": 1,
     "c415ffcd004d6518": 1,
     "c461a83b51eb7740": 1,
+    "c5c202c5db4dd601": 1,
+    "c714beebc66381dd": 1,
     "c9cf3c28bed33a5b": 1,
+    "ca7e08d1eec2ad8c": 1,
     "cab590a1d04b5a05": 1,
     "cbd444e9a6a9072e": 1,
     "cebff7d1cc87f646": 1,
-    "cf6116d195199f8a": 1,
+    "cfc928aa393146b6": 1,
     "cfd68135b744c27b": 1,
+    "cfdc0cca50233fcb": 1,
     "d016035b3bf3340c": 1,
     "d097f41a6f43e634": 1,
     "d0da8714c4b7de30": 1,
@@ -220,26 +234,27 @@
     "d6157a86fea41907": 1,
     "d6fa9884eee815f0": 1,
     "d86bafb915488255": 1,
+    "da2c10a66acdb52f": 1,
+    "dabb9fc09638e178": 1,
     "de0bf2317c53d427": 1,
     "de1b481bfe8c3e58": 1,
     "df2dc922f40485e7": 1,
     "df3b85f6947db144": 1,
-    "e0b90bce5112bb9c": 1,
     "e2ef7800deb0f464": 1,
     "e3111b845acb7a0e": 1,
-    "e4b10b56d7e1edac": 1,
     "e59733bafda785e9": 1,
     "e5feedc0c24e103e": 1,
     "e67726a913675120": 1,
+    "e686288f2e9b8a6d": 1,
     "ea1195048ded896c": 1,
     "ea88711c5deb1fe5": 1,
     "eb9a70c2a21094ff": 1,
     "ebe03c5f8c2f5147": 1,
     "ee19c8b9b332ee98": 1,
     "eeca0ccf8d821f21": 1,
-    "ef2fc2e92ac07c6e": 1,
     "f022b763ff342b2d": 1,
     "f07f979f8c2706e8": 1,
+    "f186f73c118b8e8a": 1,
     "f38f72095a67c95e": 1,
     "f40ba84763547f41": 1,
     "f46509ed693574df": 1,
@@ -248,10 +263,13 @@
     "f6678d6748e9c902": 1,
     "f67a07a611f39cb2": 1,
     "f7b1f9d699bcd580": 1,
+    "f81e07af5d3a1c3c": 1,
+    "f904844f89cab699": 1,
     "f911821aa7dda47f": 1,
     "f97bf515bfd95829": 1,
     "fae844842fba705b": 1,
     "faf76ec43b2dbbaa": 1,
+    "fc0d7bde0033411d": 1,
     "fc6ed7d760c98f51": 1,
     "fccfd8b004c12dd4": 1,
     "fe859df9f97c75d4": 1

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.25.0
+
+### Minor Changes
+
+- 4a79d62: Import Safari bookmarks, history and explicit Passwords CSV exports into Chromium profiles. Discover named Safari profiles and modern WebKit cookie stores. Derive desktop browser executable discovery and profile protection from the shared catalogue, fix Opera Local State lookup, and report Yandex Ya Passman encryption limitations. Enforce domain boundaries for migrated cookies, history and passwords, and validate migration paths and options before writing.
+
+  Resolve native Safe Storage credentials from the catalogue and provide service-specific macOS Keychain retry guidance. SQLite stores that cannot be backed up consistently return close-browser/retry guidance instead of copying live database files.
+
+  Match exact hosts and subdomains in cookie-source metadata and automatic source selection, without decoding cookie values or treating domain strings as SQL wildcard patterns.
+
+  Keep Safari profile-catalogue errors alongside readable profiles and cookie sources, including domain-filtered listings.
+
+  Filter associated Login Data notes, security records and origin statistics; re-encrypt retained notes with the target key. Reset copied sync state and report unknown metadata omitted during domain-filtered imports.
+
+  Recognize all 18 migration data classes with explicit unsupported reports. Add separate payment-card consent across native APIs, pre-launch migration, CLI and command streams, plus provider-specific passkey and certificate export limitations without accessing protected stores.
+
+  Translate Firefox history to Chromium with exact microsecond visit dates, domain filtering, immutable snapshots and per-visit malformed-data reports.
+
+  Normalize Firefox schema 16+ cookie expiry from milliseconds to seconds in both installed-profile reading and migration, preserving legacy schemas and session markers.
+
+  Preserve supported Yandex Login Data imports when an unsupported Ya Passman Data store is present, retaining separate encryption diagnostics.
+
+  Omit derived cluster labels, keywords, duplicate-visit records and unknown History metadata with named warnings during domain-filtered imports; preserve them during unfiltered imports.
+
+## 0.24.0
+
+### Minor Changes
+
+- 31d2387: Support Selenium through the common launch, connection, CLI, and browser-test
+  APIs, including raw WebDriver handles and generic engine constructors. Refresh
+  all direct dependencies and generated engine APIs to the latest stable releases.
+
 ## 0.23.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,9 @@
 # Browser Commander
 
-A universal browser automation library for JavaScript/TypeScript that supports both Playwright and Puppeteer with a unified API. The key focus is on **stoppable page triggers** - ensuring automation logic is properly mounted/unmounted during page navigation.
+A universal browser automation library for JavaScript/TypeScript that supports Playwright, Puppeteer, and Selenium with a unified API. The key focus is on **stoppable page triggers** - ensuring automation logic is properly mounted/unmounted during page navigation.
+
+See [engine support and native/CLI defaults](../docs/engine-support.md) for the
+cross-language API matrix and Selenium examples.
 
 ## Installation
 
@@ -222,7 +225,7 @@ await saveStorageState(page, './gmail-state.json');
 `browser-commander/tests` adds browser fixtures and scheduling helpers on top of
 [`test-anywhere`](https://github.com/link-foundation/test-anywhere). It keeps
 tests portable across Node.js, Bun, and Deno while running the same browser
-scenario against Playwright and Puppeteer.
+scenario against Playwright, Puppeteer, and Selenium.
 
 ```javascript
 import { assert, browserTest } from 'browser-commander/tests';
@@ -459,7 +462,7 @@ const session = await launchRealBrowser({
     browser: 'chrome', // chrome | edge | brave | chromium | firefox
     profile: 'Default',
     include: ['cookies', 'bookmarks', 'history', 'passwords', 'preferences'],
-    domains: ['npmjs.com', 'github.com'], // optional cookie filter
+    domains: ['npmjs.com', 'github.com'], // optional cookies/history/passwords filter
   },
 });
 console.log(session.migration.migrated, session.migration.skipped);
@@ -467,6 +470,12 @@ console.log(session.migration.migrated, session.migration.skipped);
 
 ### launchWebDriver(options) / connectWebDriver(options)
 
+The same engine is available through `launchBrowser({engine: 'selenium'})` and
+`connectBrowser({engine: 'selenium', serverUrl, capabilities})`. The common
+launcher defaults to a real Chrome attachment; `launch: 'engine'` enables
+ChromeDriver/GeckoDriver-managed Chrome or Firefox launches. Both return a common
+page facade plus a raw `driver` and `close()`.
+
 The `selenium` engine drives Chrome or Firefox over W3C WebDriver through
 `selenium-webdriver` (an optional peer dependency). `launchWebDriver()` finds a
 driver (`driverPath`, then `PATH`, then the Selenium Manager bundled with
@@ -515,9 +524,12 @@ overrides and managed downloads need CDP and throw on this engine; see
 
 ### listBrowserProfiles(options)
 
-Discover cookie-bearing profiles for Chrome, Edge, Brave, Chromium, and Firefox.
+Discover profiles for the browsers in the shared catalogue, including Safari.
 Pass an optional `browser` to narrow discovery. Each result contains
-`{ browser, name, displayName, path, isDefault }`.
+`{ browser, name, displayName, path, isDefault }`. If Safari's profile catalogue
+cannot be read, a `Profiles` entry carries `error` alongside readable profiles.
+Protected-file errors retain Full Disk Access instructions; cookie-source
+listings preserve the same error even when a domain filter is supplied.
 
 ### readBrowserCookies(options)
 
@@ -580,7 +592,7 @@ const report = await migrateProfile({
     'preferences',
     'extensions',
   ],
-  domains: ['github.com'], // optional cookie filter
+  domains: ['github.com'], // optional cookies/history/passwords filter
 });
 ```
 
@@ -1032,7 +1044,7 @@ echo '{"jsonrpc":"2.0","id":1,"method":"version"}' | npx browser-commander serve
 
 The other commands are `open`, `click`, `screenshot`, `pdf`, `trace start|stop|view`, `cookies import`, `profile migrate` and `doctor`. Use the `=` form for values that start with `--`, for example `--arg=--lang=de`.
 
-`serve --stdio` exposes the high-level methods (`session.launch`, `page.goto`, …). It also exposes generic handle methods (`handle.root`, `handle.call`, `handle.get`, `handle.describe`, `events.subscribe`, …), which reach every public Playwright and Puppeteer method. The Rust and Python ports use this bridge for the engines they do not implement natively.
+`serve --stdio` exposes the high-level methods (`session.launch`, `page.goto`, …). It also exposes generic handle methods (`handle.root`, `handle.call`, `handle.get`, `handle.describe`, `events.subscribe`, …), which reach public Playwright, Puppeteer, and Selenium methods and constructors. The Rust and Python ports use this bridge for the engines they do not implement natively.
 
 For raw Chrome DevTools Protocol access from JavaScript, `createCdpSession(page)` (or `commander.createCdpSession()`) returns the same `send`/`on`/`once`/`off`/`detach` surface for Playwright and Puppeteer pages.
 

package/eslint.config.js

@@ -154,7 +154,7 @@ export default [
     ignores: [
       'node_modules/**',
       'coverage/**',
-      'dist/**',
+      '**/dist/**',
       'docs-api/**',
       '*.min.js',
       '.eslintcache',