browser-commander 0.26.2 → 0.27.0

package/.jscpd-baseline.json

@@ -1,8 +1,10 @@
 {
   "version": 1,
   "fingerprints": {
+    "00504cdec3a262ed": 1,
     "00d381dd611ae8ac": 1,
     "029a62ef1f48e856": 1,
+    "02fc9852e9ba4c49": 1,
     "038170e72e0af1f5": 1,
     "0413f601c8911a92": 1,
     "04b28d01d0bb47dc": 1,
@@ -27,9 +29,7 @@
     "14beedf656e57fba": 1,
     "150c8efe188ac225": 1,
     "16340a16ed52849e": 1,
-    "16e58ea67d8ef4e8": 1,
     "17c26c0db2d35ad1": 1,
-    "193b46c0e7f72053": 1,
     "19ff70fc80fad524": 1,
     "1a9f0f0f68ed445c": 1,
     "1ad4dc7e19a77f68": 1,
@@ -42,10 +42,10 @@
     "22755b35701c5bb6": 1,
     "2296c06fa00da254": 1,
     "229b903386b17538": 1,
+    "22ab9a1ca6316d24": 1,
     "22cbd954358d25f8": 1,
     "230bfe57cfda164d": 1,
     "2357ae472525f6bf": 1,
-    "2394170c8a2a0e9a": 1,
     "23d2486c0e269b77": 1,
     "266893ea7a511fe4": 1,
     "266b9cb95f783cdf": 1,
@@ -66,7 +66,6 @@
     "35cf2769645f3234": 1,
     "37bd4114d0089f49": 1,
     "39cf8134a7fdaa31": 1,
-    "3a9f1672ecc1d55b": 1,
     "3adca52a3f04837c": 1,
     "3c1017def7b3216c": 1,
     "3c5cb4b62d3739e3": 1,
@@ -75,15 +74,17 @@
     "406fed8e5b39aafd": 1,
     "40aa2953f783819c": 1,
     "418db56376cc23bd": 1,
+    "41ba3b00db6d29f5": 1,
     "421bb16fafde32a7": 1,
     "441570d51d6f70a4": 1,
     "457c71f32f53833d": 1,
     "4715a17d690865ee": 1,
+    "47dc143be0bd8be5": 1,
     "4b0d3cc5c27227e7": 1,
     "4c3b94caa28045d0": 1,
+    "4d1ff99bb19f5685": 1,
     "4f3c541b3f3e3f23": 1,
     "4f93b074bc2ac9e8": 1,
-    "5085765e1f103f3e": 1,
     "5184c90c9f8406c3": 1,
     "520a28ee2ced56c2": 1,
     "53519ec61a6ba319": 1,
@@ -97,13 +98,16 @@
     "57aa3b487de27c90": 1,
     "57c410b183671eec": 1,
     "5825f31d55b82fae": 1,
+    "589649758d30b0b4": 1,
     "58c08b8242c875ec": 1,
-    "58c1ca12d4d2b50f": 1,
+    "591377945ae26575": 1,
+    "59b7172dfb646586": 1,
     "5a09e2677334ba05": 1,
     "5b5d3f792532356c": 1,
     "5ba2f3218754f04c": 1,
     "60052da86e7bb241": 1,
     "608e1dd27138ec6f": 1,
+    "60a3149247760d9b": 1,
     "60d0c58a01fc8746": 1,
     "61ae5da6cc003836": 1,
     "61bcadcd8dc9f63e": 1,
@@ -112,6 +116,7 @@
     "6479c3604c153ec4": 1,
     "66fb97eebd7ff0dc": 1,
     "67a95e428b8fa31c": 1,
+    "67c309590c5d69a1": 1,
     "6880d620e0e67229": 1,
     "69d50e6f6a5f2ee9": 1,
     "6a7ed9ad3fc00a39": 1,
@@ -142,35 +147,28 @@
     "79e705499ddaf44b": 1,
     "7e6bad380644f9b0": 1,
     "80cc77491cde09e5": 1,
-    "80f564fe45f6b315": 1,
-    "81a56c10bfd42e39": 1,
     "837ba752ecdaf052": 1,
     "86646647aab19e39": 1,
     "8678919f1350f154": 1,
     "86aae81b1aa0d21b": 1,
     "87484a2744e09748": 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,
     "9e049e3eefca1869": 1,
-    "9fbb8296259dedbe": 1,
+    "9fdc43960bb59bcf": 1,
     "9fe73b5b918293fe": 1,
     "a0183465782b0b15": 1,
     "a11079d40b28716c": 1,
-    "a133391f90bd1a28": 1,
     "a1e3a3a13b27dba4": 1,
     "a1ef39a15701c2b5": 1,
     "a2a00d268fb2cee4": 1,
@@ -179,17 +177,21 @@
     "a5298242b5439858": 1,
     "a6ad7ab6c05656dc": 1,
     "a6ffab1aacd00af6": 1,
+    "a71a4b720d466e32": 1,
+    "a71fab6edf38c846": 1,
     "a78d76908162699e": 1,
     "a9bd4ffef6da5faf": 1,
+    "ac3fe4ef966e0209": 1,
     "acc95d694eb2f581": 1,
     "ad4cfa76daa1b6fc": 1,
     "ad50b48938af8aef": 1,
+    "adc4fadd2bfd220c": 1,
     "add45ff3644fbeeb": 1,
     "aee1e5c65f783848": 1,
     "aee45e8b58c2d87f": 1,
     "af702b20ebd45ef2": 1,
-    "af9d6a2f4eba146e": 1,
     "b010686af23efa90": 1,
+    "b141049dde51b3e8": 1,
     "b35ff46c365dcd18": 1,
     "b41581af204af40e": 1,
     "b71fa5250da28739": 1,
@@ -224,24 +226,23 @@
     "cebff7d1cc87f646": 1,
     "cfc928aa393146b6": 1,
     "cfd68135b744c27b": 1,
-    "cfdc0cca50233fcb": 1,
     "d016035b3bf3340c": 1,
     "d097f41a6f43e634": 1,
-    "d0da8714c4b7de30": 1,
     "d17201496391f6cc": 1,
     "d17e8db5a2bab966": 1,
-    "d1a4a8e6a523b752": 1,
-    "d1e5c2961267399a": 1,
     "d2ed3d02dd6a2d8c": 1,
     "d6157a86fea41907": 1,
     "d6fa9884eee815f0": 1,
     "d86bafb915488255": 1,
     "da2c10a66acdb52f": 1,
     "dabb9fc09638e178": 1,
+    "dcc616702e5b0cb4": 1,
     "de0bf2317c53d427": 1,
     "de1b481bfe8c3e58": 1,
     "df2dc922f40485e7": 1,
     "df3b85f6947db144": 1,
+    "e071c1594e47dd0f": 1,
+    "e18fb1b06eac2f6a": 1,
     "e2ef7800deb0f464": 1,
     "e3111b845acb7a0e": 1,
     "e59733bafda785e9": 1,
@@ -249,14 +250,14 @@
     "e67726a913675120": 1,
     "e686288f2e9b8a6d": 1,
     "e7d7bb7e163d2327": 1,
+    "e902a25d9132eda9": 1,
     "ea1195048ded896c": 1,
     "ea88711c5deb1fe5": 1,
     "eb9a70c2a21094ff": 1,
     "ebe03c5f8c2f5147": 1,
     "ee19c8b9b332ee98": 1,
-    "eeca0ccf8d821f21": 1,
+    "ef6b9112e659147b": 1,
     "f07f979f8c2706e8": 1,
-    "f186f73c118b8e8a": 1,
     "f38f72095a67c95e": 1,
     "f40ba84763547f41": 1,
     "f46509ed693574df": 1,
@@ -264,15 +265,15 @@
     "f4bfa7e503443cd1": 1,
     "f6678d6748e9c902": 1,
     "f67a07a611f39cb2": 1,
+    "f762b61eef0af530": 1,
     "f7b1f9d699bcd580": 1,
     "f81e07af5d3a1c3c": 1,
     "f904844f89cab699": 1,
     "f911821aa7dda47f": 1,
     "f97bf515bfd95829": 1,
     "fae844842fba705b": 1,
-    "faf76ec43b2dbbaa": 1,
+    "fb4a079a529a6285": 1,
     "fc0d7bde0033411d": 1,
-    "fc6ed7d760c98f51": 1,
     "fccfd8b004c12dd4": 1,
     "fe859df9f97c75d4": 1
   }

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.27.0
+
+### Minor Changes
+
+- fab33b3: Honor per-call navigation policies, deadlines and cancellation; expose bounded redacted launch diagnostics. Add reusable indexed controls, ordered selectors/text, removable subscriptions and non-clearing flags. Add cookie-only browser reads, runtime cookies, session discovery and dedicated-profile persistence. Make SQLite optional, align links-notation 0.23, and document Bun CDP compatibility.
+
+## 0.26.3
+
+### Patch Changes
+
+- 796ebd8: Accept dedicated macOS application profiles under `~/Library/Application Support` by separating Safari import discovery roots from protected browser data paths. Safari, Technology Preview and Chrome default profiles remain protected.
+
 ## 0.26.2
 
 ### Patch Changes

package/README.md

@@ -1063,3 +1063,5 @@ See [src/ARCHITECTURE.md](src/ARCHITECTURE.md) for detailed architecture documen
 ## License
 
 [UNLICENSE](../LICENSE)
+
+See [navigation budgets, launch diagnostics, reusable helpers and sessions](../docs/navigation-launch-and-sessions.md) for the shared API contracts and engine limitations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-commander",
-  "version": "0.26.2",
+  "version": "0.27.0",
   "description": "Universal browser automation library that supports Playwright, Puppeteer, and Selenium with a unified API",
   "main": "src/index.js",
   "bin": {
@@ -80,11 +80,10 @@
     }
   },
   "dependencies": {
-    "better-sqlite3": "^13.0.3",
     "bplist-parser": "^0.5.0",
     "command-stream": "^1.4.0",
     "csv-parse": "^7.0.3",
-    "links-notation": "^0.22.0",
+    "links-notation": "^0.23.0",
     "log-lazy": "^1.0.4",
     "plist": "^5.0.0",
     "test-anywhere": "^0.9.1"
@@ -108,5 +107,8 @@
     "better-sqlite3@13.0.3": true,
     "node-pty": false,
     "puppeteer": false
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^13.0.3"
   }
 }

