browsecraft 0.1.0

package/dist/cli.cjs

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+'use strict';
+
+var chunkKIPQFK3Y_cjs = require('./chunk-KIPQFK3Y.cjs');
+var path = require('path');
+var fs = require('fs');
+var url = require('url');
+var browsecraftRunner = require('browsecraft-runner');
+
+var VERSION = "0.1.0";
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(`browsecraft v${VERSION}`);
+    return;
+  }
+  const command = args[0];
+  switch (command) {
+    case "test":
+      await runTests(args.slice(1));
+      break;
+    case "init":
+      await initProject();
+      break;
+    default:
+      if (command && (command.endsWith(".ts") || command.endsWith(".js"))) {
+        await runTests(args);
+      } else {
+        console.error(`Unknown command: ${command}`);
+        console.error('Run "browsecraft --help" for usage information.');
+        process.exit(1);
+      }
+  }
+}
+async function runTests(args) {
+  const flags = parseFlags(args);
+  const filePatterns = args.filter((a) => !a.startsWith("--"));
+  const userConfig = await loadConfig();
+  const config = chunkKIPQFK3Y_cjs.resolveConfig(userConfig);
+  if (flags.headed || flags.headless === false) {
+    config.headless = false;
+  }
+  if (flags.browser) {
+    config.browser = flags.browser;
+  }
+  if (flags.workers !== void 0) {
+    config.workers = flags.workers;
+  }
+  if (flags.timeout !== void 0) {
+    config.timeout = flags.timeout;
+  }
+  if (flags.retries !== void 0) {
+    config.retries = flags.retries;
+  }
+  if (flags.debug) {
+    config.debug = true;
+  }
+  const runnerOptions = {
+    config,
+    files: filePatterns.length > 0 ? filePatterns : void 0,
+    grep: flags.grep,
+    bail: flags.bail
+  };
+  const runner = new browsecraftRunner.TestRunner(runnerOptions);
+  const loadFile = async (file) => {
+    const startIdx = chunkKIPQFK3Y_cjs.testRegistry.length;
+    if (file.endsWith(".ts") || file.endsWith(".mts")) {
+      await ensureTypeScriptLoader();
+    }
+    const fileUrl = url.pathToFileURL(file).href;
+    await import(fileUrl);
+    return chunkKIPQFK3Y_cjs.testRegistry.slice(startIdx).map((tc) => ({
+      title: tc.title,
+      suitePath: tc.suitePath,
+      skip: tc.skip,
+      only: tc.only,
+      options: tc.options,
+      fn: tc.fn
+    }));
+  };
+  let sharedBrowser;
+  try {
+    sharedBrowser = await chunkKIPQFK3Y_cjs.Browser.launch({
+      browser: config.browser,
+      headless: config.headless,
+      executablePath: config.executablePath,
+      debug: config.debug,
+      timeout: config.timeout
+    });
+  } catch (err) {
+    console.error(`Failed to launch browser: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  const executeTest = async (test) => {
+    return chunkKIPQFK3Y_cjs.runTest(test, sharedBrowser);
+  };
+  try {
+    const exitCode = await runner.run(loadFile, executeTest);
+    await sharedBrowser.close().catch(() => {
+    });
+    process.exit(exitCode);
+  } catch (err) {
+    await sharedBrowser?.close().catch(() => {
+    });
+    throw err;
+  }
+}
+async function initProject() {
+  const cwd = process.cwd();
+  console.log("\n  Browsecraft - Project Setup\n");
+  const configPath = path.join(cwd, "browsecraft.config.ts");
+  if (!fs.existsSync(configPath)) {
+    fs.writeFileSync(configPath, `import { defineConfig } from 'browsecraft';
+
+export default defineConfig({
+  // Browser to use: 'chrome' | 'firefox' | 'edge'
+  browser: 'chrome',
+
+  // Run tests in headless mode
+  headless: true,
+
+  // Base URL for page.goto() calls
+  // baseURL: 'http://localhost:3000',
+
+  // Global timeout for actions (ms)
+  timeout: 30_000,
+
+  // Take screenshots on failure
+  screenshot: 'on-failure',
+});
+`);
+    console.log("  Created browsecraft.config.ts");
+  } else {
+    console.log("  browsecraft.config.ts already exists, skipping");
+  }
+  const testsDir = path.join(cwd, "tests");
+  if (!fs.existsSync(testsDir)) {
+    fs.mkdirSync(testsDir, { recursive: true });
+  }
+  const exampleTest = path.join(testsDir, "example.test.ts");
+  if (!fs.existsSync(exampleTest)) {
+    fs.writeFileSync(exampleTest, `import { test, expect } from 'browsecraft';
+
+test('homepage has correct title', async ({ page }) => {
+  await page.goto('https://example.com');
+  await expect(page).toHaveTitle('Example Domain');
+});
+
+test('can navigate to more info', async ({ page }) => {
+  await page.goto('https://example.com');
+  await page.click('More information');
+  await expect(page).toHaveURL(/iana\\.org/);
+});
+`);
+    console.log("  Created tests/example.test.ts");
+  } else {
+    console.log("  tests/example.test.ts already exists, skipping");
+  }
+  const gitignorePath = path.join(cwd, ".gitignore");
+  if (fs.existsSync(gitignorePath)) {
+    const content = await import('fs').then((fs) => fs.readFileSync(gitignorePath, "utf-8"));
+    if (!content.includes(".browsecraft")) {
+      fs.writeFileSync(gitignorePath, `${content.trimEnd()}
+
+# Browsecraft
+.browsecraft/
+`);
+      console.log("  Updated .gitignore");
+    }
+  }
+  console.log("\n  Setup complete! Run your first test:\n");
+  console.log("    npx browsecraft test\n");
+}
+async function loadConfig() {
+  const cwd = process.cwd();
+  const candidates = [
+    "browsecraft.config.ts",
+    "browsecraft.config.js",
+    "browsecraft.config.mjs",
+    "browsecraft.config.mts"
+  ];
+  for (const name of candidates) {
+    const configPath = path.resolve(cwd, name);
+    if (fs.existsSync(configPath)) {
+      try {
+        const mod = await import(configPath);
+        return mod.default ?? mod;
+      } catch {
+        console.warn(`Warning: Could not load ${name}. Using defaults.`);
+      }
+    }
+  }
+  return void 0;
+}
+var tsLoaderRegistered = false;
+async function ensureTypeScriptLoader() {
+  if (tsLoaderRegistered) return;
+  const execArgs = process.execArgv.join(" ");
+  if (execArgs.includes("tsx") || execArgs.includes("ts-node") || execArgs.includes("loader") || process.versions.bun) {
+    tsLoaderRegistered = true;
+    return;
+  }
+  for (const loader of ["tsx/esm", "ts-node/esm"]) {
+    try {
+      const { register } = await import('module');
+      if (typeof register === "function") {
+        register(loader, url.pathToFileURL("./"));
+        tsLoaderRegistered = true;
+        return;
+      }
+    } catch {
+    }
+  }
+  console.error(
+    "\n  Error: Cannot import TypeScript test files.\n  Install tsx (recommended) or ts-node:\n\n    npm install -D tsx\n\n  Or run browsecraft with tsx:\n\n    npx tsx node_modules/.bin/browsecraft test\n"
+  );
+  process.exit(1);
+}
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--headed":
+        flags.headed = true;
+        break;
+      case "--headless":
+        flags.headless = true;
+        break;
+      case "--debug":
+        flags.debug = true;
+        break;
+      case "--bail":
+        flags.bail = true;
+        break;
+      case "--browser":
+        flags.browser = args[++i];
+        break;
+      case "--workers":
+        flags.workers = Number.parseInt(args[++i] ?? "1", 10);
+        break;
+      case "--timeout":
+        flags.timeout = Number.parseInt(args[++i] ?? "30000", 10);
+        break;
+      case "--retries":
+        flags.retries = Number.parseInt(args[++i] ?? "0", 10);
+        break;
+      case "--grep":
+      case "-g":
+        flags.grep = args[++i];
+        break;
+    }
+  }
+  return flags;
+}
+function printHelp() {
+  console.log(`
+  browsecraft v${VERSION} -- AI-native browser testing
+
+  Usage:
+    browsecraft test [files...] [options]
+    browsecraft init
+
+  Commands:
+    test          Run browser tests
+    init          Create a new project with example config and test
+
+  Options:
+    --browser <name>    Browser to use: chrome, firefox, edge (default: chrome)
+    --headed            Run in headed mode (show the browser)
+    --headless          Run in headless mode (default)
+    --workers <n>       Number of parallel workers (default: half CPU cores)
+    --timeout <ms>      Global timeout in milliseconds (default: 30000)
+    --retries <n>       Retry failed tests n times (default: 0)
+    --grep <pattern>    Only run tests matching pattern
+    --bail              Stop after first failure
+    --debug             Enable verbose debug logging
+    -h, --help          Show this help message
+    -v, --version       Show version
+
+  Examples:
+    browsecraft test                          # Run all tests
+    browsecraft test tests/login.test.ts      # Run specific file
+    browsecraft test --headed --browser firefox
+    browsecraft test --grep "login" --bail
+`);
+}
+main().catch((err) => {
+  console.error("Fatal error:", err.message);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":["resolveConfig","TestRunner","testRegistry","pathToFileURL","Browser","runTest","join","existsSync","writeFileSync","mkdirSync","resolve"],"mappings":"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","file":"cli.cjs","sourcesContent":["#!/usr/bin/env node\n// ============================================================================\n// Browsecraft - CLI\n// The command-line interface for running tests and initializing projects.\n//\n// npx browsecraft test              # Run all tests\n// npx browsecraft test login.test.ts # Run specific file\n// npx browsecraft init              # Scaffold a new project\n// npx browsecraft --help            # Show help\n// ============================================================================\n\nimport { resolve, join } from 'node:path';\nimport { existsSync, writeFileSync, mkdirSync } from 'node:fs';\nimport { pathToFileURL } from 'node:url';\nimport { TestRunner, type RunnerOptions, type RunnableTest } from 'browsecraft-runner';\nimport { resolveConfig, type UserConfig } from './config.js';\nimport { testRegistry, runTest, runAfterAllHooks, type TestCase } from './test.js';\nimport { Browser } from './browser.js';\n\nconst VERSION = '0.1.0';\n\nasync function main() {\n\tconst args = process.argv.slice(2);\n\n\tif (args.length === 0 || args.includes('--help') || args.includes('-h')) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\n\tif (args.includes('--version') || args.includes('-v')) {\n\t\tconsole.log(`browsecraft v${VERSION}`);\n\t\treturn;\n\t}\n\n\tconst command = args[0];\n\n\tswitch (command) {\n\t\tcase 'test':\n\t\t\tawait runTests(args.slice(1));\n\t\t\tbreak;\n\t\tcase 'init':\n\t\t\tawait initProject();\n\t\t\tbreak;\n\t\tdefault:\n\t\t\t// If no command, assume it's a file path to test\n\t\t\tif (command && (command.endsWith('.ts') || command.endsWith('.js'))) {\n\t\t\t\tawait runTests(args);\n\t\t\t} else {\n\t\t\t\tconsole.error(`Unknown command: ${command}`);\n\t\t\t\tconsole.error('Run \"browsecraft --help\" for usage information.');\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Test Command\n// ---------------------------------------------------------------------------\n\nasync function runTests(args: string[]) {\n\t// Parse CLI flags\n\tconst flags = parseFlags(args);\n\tconst filePatterns = args.filter(a => !a.startsWith('--'));\n\n\t// Load config file if it exists\n\tconst userConfig = await loadConfig();\n\tconst config = resolveConfig(userConfig);\n\n\t// Apply CLI overrides\n\tif (flags.headed || flags.headless === false) {\n\t\tconfig.headless = false;\n\t}\n\tif (flags.browser) {\n\t\tconfig.browser = flags.browser as any;\n\t}\n\tif (flags.workers !== undefined) {\n\t\tconfig.workers = flags.workers;\n\t}\n\tif (flags.timeout !== undefined) {\n\t\tconfig.timeout = flags.timeout;\n\t}\n\tif (flags.retries !== undefined) {\n\t\tconfig.retries = flags.retries;\n\t}\n\tif (flags.debug) {\n\t\tconfig.debug = true;\n\t}\n\n\t// Set up runner options\n\tconst runnerOptions: RunnerOptions = {\n\t\tconfig,\n\t\tfiles: filePatterns.length > 0 ? filePatterns : undefined,\n\t\tgrep: flags.grep,\n\t\tbail: flags.bail,\n\t};\n\n\t// Run tests\n\tconst runner = new TestRunner(runnerOptions);\n\n\t// loadFile callback: imports the test file and returns registered tests\n\tconst loadFile = async (file: string): Promise<RunnableTest[]> => {\n\t\tconst startIdx = testRegistry.length;\n\n\t\t// For TypeScript files, register a TypeScript loader if available\n\t\tif (file.endsWith('.ts') || file.endsWith('.mts')) {\n\t\t\tawait ensureTypeScriptLoader();\n\t\t}\n\n\t\tconst fileUrl = pathToFileURL(file).href;\n\t\tawait import(fileUrl);\n\t\treturn testRegistry.slice(startIdx).map(tc => ({\n\t\t\ttitle: tc.title,\n\t\t\tsuitePath: tc.suitePath,\n\t\t\tskip: tc.skip,\n\t\t\tonly: tc.only,\n\t\t\toptions: tc.options,\n\t\t\tfn: tc.fn as (fixtures: unknown) => Promise<void>,\n\t\t}));\n\t};\n\n\t// Launch a shared browser for all tests\n\tlet sharedBrowser: Browser | undefined;\n\n\ttry {\n\t\tsharedBrowser = await Browser.launch({\n\t\t\tbrowser: config.browser,\n\t\t\theadless: config.headless,\n\t\t\texecutablePath: config.executablePath,\n\t\t\tdebug: config.debug,\n\t\t\ttimeout: config.timeout,\n\t\t});\n\t} catch (err) {\n\t\tconsole.error(`Failed to launch browser: ${err instanceof Error ? err.message : String(err)}`);\n\t\tprocess.exit(1);\n\t}\n\n\t// executeTest callback: runs a single test with fixture setup/teardown\n\tconst executeTest = async (test: RunnableTest) => {\n\t\treturn runTest(test as unknown as TestCase, sharedBrowser);\n\t};\n\n\ttry {\n\t\tconst exitCode = await runner.run(loadFile, executeTest);\n\t\tawait sharedBrowser.close().catch(() => {});\n\t\tprocess.exit(exitCode);\n\t} catch (err) {\n\t\tawait sharedBrowser?.close().catch(() => {});\n\t\tthrow err;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Init Command\n// ---------------------------------------------------------------------------\n\nasync function initProject() {\n\tconst cwd = process.cwd();\n\n\tconsole.log('\\n  Browsecraft - Project Setup\\n');\n\n\t// Create config file\n\tconst configPath = join(cwd, 'browsecraft.config.ts');\n\tif (!existsSync(configPath)) {\n\t\twriteFileSync(configPath, `import { defineConfig } from 'browsecraft';\n\nexport default defineConfig({\n  // Browser to use: 'chrome' | 'firefox' | 'edge'\n  browser: 'chrome',\n\n  // Run tests in headless mode\n  headless: true,\n\n  // Base URL for page.goto() calls\n  // baseURL: 'http://localhost:3000',\n\n  // Global timeout for actions (ms)\n  timeout: 30_000,\n\n  // Take screenshots on failure\n  screenshot: 'on-failure',\n});\n`);\n\t\tconsole.log('  Created browsecraft.config.ts');\n\t} else {\n\t\tconsole.log('  browsecraft.config.ts already exists, skipping');\n\t}\n\n\t// Create example test\n\tconst testsDir = join(cwd, 'tests');\n\tif (!existsSync(testsDir)) {\n\t\tmkdirSync(testsDir, { recursive: true });\n\t}\n\n\tconst exampleTest = join(testsDir, 'example.test.ts');\n\tif (!existsSync(exampleTest)) {\n\t\twriteFileSync(exampleTest, `import { test, expect } from 'browsecraft';\n\ntest('homepage has correct title', async ({ page }) => {\n  await page.goto('https://example.com');\n  await expect(page).toHaveTitle('Example Domain');\n});\n\ntest('can navigate to more info', async ({ page }) => {\n  await page.goto('https://example.com');\n  await page.click('More information');\n  await expect(page).toHaveURL(/iana\\\\.org/);\n});\n`);\n\t\tconsole.log('  Created tests/example.test.ts');\n\t} else {\n\t\tconsole.log('  tests/example.test.ts already exists, skipping');\n\t}\n\n\t// Add .browsecraft to .gitignore\n\tconst gitignorePath = join(cwd, '.gitignore');\n\tif (existsSync(gitignorePath)) {\n\t\tconst content = await import('node:fs').then(fs => fs.readFileSync(gitignorePath, 'utf-8'));\n\t\tif (!content.includes('.browsecraft')) {\n\t\t\twriteFileSync(gitignorePath, `${content.trimEnd()}\\n\\n# Browsecraft\\n.browsecraft/\\n`);\n\t\t\tconsole.log('  Updated .gitignore');\n\t\t}\n\t}\n\n\tconsole.log('\\n  Setup complete! Run your first test:\\n');\n\tconsole.log('    npx browsecraft test\\n');\n}\n\n// ---------------------------------------------------------------------------\n// Config Loading\n// ---------------------------------------------------------------------------\n\nasync function loadConfig(): Promise<UserConfig | undefined> {\n\tconst cwd = process.cwd();\n\tconst candidates = [\n\t\t'browsecraft.config.ts',\n\t\t'browsecraft.config.js',\n\t\t'browsecraft.config.mjs',\n\t\t'browsecraft.config.mts',\n\t];\n\n\tfor (const name of candidates) {\n\t\tconst configPath = resolve(cwd, name);\n\t\tif (existsSync(configPath)) {\n\t\t\ttry {\n\t\t\t\t// For .ts files, we need tsx or ts-node to be available\n\t\t\t\tconst mod = await import(configPath);\n\t\t\t\treturn mod.default ?? mod;\n\t\t\t} catch {\n\t\t\t\t// Config file exists but couldn't be loaded -- continue with defaults\n\t\t\t\tconsole.warn(`Warning: Could not load ${name}. Using defaults.`);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn undefined;\n}\n\n// ---------------------------------------------------------------------------\n// TypeScript Loader\n// ---------------------------------------------------------------------------\n\nlet tsLoaderRegistered = false;\n\n/**\n * Ensure a TypeScript loader is registered so that .ts test files can be imported.\n * Tries tsx first (fastest), then ts-node, then falls back to a helpful error.\n */\nasync function ensureTypeScriptLoader(): Promise<void> {\n\tif (tsLoaderRegistered) return;\n\n\t// Check if we're already running under a TS loader (e.g., `tsx`, `ts-node`, `bun`)\n\t// In that case, .ts imports already work\n\tconst execArgs = process.execArgv.join(' ');\n\tif (\n\t\texecArgs.includes('tsx') ||\n\t\texecArgs.includes('ts-node') ||\n\t\texecArgs.includes('loader') ||\n\t\tprocess.versions.bun // Bun handles TS natively\n\t) {\n\t\ttsLoaderRegistered = true;\n\t\treturn;\n\t}\n\n\t// Try to dynamically register tsx or ts-node\n\tfor (const loader of ['tsx/esm', 'ts-node/esm']) {\n\t\ttry {\n\t\t\t// Node 20.6+ supports module.register()\n\t\t\tconst { register } = await import('node:module');\n\t\t\tif (typeof register === 'function') {\n\t\t\t\tregister(loader, pathToFileURL('./'));\n\t\t\t\ttsLoaderRegistered = true;\n\t\t\t\treturn;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Loader not available, try next\n\t\t}\n\t}\n\n\t// If neither tsx nor ts-node is available, give a helpful error\n\tconsole.error(\n\t\t'\\n  Error: Cannot import TypeScript test files.\\n' +\n\t\t'  Install tsx (recommended) or ts-node:\\n\\n' +\n\t\t'    npm install -D tsx\\n\\n' +\n\t\t'  Or run browsecraft with tsx:\\n\\n' +\n\t\t'    npx tsx node_modules/.bin/browsecraft test\\n',\n\t);\n\tprocess.exit(1);\n}\n\n// ---------------------------------------------------------------------------\n// Flag parsing\n// ---------------------------------------------------------------------------\n\ninterface CLIFlags {\n\theaded?: boolean;\n\theadless?: boolean;\n\tbrowser?: string;\n\tworkers?: number;\n\ttimeout?: number;\n\tretries?: number;\n\tgrep?: string;\n\tbail?: boolean;\n\tdebug?: boolean;\n}\n\nfunction parseFlags(args: string[]): CLIFlags {\n\tconst flags: CLIFlags = {};\n\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i]!;\n\t\tswitch (arg) {\n\t\t\tcase '--headed':\n\t\t\t\tflags.headed = true;\n\t\t\t\tbreak;\n\t\t\tcase '--headless':\n\t\t\t\tflags.headless = true;\n\t\t\t\tbreak;\n\t\t\tcase '--debug':\n\t\t\t\tflags.debug = true;\n\t\t\t\tbreak;\n\t\t\tcase '--bail':\n\t\t\t\tflags.bail = true;\n\t\t\t\tbreak;\n\t\t\tcase '--browser':\n\t\t\t\tflags.browser = args[++i];\n\t\t\t\tbreak;\n\t\t\tcase '--workers':\n\t\t\t\tflags.workers = Number.parseInt(args[++i] ?? '1', 10);\n\t\t\t\tbreak;\n\t\t\tcase '--timeout':\n\t\t\t\tflags.timeout = Number.parseInt(args[++i] ?? '30000', 10);\n\t\t\t\tbreak;\n\t\t\tcase '--retries':\n\t\t\t\tflags.retries = Number.parseInt(args[++i] ?? '0', 10);\n\t\t\t\tbreak;\n\t\t\tcase '--grep':\n\t\t\tcase '-g':\n\t\t\t\tflags.grep = args[++i];\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\treturn flags;\n}\n\n// ---------------------------------------------------------------------------\n// Help\n// ---------------------------------------------------------------------------\n\nfunction printHelp() {\n\tconsole.log(`\n  browsecraft v${VERSION} -- AI-native browser testing\n\n  Usage:\n    browsecraft test [files...] [options]\n    browsecraft init\n\n  Commands:\n    test          Run browser tests\n    init          Create a new project with example config and test\n\n  Options:\n    --browser <name>    Browser to use: chrome, firefox, edge (default: chrome)\n    --headed            Run in headed mode (show the browser)\n    --headless          Run in headless mode (default)\n    --workers <n>       Number of parallel workers (default: half CPU cores)\n    --timeout <ms>      Global timeout in milliseconds (default: 30000)\n    --retries <n>       Retry failed tests n times (default: 0)\n    --grep <pattern>    Only run tests matching pattern\n    --bail              Stop after first failure\n    --debug             Enable verbose debug logging\n    -h, --help          Show this help message\n    -v, --version       Show version\n\n  Examples:\n    browsecraft test                          # Run all tests\n    browsecraft test tests/login.test.ts      # Run specific file\n    browsecraft test --headed --browser firefox\n    browsecraft test --grep \"login\" --bail\n`);\n}\n\n// ---------------------------------------------------------------------------\n// Entry point\n// ---------------------------------------------------------------------------\n\nmain().catch((err) => {\n\tconsole.error('Fatal error:', err.message);\n\tprocess.exit(1);\n});\n"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,295 @@
+#!/usr/bin/env node
+import { resolveConfig, Browser, testRegistry, runTest } from './chunk-77HRTGXZ.js';
+import { join, resolve } from 'path';
+import { existsSync, writeFileSync, mkdirSync } from 'fs';
+import { pathToFileURL } from 'url';
+import { TestRunner } from 'browsecraft-runner';
+
+var VERSION = "0.1.0";
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(`browsecraft v${VERSION}`);
+    return;
+  }
+  const command = args[0];
+  switch (command) {
+    case "test":
+      await runTests(args.slice(1));
+      break;
+    case "init":
+      await initProject();
+      break;
+    default:
+      if (command && (command.endsWith(".ts") || command.endsWith(".js"))) {
+        await runTests(args);
+      } else {
+        console.error(`Unknown command: ${command}`);
+        console.error('Run "browsecraft --help" for usage information.');
+        process.exit(1);
+      }
+  }
+}
+async function runTests(args) {
+  const flags = parseFlags(args);
+  const filePatterns = args.filter((a) => !a.startsWith("--"));
+  const userConfig = await loadConfig();
+  const config = resolveConfig(userConfig);
+  if (flags.headed || flags.headless === false) {
+    config.headless = false;
+  }
+  if (flags.browser) {
+    config.browser = flags.browser;
+  }
+  if (flags.workers !== void 0) {
+    config.workers = flags.workers;
+  }
+  if (flags.timeout !== void 0) {
+    config.timeout = flags.timeout;
+  }
+  if (flags.retries !== void 0) {
+    config.retries = flags.retries;
+  }
+  if (flags.debug) {
+    config.debug = true;
+  }
+  const runnerOptions = {
+    config,
+    files: filePatterns.length > 0 ? filePatterns : void 0,
+    grep: flags.grep,
+    bail: flags.bail
+  };
+  const runner = new TestRunner(runnerOptions);
+  const loadFile = async (file) => {
+    const startIdx = testRegistry.length;
+    if (file.endsWith(".ts") || file.endsWith(".mts")) {
+      await ensureTypeScriptLoader();
+    }
+    const fileUrl = pathToFileURL(file).href;
+    await import(fileUrl);
+    return testRegistry.slice(startIdx).map((tc) => ({
+      title: tc.title,
+      suitePath: tc.suitePath,
+      skip: tc.skip,
+      only: tc.only,
+      options: tc.options,
+      fn: tc.fn
+    }));
+  };
+  let sharedBrowser;
+  try {
+    sharedBrowser = await Browser.launch({
+      browser: config.browser,
+      headless: config.headless,
+      executablePath: config.executablePath,
+      debug: config.debug,
+      timeout: config.timeout
+    });
+  } catch (err) {
+    console.error(`Failed to launch browser: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  const executeTest = async (test) => {
+    return runTest(test, sharedBrowser);
+  };
+  try {
+    const exitCode = await runner.run(loadFile, executeTest);
+    await sharedBrowser.close().catch(() => {
+    });
+    process.exit(exitCode);
+  } catch (err) {
+    await sharedBrowser?.close().catch(() => {
+    });
+    throw err;
+  }
+}
+async function initProject() {
+  const cwd = process.cwd();
+  console.log("\n  Browsecraft - Project Setup\n");
+  const configPath = join(cwd, "browsecraft.config.ts");
+  if (!existsSync(configPath)) {
+    writeFileSync(configPath, `import { defineConfig } from 'browsecraft';
+
+export default defineConfig({
+  // Browser to use: 'chrome' | 'firefox' | 'edge'
+  browser: 'chrome',
+
+  // Run tests in headless mode
+  headless: true,
+
+  // Base URL for page.goto() calls
+  // baseURL: 'http://localhost:3000',
+
+  // Global timeout for actions (ms)
+  timeout: 30_000,
+
+  // Take screenshots on failure
+  screenshot: 'on-failure',
+});
+`);
+    console.log("  Created browsecraft.config.ts");
+  } else {
+    console.log("  browsecraft.config.ts already exists, skipping");
+  }
+  const testsDir = join(cwd, "tests");
+  if (!existsSync(testsDir)) {
+    mkdirSync(testsDir, { recursive: true });
+  }
+  const exampleTest = join(testsDir, "example.test.ts");
+  if (!existsSync(exampleTest)) {
+    writeFileSync(exampleTest, `import { test, expect } from 'browsecraft';
+
+test('homepage has correct title', async ({ page }) => {
+  await page.goto('https://example.com');
+  await expect(page).toHaveTitle('Example Domain');
+});
+
+test('can navigate to more info', async ({ page }) => {
+  await page.goto('https://example.com');
+  await page.click('More information');
+  await expect(page).toHaveURL(/iana\\.org/);
+});
+`);
+    console.log("  Created tests/example.test.ts");
+  } else {
+    console.log("  tests/example.test.ts already exists, skipping");
+  }
+  const gitignorePath = join(cwd, ".gitignore");
+  if (existsSync(gitignorePath)) {
+    const content = await import('fs').then((fs) => fs.readFileSync(gitignorePath, "utf-8"));
+    if (!content.includes(".browsecraft")) {
+      writeFileSync(gitignorePath, `${content.trimEnd()}
+
+# Browsecraft
+.browsecraft/
+`);
+      console.log("  Updated .gitignore");
+    }
+  }
+  console.log("\n  Setup complete! Run your first test:\n");
+  console.log("    npx browsecraft test\n");
+}
+async function loadConfig() {
+  const cwd = process.cwd();
+  const candidates = [
+    "browsecraft.config.ts",
+    "browsecraft.config.js",
+    "browsecraft.config.mjs",
+    "browsecraft.config.mts"
+  ];
+  for (const name of candidates) {
+    const configPath = resolve(cwd, name);
+    if (existsSync(configPath)) {
+      try {
+        const mod = await import(configPath);
+        return mod.default ?? mod;
+      } catch {
+        console.warn(`Warning: Could not load ${name}. Using defaults.`);
+      }
+    }
+  }
+  return void 0;
+}
+var tsLoaderRegistered = false;
+async function ensureTypeScriptLoader() {
+  if (tsLoaderRegistered) return;
+  const execArgs = process.execArgv.join(" ");
+  if (execArgs.includes("tsx") || execArgs.includes("ts-node") || execArgs.includes("loader") || process.versions.bun) {
+    tsLoaderRegistered = true;
+    return;
+  }
+  for (const loader of ["tsx/esm", "ts-node/esm"]) {
+    try {
+      const { register } = await import('module');
+      if (typeof register === "function") {
+        register(loader, pathToFileURL("./"));
+        tsLoaderRegistered = true;
+        return;
+      }
+    } catch {
+    }
+  }
+  console.error(
+    "\n  Error: Cannot import TypeScript test files.\n  Install tsx (recommended) or ts-node:\n\n    npm install -D tsx\n\n  Or run browsecraft with tsx:\n\n    npx tsx node_modules/.bin/browsecraft test\n"
+  );
+  process.exit(1);
+}
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--headed":
+        flags.headed = true;
+        break;
+      case "--headless":
+        flags.headless = true;
+        break;
+      case "--debug":
+        flags.debug = true;
+        break;
+      case "--bail":
+        flags.bail = true;
+        break;
+      case "--browser":
+        flags.browser = args[++i];
+        break;
+      case "--workers":
+        flags.workers = Number.parseInt(args[++i] ?? "1", 10);
+        break;
+      case "--timeout":
+        flags.timeout = Number.parseInt(args[++i] ?? "30000", 10);
+        break;
+      case "--retries":
+        flags.retries = Number.parseInt(args[++i] ?? "0", 10);
+        break;
+      case "--grep":
+      case "-g":
+        flags.grep = args[++i];
+        break;
+    }
+  }
+  return flags;
+}
+function printHelp() {
+  console.log(`
+  browsecraft v${VERSION} -- AI-native browser testing
+
+  Usage:
+    browsecraft test [files...] [options]
+    browsecraft init
+
+  Commands:
+    test          Run browser tests
+    init          Create a new project with example config and test
+
+  Options:
+    --browser <name>    Browser to use: chrome, firefox, edge (default: chrome)
+    --headed            Run in headed mode (show the browser)
+    --headless          Run in headless mode (default)
+    --workers <n>       Number of parallel workers (default: half CPU cores)
+    --timeout <ms>      Global timeout in milliseconds (default: 30000)
+    --retries <n>       Retry failed tests n times (default: 0)
+    --grep <pattern>    Only run tests matching pattern
+    --bail              Stop after first failure
+    --debug             Enable verbose debug logging
+    -h, --help          Show this help message
+    -v, --version       Show version
+
+  Examples:
+    browsecraft test                          # Run all tests
+    browsecraft test tests/login.test.ts      # Run specific file
+    browsecraft test --headed --browser firefox
+    browsecraft test --grep "login" --bail
+`);
+}
+main().catch((err) => {
+  console.error("Fatal error:", err.message);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map