@appliqation/automation-sdk 2.1.7 → 2.1.9

package/README.md

@@ -32,8 +32,8 @@ Before you begin, ensure you have:
 
 3. **Appliqation Account** with:
    - Access to Appliqation portal
-   - API key (get from your project settings)
-   - Project key (get from your project settings)
+   - API key (get from your project settings or ask your project admin)
+   - Project key (get from your project settings or ask your project admin)
 
 ---
 
@@ -61,18 +61,15 @@ Create a `.env` file in your project root with your Appliqation credentials:
 ```bash
 # IMPORTANT: No spaces around = signs, no trailing slashes on URLs
 
-APPLIQATION_BASE_URL=https://your-domain.appliqation.com
 APPLIQATION_API_KEY=appq_live_xxxxxxxxxxxxxxxxxxxx
 APPLIQATION_PROJECT_KEY=your-project-key-here
-APPLIQATION_ENVIRONMENT=Your-test-environment-name
-APPLIQATION_RUN_TITLE=Give-name-to-your-testrun
+TEST_APP_URL=https://www.example.com    # App under test (Playwright baseURL)
 ```
 
 **How to get these values:**
-- `APPLIQATION_BASE_URL` - Your Appliqation portal URL (no trailing slash!)
 - `APPLIQATION_API_KEY` -     Found in your project settings
 - `APPLIQATION_PROJECT_KEY` - Found in your project settings