package/src/bindings.js

@@ -3,6 +3,8 @@
  * This module provides helper functions for binding page, engine, and log to library functions.
  */
 
+import { findFirst, hasText, isChecked, check } from './elements/reusable.js';
+import { setCookies, clearCookies } from './browser/session-cookies.js';
 import { wait, evaluate, safeEvaluate } from './utilities/wait.js';
 import { getUrl, unfocusAddressBar } from './utilities/url.js';
 import {
@@ -52,6 +54,8 @@ import {
   fillTextArea,
 } from './interactions/fill.js';
 import {
+  readFlag,
+  uninstallClickListener,
   waitForUrlCondition,
   installClickListener,
   checkAndClearFlag,
@@ -116,6 +120,7 @@ export function createBoundFunctions(options = {}) {
       page,
       waitForUrlStabilization: waitForUrlStabilizationBound,
       navigationManager,
+      networkTracker,
     });
   const setContentBound = (opts) =>
     setContent({
@@ -352,6 +357,20 @@ export function createBoundFunctions(options = {}) {
     installClickListener: installClickListenerBound,
     checkAndClearFlag: checkAndClearFlagBound,
     findToggleButton: findToggleButtonBound,
+    findFirst: (opts) => findFirst({ ...opts, page, engine }),
+    hasText: (opts) => hasText({ ...opts, page, engine }),
+    isChecked: (opts) => isChecked({ ...opts, page, engine }),
+    check: (opts) => check({ ...opts, page, engine, wait: waitBound }),
+    readFlag: (opts) => readFlag({ ...opts, evaluate: evaluateBound }),
+    uninstallClickListener: (opts) =>
+      uninstallClickListener({ ...opts, evaluate: evaluateBound }),
+    setCookies: (options) =>
+      setCookies({
+        page,
+        engine,
+        cookies: Array.isArray(options) ? options : options.cookies,
+      }),
+    clearCookies: (opts = {}) => clearCookies({ ...opts, page, engine }),
 
     // PDF generation
     pdf: pdfBound,

package/src/browser/attach/snapshot-launch.js

@@ -1,3 +1,4 @@
+import { findBrowserSource } from '../browser-sources.js';
 import { resolveRestrictions } from '../restrictions.js';
 import { describeAttachDifferences } from './differences.js';
 import { snapshotUserDataDir } from './snapshot.js';
@@ -19,13 +20,13 @@ const KEYSTORE_BYPASS_SWITCHES = ['--use-mock-keychain', '--password-store='];
  * @returns {string}
  */
 export function snapshotBrowserForChannel(channel) {
-  if (channel.startsWith('msedge')) {
-    return 'edge';
-  }
-  if (channel === 'brave' || channel === 'chromium') {
-    return channel;
+  const source = findBrowserSource(channel);
+  if (!source || source.family !== 'chromium') {
+    throw new TypeError(
+      `Snapshot channel must identify a Chromium browser: ${channel}`
+    );
   }
-  return 'chrome';
+  return source.id;
 }
 
 /**
@@ -122,6 +123,7 @@ export async function prepareSnapshotLaunch({
     browser,
     profile,
     userDataDir: attach.userDataDir,
+    ...(attach.include ? { include: attach.include } : {}),
   });
   const warnings = [
     ...(report.warnings ?? []),

package/src/browser/attach/snapshot.js

@@ -5,6 +5,7 @@ import {
   readdir,
   readFile,
   stat,
+  lstat,
   writeFile,
 } from 'node:fs/promises';
 import os from 'node:os';
@@ -279,6 +280,7 @@ export async function snapshotUserDataDir({
   profile = 'Default',
   userDataDir,
   to,
+  include,
   platform = process.platform,
   homeDir = os.homedir(),
   environment = process.env,
@@ -293,6 +295,16 @@ export async function snapshotUserDataDir({
     );
   }
   assertProfileName(profile);
+  if (
+    include !== undefined &&
+    (!Array.isArray(include) ||
+      include.length !== 1 ||
+      include[0] !== 'cookies')
+  ) {
+    throw new TypeError(
+      'snapshot include must be ["cookies"] or omitted for the whole profile'
+    );
+  }
   const sourceRoot =
     userDataDir ??
     browserProfileRoot(normalizedBrowser, { platform, homeDir, environment });
@@ -310,6 +322,7 @@ export async function snapshotUserDataDir({
       sourceRoot,
       profile,
       target,
+      include,
       source: { browser: normalizedBrowser, profile, userDataDir: sourceRoot },
     });
   } catch (error) {
@@ -320,7 +333,7 @@ export async function snapshotUserDataDir({
   }
 }
 
-async function copyProfile({ sourceRoot, profile, target, source }) {
+async function copyProfile({ sourceRoot, profile, target, source, include }) {
   const copier = new SnapshotCopier(sourceRoot, target);
   const warnings = [];
   const localState = await stat(path.join(sourceRoot, LOCAL_STATE_FILE)).catch(
@@ -336,7 +349,31 @@ async function copyProfile({ sourceRoot, profile, target, source }) {
         'The source has no Local State; on Windows it holds the key cookies and passwords are encrypted with, so they cannot be decrypted in the copy.',
     });
   }
-  await copier.copyDirectory(profile);
+  if (include) {
+    for (const relative of [
+      `${profile}/Cookies`,
+      `${profile}/Network/Cookies`,
+    ]) {
+      const parent = await lstat(
+        path.dirname(path.join(sourceRoot, relative))
+      ).catch(() => null);
+      if (parent?.isSymbolicLink()) {
+        copier.skipped.push({ item: relative, reason: 'symlink' });
+        continue;
+      }
+      const entry = await lstat(path.join(sourceRoot, relative)).catch(
+        () => null
+      );
+      if (entry?.isFile()) {
+        await mkdir(path.dirname(path.join(target, relative)), {
+          recursive: true,
+        });
+        await copier.copyFile(relative);
+      }
+    }
+  } else {
+    await copier.copyDirectory(profile);
+  }
   await prepareUserDataDir(target, { profileDirectory: profile });
   await markExitedCleanly(path.join(target, profile));
 

package/src/browser/browser-cookie-database.js

@@ -1,5 +1,3 @@
-import BetterSqlite3 from 'better-sqlite3';
-
 let builtInSqlitePromise;
 
 function loadBuiltInSqlite() {
@@ -18,6 +16,7 @@ export async function openSqliteDatabase(
   if (DatabaseSync) {
     return new DatabaseSync(filename, { readOnly });
   }
+  const BetterSqlite3 = await loadOptionalSqlite();
   return new BetterSqlite3(filename, {
     fileMustExist,
     readonly: readOnly,
@@ -33,3 +32,73 @@ export function preserveIntegerPrecision(statement) {
   }
   return statement;
 }
+
+/** Lazy native fallback for runtimes without built-in SQLite. */
+export async function loadOptionalSqlite() {
+  try {
+    return (await import('better-sqlite3')).default;
+  } catch (cause) {
+    throw new Error(
+      'This SQLite operation needs optional better-sqlite3 on this runtime. Install it or use Node >=22.16 for built-in SQLite backups.',
+      { cause }
+    );
+  }
+}
+
+function backupProgress() {
+  let remaining = Infinity;
+  let lastProgress = Date.now();
+  return ({ remainingPages }) => {
+    if (remainingPages < remaining) {
+      lastProgress = Date.now();
+    } else if (Date.now() - lastProgress >= 1000) {
+      throw new Error('SQLite backup made no progress');
+    }
+    remaining = remainingPages;
+    return 256;
+  };
+}
+
+/** Make an online backup, including committed WAL data. */
+export async function backupSqliteDatabase(sourcePath, snapshotPath) {
+  let native;
+  try {
+    native = await loadOptionalSqlite();
+  } catch {
+    /* built-in fallback */
+  }
+  let sqlite;
+  try {
+    sqlite = await import('node:sqlite');
+  } catch {
+    /* native fallback */
+  }
+  if (!native && sqlite?.backup) {
+    const source = new sqlite.DatabaseSync(sourcePath, {
+      readOnly: true,
+      timeout: 1000,
+    });
+    try {
+      source.prepare('PRAGMA schema_version').get();
+      await sqlite.backup(source, snapshotPath, {
+        rate: 256,
+        progress: backupProgress(),
+      });
+    } finally {
+      source.close();
+    }
+    return;
+  }
+  const BetterSqlite3 = native ?? (await loadOptionalSqlite());
+  const source = new BetterSqlite3(sourcePath, {
+    readonly: true,
+    fileMustExist: true,
+    timeout: 1000,
+  });
+  try {
+    source.pragma('schema_version');
+    await source.backup(snapshotPath, { progress: backupProgress() });
+  } finally {
+    source.close();
+  }
+}

package/src/browser/browser-cookie-session.js

@@ -0,0 +1,183 @@
+import path from 'node:path';
+import { rm } from 'node:fs/promises';
+import { browserFamily } from './browser-sources.js';
+import { matchesDomains } from './migration/domains.js';
+import {
+  resolveBrowserProfile,
+  resolveSourceBrowser,
+} from './browser-profiles.js';
+import { saveStorageState } from './storage-state.js';
+import { setCookies } from './session-cookies.js';
+
+/** Decrypt through the source browser in a disposable cookie-only snapshot. */
+export async function readBrowserCookieSession(options, dependencies = {}) {
+  const browser = await resolveSourceBrowser(options.browser, dependencies);
+  if (browserFamily(browser) !== 'chromium') {
+    throw new TypeError(
+      'Browser-backed cookie reading requires a Chromium snapshot; use via: database for Firefox or Safari'
+    );
+  }
+  const profile = options.profileDir
+    ? { path: options.profileDir }
+    : await resolveBrowserProfile({
+        ...dependencies,
+        browser,
+        profile: options.profile,
+      });
+  const launch =
+    dependencies.launch ??
+    (await import('./real-browser.js')).launchRealBrowser;
+  const result = await launch({
+    ...options.launchOptions,
+    channel: browser,
+    engine: options.engine ?? 'playwright',
+    attach: {
+      mode: 'snapshot',
+      browser,
+      profile: path.basename(profile.path),
+      userDataDir: path.dirname(profile.path),
+      include: ['cookies'],
+    },
+  });
+  try {
+    const state = await saveStorageState(result.page);
+    return state.cookies.filter((cookie) =>
+      matchesDomains(
+        cookie.domain,
+        options.domains ?? (options.domainFilter ? [options.domainFilter] : [])
+      )
+    );
+  } finally {
+    await result.close();
+  }
+}
+
+async function readDatabaseSession(source, options, dependencies) {
+  const read =
+    dependencies.readCookies ??
+    (await import('./browser-cookies.js')).readBrowserCookies;
+  const cookies = (
+    await read({
+      browser: source.browser,
+      profileDir: source.path,
+      via: 'database',
+      cache: false,
+    })
+  ).filter((cookie) => matchesDomains(cookie.domain, options.domains));
+  let loggedIn = null;
+  if (options.isLoggedIn) {
+    const launch =
+      dependencies.launch ?? (await import('./launcher.js')).launchBrowser;
+    const engine = source.engine ?? options.engine ?? 'playwright';
+    const result = await launch({
+      ...options.launchOptions,
+      ...source.launchOptions,
+      engine,
+      launch: 'engine',
+      userDataDir: undefined,
+      attach: undefined,
+      persistSessionCookies: false,
+    });
+    try {
+      await setCookies({ page: result.page, engine, cookies });
+      loggedIn = Boolean(
+        await options.isLoggedIn({ ...result, source, cookies })
+      );
+    } finally {
+      await result.close();
+    }
+  }
+  return { ...source, cookies, loggedIn };
+}
+
+/** Discover candidate profiles and optionally validate their live sign-in state. */
+export async function findSiteSessions(options = {}, dependencies = {}) {
+  if (!Array.isArray(options.domains) || !options.domains.length) {
+    throw new TypeError('findSiteSessions requires domains');
+  }
+  const list =
+    dependencies.listSources ??
+    (await import('./browser-cookies.js')).listCookieSources;
+  const sources = [
+    ...(options.sources ?? (await list({ domains: options.domains }))),
+    ...(options.profiles ?? []),
+  ];
+  const sessions = [];
+  for (const source of sources) {
+    let result;
+    let snapshot;
+    try {
+      if (browserFamily(source.browser) !== 'chromium') {
+        sessions.push(await readDatabaseSession(source, options, dependencies));
+        continue;
+      }
+      const attach = {
+        mode: 'snapshot',
+        browser: source.browser,
+        profile: path.basename(source.path),
+        userDataDir: path.dirname(source.path),
+        include: ['cookies'],
+      };
+      if (source.launch === 'engine') {
+        const copy =
+          dependencies.snapshot ??
+          (await import('./attach/snapshot.js')).snapshotUserDataDir;
+        snapshot = await copy(attach);
+        const launch =
+          dependencies.launch ?? (await import('./launcher.js')).launchBrowser;
+        result = await launch({
+          ...options.launchOptions,
+          ...source.launchOptions,
+          engine: source.engine ?? options.engine ?? 'playwright',
+          launch: 'engine',
+          userDataDir: snapshot.target,
+          args: [
+            ...(options.launchOptions?.args ?? []),
+            ...(source.launchOptions?.args ?? []),
+            `--profile-directory=${attach.profile}`,
+          ],
+        });
+      } else {
+        const launch =
+          dependencies.launch ??
+          (await import('./real-browser.js')).launchRealBrowser;
+        result = await launch({
+          ...options.launchOptions,
+          engine: source.engine ?? options.engine ?? 'playwright',
+          channel: source.browser,
+          attach,
+        });
+      }
+      const state = await saveStorageState(result.page);
+      const cookies = state.cookies.filter((cookie) =>
+        matchesDomains(cookie.domain, options.domains)
+      );
+      const loggedIn = options.isLoggedIn
+        ? Boolean(await options.isLoggedIn({ ...result, source, cookies }))
+        : null;
+      sessions.push({ ...source, cookies, loggedIn });
+    } catch (error) {
+      sessions.push({
+        ...source,
+        cookies: [],
+        loggedIn: null,
+        error: error.message,
+      });
+    } finally {
+      try {
+        await result?.close();
+      } catch (error) {
+        sessions.at(-1).error = error.message;
+      } finally {
+        if (snapshot) {
+          try {
+            await rm(snapshot.target, { recursive: true, force: true });
+          } catch (error) {
+            sessions.at(-1).error = error.message;
+          }
+        }
+      }
+    }
+  }
+  return sessions;
+}