testdriverai 7.2.3 → 7.2.10

package/docs/docs.json

@@ -187,132 +187,100 @@
               }
             ]
           },
-        {
-  "version": "v7",
-  "groups": [
-    {
-      "group": "Getting Started",
-      "pages": [
-        "/v7/getting-started/quickstart",
-        "/v7/getting-started/writing-tests",
-        "/v7/getting-started/running-tests",
-        "/v7/getting-started/debugging-tests",
-        "/v7/getting-started/setting-up-in-ci"
-      ]
-    },
-    {
-      "group": "Examples",
-      "pages": [
-        "/v7/presets/chrome",
-        "/v7/presets/chrome-extension",
-        "/v7/presets/vscode",
-        "/v7/presets/electron"
-      ]
-    },
-    {
-      "group": "Guides",
-      "pages": [
-        {
-          "group": "Selectorless Testing",
-          "icon": "sparkles",
-          "pages": [
-            "/v7/features/easy-to-write",
-            "/v7/features/coverage",
-            "/v7/features/powerful",
-            "/v7/features/ai-native"
-          ]
-        },
-        {
-          "group": "Sandbox Environments",
-          "icon": "cube",
-          "pages": [
-            "/v7/features/managed-sandboxes",
-            "/v7/features/sandbox-customization",
-            "/v7/features/enterprise"
-          ]
-        },
-        {
-          "group": "Test Observability",
-          "icon": "microscope",
-          "pages": [
-            "/v7/features/application-logs",
-            "/v7/features/browser-logs",
-            "/v7/features/network-monitoring",
-            "/v7/features/system-performance"
-          ]
-        },
-        {
-          "group": "Performance & Reliability",
-          "icon": "gauge-high",
-          "pages": [
-            "/v7/features/fast",
-            "/v7/features/stable",
-            "/v7/features/parallel-execution",
-            "/v7/features/cache-management"
-          ]
-        },
-        {
-          "group": "Testing at Scale",
-          "icon": "arrow-up-right-dots",
-          "pages": [
-            "/v7/features/data-driven-testing",
-            "/v7/features/continuous-testing"
-          ]
-        },
-        {
-          "group": "Reports & Analytics",
-          "icon": "chart-line",
-          "pages": [
-            "/v7/features/test-reports",
-            "/v7/features/test-analytics",
-            "/v7/features/test-cases",
-            "/v7/features/test-replays"
-          ]
-        }
-      ]
-    },
-    {
-      "group": "Reference",
-      "icon": "book",
-      "pages": [
-        {
-          "group": "Actions",
-          "icon": "bolt",
-          "pages": [
-            "/v7/api/act",
-            "/v7/api/assert",
-            "/v7/api/assertions",
-            "/v7/api/click",
-            "/v7/api/doubleClick",
-            "/v7/api/exec",
-            "/v7/api/find",
-            "/v7/api/focusApplication",
-            "/v7/api/hover",
-            "/v7/api/mouseDown",
-            "/v7/api/mouseUp",
-            "/v7/api/pressKeys",
-            "/v7/api/rightClick",
-            "/v7/api/type",
-            "/v7/api/scroll"
-          ]
-        },
-        {
-          "group": "Client SDK",
-          "icon": "code",
-          "pages": [
-            "/v7/api/client",
-            "/v7/api/elements",
-            "/v7/api/sandbox",
-            "/v7/api/dashcam"
-          ]
-        }
-      ]
-    }
-  ]
-}
-
+          {
+            "version": "v7",
+            "groups": [
+              {
+                "group": "Overview",
+                "pages": [
+                  "/v7/what-is-testdriver",
+                  "/v7/quickstart",
+                  "/v7/examples",
+                  {
+                    "group": "Plans & Pricing",
+                    "icon": "server",
+                    "pages": [
+                      "/v7/cloud",
+                      {
+                        "group": "Self-Hosted",
+                        "icon": "server",
+                        "pages": [
+                          "/v7/self-hosted",
+                          "/v7/aws-setup"
+                        ]
+                      },
+                      "/v7/enterprise"
+                    ]
+                  }
+                ]
+              },
+              {
+                "group": "Creating Tests",
+                "pages": [
+                  "/v7/generating-tests",
+                  "/v7/locating-elements",
+                  "/v7/waiting-for-elements",
+                  "/v7/performing-actions",
+                  "/v7/making-assertions"
+                ]
+              },
+              {
+                "group": "Running Tests",
+                "pages": [
+                  "/v7/running-tests",
+                  "/v7/caching",
+                  "/v7/ci-cd"
+                ]
+              },
+              {
+                "group": "Scaling",
+                "pages": [
+                  "/v7/variables",
+                  "/v7/secrets",
+                  "/v7/reusable-code",
+                  "/v7/customizing-devices"
+                ]
+              },
+              {
+                "group": "Reference",
+                "icon": "book",
+                "pages": [
+                  {
+                    "group": "Actions",
+                    "icon": "bolt",
+                    "pages": [
+                      "/v7/ai",
+                      "/v7/assert",
+                      "/v7/click",
+                      "/v7/double-click",
+                      "/v7/exec",
+                      "/v7/find",
+                      "/v7/focus-application",
+                      "/v7/hover",
+                      "/v7/mouse-down",
+                      "/v7/mouse-up",
+                      "/v7/press-keys",
+                      "/v7/right-click",
+                      "/v7/type",
+                      "/v7/scroll"
+                    ]
+                  },
+                  {
+                    "group": "Client SDK",
+                    "icon": "code",
+                    "pages": [
+                      "/v7/client",
+                      "/v7/elements",
+                      "/v7/sandbox",
+                      "/v7/dashcam"
+                    ]
+                  }
+                ]
+              }
+            ]
+          }
         ]
