testdriverai 7.1.3 → 7.2.0

package/docs/v7/features/enterprise.mdx

@@ -1,53 +1,169 @@
 ---
-title: "Enterprise Ready"
-description: "Security, compliance, and scale for the largest organizations"
-icon: "building"
+title: 'Enterprise'
+description: 'Enterprise-grade testing infrastructure with enhanced security, dedicated support, and custom environments'
+icon: 'building'
 ---
 
-TestDriver Enterprise provides the security, control, and scalability that large organizations demand.
+## Overview
 
-## On-Premise Deployment
+TestDriver Enterprise provides organizations with a comprehensive testing platform that includes advanced security controls, dedicated onboarding, priority support, and custom environment provisioning.
 
-Run TestDriver entirely within your infrastructure:
+## Security & Infrastructure
 
-<Card title="Deployment Options" icon="server">
-  - **Air-Gapped Installation** - No external connectivity required
-  - **Custom VPC** - Deploy in your AWS/Azure/GCP environment
-  - **Kubernetes** - Helm charts for container orchestration
-  - **Docker Compose** - Simple self-hosted deployment
-  - **Bare Metal** - Install on your own hardware
-</Card>
+### Controlled Ingress/Egress
 
-```yaml docker-compose.yml
-version: '3.8'
-services:
-  testdriver-api:
-    image: testdriver/api:latest
-    environment:
-      - LICENSE_KEY=${TESTDRIVER_LICENSE}
-      - DATABASE_URL=${DATABASE_URL}
-      - REDIS_URL=${REDIS_URL}
-    ports:
-      - "3000:3000"
+Enterprise customers have full control over network traffic in their testing environments:
 
-  testdriver-worker:
-    image: testdriver/worker:latest
-    environment:
-      - API_URL=http://testdriver-api:3000
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock
-
-  testdriver-scheduler:
-    image: testdriver/scheduler:latest
-    environment:
-      - API_URL=http://testdriver-api:3000
-```
+- Configure custom firewall rules and network policies
+- Whitelist specific domains and IP ranges
+- Monitor and audit all network activity
+- Implement zero-trust network architecture
+
+### Bring Your Own Key (BYOK)
+
+Maintain complete control over your AI model access:
+
+- **AWS Integration**: Use your own AWS credentials and keys
+- **Claude/Anthropic**: Connect using your own Anthropic API keys
+- **OpenAI**: Integrate with your existing OpenAI account
+- All AI requests use your keys, ensuring data sovereignty
+
+### Your Own VPC on AWS
+
+Deploy TestDriver infrastructure directly in your AWS environment:
+
+- Complete isolation within your own Virtual Private Cloud
+- Full control over networking, security groups, and access policies
+- Compliance with internal security requirements
+- Integration with existing AWS infrastructure
+
+### CloudFormation Deployment
+
+Quick deployment using infrastructure as code:
+
+- Pre-configured CloudFormation templates for self-hosted setup
+- Automated provisioning of all required resources
+- See our [Self-Hosting Guide](/v6/getting-started/self-hosting) for deployment instructions
+- Customizable templates to match your infrastructure standards
+
+## Onboarding & Training Program
+
+### Guided Onboarding
+
+Our team works directly with yours to ensure success:
+
+1. **Initial Setup**: We help configure your first test environment
+2. **First Tests**: Walk through creating your first automated tests together
+3. **Best Practices**: Learn TestDriver patterns and techniques specific to your application
+4. **Knowledge Transfer**: Educational sessions tailored to your team's needs
+
+### Continuous Education
+
+Ongoing training as your testing needs evolve:
+
+- Regular check-ins and training sessions
+- Access to advanced feature workshops
+- Early access to new capabilities and features
+- Custom training materials for your use cases
+
+## Support & Roadmap Influence
+
+### Priority Support
+
+Get help when you need it:
+
+- **Private Slack Channels**: Direct access to TestDriver engineers
+- Faster response times for critical issues
+- Dedicated support team familiar with your setup
+- Screen sharing and pair programming sessions
+
+### Roadmap Influence
+
+Help shape the future of TestDriver:
 
