stealth-cli 0.5.1 → 0.6.0

package/src/utils/browser-factory.js

@@ -0,0 +1,86 @@
+/**
+ * Shared browser bootstrap utilities
+ * Eliminates duplication across browser.js, daemon.js, serve.js, mcp-server.js
+ */
+
+import os from 'os';
+import { launchOptions } from 'camoufox-js';
+import { firefox } from 'playwright-core';
+
+/**
+ * Detect host OS for Camoufox fingerprint matching
+ */
+export function getHostOS() {
+  const platform = os.platform();
+  if (platform === 'darwin') return 'macos';
+  if (platform === 'win32') return 'windows';
+  return 'linux';
+}
+
+/**
+ * Launch a Camoufox browser instance with standard settings
+ *
+ * @param {object} opts
+ * @param {boolean} [opts.headless=true]
+ * @param {string} [opts.os] - Override OS (default: auto-detect)
+ * @param {object} [opts.proxy] - { server, username?, password? }
+ * @returns {Promise<import('playwright-core').Browser>}
+ */
+export async function createBrowser(opts = {}) {
+  const {
+    headless = true,
+    os: targetOS,
+    proxy,
+  } = opts;
+
+  const options = await launchOptions({
+    headless,
+    os: targetOS || getHostOS(),
+    // Camoufox's `humanize` controls low-level fingerprint randomization (canvas noise, etc.)
+    // This is NOT the same as stealth-cli's --humanize flag (which controls mouse/scroll/type simulation).
+    // Always enabled for anti-detection effectiveness.
+    humanize: true,
+    enable_cache: true,
+    proxy: proxy || undefined,
+    geoip: !!proxy,
+  });
+
+  return firefox.launch(options);
+}
+
+/**
+ * Create a standard browser context
+ *
+ * @param {import('playwright-core').Browser} browser
+ * @param {object} opts
+ * @returns {Promise<import('playwright-core').BrowserContext>}
+ */
+export async function createContext(browser, opts = {}) {
+  const {
+    locale = 'en-US',
+    timezone = 'America/Los_Angeles',
+    viewport = { width: 1280, height: 720 },
+    geo = { latitude: 37.7749, longitude: -122.4194 },
+  } = opts;
+
+  return browser.newContext({
+    viewport,
+    locale,
+    timezoneId: timezone,
+    permissions: ['geolocation'],
+    geolocation: geo,
+  });
+}
+
+/**
+ * Extract visible text from a page.
+ * Pass directly to page.evaluate() — must not reference Node.js scope.
+ * Using a function (not a string) avoids eval-injection risks.
+ */
+export function extractPageText() {
+  const body = document.body;
+  if (!body) return '';
+  const clone = body.cloneNode(true);
+  clone.querySelectorAll('script, style, noscript').forEach(el => el.remove());
+  return clone.innerText || clone.textContent || '';
+}

package/src/utils/resolve-opts.js

@@ -0,0 +1,83 @@
+/**
+ * Merge global config with CLI options.
+ * Priority: CLI explicit opts > global config > defaults
+ *
+ * Special handling for Commander's --no-xxx pattern:
+ *   Commander sets `headless: true` by default even when user didn't pass --headless.
+ *   We can't tell "default true" from "explicit --headless". So when the CLI value
+ *   matches Commander's auto-default AND global config has a different value,
+ *   we let global config win.
+ */
+
+import { loadConfig, DEFAULTS } from '../config.js';
+
+// Commander auto-defaults for --no-xxx flags.
+// When CLI value === auto-default, it may be Commander's default, not user intent.
+const COMMANDER_AUTO_DEFAULTS = {
+  headless: true,
+};
+
+// Keys from config.js DEFAULTS that map to CLI option names
+const CONFIG_TO_CLI = {
+  headless: 'headless',
+  locale: 'locale',
+  timezone: 'timezone',
+  timeout: 'timeout',
+  retries: 'retries',
+  humanize: 'humanize',
+  delay: 'delay',
+  format: 'format',
+  proxy: 'proxy',
+  viewportWidth: 'viewportWidth',
+  viewportHeight: 'viewportHeight',
+};
+
+// Numeric fields that Commander passes as strings
+const NUMERIC_KEYS = [
+  'retries', 'timeout', 'delay', 'viewportWidth', 'viewportHeight',
+  'wait', 'depth', 'limit', 'interval', 'count', 'port', 'num', 'width', 'height',
+];
+
+/**
+ * Resolve final options by merging:
+ *   1. Built-in defaults (from config.js DEFAULTS)
+ *   2. User's global config (~/.stealth/config.json)
+ *   3. CLI arguments (highest priority)
+ *
+ * @param {object} cliOpts - Options from Commander action
+ * @returns {object} Merged options
+ */
+export function resolveOpts(cliOpts = {}) {
+  const globalConfig = loadConfig(); // merges DEFAULTS + user config file
+
+  // Start with global config values
+  const merged = {};
+  for (const [configKey, cliKey] of Object.entries(CONFIG_TO_CLI)) {
+    merged[cliKey] = globalConfig[configKey];
+  }
+
+  // Overlay CLI options (only if explicitly provided)
+  for (const [key, value] of Object.entries(cliOpts)) {
+    if (value === undefined) continue;
+
+    // Handle Commander auto-defaults: if CLI value matches the auto-default
+    // and user has set a different value in global config, let config win.
+    if (key in COMMANDER_AUTO_DEFAULTS && value === COMMANDER_AUTO_DEFAULTS[key]) {
+      if (merged[key] !== undefined && merged[key] !== DEFAULTS[key]) {
+        continue; // Global config has a user-set value — don't overwrite with auto-default
+      }
+    }
+
+    merged[key] = value;
+  }
+
+  // Coerce numeric fields (Commander passes CLI values as strings)
+  for (const key of NUMERIC_KEYS) {
+    if (typeof merged[key] === 'string') {
+      const n = parseInt(merged[key], 10);
+      if (!isNaN(n)) merged[key] = n;
+    }
+  }
+
+  return merged;
+}