testdriverai 7.0.0 → 7.1.0

package/testdriver/acceptance-sdk/focus-window.test.mjs

@@ -3,29 +3,17 @@
  * Converted from: testdriver/acceptance/focus-window.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Focus Window Test", () => {
-  let testdriver;
-
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it.skipIf(() => testdriver.os === "linux")(
+  it.skipIf(process.env.TD_OS === "linux")(
     "should click Microsoft Edge icon and focus Google Chrome",
-    async () => {
+    async (context) => {
+      const testdriver = TestDriver(context, { headless: true });
+      await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
+
+      //
       // Show desktop
       await testdriver.pressKeys(["winleft", "d"]);
 

package/testdriver/acceptance-sdk/formatted-logging.test.mjs

@@ -3,28 +3,13 @@
  * Demonstrates nice Vitest-style formatted logs for Dashcam replay
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Formatted Logging Test", () => {
-  let testdriver;
-
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should demonstrate formatted logs in dashcam replay", async () => {
-    await testdriver.focusApplication("Google Chrome");
+  it("should demonstrate formatted logs in dashcam replay", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
     // Find and click - logs will be nicely formatted
     const signInButton = await testdriver.find(

package/testdriver/acceptance-sdk/hooks-example.test.mjs

@@ -0,0 +1,38 @@
+/**
+ * TestDriver Hooks API Demo
+ * Demonstrates the new React-style hooks for Vitest
+ * 
+ * This is the SIMPLEST way to use TestDriver with Vitest!
+ */
+
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
+
+describe("Hooks API Demo", () => {
+  it("should use hooks for automatic lifecycle management", async (context) => {
+    // ✨ One line gets you TestDriver + Dashcam with full auto-lifecycle!
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
+    
+    // Everything is automatic:
+    // - Sandbox connection ✅
+    // - Dashcam recording ✅
+    // - Chrome launch ✅
+    // - Recording stop ✅
+    // - Cleanup ✅
+    
+    await testdriver.focusApplication("Google Chrome");
+
+    const signInButton = await testdriver.find(
+      "Sign In, black button below the password field",
+    );
+    await signInButton.click();
+
+    const result = await testdriver.assert(
+      "an error shows that fields are required",
+    );
+    expect(result).toBeTruthy();
+    
+    // That's it! Dashcam URL automatically registered with the test run
+  });
+});

package/testdriver/acceptance-sdk/hover-image.test.mjs

@@ -3,28 +3,19 @@
  * Converted from: testdriver/acceptance/hover-image.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  performLogin,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { performLogin } from "./setup/testHelpers.mjs";
 
 describe("Hover Image Test", () => {
-  let testdriver;
+  it("should click on shopping cart icon and verify empty cart", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    
+    // provision.chrome() automatically calls ready() and starts dashcam
+    await testdriver.provision.chrome({
+      url: 'http://testdriver-sandbox.vercel.app/login',
+    });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should click on shopping cart icon and verify empty cart", async () => {
     // Perform login first
     await performLogin(testdriver);
 

package/testdriver/acceptance-sdk/hover-text-with-description.test.mjs

@@ -3,28 +3,16 @@
  * Converted from: testdriver/acceptance/hover-text-with-description.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  performLogin,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { performLogin } from "./setup/testHelpers.mjs";
 
 describe("Hover Text With Description Test", () => {
-  let testdriver;
+  it("should add TestDriver Hat to cart and verify", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should add TestDriver Hat to cart and verify", async () => {
+    //
     // Perform login first
     await performLogin(testdriver);
 

package/testdriver/acceptance-sdk/hover-text.test.mjs

@@ -3,29 +3,15 @@
  * Converted from: testdriver/acceptance/hover-text.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Hover Text Test", () => {
-  let testdriver;
+  it("should click Sign In and verify error message", async (context) => {
+    const testdriver = TestDriver(context, { headless: true, newSandbox: true, cacheKey: 'hover-text-test' });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should click Sign In and verify error message", async () => {
     // Click on Sign In button using new find() API
-    await testdriver.focusApplication("Google Chrome");
 
     const signInButton = await testdriver.find(
       "Sign In, black button below the password field",

package/testdriver/acceptance-sdk/match-image.test.mjs

@@ -5,32 +5,20 @@
 
 import path, { dirname } from "path";
 import { fileURLToPath } from "url";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  performLogin,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { performLogin } from "./setup/testHelpers.mjs";
 
 // Get the directory of the current module
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 describe("Match Image Test", () => {
-  let testdriver;
+  it("should match shopping cart image and verify empty cart", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should match shopping cart image and verify empty cart", async () => {
+    //
     // Perform login first
     await performLogin(testdriver);
 

package/testdriver/acceptance-sdk/presets-example.test.mjs

@@ -0,0 +1,87 @@
+/**
+ * Examples demonstrating TestDriver Presets
+ * 
+ * Presets provide pre-configured setups for common applications,
+ * reducing boilerplate and making tests easier to write.
+ */
+
+import { test } from 'vitest';
+import { chromePreset, createPreset, electronPreset, vscodePreset } from '../../src/presets/index.mjs';
+
+test('Chrome preset - simple navigation', async (context) => {
+  const { browser } = await chromePreset(context, {
+    url: 'http://testdriver-sandbox.vercel.app/',
+  });
+
+  // Browser is already open and focused on the URL
+  const result = await browser.find('main heading text');
+  console.log('Found heading:', result);
+}, 60000);
+
+test('Chrome preset - with custom options', async (context) => {
+  const { browser, dashcam } = await chromePreset(context, {
+    url: 'https://google.com',
+    maximized: false,
+    guest: false,
+    dashcam: true, // Dashcam auto-starts and auto-stops
+  });
+
+  await browser.find('search box').type('testdriverai');
+  console.log('Dashcam recording:', dashcam.isRecording());
+}, 60000);
+
+test.skip('VS Code preset - basic usage', async (context) => {
+  const { vscode } = await vscodePreset(context, {
+    workspace: '/tmp/test-project',
+  });
+
+  // VS Code is already open with the workspace loaded
+  await vscode.find('File menu').click();
+  await vscode.find('New File').click();
+}, 60000);
+
+test.skip('VS Code preset - with extensions', async (context) => {
+  const { vscode } = await vscodePreset(context, {
+    workspace: '/tmp/test-project',
+    extensions: ['ms-python.python'],
+    dashcam: true,
+  });
+
+  // Extensions are pre-installed, dashcam auto-recording
+  await vscode.find('Python extension').click();
+}, 120000);
+
+test.skip('Custom preset - Electron app', async (context) => {
+  const { app } = await electronPreset(context, {
+    appPath: '/path/to/electron/app',
+    args: ['--enable-logging'],
+  });
+
+  await app.find('main window').click();
+}, 60000);
+
+test.skip('Custom preset - create your own', async (context) => {
+  // Create a custom preset for your application
+  const firefoxPreset = createPreset({
+    name: 'Firefox Browser',
+    defaults: { os: 'linux', dashcam: true },
+    async setup(context, client, dashcam, options) {
+      const { url } = options;
+      
+      // Launch Firefox
+      await client.exec('sh', `firefox "${url}" >/dev/null 2>&1 &`, 30000);
+      await client.focusApplication('Firefox');
+      
+      return {
+        browser: client,
+      };
+    },
+  });
+
+  // Use your custom preset
+  const { browser } = await firefoxPreset(context, {
+    url: 'https://example.com',
+  });
+
+  await browser.find('page content').click();
+}, 60000);

package/testdriver/acceptance-sdk/press-keys.test.mjs

@@ -3,28 +3,14 @@
  * Converted from: testdriver/acceptance/press-keys.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Press Keys Test", () => {
-  let testdriver;
+  it("should create tabs and navigate using keyboard shortcuts", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should create tabs and navigate using keyboard shortcuts", async () => {
-    await testdriver.focusApplication("Google Chrome");
     const signInButton = await testdriver.find(
       "Sign In, black button below the password field",
     );

package/testdriver/acceptance-sdk/prompt.test.mjs

@@ -3,27 +3,15 @@
  * Converted from: testdriver/acceptance/prompt.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe.skip("Prompt Test", () => {
-  let testdriver;
+  it("should execute AI-driven prompts", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should execute AI-driven prompts", async () => {
+    //
     // Note: The SDK doesn't have a direct equivalent to YAML prompts without commands.
     // This would typically be handled by the AI agent interpreting natural language.
     // For SDK usage, you need to use explicit commands.

package/testdriver/acceptance-sdk/scroll-keyboard.test.mjs

@@ -3,29 +3,15 @@
  * Converted from: testdriver/acceptance/scroll-keyboard.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Scroll Keyboard Test", () => {
-  let testdriver;
+  it("should navigate to webhamster.com and scroll with keyboard", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({
-      task: context.task,
-      redrawThreshold: 0.5, // Higher threshold for scroll test
-    });
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should navigate to webhamster.com and scroll with keyboard", async () => {
+    //
     // Navigate to https://www.webhamster.com/
     await testdriver.focusApplication("Google Chrome");
     const urlBar = await testdriver.find(

package/testdriver/acceptance-sdk/scroll-until-image.test.mjs

@@ -3,27 +3,15 @@
  * Converted from: testdriver/acceptance/scroll-until-image.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Scroll Until Image Test", () => {
-  let testdriver;
+  it("should scroll until brown colored house image appears", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should scroll until brown colored house image appears", async () => {
+    //
     // Navigate to Wikipedia page
     await testdriver.pressKeys(["ctrl", "l"]);
     await testdriver.type("https://en.wikipedia.org/wiki/Leonardo_da_Vinci");

package/testdriver/acceptance-sdk/scroll-until-text.test.mjs

@@ -3,40 +3,26 @@
  * Converted from: testdriver/acceptance/scroll-until-text.yaml
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  performLogin,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { performLogin } from "./setup/testHelpers.mjs";
 
 describe("Scroll Until Text Test", () => {
-  let testdriver;
+  it('should scroll until "testdriver socks" appears', async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
-
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it('should scroll until "testdriver socks" appears', async () => {
+    //
     // Perform login first
     await performLogin(testdriver);
 
     // Scroll until text appears
     await testdriver.focusApplication("Google Chrome");
-    await testdriver.scrollUntilText("testdriver socks", "down");
+    await testdriver.scrollUntilText({ text: "testdriver socks", direction: "down" });
 
     // Assert testdriver socks appears on screen
     await testdriver.focusApplication("Google Chrome");
-    const result = await testdriver.assert(
-      "TestDriver Socks appears on screen",
-    );
+    const result = await testdriver.assert("TestDriver Socks appears on screen");
     expect(result).toBeTruthy();
   });
 });

package/testdriver/acceptance-sdk/scroll.test.mjs

@@ -1,33 +1,24 @@
 /**
  * TestDriver SDK - Scroll Test (Vitest)
  * Converted from: testdriver/acceptance/scroll.yaml
+ * 
+ * UPDATED: Now using chrome preset for automatic setup
  */
 
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-  createTestClient,
-  setupTest,
-  teardownTest,
-} from "./setup/testHelpers.mjs";
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../../src/vitest/hooks.mjs";
 
 describe("Scroll Test", () => {
-  let testdriver;
+  it("should navigate and scroll down the page", async (context) => {
+    const testdriver = TestDriver(context, { headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
-  beforeEach(async (context) => {
-    testdriver = createTestClient({ task: context.task });
+    // Give Chrome a moment to fully render the UI
+    await new Promise(resolve => setTimeout(resolve, 2000));
 
-    await setupTest(testdriver);
-  });
-
-  afterEach(async (context) => {
-    await teardownTest(testdriver, { task: context.task });
-  });
-
-  it("should navigate and scroll down the page", async () => {
-    // Navigate to webhamster.com
-    await testdriver.focusApplication("Google Chrome");
+    // Navigate to webhamster.com - just look for the domain, not the full path
     const urlBar = await testdriver.find(
-      "testdriver-sandbox.vercel.app/login, the URL in the omnibox showing the current page",
+      "testdriver-sandbox.vercel.app, the URL in the address bar",
     );
     await urlBar.click();
     await testdriver.pressKeys(["ctrl", "a"]);
@@ -44,7 +35,7 @@ describe("Scroll Test", () => {
     await testdriver.scroll("down", 1000);
 
     // Assert page is scrolled
-    const result = await testdriver.assert("the page is scrolled down");
+    const result = await testdriver.assert("the page is scrolled down, the hamster dance heading is not visible on the page");
     expect(result).toBeTruthy();
   });
 });