-- `APPLIQATION_ENVIRONMENT` - Environment name (Local, Staging, Production, etc. Found in your project settings)
+- `TEST_APP_URL` - The site you’re testing (e.g., https://www.amazon.in). Used as Playwright `baseURL`.
 - 
 
 **⚠️ Add .env to .gitignore** to keep credentials secret:
@@ -94,11 +91,8 @@ require('dotenv').config();  // Load .env variables
 
 // SDK configuration
 const appliqationConfig = {
-  baseUrl: process.env.APPLIQATION_BASE_URL,
   apiKey: process.env.APPLIQATION_API_KEY,
   projectKey: process.env.APPLIQATION_PROJECT_KEY,
-  environment: process.env.APPLIQATION_ENVIRONMENT,
-  title: process.env.APPLIQATION_RUN_TITLE, // Custom run title (optional)
 
   // Optional settings
   autoCreateRun: true,           // Automatically create run on test start
@@ -117,7 +111,7 @@ module.exports = defineConfig({
   globalTeardown: require.resolve('@appliqation/automation-sdk/playwright/global-teardown'),
 
   use: {
-    baseURL: process.env.APPLIQATION_BASE_URL,
+    baseURL: process.env.TEST_APP_URL,
 
     // Use SDK-managed authentication state
     storageState: '.auth/jwt.json',
@@ -205,7 +199,8 @@ test('should display user profile', async ({ page }, testInfo) => {
 Run your Playwright tests as normal:
 
 ```bash
-npx playwright test
+APPLIQATION_RUN_TITLE=yourruntitle APPLIQATION_ENVIRONMENT=test_env_name npx playwright test
+
 ```
 
 **What happens:**
@@ -257,8 +252,8 @@ Understanding the SDK's authentication and result submission flow helps troubles
 │  1. Read .env configuration                                     │
 │     ├─ APPLIQATION_API_KEY                                      │
 │     ├─ APPLIQATION_PROJECT_KEY                                  │
-│     ├─ APPLIQATION_BASE_URL                                     │
-│     └─ APPLIQATION_SCENARIO_ID                                  │
+│     ├─ TEST_APP_URL                                     │
+                                  │
 │                   │                                              │
 │                   ▼                                              │
 │  2. Create automation run via API                               │
@@ -408,9 +403,8 @@ your-playwright-project/
 ├── .env                            # YOU CREATE THIS (Step 2)
 │   ├── APPLIQATION_API_KEY=appq_live_xxxxx
 │   ├── APPLIQATION_PROJECT_KEY=your-project-key
-│   ├── APPLIQATION_BASE_URL=https://your-domain.com
-│   ├── APPLIQATION_SCENARIO_ID=1154
-│   └── APPLIQATION_ENVIRONMENT=Local
+│   ├── TEST_APP_URL=https://your-domain.com
+│   
 │
 ├── playwright.config.js            # YOU UPDATE THIS (Step 3)
 │   ├── globalSetup: require.resolve('@appliqation/automation-sdk/playwright/global-setup')
@@ -449,37 +443,10 @@ All environment variables and their purposes:
 
 | Variable | Required | Description | Example |
 |----------|----------|-------------|---------|
-| `APPLIQATION_BASE_URL` | ✅ Yes | Your Appliqation portal URL (no trailing slash) | `https://portal.appliqation.com` |
+| `TEST_APP_URL` | ✅ Yes | Your Test App  URL (no trailing slash) | `https://example.com` |
 | `APPLIQATION_API_KEY` | ✅ Yes | API key from `/admin/config/appliqation/api-keys` | `appq_live_abc123xyz...` |
 | `APPLIQATION_PROJECT_KEY` | ✅ Yes | Project key from project settings | `my-project-key` |
-| `APPLIQATION_SCENARIO_ID` | ✅ Yes | Scenario node ID to track | `1154` |
-| `APPLIQATION_ENVIRONMENT` | ❌ No | Environment name (default: `Local`) | `Staging`, `Production` |
-| `APPLIQATION_RUN_TITLE` | ❌ No | Custom run title (default: auto-generated) | `Sprint 24 - Regression` |
-| `LOG_LEVEL` | ❌ No | Logging verbosity (default: `INFO`) | `DEBUG`, `ERROR` |
-
-### Reporter Options (playwright.config.js)
-
-All available options for the Appliqation reporter config:
 
-```javascript
-const appliqationConfig = {
-  // Required
-  baseUrl: process.env.APPLIQATION_BASE_URL,
-  apiKey: process.env.APPLIQATION_API_KEY,
-  projectKey: process.env.APPLIQATION_PROJECT_KEY,
-  scenarioId: parseInt(process.env.APPLIQATION_SCENARIO_ID),
-
-  // Optional
-  environment: 'Local',              // Environment name
-  title: 'My Custom Run',            // Custom run title
-  autoCreateRun: true,               // Auto-create run (default: true)
-  batchSubmit: true,                 // Batch results (default: true)
-  batchSize: 50,                     // Results per batch (default: 50)
-  logOrphans: true,                  // Log tests without UUIDs (default: true)
-  logLevel: 'INFO',                  // INFO, DEBUG, ERROR (default: INFO)
-  rejectUnauthorized: false          // Allow self-signed certs (default: false)
-};
-```
 
 **Common Configurations:**
 
@@ -598,13 +565,13 @@ Tests without `mapAppqUuid()` calls are called **orphan tests**. The SDK will:
    }]
    ```
 
-4. Check `.env` has correct `APPLIQATION_BASE_URL` (no trailing slash):
+4. Check `.env` has correct `TEST_APP_URL` (no trailing slash):
    ```bash
    # ❌ Wrong
-   APPLIQATION_BASE_URL=https://portal.com/
+   TEST_APP_URL=https://portal.com/
 
    # ✅ Correct
-   APPLIQATION_BASE_URL=https://portal.com
+   TEST_APP_URL=https://portal.com
    ```
 
 ---
@@ -666,11 +633,8 @@ Add `rejectUnauthorized: false` to your SDK configuration in `playwright.config.
 
 ```javascript
 const appliqationConfig = {
-  baseUrl: process.env.APPLIQATION_BASE_URL,
   apiKey: process.env.APPLIQATION_API_KEY,
   projectKey: process.env.APPLIQATION_PROJECT_KEY,
-  environment: process.env.APPLIQATION_ENVIRONMENT,
-  title: process.env.APPLIQATION_RUN_TITLE,
 
   // Add this for self-signed certificates
   rejectUnauthorized: false  // ⚠️ Only use in development!
@@ -689,14 +653,11 @@ const appliqationConfig = {
    - **Fix:** Add UUID mapping to all tests
    - Enable `logOrphans: true` to see which tests are orphans
 
-2. **Wrong scenario ID** - Results sent to different scenario
-   - **Fix:** Verify `APPLIQATION_SCENARIO_ID` matches portal
-
-3. **API key invalid** - Authentication failed
+2. **API key invalid** - Authentication failed
    - **Fix:** Regenerate API key from portal
 
-4. **Network issues** - Portal unreachable
-   - **Fix:** Check `APPLIQATION_BASE_URL` is accessible
+3. **Network issues** - Portal unreachable
+   - **Fix:** Check `TEST_APP_URL` is accessible
 
 ---
 
@@ -737,7 +698,6 @@ require('dotenv').config();
 
 async function testConnection() {
   const client = new AppliqationClient({
-    baseUrl: process.env.APPLIQATION_BASE_URL,
     apiKey: process.env.APPLIQATION_API_KEY,
     projectKey: process.env.APPLIQATION_PROJECT_KEY
   });
@@ -796,14 +756,12 @@ const AppliqationClient = require('@appliqation/automation-sdk');
 
 // Initialize client
 const client = new AppliqationClient({
-  baseUrl: process.env.APPLIQATION_BASE_URL,
   apiKey: process.env.APPLIQATION_API_KEY,
   projectKey: process.env.APPLIQATION_PROJECT_KEY
 });
 
 // Create run
 const run = await client.createRun({
-  scenarioId: 1154,
   environment: 'Production',
   browsers: ['Chrome'],
   device: 'Desktop',
@@ -838,25 +796,6 @@ Set custom titles for test runs:
 ```bash
 APPLIQATION_RUN_TITLE="Sprint 24 - Regression Tests" npx playwright test
 ```
-
-**Method 2: Config File**
-```javascript
-const appliqationConfig = {
-  // ... other config
-  title: "Sprint 24 - Regression Tests"
-};
-```
-
-**Method 3: Programmatic (Core SDK)**
-```javascript
-const client = new AppliqationClient({
-  // ... other config
-  title: "Sprint 24 - Regression Tests"
-});
-```
-
-**Priority:** Config > Env Var > Default (`"Automation Run - {timestamp}"`)
-
 ---
 
 ## API Reference

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appliqation/automation-sdk",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "Appliqation Automation SDK with API key authentication, custom run titles, and framework-specific reporters",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/AppliqationClient.js

@@ -6,6 +6,7 @@ const OrphanTestService = require('./services/OrphanTestService');
 const UuidValidator = require('./utils/UuidValidator');
 const PayloadBuilder = require('./utils/PayloadBuilder');
 const logger = require('./utils/logger');
+const { DEFAULT_APPLIQATION_BASE_URL } = require('./constants');
 
 /**
  * Main Appliqation Automation SDK Client
@@ -51,16 +52,23 @@ class AppliqationClient {
    * @param {string} [config.options.logLevel='info'] - Logging level
    */
   constructor(config) {
+    // Apply SDK default for baseUrl when not provided
+    const resolvedBaseUrl = (config?.baseUrl || process.env.APPLIQATION_BASE_URL || DEFAULT_APPLIQATION_BASE_URL || '').replace(/\/$/, '');
+    const normalizedConfig = {
+      ...(config || {}),
+      baseUrl: resolvedBaseUrl
+    };
+
     // Validate configuration
-    this.validateConfig(config);
+    this.validateConfig(normalizedConfig);
 
     // Determine SSL enforcement based on environment
     const isProduction = this._isProductionEnvironment();
     let rejectUnauthorized = true; // Default to secure
 
-    if (config.rejectUnauthorized !== undefined) {
+    if (normalizedConfig.rejectUnauthorized !== undefined) {
       // User explicitly set rejectUnauthorized
-      if (isProduction && config.rejectUnauthorized === false) {
+      if (isProduction && normalizedConfig.rejectUnauthorized === false) {
         // WARNING: User is trying to disable SSL in production
         logger.warn('SSL certificate verification is disabled in production environment!', {
           environment: process.env.NODE_ENV,
@@ -68,7 +76,7 @@ class AppliqationClient {
           warning: 'This is a security risk. SSL verification should be enabled in production.'
         });
       }
-      rejectUnauthorized = config.rejectUnauthorized;
+      rejectUnauthorized = normalizedConfig.rejectUnauthorized;
     } else if (isProduction) {
       // Production environment - force SSL verification
       rejectUnauthorized = true;
@@ -80,18 +88,18 @@ class AppliqationClient {
 
     // Store configuration
     this.config = {
-      baseUrl: config.baseUrl.replace(/\/$/, ''), // Remove trailing slash
-      apiKey: config.apiKey,
-      projectKey: config.projectKey,
-      username: config.username,
-      password: config.password,
-      runTitle: config.runTitle || config.title || process.env.APPLIQATION_RUN_TITLE || null,
+      baseUrl: resolvedBaseUrl,
+      apiKey: normalizedConfig.apiKey,
+      projectKey: normalizedConfig.projectKey,
+      username: normalizedConfig.username,
+      password: normalizedConfig.password,
+      runTitle: normalizedConfig.runTitle || normalizedConfig.title || process.env.APPLIQATION_RUN_TITLE || null,
       rejectUnauthorized: rejectUnauthorized,
       options: {
-        timeout: config.options?.timeout || 30000,
-        retries: config.options?.retries || 3,
-        logOrphans: config.options?.logOrphans !== false,
-        logLevel: config.options?.logLevel || 'info'
+        timeout: normalizedConfig.options?.timeout || 30000,
+        retries: normalizedConfig.options?.retries || 3,
+        logOrphans: normalizedConfig.options?.logOrphans !== false,
+        logLevel: normalizedConfig.options?.logLevel || 'info'
       }
     };
 
@@ -110,10 +118,12 @@ class AppliqationClient {
     // Track current run context
     this.currentRun = null;
 
-    logger.info('Appliqation client initialized', {
-      baseUrl: this.config.baseUrl,
+    // Show baseUrl only in DEBUG mode
+    const meta = {
       authMode: this.config.apiKey ? 'api_key' : 'csrf'
-    });
+    };
+    logger.info('Appliqation client initialized', meta);
+    logger.debug('Client configuration', { baseUrl: this.config.baseUrl });
   }
 
   /**

package/src/constants.js

@@ -197,6 +197,13 @@ const DEFAULT_DEVICE = 'Desktop';
  */
 const DEFAULT_OS = 'Unknown';
 
+/**
+ * Default Appliqation portal URL
+ * Used when APPLIQATION_BASE_URL is not provided by the user
+ * @constant {string}
+ */
+const DEFAULT_APPLIQATION_BASE_URL = 'https://appq.appliqation.io';
+
 // ============================================================================
 // Exports
 // ============================================================================
@@ -241,5 +248,8 @@ module.exports = {
   DEFAULT_SCENARIO_ID,
   DEFAULT_ENVIRONMENT,
   DEFAULT_DEVICE,
-  DEFAULT_OS
+  DEFAULT_OS,
+
+  // Base URL
+  DEFAULT_APPLIQATION_BASE_URL
 };

package/src/playwright/fixture.js

@@ -10,6 +10,7 @@ try {
 
 const JwtBrowserAuth = require('./JwtBrowserAuth');
 require('dotenv').config();
+const { DEFAULT_APPLIQATION_BASE_URL } = require('../constants');
 
 /**
  * Appliqation Playwright Fixture with Auto JWT Refresh
@@ -42,7 +43,7 @@ if (baseTest) {
   test = baseTest.extend({
     page: async ({ page }, use) => {
       // Get configuration from environment
-      const baseUrl = process.env.APPLIQATION_BASE_URL;
+      const baseUrl = process.env.APPLIQATION_BASE_URL || DEFAULT_APPLIQATION_BASE_URL;
       const apiKey = process.env.APPLIQATION_API_KEY;
       const projectKey = process.env.APPLIQATION_PROJECT_KEY;
 

package/src/playwright/global-setup.js

@@ -27,6 +27,7 @@ const axios = require('axios');
 const https = require('https');
 const fs = require('fs');
 const path = require('path');
+const { DEFAULT_APPLIQATION_BASE_URL } = require('../constants');
 
 /**
  * Setup JWT-based browser authentication
@@ -35,11 +36,27 @@ const path = require('path');
  * @returns {Promise<void>}
  */
 async function globalSetup(config) {
-  console.log('\n🔐 Setting up JWT browser authentication...\n');
+  console.log('\n🚀 Global Setup: Initializing Test Environment...\n');
 
   // Extract SDK configuration from reporter config or use env
   const sdkConfig = extractSDKConfig(config);
 
+  // Display startup information
+  console.log(`🌍 Environment: ${sdkConfig.environment || 'Not specified'}`);
+  console.log(`🔗 Test App URL: ${sdkConfig.appUrl || 'Not specified'}`);
+
+  // Show Run ID and Timestamp only in DEBUG mode
+  if (process.env.LOG_LEVEL === 'DEBUG') {
+    const crypto = require('crypto');
+    const runId = crypto.randomUUID();
+    console.log(`📊 Run ID: ${runId}`);
+    console.log(`⏰ Timestamp: ${new Date().toISOString()}`);
+  }
+
+  console.log(`🔑 API Key: ${sdkConfig.apiKey ? 'Configured' : 'Not set'}\n`);
+
+  console.log('🔐 Setting up JWT browser authentication...\n');
+
   // Validate required configuration
   if (!sdkConfig.apiKey) {
     console.error('❌ APPLIQATION_API_KEY is required for JWT authentication');
@@ -71,8 +88,7 @@ async function globalSetup(config) {
       return;
     }
 
-    console.log(`✅ JWT token received (expires in 1 hour)`);
-    console.log(`   Run ID: ${jwtData.run_id}\n`);
+    console.log(`✅ JWT token received (expires in 1 hour)\n`);
 
     // Step 2: Setup browser with JWT
     console.log('🌐 Setting up browser session with JWT...');
@@ -82,9 +98,8 @@ async function globalSetup(config) {
     console.log('📄 Authenticated state saved to: .auth/jwt.json\n');
     console.log('✨ Tests will run with JWT authentication!\n');
 
-    // Store for use in tests
+    // Store for use in tests (run_id will be set by reporter when tests execute)
     process.env.APPLIQATION_JWT_TOKEN = jwtData.jwt_token;
-    process.env.APPLIQATION_RUN_ID = jwtData.run_id;
 
   } catch (error) {
     console.error('\n❌ JWT authentication setup failed:', error.message);
@@ -124,13 +139,15 @@ function extractSDKConfig(config) {
   }
 
   // Fallback to environment variables
+  const baseUrl = sdkConfig.baseUrl || process.env.APPLIQATION_BASE_URL || DEFAULT_APPLIQATION_BASE_URL;
+
   return {
-    baseUrl: sdkConfig.baseUrl || process.env.APPLIQATION_BASE_URL,
+    baseUrl,
     apiKey: sdkConfig.apiKey || process.env.APPLIQATION_API_KEY,
     projectKey: sdkConfig.projectKey || process.env.APPLIQATION_PROJECT_KEY,
     scenarioId: sdkConfig.scenarioId || parseInt(process.env.APPLIQATION_SCENARIO_ID) || 0,
     environment: sdkConfig.environment || process.env.APPLIQATION_ENVIRONMENT || 'Local',
-    appUrl: sdkConfig.appUrl || process.env.APPLIQATION_APP_URL || sdkConfig.baseUrl || process.env.APPLIQATION_BASE_URL,
+    appUrl: sdkConfig.appUrl || process.env.APPLIQATION_APP_URL || process.env.TEST_APP_URL || baseUrl,
     useJwtAuth: sdkConfig.useJwtAuth !== undefined ? sdkConfig.useJwtAuth : process.env.APPLIQATION_USE_JWT_AUTH !== 'false',
     runTitle: sdkConfig.runTitle || process.env.APPLIQATION_RUN_TITLE || `JWT Auth Setup - ${new Date().toISOString()}`,
   };
@@ -143,46 +160,15 @@ function extractSDKConfig(config) {
  * @returns {Promise<Object>} JWT data { jwt_token, run_id, user_id, project_id }
  */
 async function getJWTToken(sdkConfig) {
-  // STEP 1: Create automation run
-  const createRunEndpoint = `${sdkConfig.baseUrl.replace(/\/$/, '')}/api/automation/run/create`;
-
-  const runPayload = {
-    project_key: sdkConfig.projectKey,
-    scenario_id: sdkConfig.scenarioId || 0,
-    environment: sdkConfig.environment,
-    title: sdkConfig.runTitle,
-    browsers: ['Chrome'], // Default browser for setup
-    device: 'Desktop',
-    // IMPORTANT: Always use Windows for JWT setup run to avoid WSL2/Linux detection issues
-    // The actual test runs will detect the correct OS from browser user agents
-    os: process.platform === 'darwin' ? 'macOS' : 'Windows', // Default to Windows (not Linux)
+  // Get browser session JWT token directly (no need to create run matrix)
+  // The SDK reporter will create run matrices automatically when tests execute
+  const jwtEndpoint = `${sdkConfig.baseUrl.replace(/\/$/, '')}/api/auth/jwt/browser`;
+
+  const jwtPayload = {
+    api_key: sdkConfig.apiKey
   };
 
   try {
-    const runResponse = await axios.post(createRunEndpoint, runPayload, {
-      headers: {
-        'Content-Type': 'application/json',
-        'X-API-Key': sdkConfig.apiKey,
-      },
-      httpsAgent: new https.Agent({
-        rejectUnauthorized: false, // Allow self-signed certs in dev
-      }),
-      validateStatus: (status) => status < 500,
-    });
-
-    if (runResponse.status !== 200 && runResponse.status !== 201) {
-      throw new Error(`Run creation failed: ${runResponse.status} - ${runResponse.data?.message || 'Unknown error'}`);
-    }
-
-    const runId = runResponse.data.run_id;
-
-    // STEP 2: Get browser session JWT token
-    const jwtEndpoint = `${sdkConfig.baseUrl.replace(/\/$/, '')}/api/auth/jwt/browser`;
-
-    const jwtPayload = {
-      api_key: sdkConfig.apiKey
-    };
-
     const jwtResponse = await axios.post(jwtEndpoint, jwtPayload, {
       headers: {
         'Content-Type': 'application/json',
@@ -199,7 +185,7 @@ async function getJWTToken(sdkConfig) {
 
     return {
       jwt_token: jwtResponse.data.jwt_token,
-      run_id: runId,
+      run_id: null, // No run created during auth setup
       user_id: jwtResponse.data.user_id,
       project_id: jwtResponse.data.project_id,
       expires_in: jwtResponse.data.expires_in,

package/src/reporters/playwright/AppliqationReporter.js

@@ -3,6 +3,7 @@ const UuidExtractor = require('./helpers/UuidExtractor');
 const DeviceOsDetector = require('./helpers/DeviceOsDetector');
 const PayloadBuilder = require('../../utils/PayloadBuilder');
 const logger = require('../../utils/logger');
+const { DEFAULT_APPLIQATION_BASE_URL } = require('../../constants');
 
 /**
  * Appliqation Reporter for Playwright
@@ -51,6 +52,25 @@ class AppliqationReporter {
       ...config
     };
 
+    // Apply baseUrl fallback if not provided
+    // Priority: 1) config.baseUrl, 2) process.env.APPLIQATION_BASE_URL, 3) DEFAULT_APPLIQATION_BASE_URL
+    if (!this.config.baseUrl) {
+      this.config.baseUrl = process.env.APPLIQATION_BASE_URL || DEFAULT_APPLIQATION_BASE_URL;
+    }
+
+    // Apply environment from process.env if not in config
+    // Priority: 1) config.environment, 2) process.env.APPLIQATION_ENVIRONMENT
+    if (!this.config.environment) {
+      this.config.environment = process.env.APPLIQATION_ENVIRONMENT;
+    }
+    // Note: No default fallback - validation will catch missing value
+
+    // Apply title fallback if not provided
+    // Priority: 1) config.title, 2) process.env.APPLIQATION_RUN_TITLE, 3) timestamp-based default
+    if (!this.config.title) {
+      this.config.title = process.env.APPLIQATION_RUN_TITLE || `Automation Run - ${new Date().toISOString()}`;
+    }
+
     // Validate configuration
     this.validateConfig();
 
@@ -77,11 +97,14 @@ class AppliqationReporter {
     this.skippedTests = 0;
     this.orphanTests = 0;
 
+    // Show baseUrl only in DEBUG mode
     logger.info('Appliqation Playwright Reporter initialized', {
-      baseUrl: this.config.baseUrl,
-      scenarioId: this.config.scenarioId,
       environment: this.config.environment
     });
+    logger.debug('Reporter configuration', {
+      baseUrl: this.config.baseUrl,
+      scenarioId: this.config.scenarioId
+    });
   }
 
   /**
@@ -135,12 +158,13 @@ class AppliqationReporter {
     logger.info(`Creating ${matrixConfigs.length} run matrices for device/OS combinations...`);
     logger.debug(`Matrix configurations:`, matrixConfigs);
 
-    // Create runs for each device/OS combination with ALL browsers
-    for (const matrixConfig of matrixConfigs) {
+    // Create runs for each device/OS combination in parallel for better performance
+    const creationStartTime = Date.now();
+    const creationPromises = matrixConfigs.map(async (matrixConfig) => {
       const projectKey = `${matrixConfig.device}-${matrixConfig.os}`;
 
       // Skip if already created (shouldn't happen but safety check)
-      if (this.runsByProject.has(projectKey)) continue;
+      if (this.runsByProject.has(projectKey)) return null;
 
       try {
         const runOptions = {
@@ -170,6 +194,8 @@ class AppliqationReporter {
           runId: run.runId,
           browsers: matrixConfig.browsers
         });
+
+        return { projectKey, runId: run.runId };
       } catch (error) {
         // Check if this is an API validation error with details
         if (error.details) {
@@ -226,7 +252,55 @@ class AppliqationReporter {
           throw error;
         }
       }
+    });
+
+    // Wait for all run creations to complete in parallel
+    await Promise.all(creationPromises);
+
+    const creationDuration = Date.now() - creationStartTime;
+    logger.info(`All run matrices created in ${creationDuration}ms`);
+    console.log(`✅ Created ${this.runsByProject.size} run matrix(es) in ${(creationDuration / 1000).toFixed(2)}s`);
+  }
+
+  /**
+   * Wait for run matrix to be available (handles race condition with slow backend)
+   * @param {string} projectKey - The project key to wait for
+   * @param {number} maxWaitMs - Maximum time to wait in milliseconds (default 60s for slow backends)
+   * @returns {Promise<Object|null>} Run info object or null if timeout
+   */
+  async waitForRunMatrix(projectKey, maxWaitMs = 60000) {
+    const startTime = Date.now();
+    const pollInterval = 500; // Check every 500ms
+    let warningShown = false;
+
+    while (Date.now() - startTime < maxWaitMs) {
+      const runInfo = this.runsByProject.get(projectKey);
+
+      if (runInfo) {
+        const waitedMs = Date.now() - startTime;
+        if (waitedMs > 1000) {
+          logger.info(`Run matrix became available after ${waitedMs}ms`, { projectKey });
+        }
+        return runInfo;
+      }
+
+      // Show warning if waiting too long (5 seconds)
+      if (!warningShown && Date.now() - startTime > 5000) {
+        console.warn(`⏳ Waiting for run matrix creation for ${projectKey}... (this may take a moment with slow backends)`);
+        logger.warn(`Still waiting for run matrix after 5 seconds`, { projectKey });
+        warningShown = true;
+      }
+
+      // Wait before next poll
+      await new Promise(resolve => setTimeout(resolve, pollInterval));
     }
+
+    // Timeout reached
+    logger.error(`Timeout waiting for run matrix after ${maxWaitMs}ms`, { projectKey });
+    console.error(`\n❌ TIMEOUT: Run matrix creation took longer than ${maxWaitMs / 1000}s for ${projectKey}`);
+    console.error(`   This usually indicates slow backend response or browser version detection delays.`);
+    console.error(`   Try adding browserVersion to your project metadata to speed up run creation.\n`);
+    return null;
   }
 
   /**
@@ -256,11 +330,16 @@ class AppliqationReporter {
       const deviceInfo = DeviceOsDetector.getDeviceInfo(project, null);
       const projectKey = `${deviceInfo.device}-${deviceInfo.os}`;
 
-      // Get run info for this device/OS combination (pre-created in onBegin)
-      const runInfo = this.runsByProject.get(projectKey);
+      // Wait for run matrix to be available (handles race condition with slow backend)
+      const runInfo = await this.waitForRunMatrix(projectKey, 30000);
 
       if (!runInfo) {
-        logger.warn('No run matrix found for project', { projectKey });
+        logger.error('Run matrix not available after timeout - result will not be submitted', {
+          projectKey,
+          testTitle: test.title,
+          testFile: test.location?.file
+        });
+        console.error(`\n⚠️  ERROR: Run matrix not created for ${projectKey}. Test result for "${test.title}" will not be submitted.\n`);
         return;
       }
 
@@ -535,6 +614,7 @@ class AppliqationReporter {
 
   /**
    * Auto-detect and inject browser versions for projects missing browserVersion metadata
+   * Now runs in parallel for better performance
    * @private
    * @param {Array} projects - Array of Playwright project configurations
    */
@@ -555,13 +635,17 @@ class AppliqationReporter {
 
     const { chromium, firefox, webkit } = playwright;
 
-    for (const project of projects) {
+    // Cache for browser versions to avoid launching same browser multiple times
+    const versionCache = new Map();
+
+    // Create detection promises for all projects in parallel
+    const detectionPromises = projects.map(async (project) => {
       // Skip if browserVersion is already configured
       if (project.use?.metadata?.browserVersion) {
         logger.debug(`Project "${project.name}" already has browserVersion configured`, {
           version: project.use.metadata.browserVersion
         });
-        continue;
+        return null;
       }
 
       // Get browser name from project - check multiple sources
@@ -579,33 +663,45 @@ class AppliqationReporter {
         }
       }
 
-      if (!browserName) continue;
+      if (!browserName) return null;
 
       try {
-        let browser = null;
         let version = null;
 
-        // Launch browser to detect version
-        switch (browserName.toLowerCase()) {
-          case 'chromium':
-          case 'chrome':
-            browser = await chromium.launch({ headless: true });
-            version = browser.version();
-            await browser.close();
-            break;
-
-          case 'firefox':
-            browser = await firefox.launch({ headless: true });
-            version = browser.version();
-            await browser.close();
-            break;
+        // Check cache first
+        if (versionCache.has(browserName)) {
+          version = versionCache.get(browserName);
+          logger.debug(`Using cached version for ${browserName}`, { version });
+        } else {
+          // Launch browser to detect version
+          let browser = null;
+
+          switch (browserName.toLowerCase()) {
+            case 'chromium':
+            case 'chrome':
+              browser = await chromium.launch({ headless: true });
+              version = browser.version();
+              await browser.close();
+              break;
+
+            case 'firefox':
+              browser = await firefox.launch({ headless: true });
+              version = browser.version();
+              await browser.close();
+              break;
+
+            case 'webkit':
+            case 'safari':
+              browser = await webkit.launch({ headless: true });
+              version = browser.version();
+              await browser.close();
+              break;
+          }
 
-          case 'webkit':
-          case 'safari':
-            browser = await webkit.launch({ headless: true });
-            version = browser.version();
-            await browser.close();
-            break;
+          // Cache the version
+          if (version) {
+            versionCache.set(browserName, version);
+          }
         }
 
         if (version) {
@@ -624,6 +720,8 @@ class AppliqationReporter {
               version: majorVersion,
               fullVersion: version
             });
+
+            return { project: project.name, browser: browserName, version: majorVersion };
           }
         }
       } catch (error) {
@@ -632,6 +730,17 @@ class AppliqationReporter {
           error: error.message
         });
       }
+
+      return null;
+    });
+
+    // Wait for all browser version detections to complete in parallel
+    const results = await Promise.all(detectionPromises);
+
+    // Log summary
+    const detected = results.filter(r => r !== null);
+    if (detected.length > 0) {
+      logger.info(`Browser version detection completed for ${detected.length} project(s)`);
     }
   }
 
@@ -652,8 +761,25 @@ class AppliqationReporter {
       throw new Error('projectKey is required');
     }
 
-    // Note: scenarioId and testSetId are now optional
-    // If neither is provided, will default to 0 for generic automation runs
+    // Environment is required - no default fallback
+    if (!this.config.environment) {
+      throw new Error(
+        '\n' +
+        '❌ Testing environment is required.\n' +
+        '\n' +
+        'Please provide the environment in your test run command:\n' +
+        '\n' +
+        '  APPLIQATION_ENVIRONMENT=Production npx playwright test\n' +
+        '\n' +
+        'Or set it in your .env file:\n' +
+        '\n' +
+        '  APPLIQATION_ENVIRONMENT=Production\n' +
+        '\n' +
+        'Valid environments are configured in your Appliqation project settings.\n'
+      );
+    }
+
+    // Note: scenarioId, testSetId, and title are optional
   }
 
   /**