testdriverai 7.3.3 → 7.3.5

package/docs/v7/examples/type.mdx

@@ -0,0 +1,92 @@
+---
+title: "Typing Test Example"
+sidebarTitle: "Typing"
+description: "Example test demonstrating how to type text into input fields and verify the content."
+icon: "keyboard"
+mode: "wide"
+---
+
+## Demo Test Run
+
+Watch this test execute in a real sandbox environment:
+
+{/* type.test.mjs output */}
+<iframe 
+  src="https://testdriver-api.onrender.com/api/v1/testdriver/testcase/69852d10eae78746d7ac0c2e/replay" 
+  width="100%" 
+  height="390" 
+  style={{ border: "1px solid #333", borderRadius: "8px" }}
+  allow="fullscreen"
+/>
+
+## Source Code
+
+```javascript title="type.test.mjs" {13}
+/**
+ * TestDriver SDK - Type Test
+ */
+
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
+
+describe("Type Test", () => {
+  it("should enter standard_user in username field", async (context) => {
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP, headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
+
+    //
+    const usernameField = await testdriver.find(
+      "Username, input field for username",
+    );
+    await usernameField.click();
+    await testdriver.type("standard_user");
+
+    const result = await testdriver.assert(
+      'the username field contains "standard_user"',
+    );
+    expect(result).toBeTruthy();
+  });
+
+  it("should show validation message when clicking Sign In without password", async (context) => {
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP, headless: true });
+    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
+
+    // First fill in username
+    const usernameField = await testdriver.find(
+      "Username, input field for username",
+    );
+    await usernameField.click();
+    await testdriver.type("standard_user");
+
+    //
+    const signInButton = await testdriver.find(
+      "Sign in, black button below the password field",
+    );
+    await signInButton.click();
+
+    await testdriver.focusApplication("Google Chrome");
+    const result = await testdriver.assert(
+      "Please fill out this field is visible near the password field",
+    );
+    expect(result).toBeTruthy();
+  });
+});
+```
+
+## Running This Example
+
+```bash
+# Clone the TestDriver repository
+git clone https://github.com/testdriverai/testdriverai
+
+# Install dependencies
+cd testdriverai
+npm install
+
+# Run this specific example
+npx vitest run examples/type.test.mjs
+```
+
+<Note>
+  Make sure you have `TD_API_KEY` set in your environment. Get one at [testdriver.ai](https://testdriver.ai).
+</Note>

package/docs/v7/examples/windows-installer.mdx

@@ -0,0 +1,89 @@
+---
+title: "Windows App Installation"
+sidebarTitle: "Windows Installer"
+description: "Example test showing how to download and install Windows applications using MSI installers."
+icon: "download"
+mode: "wide"
+---
+
+## Demo Test Run
+
+Watch this test execute in a real sandbox environment:
+
+{/* windows-installer.test.mjs output */}
+<iframe 
+  src="https://testdriver-api.onrender.com/api/v1/testdriver/testcase/69852931eae78746d7ac0be6/replay" 
+  width="100%" 
+  height="390" 
+  style={{ border: "1px solid #333", borderRadius: "8px" }}
+  allow="fullscreen"
+/>
+
+## Source Code
+
+```javascript title="windows-installer.test.mjs" {22-25}
+/**
+ * TestDriver SDK - Windows Installer Example
+ */
+
+import { describe, it } from "vitest";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
+
+const isLinux = (process.env.TD_OS || "linux") === "linux";
+
+describe("Windows App Installation", () => {
+    
+  it.skipIf(isLinux)("should download, install, and launch GitButler on Windows", async (context) => {
+    // Alternative approach using provision.installer helper
+    const testdriver = TestDriver(context, { 
+      ip: context.ip || process.env.TD_IP,
+      os: 'windows'
+    });
+
+    // Download the MSI installer
+    const installerPath = await testdriver.provision.installer({
+      url: 'https://app.gitbutler.com/downloads/release/windows/x86_64/msi',
+      launch: false, // Don't auto-launch, we'll install manually
+    });
+
+    console.log('Installer downloaded to:', installerPath);
+
+    // Install the MSI silently (the file might not have an extension, so we try MSI first)
+    await testdriver.exec('pwsh', 
+      `Start-Process msiexec.exe -ArgumentList "/i \`"${installerPath}\`" /qn /norestart" -Wait`,
+      120000
+    );
+
+    // Verify installation by checking if executable exists
+    const verifyScript = `
+      $exePath = "C:\\Program Files\\GitButler\\gitbutler-tauri.exe"
+      if (Test-Path $exePath) {
+          Write-Host "GitButler installed successfully at $exePath"
+      } else {
+          Write-Error "GitButler not found"
+          exit 1
+      }
+    `;
+
+    await testdriver.exec('pwsh', verifyScript, 5000);
+  });
+});
+```
+
+## Running This Example
+
+```bash
+# Clone the TestDriver repository
+git clone https://github.com/testdriverai/testdriverai
+
+# Install dependencies
+cd testdriverai
+npm install
+
+# Run this specific example
+npx vitest run examples/windows-installer.test.mjs
+```
+
+<Note>
+  Make sure you have `TD_API_KEY` set in your environment. Get one at [testdriver.ai](https://testdriver.ai).
+</Note>

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.3",
+  "version": "7.3.5",
   "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/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"
-  ]
-}