testdriverai 7.3.4 → 7.3.6

package/interfaces/vitest-plugin.mjs

@@ -14,30 +14,54 @@ const require = createRequire(import.meta.url);
  */
 const MINIMUM_VITEST_VERSION = 4;
 
+/**
+ * Try to read vitest's package.json version using multiple resolution strategies.
+ * Vitest's Vite-based transform pipeline can rewrite import.meta.url, causing
+ * createRequire to resolve from the wrong location. We fall back to resolving
+ * from process.cwd() and then to reading directly from node_modules.
+ * @returns {string|null} The vitest version string, or null if not found
+ */
+function resolveVitestVersion() {
+  // Strategy 1: createRequire from import.meta.url (standard CJS interop)
+  try {
+    return require("vitest/package.json").version;
+  } catch {}
+
+  // Strategy 2: createRequire from process.cwd() (works when import.meta.url is rewritten)
+  try {
+    const cwdRequire = createRequire(path.join(process.cwd(), "package.json"));
+    return cwdRequire("vitest/package.json").version;
+  } catch {}
+
+  // Strategy 3: read directly from node_modules on disk
+  try {
+    const vitestPkgPath = path.join(process.cwd(), "node_modules", "vitest", "package.json");
+    return JSON.parse(fs.readFileSync(vitestPkgPath, "utf8")).version;
+  } catch {}
+
+  return null;
+}
+
 /**
  * Check that Vitest version meets minimum requirements
  * @throws {Error} if Vitest version is below minimum or not installed
  */
 function checkVitestVersion() {
-  try {
-    const vitestPkg = require("vitest/package.json");
-    const version = vitestPkg.version;
-    const major = parseInt(version.split(".")[0], 10);
+  const version = resolveVitestVersion();
 
-    if (major < MINIMUM_VITEST_VERSION) {
-      throw new Error(
-        `TestDriver requires Vitest >= ${MINIMUM_VITEST_VERSION}.0.0, but found ${version}. ` +
-          `Please upgrade Vitest: npm install vitest@latest`,
-      );
-    }
-  } catch (err) {
-    if (err.code === "MODULE_NOT_FOUND") {
-      throw new Error(
-        "TestDriver requires Vitest to be installed. " +
-          "Please install it: npm install vitest@latest",
-      );
-    }
-    throw err;
+  if (!version) {
+    throw new Error(
+      "TestDriver requires Vitest to be installed. " +
+        "Please install it: npm install vitest@latest",
+    );
+  }
+
+  const major = parseInt(version.split(".")[0], 10);
+  if (major < MINIMUM_VITEST_VERSION) {
+    throw new Error(
+      `TestDriver requires Vitest >= ${MINIMUM_VITEST_VERSION}.0.0, but found ${version}. ` +
+        `Please upgrade Vitest: npm install vitest@latest`,
+    );
   }
 }
 
@@ -1013,6 +1037,14 @@ class TestDriverReporter {
       console.log(
         `🔗 Test Report: ${getConsoleUrl(pluginState.apiRoot)}/runs/${testRunDbId}/${testCaseDbId}`,
       );
+      
+      // Output parseable format for docs generation (examples only)
+      if (testFile.startsWith("examples/")) {
+        const testFileName = path.basename(testFile);
+        console.log(
+          `TESTDRIVER_EXAMPLE_URL::${testFileName}::${getConsoleUrl(pluginState.apiRoot)}/runs/${testRunDbId}/${testCaseDbId}`,
+        );
+      }
     } catch (error) {
       logger.error("Failed to report test case:", error.message);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.3.4",
+  "version": "7.3.6",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "types": "sdk.d.ts",
@@ -42,6 +42,8 @@
     "docs:build": "npm run docs:skills && cd docs && npx mint@latest build",
     "docs:links": "node docs/_scripts/link-replacer.js",
     "docs:skills": "node docs/_scripts/generate-skills.js",
+    "docs:examples": "node docs/_scripts/generate-examples.js",
+    "docs:extract-urls": "node docs/_scripts/extract-example-urls.js",
     "bundle": "node build.mjs",
     "test": "mocha test/*",
     "test:sdk": "vitest run",

package/sdk.js

@@ -1567,6 +1567,51 @@ class TestDriverSDK {
     return "C:\\PROGRA~1\\nodejs\\node_modules\\dashcam-chrome\\build";
   }
 
+  /**
+   * Wait for Chrome DevTools Protocol debugger to be ready on port 9222,
+   * then wait for a page to report loaded.
+   * Works on both Windows (PowerShell) and Linux (sh).
+   * @param {number} [timeoutMs=60000] - Maximum time to wait in ms
+   * @returns {Promise<void>}
+   */
+  async _waitForChromeDebuggerReady(timeoutMs = 60000) {
+    const shell = this.os === "windows" ? "pwsh" : "sh";
+
+    if (this.os === "windows") {
+      // Wait for port 9222 to be listening
+      await this.exec(
+        shell,
+        `$timeout = ${Math.floor(timeoutMs / 1000)}; $elapsed = 0; while ($elapsed -lt $timeout) { try { $tcp = New-Object System.Net.Sockets.TcpClient; $tcp.Connect('127.0.0.1', 9222); $tcp.Close(); break } catch { Start-Sleep -Milliseconds 200; $elapsed += 0.2 } }`,
+        timeoutMs,
+        true,
+      );
+
+      // Wait for a page target to appear via CDP
+      await this.exec(
+        shell,
+        `$timeout = ${Math.floor(timeoutMs / 1000)}; $elapsed = 0; while ($elapsed -lt $timeout) { try { $r = Invoke-RestMethod -Uri 'http://localhost:9222/json' -TimeoutSec 2; if ($r | Where-Object { $_.type -eq 'page' }) { break } } catch {} Start-Sleep -Milliseconds 500; $elapsed += 0.5 }`,
+        timeoutMs,
+        true,
+      );
+    } else {
+      // Wait for port 9222 to be listening
+      await this.exec(
+        shell,
+        `timeout=${Math.floor(timeoutMs / 1000)}; elapsed=0; while [ $elapsed -lt $timeout ]; do nc -z localhost 9222 && break; sleep 0.2; elapsed=$((elapsed + 1)); done`,
+        timeoutMs,
+        true,
+      );
+
+      // Wait for a page target to appear via CDP
+      await this.exec(
+        shell,
+        `timeout=${Math.floor(timeoutMs / 1000)}; elapsed=0; while [ $elapsed -lt $timeout ]; do curl -s http://localhost:9222/json 2>/dev/null | grep -q '"type": "page"' && break; sleep 0.5; elapsed=$((elapsed + 1)); done`,
+        timeoutMs,
+        true,
+      );
+    }
+  }
+
   _createProvisionAPI() {
     const self = this;
 
@@ -1691,31 +1736,9 @@ class TestDriverSDK {
           );
         }
 
-        // Wait for Chrome to be ready
+        // Wait for Chrome debugger port and page to be ready
+        await this._waitForChromeDebuggerReady();
         await this.focusApplication("Google Chrome");
-
-        // Wait for URL to load
-        try {
-          const urlObj = new URL(url);
-          const domain = urlObj.hostname;
-
-          for (let attempt = 0; attempt < 30; attempt++) {
-            const result = await this.find(`${domain}`);
-
-            if (result.found()) {
-              break;
-            } else {
-              await new Promise((resolve) => setTimeout(resolve, 1000));
-            }
-          }
-
-          await this.focusApplication("Google Chrome");
-        } catch (e) {
-          console.warn(
-            `[provision.chrome] ⚠️  Could not parse URL "${url}":`,
-            e.message,
-          );
-        }
       },
 
       /**
@@ -1977,20 +2000,8 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
           );
         }
 
-        // Wait for Chrome to be ready
-        await this.focusApplication("Google Chrome");
-
-        // Wait for New Tab to appear
-        for (let attempt = 0; attempt < 30; attempt++) {
-          const result = await this.find("New Tab");
-
-          if (result.found()) {
-            break;
-          } else {
-            await new Promise((resolve) => setTimeout(resolve, 1000));
-          }
-        }
-
+        // Wait for Chrome debugger port and page to be ready
+        await this._waitForChromeDebuggerReady();
         await this.focusApplication("Google Chrome");
       },
 

package/vitest.config.mjs

@@ -13,7 +13,7 @@ export default defineConfig({
     testTimeout: 900000,
     hookTimeout: 900000,
     disableConsoleIntercept: true,
-    maxConcurrency: 3,
+    maxConcurrency: 100,
     reporters: [
       "default",
       TestDriver(),

package/docs/v7/examples.mdx

@@ -1,5 +0,0 @@
----
-title: "Examples"
-url: "https://github.com/testdriverai/testdriverai/tree/main/examples"
-icon: 'code'
----

package/jsconfig.json

@@ -1,26 +0,0 @@
-{
-  "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "target": "ES2022",
-    "checkJs": true,
-    "strict": false,
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "baseUrl": ".",
-    "typeRoots": ["."]
-  },
-  "include": [
-    "**/*.js",
-    "**/*.mjs",
-    "**/*.d.ts",
-    "sdk.d.ts",
-    "lib/**/*.d.ts",
-    "interfaces/**/*.d.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    "build"
-  ]
-}