@agent-infra/browser 0.0.2 → 0.1.0

package/dist/browser-finder.mjs

@@ -1,116 +0,0 @@
-/**
-* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
-* SPDX-License-Identifier: Apache-2.0
-*/
-import * as __WEBPACK_EXTERNAL_MODULE_fs__ from "fs";
-import * as __WEBPACK_EXTERNAL_MODULE_path__ from "path";
-import * as __WEBPACK_EXTERNAL_MODULE_os__ from "os";
-import * as __WEBPACK_EXTERNAL_MODULE__agent_infra_logger_ddae3da2__ from "@agent-infra/logger";
-function _define_property(obj, key, value) {
-    if (key in obj) Object.defineProperty(obj, key, {
-        value: value,
-        enumerable: true,
-        configurable: true,
-        writable: true
-    });
-    else obj[key] = value;
-    return obj;
-}
-class BrowserFinder {
-    get browsers() {
-        const HOME_DIR = __WEBPACK_EXTERNAL_MODULE_os__.homedir();
-        const LOCAL_APP_DATA = process.env.LOCALAPPDATA;
-        return [
-            {
-                name: 'Chromium',
-                executable: {
-                    win32: 'C:\\Program Files\\Chromium\\Application\\chrome.exe',
-                    darwin: '/Applications/Chromium.app/Contents/MacOS/Chromium',
-                    linux: '/usr/bin/chromium'
-                },
-                userDataDir: {
-                    win32: `${LOCAL_APP_DATA}\\Chromium\\User Data`,
-                    darwin: `${HOME_DIR}/Library/Application Support/Chromium`,
-                    linux: `${HOME_DIR}/.config/chromium`
-                }
-            },
-            {
-                name: 'Google Chrome',
-                executable: {
-                    win32: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-                    darwin: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-                    linux: '/usr/bin/google-chrome'
-                },
-                userDataDir: {
-                    win32: `${LOCAL_APP_DATA}\\Google\\Chrome\\User Data`,
-                    darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome`,
-                    linux: `${HOME_DIR}/.config/google-chrome`
-                }
-            },
-            {
-                name: 'Google Chrome Canary',
-                executable: {
-                    win32: 'C:\\Program Files\\Google\\Chrome Canary\\Application\\chrome.exe',
-                    darwin: '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
-                    linux: '/usr/bin/google-chrome-canary'
-                },
-                userDataDir: {
-                    win32: `${LOCAL_APP_DATA}\\Google\\Chrome Canary\\User Data`,
-                    darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome Canary`,
-                    linux: `${HOME_DIR}/.config/google-chrome-canary`
-                }
-            }
-        ];
-    }
-    findBrowser(name) {
-        const platform = process.platform;
-        this.logger.info('Finding browser on platform:', platform);
-        if ('darwin' !== platform && 'win32' !== platform && 'linux' !== platform) {
-            const error = new Error(`Unsupported platform: ${platform}`);
-            this.logger.error(error.message);
-            throw error;
-        }
-        const browser = name ? this.browsers.find((b)=>b.name === name && __WEBPACK_EXTERNAL_MODULE_fs__.existsSync(b.executable[platform])) : this.browsers.find((b)=>__WEBPACK_EXTERNAL_MODULE_fs__.existsSync(b.executable[platform]));
-        this.logger.log('browser', browser);
-        if (!browser) {
-            const error = name ? new Error(`Cannot find browser: ${name}`) : new Error('Cannot find a supported browser on your system. Please install Chrome, Edge, or Brave.');
-            this.logger.error(error.message);
-            throw error;
-        }
-        const result = {
-            executable: browser.executable[platform],
-            userDataDir: browser.userDataDir[platform]
-        };
-        this.logger.success(`Found browser: ${browser.name}`);
-        this.logger.info('Browser details:', result);
-        return result;
-    }
-    getBrowserProfiles(browserName) {
-        const browser = this.findBrowser(browserName);
-        try {
-            const localState = JSON.parse(__WEBPACK_EXTERNAL_MODULE_fs__.readFileSync(__WEBPACK_EXTERNAL_MODULE_path__.join(browser.userDataDir, 'Local State'), 'utf8'));
-            const profileInfo = localState.profile.info_cache;
-            return Object.entries(profileInfo).map(([profileName, info])=>({
-                    displayName: info.name,
-                    path: __WEBPACK_EXTERNAL_MODULE_path__.join(browser.userDataDir, profileName)
-                }));
-        } catch (error) {
-            return [];
-        }
-    }
-    findChrome() {
-        try {
-            const { executable } = this.findBrowser('Google Chrome');
-            return executable;
-        } catch  {
-            return null;
-        }
-    }
-    constructor(logger){
-        _define_property(this, "logger", void 0);
-        this.logger = logger ?? __WEBPACK_EXTERNAL_MODULE__agent_infra_logger_ddae3da2__.defaultLogger;
-    }
-}
-export { BrowserFinder };
-
-//# sourceMappingURL=browser-finder.mjs.map

