@hasna/testers 0.0.7 → 0.0.8

package/dist/cli/index.js

@@ -2795,6 +2795,168 @@ var init_runs = __esm(() => {
   init_database();
 });
 
+// src/lib/browser-lightpanda.ts
+var exports_browser_lightpanda = {};
+__export(exports_browser_lightpanda, {
+  startLightpandaServer: () => startLightpandaServer,
+  launchLightpanda: () => launchLightpanda,
+  isLightpandaAvailable: () => isLightpandaAvailable,
+  installLightpanda: () => installLightpanda,
+  getLightpandaPage: () => getLightpandaPage,
+  closeLightpanda: () => closeLightpanda
+});
+import { chromium } from "playwright";
+import { spawn } from "child_process";
+function isLightpandaAvailable() {
+  try {
+    const possiblePaths = [
+      `${process.env["HOME"]}/.cache/lightpanda-node/lightpanda`,
+      process.env["LIGHTPANDA_EXECUTABLE_PATH"]
+    ];
+    for (const p of possiblePaths) {
+      if (p) {
+        try {
+          const { existsSync: existsSync2 } = __require("fs");
+          if (existsSync2(p))
+            return true;
+        } catch {
+          continue;
+        }
+      }
+    }
+    const { execSync } = __require("child_process");
+    execSync("lightpanda --version", { stdio: "ignore", timeout: 5000 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findLightpandaBinary() {
+  const envPath = process.env["LIGHTPANDA_EXECUTABLE_PATH"];
+  if (envPath)
+    return envPath;
+  const cachePath = `${process.env["HOME"]}/.cache/lightpanda-node/lightpanda`;
+  try {
+    const { existsSync: existsSync2 } = __require("fs");
+    if (existsSync2(cachePath))
+      return cachePath;
+  } catch {}
+  return "lightpanda";
+}
+async function startLightpandaServer(port) {
+  const binary = findLightpandaBinary();
+  const cdpPort = port ?? 9222 + Math.floor(Math.random() * 1000);
+  return new Promise((resolve, reject) => {
+    const proc = spawn(binary, ["serve", "--port", String(cdpPort)], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let resolved = false;
+    const timeout = setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        resolve({
+          process: proc,
+          wsEndpoint: `ws://127.0.0.1:${cdpPort}`
+        });
+      }
+    }, 5000);
+    proc.stdout?.on("data", (data) => {
+      const output = data.toString();
+      if (output.includes("127.0.0.1") || output.includes("listening") || output.includes("DevTools")) {
+        if (!resolved) {
+          resolved = true;
+          clearTimeout(timeout);
+          resolve({
+            process: proc,
+            wsEndpoint: `ws://127.0.0.1:${cdpPort}`
+          });
+        }
+      }
+    });
+    proc.stderr?.on("data", (data) => {
+      const output = data.toString();
+      if (output.includes("127.0.0.1") || output.includes("listening")) {
+        if (!resolved) {
+          resolved = true;
+          clearTimeout(timeout);
+          resolve({
+            process: proc,
+            wsEndpoint: `ws://127.0.0.1:${cdpPort}`
+          });
+        }
+      }
+    });
+    proc.on("error", (err) => {
+      clearTimeout(timeout);
+      if (!resolved) {
+        resolved = true;
+        reject(new BrowserError(`Failed to start Lightpanda: ${err.message}. ` + `Install it with: bun install @lightpanda/browser`));
+      }
+    });
+    proc.on("exit", (code) => {
+      if (!resolved) {
+        resolved = true;
+        clearTimeout(timeout);
+        reject(new BrowserError(`Lightpanda exited with code ${code}. ` + `Install it with: bun install @lightpanda/browser`));
+      }
+    });
+  });
+}
+async function launchLightpanda(_options) {
+  try {
+    const { process: proc, wsEndpoint } = await startLightpandaServer();
+    lightpandaProcess = proc;
+    const browser = await chromium.connectOverCDP(wsEndpoint);
+    return browser;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new BrowserError(`Failed to launch Lightpanda: ${message}`);
+  }
+}
+async function getLightpandaPage(browser, options) {
+  try {
+    const contexts = browser.contexts();
+    const context = contexts.length > 0 ? contexts[0] : await browser.newContext({
+      viewport: options?.viewport ?? { width: 1280, height: 720 },
+      userAgent: options?.userAgent,
+      locale: options?.locale
+    });
+    const page = await context.newPage();
+    return page;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new BrowserError(`Failed to create Lightpanda page: ${message}`);
+  }
+}
+async function closeLightpanda(browser) {
+  try {
+    await browser.close();
+  } catch {}
+  if (lightpandaProcess) {
+    try {
+      lightpandaProcess.kill("SIGTERM");
+      lightpandaProcess = null;
+    } catch {}
+  }
+}
+async function installLightpanda() {
+  const { execSync } = __require("child_process");
+  try {
+    execSync("bun install @lightpanda/browser", {
+      stdio: "inherit",
+      cwd: process.env["HOME"]
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new BrowserError(`Failed to install Lightpanda: ${message}
+` + `Try manually: bun install @lightpanda/browser`);
+  }
+}
+var lightpandaProcess = null;
+var init_browser_lightpanda = __esm(() => {
+  init_types();
+});
+
 // src/db/flows.ts
 var exports_flows = {};
 __export(exports_flows, {
@@ -3050,9 +3212,9 @@ __export(exports_recorder, {
   recordAndSave: () => recordAndSave,
   actionsToScenarioInput: () => actionsToScenarioInput
 });
-import { chromium as chromium2 } from "playwright";
+import { chromium as chromium3 } from "playwright";
 async function recordSession(url, options) {
-  const browser = await chromium2.launch({ headless: false });
+  const browser = await chromium3.launch({ headless: false });
   const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });
   const page = await context.newPage();
   const actions = [];
@@ -3336,14 +3498,22 @@ init_scenarios();
 
 // src/lib/browser.ts
 init_types();
-import { chromium } from "playwright";
+import { chromium as chromium2 } from "playwright";
 import { execSync } from "child_process";
 var DEFAULT_VIEWPORT = { width: 1280, height: 720 };
 async function launchBrowser(options) {
+  const engine = options?.engine ?? process.env["TESTERS_BROWSER_ENGINE"] ?? "playwright";
+  if (engine === "lightpanda") {
+    const { launchLightpanda: launchLightpanda2, isLightpandaAvailable: isLightpandaAvailable2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    if (!isLightpandaAvailable2()) {
+      throw new BrowserError("Lightpanda not installed. Run: testers install-browser --engine lightpanda");
+    }
+    return launchLightpanda2({ viewport: options?.viewport });
+  }
   const headless = options?.headless ?? true;
   const viewport = options?.viewport ?? DEFAULT_VIEWPORT;
   try {
-    const browser = await chromium.launch({
+    const browser = await chromium2.launch({
       headless,
       args: [
         `--window-size=${viewport.width},${viewport.height}`
@@ -3356,6 +3526,11 @@ async function launchBrowser(options) {
   }
 }
 async function getPage(browser, options) {
+  const engine = options?.engine ?? "playwright";
+  if (engine === "lightpanda") {
+    const { getLightpandaPage: getLightpandaPage2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    return getLightpandaPage2(browser, options);
+  }
   const viewport = options?.viewport ?? DEFAULT_VIEWPORT;
   try {
     const context = await browser.newContext({
@@ -3370,7 +3545,11 @@ async function getPage(browser, options) {
     throw new BrowserError(`Failed to create page: ${message}`);
   }
 }
-async function closeBrowser(browser) {
+async function closeBrowser(browser, engine) {
+  if (engine === "lightpanda") {
+    const { closeLightpanda: closeLightpanda2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    return closeLightpanda2(browser);
+  }
   try {
     await browser.close();
   } catch (error) {
@@ -3378,7 +3557,11 @@ async function closeBrowser(browser) {
     throw new BrowserError(`Failed to close browser: ${message}`);
   }
 }
-async function installBrowser() {
+async function installBrowser(engine) {
+  if (engine === "lightpanda") {
+    const { installLightpanda: installLightpanda2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    return installLightpanda2();
+  }
   try {
     execSync("bunx playwright install chromium", {
       stdio: "inherit"
@@ -4452,7 +4635,7 @@ async function runSingleScenario(scenario, runId, options) {
   let browser = null;
   let page = null;
   try {
-    browser = await launchBrowser({ headless: !(options.headed ?? false) });
+    browser = await launchBrowser({ headless: !(options.headed ?? false), engine: options.engine });
     page = await getPage(browser, {
       viewport: config.browser.viewport
     });
@@ -4517,7 +4700,7 @@ async function runSingleScenario(scenario, runId, options) {
     return updatedResult;
   } finally {
     if (browser)
-      await closeBrowser(browser);
+      await closeBrowser(browser, options.engine);
   }
 }
 async function runBatch(scenarios, options) {
@@ -6489,7 +6672,7 @@ program2.command("delete <id>").description("Delete a scenario").action((id) =>
 program2.command("run [url] [description]").description("Run test scenarios against a URL").option("-t, --tag <tag>", "Filter by tag (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).option("-s, --scenario <id>", "Run specific scenario ID").option("-p, --priority <level>", "Filter by priority").option("--headed", "Run browser in headed mode", false).option("-m, --model <model>", "AI model to use").option("--parallel <n>", "Number of parallel browsers", "1").option("--json", "Output results as JSON", false).option("-o, --output <filepath>", "Write JSON results to file").option("--timeout <ms>", "Timeout in milliseconds").option("--from-todos", "Import scenarios from todos before running", false).option("--project <id>", "Project ID").option("-b, --background", "Start run in background and return immediately", false).option("--env <name>", "Use a named environment for the URL").action(async (urlArg, description, opts) => {
+}, []).option("-s, --scenario <id>", "Run specific scenario ID").option("-p, --priority <level>", "Filter by priority").option("--headed", "Run browser in headed mode", false).option("-m, --model <model>", "AI model to use").option("--parallel <n>", "Number of parallel browsers", "1").option("--json", "Output results as JSON", false).option("-o, --output <filepath>", "Write JSON results to file").option("--timeout <ms>", "Timeout in milliseconds").option("--from-todos", "Import scenarios from todos before running", false).option("--project <id>", "Project ID").option("-b, --background", "Start run in background and return immediately", false).option("--browser <engine>", "Browser engine: playwright or lightpanda", "playwright").option("--env <name>", "Use a named environment for the URL").action(async (urlArg, description, opts) => {
   try {
     const projectId = resolveProject(opts.project);
     let url = urlArg;
@@ -6529,7 +6712,8 @@ program2.command("run [url] [description]").description("Run test scenarios agai
         headed: opts.headed,
         parallel: parseInt(opts.parallel, 10),
         timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
-        projectId
+        projectId,
+        engine: opts.browser
       });
       console.log(chalk5.green(`Run started in background: ${chalk5.bold(runId.slice(0, 8))}`));
       console.log(chalk5.dim(`  Scenarios: ${scenarioCount}`));
@@ -6592,7 +6776,8 @@ program2.command("run [url] [description]").description("Run test scenarios agai
         headed: opts.headed,
         parallel: parseInt(opts.parallel, 10),
         timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
-        projectId
+        projectId,
+        engine: opts.browser
       });
       if (opts.json || opts.output) {
         const jsonOutput = formatJSON(run2, results2);
@@ -6617,7 +6802,8 @@ program2.command("run [url] [description]").description("Run test scenarios agai
       headed: opts.headed,
       parallel: parseInt(opts.parallel, 10),
       timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
-      projectId
+      projectId,
+      engine: opts.browser
     });
     if (opts.json || opts.output) {
       const jsonOutput = formatJSON(run, results);
@@ -6781,11 +6967,18 @@ program2.command("status").description("Show database and auth status").action((
     process.exit(1);
   }
 });
-program2.command("install-browser").description("Install Playwright Chromium browser").action(async () => {
+program2.command("install-browser").description("Install browser engine").option("--engine <engine>", "Engine to install: playwright, lightpanda, or all", "playwright").action(async (opts) => {
   try {
-    console.log(chalk5.blue("Installing Playwright Chromium..."));
-    await installBrowser();
-    console.log(chalk5.green("Browser installed successfully."));
+    if (opts.engine === "all" || opts.engine === "playwright") {
+      console.log(chalk5.blue("Installing Playwright Chromium..."));
+      await installBrowser("playwright");
+      console.log(chalk5.green("Playwright Chromium installed."));
+    }
+    if (opts.engine === "all" || opts.engine === "lightpanda") {
+      console.log(chalk5.blue("Installing Lightpanda..."));
+      await installBrowser("lightpanda");
+      console.log(chalk5.green("Lightpanda installed."));
+    }
   } catch (error) {
     console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { ScenarioPriority, RunStatus, ResultStatus, ModelPreset, ProjectRow, AgentRow, ScenarioRow, RunRow, ResultRow, ScreenshotRow, Project, Agent, Scenario, Run, Result, Screenshot, CreateScenarioInput, UpdateScenarioInput, CreateRunInput, ScenarioFilter, RunFilter, ScheduleRow, Schedule, CreateScheduleInput, UpdateScheduleInput, ScheduleFilter, FlowRow, Flow, CreateFlowInput, AuthConfig, BrowserConfig, ScreenshotConfig, TestersConfig, } from "./types/index.js";
+export type { ScenarioPriority, RunStatus, ResultStatus, ModelPreset, BrowserEngine, ProjectRow, AgentRow, ScenarioRow, RunRow, ResultRow, ScreenshotRow, Project, Agent, Scenario, Run, Result, Screenshot, CreateScenarioInput, UpdateScenarioInput, CreateRunInput, ScenarioFilter, RunFilter, ScheduleRow, Schedule, CreateScheduleInput, UpdateScheduleInput, ScheduleFilter, FlowRow, Flow, CreateFlowInput, AuthConfig, BrowserConfig, ScreenshotConfig, TestersConfig, } from "./types/index.js";
 export { MODEL_MAP, projectFromRow, agentFromRow, scenarioFromRow, runFromRow, resultFromRow, screenshotFromRow, scheduleFromRow, ScenarioNotFoundError, RunNotFoundError, ResultNotFoundError, VersionConflictError, BrowserError, AIClientError, TodosConnectionError, ProjectNotFoundError, AgentNotFoundError, ScheduleNotFoundError, FlowNotFoundError, DependencyCycleError, flowFromRow, } from "./types/index.js";
 export { getDatabase, closeDatabase, resetDatabase, resolvePartialId, now, uuid, shortUuid, } from "./db/database.js";
 export { createScenario, getScenario, getScenarioByShortId, listScenarios, updateScenario, deleteScenario, } from "./db/scenarios.js";
@@ -11,6 +11,7 @@ export { createSchedule, getSchedule, listSchedules, updateSchedule, deleteSched
 export { addDependency, removeDependency, getDependencies, getDependents, getTransitiveDependencies, topologicalSort, createFlow, getFlow, listFlows, deleteFlow, } from "./db/flows.js";
 export { loadConfig, resolveModel as resolveModelConfig, getDefaultConfig, } from "./lib/config.js";
 export { launchBrowser, getPage, closeBrowser, BrowserPool, installBrowser, } from "./lib/browser.js";
+export { isLightpandaAvailable, launchLightpanda, getLightpandaPage, closeLightpanda, installLightpanda, } from "./lib/browser-lightpanda.js";
 export { Screenshotter, slugify, generateFilename, getScreenshotDir, ensureDir, } from "./lib/screenshotter.js";
 export { createClient, resolveModel, runAgentLoop, executeTool, BROWSER_TOOLS, } from "./lib/ai-client.js";
 export { runSingleScenario, runBatch, runByFilter, startRunAsync, onRunEvent, } from "./lib/runner.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -10,6 +10,7 @@ var __export = (target, all) => {
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
 
 // src/types/index.ts
 function projectFromRow(row) {
@@ -792,6 +793,168 @@ var init_flows = __esm(() => {
   init_types();
 });
 
+// src/lib/browser-lightpanda.ts
+var exports_browser_lightpanda = {};
+__export(exports_browser_lightpanda, {
+  startLightpandaServer: () => startLightpandaServer,
+  launchLightpanda: () => launchLightpanda,
+  isLightpandaAvailable: () => isLightpandaAvailable,
+  installLightpanda: () => installLightpanda,
+  getLightpandaPage: () => getLightpandaPage,
+  closeLightpanda: () => closeLightpanda
+});
+import { chromium } from "playwright";
+import { spawn } from "child_process";
+function isLightpandaAvailable() {
+  try {
+    const possiblePaths = [
+      `${process.env["HOME"]}/.cache/lightpanda-node/lightpanda`,
+      process.env["LIGHTPANDA_EXECUTABLE_PATH"]
+    ];
+    for (const p of possiblePaths) {
+      if (p) {
+        try {
+          const { existsSync: existsSync3 } = __require("fs");
+          if (existsSync3(p))
+            return true;
+        } catch {
+          continue;
+        }
+      }
+    }
+    const { execSync } = __require("child_process");
+    execSync("lightpanda --version", { stdio: "ignore", timeout: 5000 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findLightpandaBinary() {
+  const envPath = process.env["LIGHTPANDA_EXECUTABLE_PATH"];
+  if (envPath)
+    return envPath;
+  const cachePath = `${process.env["HOME"]}/.cache/lightpanda-node/lightpanda`;
+  try {
+    const { existsSync: existsSync3 } = __require("fs");
+    if (existsSync3(cachePath))
+      return cachePath;
+  } catch {}
+  return "lightpanda";
+}
+async function startLightpandaServer(port) {
+  const binary = findLightpandaBinary();
+  const cdpPort = port ?? 9222 + Math.floor(Math.random() * 1000);
+  return new Promise((resolve, reject) => {
+    const proc = spawn(binary, ["serve", "--port", String(cdpPort)], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let resolved = false;
+    const timeout = setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        resolve({
+          process: proc,
+          wsEndpoint: `ws://127.0.0.1:${cdpPort}`
+        });
+      }
+    }, 5000);
+    proc.stdout?.on("data", (data) => {
+      const output = data.toString();
+      if (output.includes("127.0.0.1") || output.includes("listening") || output.includes("DevTools")) {
+        if (!resolved) {
+          resolved = true;
+          clearTimeout(timeout);
+          resolve({
+            process: proc,
+            wsEndpoint: `ws://127.0.0.1:${cdpPort}`
+          });
+        }
+      }
+    });
+    proc.stderr?.on("data", (data) => {
+      const output = data.toString();
+      if (output.includes("127.0.0.1") || output.includes("listening")) {
+        if (!resolved) {
+          resolved = true;
+          clearTimeout(timeout);
+          resolve({
+            process: proc,
+            wsEndpoint: `ws://127.0.0.1:${cdpPort}`
+          });
+        }
+      }
+    });
+    proc.on("error", (err) => {
+      clearTimeout(timeout);
+      if (!resolved) {
+        resolved = true;
+        reject(new BrowserError(`Failed to start Lightpanda: ${err.message}. ` + `Install it with: bun install @lightpanda/browser`));
+      }
+    });
+    proc.on("exit", (code) => {
+      if (!resolved) {
+        resolved = true;
+        clearTimeout(timeout);
+        reject(new BrowserError(`Lightpanda exited with code ${code}. ` + `Install it with: bun install @lightpanda/browser`));
+      }
+    });
+  });
+}
+async function launchLightpanda(_options) {
+  try {
+    const { process: proc, wsEndpoint } = await startLightpandaServer();
+    lightpandaProcess = proc;
+    const browser = await chromium.connectOverCDP(wsEndpoint);
+    return browser;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new BrowserError(`Failed to launch Lightpanda: ${message}`);
+  }
+}
+async function getLightpandaPage(browser, options) {
+  try {
+    const contexts = browser.contexts();
+    const context = contexts.length > 0 ? contexts[0] : await browser.newContext({
+      viewport: options?.viewport ?? { width: 1280, height: 720 },
+      userAgent: options?.userAgent,
+      locale: options?.locale
+    });
+    const page = await context.newPage();
+    return page;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new BrowserError(`Failed to create Lightpanda page: ${message}`);
+  }
+}
+async function closeLightpanda(browser) {
+  try {
+    await browser.close();
+  } catch {}
+  if (lightpandaProcess) {
+    try {
+      lightpandaProcess.kill("SIGTERM");
+      lightpandaProcess = null;
+    } catch {}
+  }
+}
+async function installLightpanda() {
+  const { execSync } = __require("child_process");
+  try {
+    execSync("bun install @lightpanda/browser", {
+      stdio: "inherit",
+      cwd: process.env["HOME"]
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new BrowserError(`Failed to install Lightpanda: ${message}
+` + `Try manually: bun install @lightpanda/browser`);
+  }
+}
+var lightpandaProcess = null;
+var init_browser_lightpanda = __esm(() => {
+  init_types();
+});
+
 // src/index.ts
 init_types();
 init_database();
@@ -1337,14 +1500,22 @@ function resolveModel(nameOrId) {
 }
 // src/lib/browser.ts
 init_types();
-import { chromium } from "playwright";
+import { chromium as chromium2 } from "playwright";
 import { execSync } from "child_process";
 var DEFAULT_VIEWPORT = { width: 1280, height: 720 };
 async function launchBrowser(options) {
+  const engine = options?.engine ?? process.env["TESTERS_BROWSER_ENGINE"] ?? "playwright";
+  if (engine === "lightpanda") {
+    const { launchLightpanda: launchLightpanda2, isLightpandaAvailable: isLightpandaAvailable2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    if (!isLightpandaAvailable2()) {
+      throw new BrowserError("Lightpanda not installed. Run: testers install-browser --engine lightpanda");
+    }
+    return launchLightpanda2({ viewport: options?.viewport });
+  }
   const headless = options?.headless ?? true;
   const viewport = options?.viewport ?? DEFAULT_VIEWPORT;
   try {
-    const browser = await chromium.launch({
+    const browser = await chromium2.launch({
       headless,
       args: [
         `--window-size=${viewport.width},${viewport.height}`
@@ -1357,6 +1528,11 @@ async function launchBrowser(options) {
   }
 }
 async function getPage(browser, options) {
+  const engine = options?.engine ?? "playwright";
+  if (engine === "lightpanda") {
+    const { getLightpandaPage: getLightpandaPage2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    return getLightpandaPage2(browser, options);
+  }
   const viewport = options?.viewport ?? DEFAULT_VIEWPORT;
   try {
     const context = await browser.newContext({
@@ -1371,7 +1547,11 @@ async function getPage(browser, options) {
     throw new BrowserError(`Failed to create page: ${message}`);
   }
 }
-async function closeBrowser(browser) {
+async function closeBrowser(browser, engine) {
+  if (engine === "lightpanda") {
+    const { closeLightpanda: closeLightpanda2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    return closeLightpanda2(browser);
+  }
   try {
     await browser.close();
   } catch (error) {
@@ -1385,26 +1565,29 @@ class BrowserPool {
   maxSize;
   headless;
   viewport;
+  engine;
   constructor(size, options) {
     this.maxSize = size;
     this.headless = options?.headless ?? true;
     this.viewport = options?.viewport ?? DEFAULT_VIEWPORT;
+    this.engine = options?.engine ?? "playwright";
   }
   async acquire() {
     const idle = this.pool.find((entry) => !entry.inUse);
     if (idle) {
       idle.inUse = true;
-      const page = await getPage(idle.browser, { viewport: this.viewport });
+      const page = await getPage(idle.browser, { viewport: this.viewport, engine: this.engine });
       return { browser: idle.browser, page };
     }
     if (this.pool.length < this.maxSize) {
       const browser = await launchBrowser({
         headless: this.headless,
-        viewport: this.viewport
+        viewport: this.viewport,
+        engine: this.engine
       });
       const entry = { browser, inUse: true };
       this.pool.push(entry);
-      const page = await getPage(browser, { viewport: this.viewport });
+      const page = await getPage(browser, { viewport: this.viewport, engine: this.engine });
       return { browser, page };
     }
     return new Promise((resolve, reject) => {
@@ -1413,7 +1596,7 @@ class BrowserPool {
         if (available) {
           clearInterval(interval);
           available.inUse = true;
-          getPage(available.browser, { viewport: this.viewport }).then((page) => resolve({ browser: available.browser, page })).catch(reject);
+          getPage(available.browser, { viewport: this.viewport, engine: this.engine }).then((page) => resolve({ browser: available.browser, page })).catch(reject);
         }
       }, 50);
     });
@@ -1430,7 +1613,11 @@ class BrowserPool {
     this.pool.length = 0;
   }
 }
-async function installBrowser() {
+async function installBrowser(engine) {
+  if (engine === "lightpanda") {
+    const { installLightpanda: installLightpanda2 } = await Promise.resolve().then(() => (init_browser_lightpanda(), exports_browser_lightpanda));
+    return installLightpanda2();
+  }
   try {
     execSync("bunx playwright install chromium", {
       stdio: "inherit"
@@ -1440,6 +1627,10 @@ async function installBrowser() {
     throw new BrowserError(`Failed to install browser: ${message}`);
   }
 }
+
+// src/index.ts
+init_browser_lightpanda();
+
 // src/lib/screenshotter.ts
 import { mkdirSync as mkdirSync2, existsSync as existsSync3, writeFileSync } from "fs";
 import { join as join3 } from "path";
@@ -2514,7 +2705,7 @@ async function runSingleScenario(scenario, runId, options) {
   let browser = null;
   let page = null;
   try {
-    browser = await launchBrowser({ headless: !(options.headed ?? false) });
+    browser = await launchBrowser({ headless: !(options.headed ?? false), engine: options.engine });
     page = await getPage(browser, {
       viewport: config.browser.viewport
     });
@@ -2579,7 +2770,7 @@ async function runSingleScenario(scenario, runId, options) {
     return updatedResult;
   } finally {
     if (browser)
-      await closeBrowser(browser);
+      await closeBrowser(browser, options.engine);
   }
 }
 async function runBatch(scenarios, options) {
@@ -4861,7 +5052,10 @@ export {
   listFlows,
   listAuthPresets,
   listAgents,
+  launchLightpanda,
   launchBrowser,
+  isLightpandaAvailable,
+  installLightpanda,
   installBrowser,
   initProject,
   importFromTodos,
@@ -4883,6 +5077,7 @@ export {
   getProject,
   getPage,
   getNextRunTime,
+  getLightpandaPage,
   getFlow,
   getExitCode,
   getEnabledSchedules,
@@ -4932,6 +5127,7 @@ export {
   createClient,
   createAuthPreset,
   connectToTodos,
+  closeLightpanda,
   closeDatabase,
   closeBrowser,
   checkBudget,