await page.expectText("h1", "Welcome");     // retries until match or 5s timeout
await page.expectURL("/dashboard");          // retries until URL matches
await page.expectVisible(".modal");          // retries until visible
await page.expectCount(".item", 3);          // retries until count matches

const text = await page.textContent("h1");   // waits for element, returns textContent
const val  = await page.inputValue("#email"); // waits for input, returns .value
await page.waitForURL("/dashboard");          // polls URL until match

await page.clickAndNavigate("a.link");       // Promise.all([waitForNavigation, click]) + metrics
await page.type("#email", "user@test.com");  // auto-wait + type (Locator has fill(), not type())
await page.upload("#file", "./resume.pdf");  // wait for input + uploadFile()

await page.setViewport({ width: 1280, height: 720 });  // Puppeteer method, works directly
await page.keyboard.press("Enter");                     // Puppeteer method, works directly

const browser = await puppeteer.launch();
const page = await browser.newPage();
try {
  await page.goto("http://localhost:3000/login");

  // v21+ Locator API — auto-waits for element
  await page.locator("#email").fill("user@test.com");
  await page.locator("#password").fill("secret");

  await Promise.all([
    page.waitForNavigation({ waitUntil: "load" }),
    page.locator('button[type="submit"]').click(),
  ]);

  // manual URL check — no retry
  expect(page.url()).toContain("/dashboard");

  // manual text check — no retry, no helper
  const text = await page.$eval("h1", (el) => el.textContent);
  expect(text).toBe("Welcome back");
} catch (err) {
  await page.screenshot({ path: "fail.png", fullPage: true });
  throw err;
} finally {
  await browser.close();
}
// traces? metrics? network logs? console errors? — all DIY

export const login = browserTest("login", async ({ page }) => {
  await page.goto("/login");
  await page.type("#email", "user@test.com");
  await page.type("#password", "secret");
  await page.clickAndNavigate('button[type="submit"]');
  await page.expectURL("/dashboard");
  await page.expectText("h1", "Welcome back");
});
// traces ✓  metrics ✓  network logs ✓  console errors ✓  screenshots ✓
// page.raw is the native Puppeteer Page — zero capability loss

// deno.json
{
  "imports": {
    "@glubean/browser": "jsr:@glubean/browser@^0.1.0"
  }
}

// tests/configure.ts
import { configure } from "@glubean/sdk";
import { browser } from "@glubean/browser";

export const { chrome } = configure({
  plugins: {
    chrome: browser({ launch: true }),
  },
});

import { configure } from "@glubean/sdk";
import { browser } from "@glubean/browser";
import puppeteerExtra from "puppeteer-extra";
import StealthPlugin from "puppeteer-extra-plugin-stealth";
import RecaptchaPlugin from "puppeteer-extra-plugin-recaptcha";

puppeteerExtra.use(StealthPlugin());
puppeteerExtra.use(RecaptchaPlugin({ provider: { id: "2captcha", token: "TOKEN" } }));

export const { chrome } = configure({
  plugins: {
    chrome: browser({ launch: true, puppeteer: puppeteerExtra }),
  },
});

export const { chrome } = configure({
  plugins: {
    chrome: browser({
      endpoint: "CHROME_ENDPOINT",
      baseUrl: "APP_URL",
    }),
  },
});

// tests/base.ts
import { test } from "@glubean/sdk";
import { chrome } from "./configure.ts";

export const browserTest = test.extend({
  page: async (ctx, use) => {
    const pg = await chrome.newPage(ctx);
    try {
      await use(pg);
    } finally {
      await pg.close();
    }
  },
});

// tests/login.test.ts
import { browserTest } from "./base.ts";

export const loginFlow = browserTest("login-flow", async (ctx) => {
  const { page } = ctx;

  await page.goto("/login");
  await page.type("#email", "user@test.com");
  await page.type("#password", ctx.secrets.require("TEST_PASSWORD"));
  await page.click('button[type="submit"]');

  // Auto-retrying assertions — no manual waits needed
  await page.expectURL("/dashboard");
  await page.expectText("h1", "Welcome back");
});

browser({ launch: true });

browser({ launch: true, executablePath: "/usr/bin/chromium" });

browser({ launch: true, executablePath: "/usr/bin/chromium" });

browser({ endpoint: "CHROME_ENDPOINT" });