package/dist/browser-finder.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-finder.mjs","sources":["webpack://@agent-infra/browser/./src/browser-finder.ts"],"sourcesContent":["/**\n * The following code is modified based on\n * https://github.com/egoist/local-web-search/blob/main/src/find-browser.ts\n *\n * MIT Licensed\n * Copyright (c) 2025 ChatWise (https://chatwise.app) <kevin@chatwise.app>\n * https://github.com/egoist/local-web-search/blob/main/LICENSE\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { Logger, defaultLogger } from '@agent-infra/logger';\n\n/**\n * Interface defining browser locations and configurations\n * Contains paths and settings for different operating systems\n * @interface Browser\n */\ninterface Browser {\n  /**\n   * Browser name identifier\n   */\n  name: string;\n\n  /**\n   * Executable paths by platform\n   * @property {string} win32 - Windows executable path\n   * @property {string} darwin - macOS executable path\n   * @property {string} linux - Linux executable path\n   */\n  executable: {\n    win32: string;\n    darwin: string;\n    linux: string;\n  };\n\n  /**\n   * User data directory paths by platform\n   * @property {string} win32 - Windows user data directory\n   * @property {string} darwin - macOS user data directory\n   * @property {string} linux - Linux user data directory\n   */\n  userDataDir: {\n    win32: string;\n    darwin: string;\n    linux: string;\n  };\n}\n\n/**\n * Class responsible for finding and managing browser installations\n * Detects installed browsers and their profiles across different platforms\n */\nexport class BrowserFinder {\n  /**\n   * Logger instance for diagnostic output\n   * @private\n   */\n  private logger: Logger;\n\n  /**\n   * Creates a new BrowserFinder instance\n   * @param {Logger} [logger] - Optional custom logger\n   */\n  constructor(logger?: Logger) {\n    this.logger = logger ?? defaultLogger;\n  }\n\n  /**\n   * Getter that returns the list of supported browsers with their platform-specific paths\n   * @returns {Browser[]} Array of browser configurations\n   * @private\n   */\n  private get browsers(): Browser[] {\n    // Get HOME_DIR inside the getter to ensure it's always current\n    const HOME_DIR = os.homedir();\n    const LOCAL_APP_DATA = process.env.LOCALAPPDATA;\n\n    return [\n      {\n        name: 'Chromium',\n        executable: {\n          win32: 'C:\\\\Program Files\\\\Chromium\\\\Application\\\\chrome.exe',\n          darwin: '/Applications/Chromium.app/Contents/MacOS/Chromium',\n          linux: '/usr/bin/chromium',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Chromium\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Chromium`,\n          linux: `${HOME_DIR}/.config/chromium`,\n        },\n      },\n      {\n        name: 'Google Chrome',\n        executable: {\n          win32: 'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n          darwin:\n            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n          linux: '/usr/bin/google-chrome',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Google\\\\Chrome\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome`,\n          linux: `${HOME_DIR}/.config/google-chrome`,\n        },\n      },\n      {\n        name: 'Google Chrome Canary',\n        executable: {\n          win32:\n            'C:\\\\Program Files\\\\Google\\\\Chrome Canary\\\\Application\\\\chrome.exe',\n          darwin:\n            '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n          linux: '/usr/bin/google-chrome-canary',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Google\\\\Chrome Canary\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome Canary`,\n          linux: `${HOME_DIR}/.config/google-chrome-canary`,\n        },\n      },\n    ];\n  }\n\n  /**\n   * Find a specific browser or the first available browser\n   * @param {string} [name] - Optional browser name to find\n   * @returns {{ executable: string; userDataDir: string }} Browser executable and user data paths\n   * @throws {Error} If no supported browser is found or the platform is unsupported\n   */\n  findBrowser(name?: string): {\n    executable: string;\n    userDataDir: string;\n  } {\n    const platform = process.platform;\n    this.logger.info('Finding browser on platform:', platform);\n\n    if (platform !== 'darwin' && platform !== 'win32' && platform !== 'linux') {\n      const error = new Error(`Unsupported platform: ${platform}`);\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    const browser = name\n      ? this.browsers.find(\n          (b) => b.name === name && fs.existsSync(b.executable[platform]),\n        )\n      : this.browsers.find((b) => fs.existsSync(b.executable[platform]));\n\n    this.logger.log('browser', browser);\n\n    if (!browser) {\n      const error = name\n        ? new Error(`Cannot find browser: ${name}`)\n        : new Error(\n            'Cannot find a supported browser on your system. Please install Chrome, Edge, or Brave.',\n          );\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    const result = {\n      executable: browser.executable[platform],\n      userDataDir: browser.userDataDir[platform],\n    };\n\n    this.logger.success(`Found browser: ${browser.name}`);\n    this.logger.info('Browser details:', result);\n\n    return result;\n  }\n\n  /**\n   * Get browser profiles for a specific browser\n   * Reads the Local State file to extract profile information\n   * @param {string} [browserName] - Optional browser name to get profiles for\n   * @returns {Array<{ displayName: string; path: string }>} Array of profile objects with display names and paths\n   */\n  getBrowserProfiles(\n    browserName?: string,\n  ): Array<{ displayName: string; path: string }> {\n    const browser = this.findBrowser(browserName);\n\n    try {\n      const localState = JSON.parse(\n        fs.readFileSync(path.join(browser.userDataDir, 'Local State'), 'utf8'),\n      );\n      const profileInfo = localState.profile.info_cache;\n\n      return Object.entries(profileInfo).map(\n        ([profileName, info]: [string, any]) => ({\n          displayName: info.name,\n          path: path.join(browser.userDataDir, profileName),\n        }),\n      );\n    } catch (error) {\n      return [];\n    }\n  }\n\n  /**\n   * Legacy method for backwards compatibility\n   * Finds Chrome browser executable path\n   * @deprecated Use findBrowser instead\n   * @returns {string | null} Chrome executable path or null if not found\n   */\n  findChrome(): string | null {\n    try {\n      const { executable } = this.findBrowser('Google Chrome');\n      return executable;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["BrowserFinder","HOME_DIR","os","LOCAL_APP_DATA","process","name","platform","error","Error","browser","b","fs","result","browserName","localState","JSON","path","profileInfo","Object","profileName","info","executable","logger","defaultLogger"],"mappings":"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"}

package/dist/browser-finder.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=browser-finder.test.d.ts.map

package/dist/browser-finder.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-finder.test.d.ts","sourceRoot":"","sources":["../src/browser-finder.test.ts"],"names":[],"mappings":""}