-  },
+      },
   "logo": {
     "light": "/images/template/light.png",
     "dark": "/images/template/dark.png",

package/docs/v7/_drafts/architecture.mdx

@@ -44,7 +44,6 @@ This system provides comprehensive test execution tracking, linking test runs wi
 │         │                │                                   │
 │         │ • TdTestRun    │                                   │
 │         │ • TdTestCase   │                                   │
-│         │ • TdSandbox    │                                   │
 │         │ • Replay       │                                   │
 │         └────────────────┘                                   │
 │                                                               │
@@ -95,7 +94,6 @@ Represents a complete test suite execution (e.g., `npx vitest run`).
 
 **Relationships:**
 - `team`: Owner team
-- `sandbox`: TdSandbox where tests ran
 - `testCases`: Collection of TdTestCase
 - `replays`: Associated Replay records
 
@@ -114,36 +112,13 @@ Represents an individual test within a test run.
 
 **Relationships:**
 - `testRun`: Parent TdTestRun
-- `replay`: Associated Replay record
-
-### TdSandbox
-Represents a spawned VM/sandbox instance.
-
-**Key Fields:**
-- `sandboxId`: Unique identifier
-- `platform`: windows | mac | linux
-- `status`: provisioning | ready | running | stopped | terminated
-- `instanceId`, `instanceType`: AWS EC2 details
-- `ipAddress`, `vncUrl`, `wsUrl`: Connection details
-- `spawnTime`, `readyTime`, `terminateTime`: Lifecycle timestamps
-- `dashcamAuth`: Whether dashcam was authenticated
-- `dashcamProjectId`: Dashcam project for replays
-
-**Relationships:**
-- `team`: Owner team
-- `user`: User who spawned it
-- `testRuns`: Tests that ran on this sandbox
-- `replays`: Dashcam recordings from this sandbox
-
-**Note:** Sandbox creation/updates happen via WebSocket (not REST API) as part of the sandbox provisioning flow.
-
+- `replay`: Associated Replay recor
 ### Replay (Extended)
 Existing model extended with test run associations.
 
 **New Fields:**
 - `tdTestRun`: Associated test run
 - `tdTestCase`: Associated test case
-- `tdSandbox`: Sandbox where recorded
 
 ## API Endpoints
 

package/docs/v7/_drafts/caching.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Caching"
-sidebarTitle: "Caching"
+title: "Caching Prompts"
+sidebarTitle: "Caching Prompts"
 description: "How TestDriver caches AI responses and element locations for faster tests"
 icon: "bolt"
 ---

package/docs/v7/{getting-started → _drafts}/installation.mdx

@@ -418,69 +418,3 @@ npx vitest run verify.test.js
     For on-premise deployment, see [self-hosting guide](/v7/guides/self-hosting).
   </Accordion>
 </AccordionGroup>
-
-## Next Steps
-
-Now that you have TestDriver installed:
-
-<CardGroup cols={2}>
-  <Card
-    title="Write Your First Test"
-    icon="pencil"
-    href="/v7/getting-started/writing-tests"
-  >
-    Learn how to write effective TestDriver tests
-  </Card>
-
-  <Card
-    title="Generate Tests with AI"
-    icon="wand-magic-sparkles"
-    href="/v7/getting-started/generating-tests"
-  >
-    Use Claude to generate tests automatically
-  </Card>
-
-  <Card
-    title="View Examples"
-    icon="code"
-    href="/v7/presets/chrome"
-  >
-    See TestDriver in action with examples
-  </Card>
-
-  <Card
-    title="API Reference"
-    icon="book"
-    href="/v7/api/client"
-  >
-    Explore all available methods
-  </Card>
-</CardGroup>
-
-## Getting Help
-
-<CardGroup cols={3}>
-  <Card
-    title="Discord"
-    icon="discord"
-    href="https://discord.com/invite/cWDFW8DzPm"
-  >
-    Join our community
-  </Card>
-
-  <Card
-    title="GitHub"
-    icon="github"
-    href="https://github.com/testdriverai"
-  >
-    Report issues
-  </Card>
-
-  <Card
-    title="Documentation"
-    icon="book"
-    href="/v7/guides/troubleshooting"
-  >
-    Troubleshooting guide
-  </Card>
-</CardGroup>

package/docs/v7/{features/coverage.mdx → _drafts/powerful.mdx}

@@ -1,100 +1,11 @@
 ---
-title: "Selectorless Coverage"
+title: "Common Patterns"
 description: "Test everything from desktop apps to chatbots to video content"
 icon: "radar"
 ---
 
 TestDriver provides unmatched testing coverage across platforms, applications, and content types. From desktop applications to AI chatbots, from PDFs to videos, TestDriver can test it all.
 
-## Application Types
-
-### Desktop Applications
-
-Test native desktop applications on Windows, macOS, and Linux with the same simple API:
-
-```javascript
-import { test } from 'vitest';
-import { desktop } from 'testdriverai/presets';
-
-test('desktop app with file operations', async (context) => {
-  const { testdriver } = await desktop(context, {
-    appPath: '/Applications/MyApp.app',
-    os: 'mac'
-  });
-
-  await testdriver.find('File menu').click();
-  await testdriver.find('Open').click();
-  await testdriver.find('Documents folder').doubleClick();
-  await testdriver.find('test.txt').click();
-  await testdriver.find('Open button').click();
-  await testdriver.assert('test.txt is displayed in the editor');
-});
-```
-
-<Card title="Desktop Preset" icon="desktop" href="/v7/presets/desktop">
-  Complete guide to testing desktop applications
-</Card>
-
-### VS Code Extensions
-
-Test IDE extensions with full access to the VS Code environment:
-
-```javascript
-import { test } from 'vitest';
-import { vscode } from 'testdriverai/presets';
-
-test('vscode extension with settings', async (context) => {
-  const { testdriver } = await vscode(context, {
-    workspace: '/tmp/test-project',
-    extensions: ['your-extension-id']
-  });
-
-  // Open settings
-  await testdriver.pressKeys(['cmd', ',']);
-  await testdriver.find('search settings input').type('your.extension.setting');
-  await testdriver.find('Enable feature checkbox').click();
-  
-  // Verify extension behavior
-  await testdriver.pressKeys(['cmd', 'shift', 'p']);
-  await testdriver.type('Your Extension Command');
-  await testdriver.pressKeys(['enter']);
-  await testdriver.assert('Extension panel is visible');
-});
-```
-
-<Card title="VS Code Preset" icon="code" href="/v7/presets/vscode">
-  Complete guide to testing VS Code extensions
-</Card>
-
-### Chrome Extensions
-
-Test browser extensions in their natural environment with access to popups, content scripts, and background pages:
-
-```javascript
-import { test } from 'vitest';
-import { chromeExtension } from 'testdriverai/presets';
-
-test('chrome extension functionality', async (context) => {
-  const { testdriver } = await chromeExtension(context, {
-    extensionPath: './my-extension',
-    url: 'https://example.com'
-  });
-
-  // Test extension popup
-  await testdriver.find('extension icon').click();
-  await testdriver.find('Enable feature toggle').click();
-  await testdriver.assert('Feature enabled message appears');
-
-  // Test content script injection
-  await testdriver.assert('Extension content is visible on page');
-});
-```
-
-<Card title="Chrome Extension Preset" icon="puzzle-piece" href="/v7/presets/chrome-extension">
-  Complete guide to testing Chrome extensions
-</Card>
-
-## Advanced Use Cases
 
 ### AI Chatbots
 

package/docs/v7/_drafts/quick-start-test-recording.mdx

@@ -185,7 +185,6 @@ await client.completeTestRun({
 **API (Backend)**
 - `api/models/TdTestRun.js` - Test run model
 - `api/models/TdTestCase.js` - Test case model
-- `api/models/TdSandbox.js` - Sandbox tracking model
 - `api/controllers/testdriver/testdriver-test-run-create.js` - Create test run endpoint
 - `api/controllers/testdriver/testdriver-test-run-complete.js` - Complete test run endpoint
 - `api/controllers/testdriver/testdriver-test-case-create.js` - Record test case endpoint

package/docs/v7/{features → _drafts}/scalable.mdx

@@ -344,13 +344,35 @@ TestDriver integrates seamlessly with all major CI/CD platforms:
 
 ## JUnit Reports
 
-Generate JUnit XML reports for test result aggregation:
+Generate JUnit XML reports for test result aggregation and CI/CD integration.
+
+### Basic Setup
+
+Configure Vitest to output JUnit reports by adding a reporter to your config:
+
+```javascript vitest.config.mjs
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    testTimeout: 120000,
+    hookTimeout: 120000,
+    reporters: ['default', 'junit'],
+    outputFile: {
+      junit: 'test-report.junit.xml'
+    }
+  },
+});
+```
+
+Or run from the command line:
 
 ```bash
-# Generate JUnit report
 npx vitest run --reporter=junit --outputFile=test-results.xml
 ```
 
+This generates a standard JUnit XML report:
+
 ```xml test-results.xml
 <?xml version="1.0" encoding="UTF-8"?>
 <testsuites name="vitest tests" tests="12" failures="0" errors="0" time="125.3">
@@ -359,12 +381,112 @@ npx vitest run --reporter=junit --outputFile=test-results.xml
     <testcase name="invalid credentials show error" time="9.8" />
     <testcase name="password reset works" time="9.0" />
   </testsuite>
-  <!-- More test suites -->
 </testsuites>
 ```
 
+### GitHub Actions PR Comments
+
+Use JUnit reports to automatically post test results as comments on pull requests. This provides immediate visibility into test failures without leaving GitHub.
+
+```yaml .github/workflows/test.yml
+name: E2E Tests
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+  checks: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run tests
+        run: npx vitest run
+        env:
+          TD_API_KEY: ${{ secrets.TD_API_KEY }}
+
+      - name: Publish Test Results
+        uses: EnricoMi/publish-unit-test-result-action@v2
+        if: always()
+        with:
+          files: test-report.junit.xml
+          comment_mode: always
+          check_name: Test Results
+```
+
+<Note>
+  The `if: always()` ensures test results are published even when tests fail, so you always see what went wrong.
+</Note>
+
+The [publish-unit-test-result-action](https://github.com/EnricoMi/publish-unit-test-result-action) creates:
+
+- **PR comments** with a summary table of passed/failed tests
+- **Check runs** visible in the GitHub PR checks tab
+- **Annotations** highlighting failed tests in the diff view
+
+### Multi-Platform Testing with JUnit
+
+When testing across multiple platforms, use separate check names to distinguish results:
+
+```yaml .github/workflows/test.yml
+jobs:
+  test-linux:
+    runs-on: ubuntu-latest
+    steps:
+      # ... setup steps ...
+      
+      - name: Run Linux tests
+        run: npx vitest run
+        env:
+          TD_API_KEY: ${{ secrets.TD_API_KEY }}
+          TD_OS: linux
+
+      - name: Publish Test Results
+        uses: EnricoMi/publish-unit-test-result-action@v2
+        if: always()
+        with:
+          files: test-report.junit.xml
+          comment_mode: always
+          check_name: Test Results (Linux)
+
+  test-windows:
+    runs-on: ubuntu-latest
+    steps:
+      # ... setup steps ...
+      
+      - name: Run Windows tests
+        run: npx vitest run
+        env:
+          TD_API_KEY: ${{ secrets.TD_API_KEY }}
+          TD_OS: windows
+
+      - name: Publish Test Results
+        uses: EnricoMi/publish-unit-test-result-action@v2
+        if: always()
+        with:
+          files: test-report.junit.xml
+          comment_mode: always
+          check_name: Test Results (Windows)
+```
+
 <Check>
-  JUnit reports integrate with Jenkins, Azure DevOps, TeamCity, and other CI platforms for test result visualization.
+  JUnit reports integrate with Jenkins, Azure DevOps, TeamCity, GitLab, and other CI platforms for test result visualization.
 </Check>
 
 ## Familiar Test Syntax