-[Complete self-hosting guide](/v7/guides/self-hosting)
+- Input on feature prioritization
+- Early access to beta features
+- Custom feature development consideration
+- Quarterly roadmap review sessions
+
+## Pricing Advantages
+
+### Self-Hosted Sandboxes
+
+Reduce costs by running tests in your own infrastructure:
+
+- No sandbox usage fees for self-hosted environments
+- Unlimited parallel test execution
+- Pay only for your AWS infrastructure costs
+
+### Unlimited Compute Credits
+
+No surprise bills based on usage:
+
+- Fixed pricing regardless of test volume
+- Unlimited AI model usage for test generation and maintenance
+- Predictable monthly costs
+
+### Per-Parallel Pricing Model
+
+Simple, scalable pricing:
+
+- Pay based on concurrent test runners, not usage
+- Scale up or down based on your needs
+- No per-test or per-minute charges
+
+## Custom Environments
+
+### Custom VM Configuration
+
+We help you create and maintain customized test environments:
+
+- Install specific applications and dependencies
+- Configure system settings and preferences
+- Set up authentication and certificates
+- Prepare baseline snapshots
+
+### AWS AMI Management
+
+Custom Amazon Machine Images for your testing needs:
+
+- We work with you to build custom AMIs
+- Regular updates and security patches
+- Version control for environment changes
+- Rollback capabilities for stability
+
+### Provisioning API
+
+Programmatic environment customization:
+
+- Use the [provisioning API](/v7/features/sandbox-customization#provisioning-api) to install software
+- Run setup scripts before tests
+- Configure applications dynamically
+- Learn more in our [Sandbox Customization](/v7/features/sandbox-customization) guide
+
+### Environment Templates
+
+Reusable environment configurations:
+
+- Create templates for different application types
+- Share configurations across teams
+- Version control for environment specs
+- Quick provisioning of standardized environments
+
+## Getting Started
+
+To learn more about TestDriver Enterprise:
+
+1. [Book a demo](https://form.typeform.com/to/UECf9rDx?typeform-source=docs.testdriver.ai) with our team
+2. Join our [Discord community](https://discord.com/invite/cWDFW8DzPm)
+3. Contact us through your private Slack channel (existing customers)
+
+## Learn More
 
-## Hardened Security
+- [Managed Sandboxes](/v7/features/managed-sandboxes)
+- [Sandbox Customization](/v7/features/sandbox-customization)
+- [Self-Hosting Guide](/v6/getting-started/self-hosting)
 
-Enterprise-grade security features:
 
 <AccordionGroup>
   <Accordion title="SOC 2 Type II Certified">

package/docs/v7/features/fast.mdx

@@ -1,32 +1,36 @@
 ---
-title: "Fast Performance"
+title: "Intelligent Caching"
 description: "1.7x faster test execution with intelligent caching and optimization"
 icon: "bolt"
 ---
 
-Speed matters when you're running hundreds or thousands of tests. TestDriver is engineered for performance with intelligent caching that delivers up to **1.7x faster** test execution.
+Speed matters when you're running hundreds or thousands of tests. TestDriver is engineered for performance with intelligent caching that delivers up to **1.7x faster** test execution by skipping redundant AI vision analysis.
 
 ## Test Caching Performance
 
 Selector caching dramatically reduces test execution time by skipping redundant AI vision analysis:
 
-<Card title="Real Performance Results" icon="chart-line">
-  **First run (no cache):**
-  ```
-  ⏱️  Test duration: 45.2s
-  🔍 AI vision calls: 12
-  💰 Cost: $0.048
-  ```
+```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'xyChart': {'backgroundColor': 'transparent', 'titleColor': '#ffffff', 'xAxisLabelColor': '#ffffff', 'xAxisTitleColor': '#ffffff', 'xAxisTickColor': '#ffffff', 'xAxisLineColor': '#ffffff', 'yAxisLabelColor': '#ffffff', 'yAxisTitleColor': '#ffffff', 'yAxisTickColor': '#ffffff', 'yAxisLineColor': '#ffffff', 'plotColorPalette': '#b3d334, #b3d334'}}}}%%
+xychart-beta
+    title "Test Execution Time Comparison"
+    x-axis ["First Run (No Cache)", "Cached Run"]
+    y-axis "Duration (seconds)" 0 --> 10
+    bar [8.2, 4.8]
+```
+
+```javascript
+// First run: builds cache
+await testdriver.find('submit button');
+
+// Second run: exact match
+await testdriver.find('submit button');
+``` 
 
-  **Cached run:**
-  ```
-  ⚡ Test duration: 26.6s (1.7x faster)
-  ✅ Cache hits: 11/12
-  💰 Cost: $0.004 (92% savings)
-  ```
-</Card>
+**Performance Improvement: 1.7x faster** – The more you run your tests, the faster they get. Cache hits are nearly instant, turning slow AI analysis into millisecond lookups.
 
-The more you run your tests, the faster they get. Cache hits are nearly instant, turning slow AI analysis into millisecond lookups.
+- **First run:** 45.2s with 12 AI vision calls
+- **Cached run:** 26.6s with 11/12 cache hits
 
 ## Intelligent Cache Strategy
 
@@ -40,13 +44,6 @@ TestDriver uses a sophisticated three-tier matching system to maximize cache hit
     - **Accuracy:** 100%
     - **Use case:** Repeat test runs
 
-    ```javascript
-    // First run: builds cache
-    await testdriver.find('submit button'); // 2.3s (AI analysis)
-
-    // Second run: exact match
-    await testdriver.find('submit button'); // 8ms (cache hit) ⚡
-    ```
   </Step>
 
   <Step title="Pixel Diff Match (Fast)">
@@ -55,13 +52,6 @@ TestDriver uses a sophisticated three-tier matching system to maximize cache hit
     - **Speed:** Very fast (< 50ms)
     - **Accuracy:** 95%+ similarity threshold
     - **Use case:** Minor UI changes (hover states, animations)
-
-    ```javascript
-    // Cache works even with small visual changes
-    await testdriver.find('button', {
-      cacheThreshold: 0.05 // Allow 5% difference
-    });
-    ```
   </Step>
 
   <Step title="Template Match (Fallback)">
@@ -70,13 +60,6 @@ TestDriver uses a sophisticated three-tier matching system to maximize cache hit
     - **Speed:** Fast (< 200ms)
     - **Accuracy:** 75%+ confidence
     - **Use case:** Layout changes, responsive design
-
-    ```javascript
-    // Still uses cache even when layout shifts
-    await testdriver.find('submit button', {
-      cacheThreshold: 0.10 // More lenient
-    });
-    ```
   </Step>
 </Steps>
 
@@ -102,9 +85,19 @@ test('auto-cached test', async (context) => {
 ```
 
 <Tip>
-  TestDriver automatically generates cache keys based on your test file hash. Each file has isolated caching, preventing cross-test pollution.
+  **File-Based Cache Keys:** TestDriver automatically generates cache keys from a hash of the test file calling the TestDriver methods. This means each test file has its own isolated cache namespace, preventing cache pollution between different tests while enabling fast lookups within the same test file.
 </Tip>
 
+### How Cache Keys Work
+
+The cache key is computed from:
+- **File hash**: SHA-256 hash of the test file contents
+- **Selector prompt**: The exact text description passed to `find()`
+- **Screenshot context**: Perceptual hash of the current screen state
+- **Platform**: Operating system and browser version
+
+When you modify your test file, the hash changes automatically, invalidating stale cache entries and ensuring fresh AI analysis with your updated test logic.
+
 ## Cache Hit Monitoring
 
 Track cache performance in real-time:
@@ -187,47 +180,6 @@ Fine-tune cache behavior for your application:
   </Tab>
 </Tabs>
 
-## Parallel Execution
-
-Run tests concurrently for maximum throughput:
-
-```javascript vitest.config.mjs
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    testTimeout: 120000,
-    maxConcurrency: 10, // Run 10 tests simultaneously
-  },
-});
-```
-
-<CardGroup cols={2}>
-  <Card title="Sequential Execution" icon="arrow-right">
-    ```
-    Test 1: 30s
-    Test 2: 30s
-    Test 3: 30s
-    Total: 90s
-    ```
-  </Card>
-
-  <Card title="Parallel Execution (3x)" icon="arrows-split-up-and-left">
-    ```
-    Test 1: 30s
-    Test 2: 30s  } concurrent
-    Test 3: 30s
-    Total: 30s
-    ```
-  </Card>
-</CardGroup>
-
-With caching + parallelization:
-```
-✅ Cache-accelerated parallel execution:
-   Total: 15s (6x faster than sequential, no cache)
-```
-
 ## Cache Persistence
 
 Cache entries are stored server-side with intelligent expiration:
@@ -311,7 +263,29 @@ View cache performance in the TestDriver console:
     Automatic file-based cache keys prevent cross-test issues while enabling caching.
   </Accordion>
 
-  <Accordion title="4. Monitor Cache Hit Rates">
+  <Accordion title="4. Use Custom Cache Keys with Variables">
+    ```javascript
+    // ❌ Without cache key - creates new cache for each variable value
+    const email = 'user@example.com';
+    await testdriver.find(`input for ${email}`); // Cache miss every time
+
+    // ✅ With cache key - reuses cache regardless of variable
+    const email = 'user@example.com';
+    await testdriver.find(`input for ${email}`, {
+      cacheKey: 'email-input'
+    });
+
+    // Also useful for dynamic IDs, names, or other changing data
+    const orderId = generateOrderId();
+    await testdriver.find(`order ${orderId} status`, {
+      cacheKey: 'order-status'  // Same cache for all orders
+    });
+    ```
+
+    Custom cache keys prevent cache pollution when using variables in prompts, dramatically improving cache hit rates.
+  </Accordion>
+
+  <Accordion title="5. Monitor Cache Hit Rates">
     ```javascript
     test('track cache performance', async (context) => {
       const { testdriver } = await chrome(context, { url });
@@ -390,6 +364,14 @@ const testdriver = new TestDriver({
 ## Learn More
 
 <CardGroup cols={2}>
+  <Card
+    title="Parallel Execution"
+    icon="layer-group"
+    href="/v7/features/parallel-execution"
+  >
+    Run tests concurrently for maximum speed
+  </Card>
+
   <Card
     title="Selector Caching Guide"
     icon="crosshairs"