testdriverai 7.1.0 → 7.1.2

package/{testdriver/acceptance-sdk → test/testdriver}/element-not-found.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Element Not Found Test", () => {
   it("should handle non-existent element gracefully without timing out", async (context) => {

package/{testdriver/acceptance-sdk → test/testdriver}/exec-js.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Exec JavaScript Test", () => {
   it("should fetch user data from API and enter email", async (context) => {

package/{testdriver/acceptance-sdk → test/testdriver}/exec-output.test.mjs

@@ -4,10 +4,10 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
-describe("Exec Output Test", () => {
-  it.skipIf(process.env.TD_OS === "linux")(
+describe.skipIf(process.env.TD_OS === "linux")("Exec Output Test", () => {
+  it(
     "should set date using PowerShell and navigate to calendar",
     async (context) => {
       const testdriver = TestDriver(context, { headless: true });

package/{testdriver/acceptance-sdk → test/testdriver}/exec-pwsh.test.mjs

@@ -4,10 +4,10 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
-describe("Exec PowerShell Test", () => {
-  it.skipIf(process.env.TD_OS === "linux")(
+describe.skipIf(process.env.TD_OS === "linux")("Exec PowerShell Test", () => {
+  it(
     "should generate random email using PowerShell and enter it",
     async (context) => {
       const testdriver = TestDriver(context, { headless: true });

package/{testdriver/acceptance-sdk → test/testdriver}/focus-window.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Focus Window Test", () => {
   it.skipIf(process.env.TD_OS === "linux")(

package/{testdriver/acceptance-sdk → test/testdriver}/formatted-logging.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Formatted Logging Test", () => {
   it("should demonstrate formatted logs in dashcam replay", async (context) => {

package/{testdriver/acceptance-sdk → test/testdriver}/hover-image.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 import { performLogin } from "./setup/testHelpers.mjs";
 
 describe("Hover Image Test", () => {

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

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 import { performLogin } from "./setup/testHelpers.mjs";
 
 describe("Hover Text With Description Test", () => {

package/{testdriver/acceptance-sdk → test/testdriver}/hover-text.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Hover Text Test", () => {
   it("should click Sign In and verify error message", async (context) => {

package/{testdriver/acceptance-sdk → test/testdriver}/match-image.test.mjs

@@ -6,7 +6,7 @@
 import path, { dirname } from "path";
 import { fileURLToPath } from "url";
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 import { performLogin } from "./setup/testHelpers.mjs";
 
 // Get the directory of the current module

package/{testdriver/acceptance-sdk → test/testdriver}/press-keys.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Press Keys Test", () => {
   it("should create tabs and navigate using keyboard shortcuts", async (context) => {

package/{testdriver/acceptance-sdk → test/testdriver}/prompt.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe.skip("Prompt Test", () => {
   it("should execute AI-driven prompts", async (context) => {
@@ -25,7 +25,7 @@ describe.skip("Prompt Test", () => {
     // This test is skipped as it requires explicit SDK implementation
     // You would need to implement these as explicit SDK calls
 
-    await testdriver.ai("log in");
+    await testdriver.act("log in");
 
     const result = await testdriver.assert("the testdriver sandbox is visible");
     expect(result).toBeTruthy();

package/{testdriver/acceptance-sdk → test/testdriver}/scroll-keyboard.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Scroll Keyboard Test", () => {
   it("should navigate to webhamster.com and scroll with keyboard", async (context) => {

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

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Scroll Until Image Test", () => {
   it("should scroll until brown colored house image appears", async (context) => {

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

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 import { performLogin } from "./setup/testHelpers.mjs";
 
 describe("Scroll Until Text Test", () => {

package/{testdriver/acceptance-sdk → test/testdriver}/scroll.test.mjs

@@ -6,7 +6,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../src/vitest/hooks.mjs";
+import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Scroll Test", () => {
   it("should navigate and scroll down the page", async (context) => {

package/{src/vitest/lifecycle.mjs → test/testdriver/setup/lifecycleHelpers.mjs}

@@ -1,23 +1,16 @@
 /**
- * Lifecycle Helpers for TestDriver Vitest Plugin
+ * Lifecycle Helpers
+ * Shared lifecycle hook functions (prerun, postrun)
  * 
- * Provides reusable lifecycle hook functions for common test patterns.
- * These are thin wrappers around the Dashcam class.
+ * LEGACY: These helpers are thin wrappers around the new Dashcam class.
+ * For new code, prefer using the Dashcam class directly:
  * 
- * @example
- * import { launchChrome, waitForPage } from 'testdriverai/vitest';
- * 
- * test('my test', async (context) => {
- *   const testdriver = TestDriver(context);
- *   await testdriver.provision.chrome({ url: 'https://example.com' });
- *   
- *   // Or use manual lifecycle helpers
- *   await launchChrome(testdriver, 'https://other-site.com');
- *   await waitForPage(testdriver, 'Welcome');
- * });
+ * import { Dashcam } from 'testdriverai/core';
+ * const dashcam = new Dashcam(client);
+ * await dashcam.auth();
  */
 
-import Dashcam from '../core/Dashcam.js';
+import Dashcam from '../../../lib/core/Dashcam.js';
 
 // Module-level cache to maintain Dashcam instance state across helper calls
 const dashcamInstances = new WeakMap();
@@ -38,16 +31,21 @@ function getDashcam(client, options = {}) {
 
 /**
  * Authenticate dashcam with API key
+ * @deprecated Use `new Dashcam(client)` and `dashcam.auth()` instead
  * @param {TestDriver} client - TestDriver client
- * @param {string} apiKey - Dashcam API key (default from environment)
+ * @param {string} apiKey - Dashcam API key (default: 4e93d8bf-3886-4d26-a144-116c4063522d)
  */
-export async function authDashcam(client, apiKey) {
+export async function authDashcam(
+  client,
+  apiKey = "4e93d8bf-3886-4d26-a144-116c4063522d",
+) {
   const dashcam = getDashcam(client, { apiKey });
   await dashcam.auth();
 }
 
 /**
  * Add log file tracking to dashcam
+ * @deprecated Use `new Dashcam(client)` and `dashcam.addFileLog()` instead
  * @param {TestDriver} client - TestDriver client
  * @param {string} logName - Name for the log in dashcam (default: "TestDriver Log")
  */
@@ -58,11 +56,10 @@ export async function addDashcamLog(client, logName = "TestDriver Log") {
     : "/tmp/testdriver.log";
   
   // Create log file first
-  const shell = client.os === "windows" ? "pwsh" : "sh";
   if (client.os === "windows") {
-    await client.exec(shell, `New-Item -ItemType File -Path "${logPath}" -Force`, 10000, true);
+    await client.exec("pwsh", `New-Item -ItemType File -Path "${logPath}" -Force`, 10000, true);
   } else {
-    await client.exec(shell, `touch ${logPath}`, 10000, true);
+    await client.exec("sh", `touch ${logPath}`, 10000, true);
   }
   
   await dashcam.addFileLog(logPath, logName);
@@ -70,6 +67,7 @@ export async function addDashcamLog(client, logName = "TestDriver Log") {
 
 /**
  * Start dashcam recording
+ * @deprecated Use `new Dashcam(client)` and `dashcam.start()` instead
  * @param {TestDriver} client - TestDriver client
  */
 export async function startDashcam(client) {
@@ -79,6 +77,7 @@ export async function startDashcam(client) {
 
 /**
  * Stop dashcam recording and retrieve URL
+ * @deprecated Use `new Dashcam(client)` and `dashcam.stop()` instead
  * @param {TestDriver} client - TestDriver client
  * @returns {Promise<string|null>} Dashcam URL if available
  */
@@ -98,76 +97,81 @@ export async function stopDashcam(client) {
 }
 
 /**
- * Launch Chrome browser
+ * Launch Chrome browser with guest mode
  * @param {TestDriver} client - TestDriver client
- * @param {string} url - URL to open
- * @param {object} options - Browser options
- * @param {boolean} options.guest - Launch in guest mode (default: true)
- * @param {boolean} options.maximized - Start maximized (default: true)
+ * @param {string} url - URL to open (default: https://testdriver-sandbox.vercel.app/)
  */
-export async function launchChrome(client, url = "about:blank", options = {}) {
-  const { guest = true, maximized = true } = options;
+export async function launchChrome(
+  client,
+  url = "http://testdriver-sandbox.vercel.app/",
+) {
   const shell = client.os === "windows" ? "pwsh" : "sh";
-  
-  const guestFlag = guest ? "--guest" : "";
-  const maxFlag = maximized ? "--start-maximized" : "";
 
   if (client.os === "windows") {
-    const args = [maxFlag, guestFlag, `"${url}"`].filter(Boolean).join('", "');
     await client.exec(
       "pwsh",
-      `Start-Process "C:/Program Files/Google/Chrome/Application/chrome.exe" -ArgumentList "${args}"`,
+      `Start-Process "C:/Program Files/Google/Chrome/Application/chrome.exe" -ArgumentList "--start-maximized", "--guest", "${url}"`,
       30000,
     );
   } else {
-    const flags = [maxFlag, "--disable-fre", "--no-default-browser-check", "--no-first-run", guestFlag].filter(Boolean).join(" ");
     await client.exec(
       shell,
-      `google-chrome ${flags} "${url}" >/dev/null 2>&1 &`,
+      `google-chrome --start-maximized --disable-fre --no-default-browser-check --no-first-run --guest "${url}" >/dev/null 2>&1 &`,
       30000,
     );
   }
 }
 
 /**
- * Launch Chrome for Testing browser
+ * Launch Chrome for Testing browser with guest mode
  * @param {TestDriver} client - TestDriver client
- * @param {string} url - URL to open
- * @param {object} options - Browser options
+ * @param {string} url - URL to open (default: https://testdriver-sandbox.vercel.app/)
  */
-export async function launchChromeForTesting(client, url = "about:blank", options = {}) {
-  const { guest = true, maximized = true } = options;
+export async function launchChromeForTesting(
+  client,
+  url = "http://testdriver-sandbox.vercel.app/",
+) {
   const shell = client.os === "windows" ? "pwsh" : "sh";
-  
-  const guestFlag = guest ? "--guest" : "";
-  const maxFlag = maximized ? "--start-maximized" : "";
 
   if (client.os === "windows") {
-    // Fallback to regular Chrome on Windows
-    await launchChrome(client, url, options);
+    // Windows Chrome for Testing path would need to be determined
+    // For now, fallback to regular Chrome on Windows
+    await client.exec(
+      "pwsh",
+      `Start-Process "C:/Program Files/Google/Chrome/Application/chrome.exe" -ArgumentList "--start-maximized", "--guest", "${url}"`,
+      30000,
+    );
   } else {
-    const flags = [maxFlag, "--disable-fre", "--no-default-browser-check", "--no-first-run", guestFlag].filter(Boolean).join(" ");
     await client.exec(
       shell,
-      `chrome-for-testing ${flags} "${url}" >/dev/null 2>&1 &`,
+      `chrome-for-testing --start-maximized --disable-fre --no-default-browser-check --no-first-run --guest "${url}" >/dev/null 2>&1 &`,
       30000,
     );
   }
 }
 
 /**
- * Launch Chrome with a Chrome extension loaded
+ * Launch Chrome for Testing with a Chrome extension loaded
  * @param {TestDriver} client - TestDriver client
- * @param {string} extensionId - Chrome Web Store extension ID
- * @param {string} url - URL to open
+ * @param {string} extensionId - Chrome Web Store extension ID (e.g., "cjpalhdlnbpafiamejdnhcphjbkeiagm" for uBlock Origin)
+ * @param {string} url - URL to open (default: https://testdriver-sandbox.vercel.app/)
  * @example
  * // Launch with uBlock Origin extension
  * await launchChromeExtension(client, "cjpalhdlnbpafiamejdnhcphjbkeiagm");
+ * 
+ * // Launch with multiple extensions (comma-separated)
+ * await launchChromeExtension(client, "cjpalhdlnbpafiamejdnhcphjbkeiagm,nngceckbapebfimnlniiiahkandclblb");
  */
-export async function launchChromeExtension(client, extensionId, url = "about:blank") {
+export async function launchChromeExtension(
+  client,
+  extensionId,
+  url = "http://testdriver-sandbox.vercel.app/",
+) {
   const shell = client.os === "windows" ? "pwsh" : "sh";
 
   if (client.os === "windows") {
+    // Windows Chrome for Testing path would need to be determined
+    // For now, fallback to regular Chrome on Windows
     await client.exec(
       "pwsh",
       `Start-Process "C:/Program Files/Google/Chrome/Application/chrome.exe" -ArgumentList "--start-maximized", "--load-extension=${extensionId}", "${url}"`,
@@ -188,87 +192,68 @@ export async function launchChromeExtension(client, extensionId, url = "about:bl
  * @param {string} text - Text to wait for
  * @param {number} maxAttempts - Maximum number of attempts (default: 60)
  * @param {number} pollInterval - Interval between polls in ms (default: 5000)
- * @returns {Promise<boolean>} True if text was found
  */
-export async function waitForPage(client, text, maxAttempts = 60, pollInterval = 5000) {
+export async function waitForPage(
+  client,
+  text,
+  maxAttempts = 60,
+  pollInterval = 5000,
+) {
   console.log("Waiting for page to load, looking for text:", text);
+  let element;
   for (let i = 0; i < maxAttempts; i++) {
-    const element = await client.find(text);
-    if (element.found()) {
-      return true;
-    }
+    element = await client.find(text);
+    if (element.found()) break;
     await new Promise((resolve) => setTimeout(resolve, pollInterval));
   }
-  return false;
 }
 
 /**
- * Run standard prerun lifecycle hooks
- * Authenticates, starts dashcam, launches Chrome
+ * Run prerun lifecycle hooks
+ * Implements lifecycle/prerun.yaml functionality
  * @param {TestDriver} client - TestDriver client
- * @param {object} options - Options
- * @param {string} options.url - URL to open (default: sandbox)
- * @param {string} options.waitForText - Text to wait for after page load
  */
-export async function runPrerun(client, options = {}) {
-  const { 
-    url = "http://testdriver-sandbox.vercel.app/", 
-    waitForText = "TestDriver.ai Sandbox" 
-  } = options;
-  
+export async function runPrerun(client) {
   await authDashcam(client);
   await addDashcamLog(client);
   await startDashcam(client);
-  await launchChrome(client, url);
-  if (waitForText) {
-    await waitForPage(client, waitForText);
-  }
+  await launchChrome(client);
+  await waitForPage(client, "TestDriver.ai Sandbox");
 }
 
 /**
- * Run prerun with Chrome for Testing
+ * Run prerun lifecycle hooks with Chrome for Testing
+ * Implements lifecycle/prerun.yaml functionality using Chrome for Testing
  * @param {TestDriver} client - TestDriver client
- * @param {object} options - Options
  */
-export async function runPrerunChromeForTesting(client, options = {}) {
-  const { 
-    url = "http://testdriver-sandbox.vercel.app/", 
-    waitForText = "TestDriver.ai Sandbox" 
-  } = options;
-  
+export async function runPrerunChromeForTesting(client) {
   await authDashcam(client);
   await addDashcamLog(client);
   await startDashcam(client);
-  await launchChromeForTesting(client, url);
-  if (waitForText) {
-    await waitForPage(client, waitForText);
-  }
+  await launchChromeForTesting(client);
+  await waitForPage(client, "TestDriver.ai Sandbox");
 }
 
 /**
- * Run prerun with Chrome extension
+ * Run prerun lifecycle hooks with Chrome extension loaded
+ * Implements lifecycle/prerun.yaml functionality with a Chrome extension
  * @param {TestDriver} client - TestDriver client
- * @param {string} extensionId - Chrome extension ID
- * @param {object} options - Options
+ * @param {string} extensionId - Chrome Web Store extension ID to load
+ * @example
+ * // Launch with uBlock Origin extension
+ * await runPrerunChromeExtension(client, "cjpalhdlnbpafiamejdnhcphjbkeiagm");
  */
-export async function runPrerunChromeExtension(client, extensionId, options = {}) {
-  const { 
-    url = "http://testdriver-sandbox.vercel.app/", 
-    waitForText = "TestDriver.ai Sandbox" 
-  } = options;
-  
+export async function runPrerunChromeExtension(client, extensionId) {
   await authDashcam(client);
   await addDashcamLog(client);
   await startDashcam(client);
-  await launchChromeExtension(client, extensionId, url);
-  if (waitForText) {
-    await waitForPage(client, waitForText);
-  }
+  await launchChromeExtension(client, extensionId);
+  await waitForPage(client, "TestDriver.ai Sandbox");
 }
 
 /**
- * Run standard postrun lifecycle hooks
- * Stops dashcam and returns URL
+ * Run postrun lifecycle hooks
+ * Implements lifecycle/postrun.yaml functionality
  * @param {TestDriver} client - TestDriver client
  * @returns {Promise<string|null>} Dashcam URL if available
  */