@appliqation/automation-sdk 2.1.11 → 2.3.0

package/src/core/HttpClient.js

@@ -254,6 +254,58 @@ class HttpClient {
     }
   }
 
+  /**
+   * Delete a test run
+   * @param {string} runId - Run ID to delete
+   * @param {string} reason - Reason for deletion (for audit logging)
+   * @returns {Promise<Object>} Deletion result
+   */
+  async deleteRun(runId, reason = 'sdk_cleanup') {
+    const maxRetries = 3;
+    const retryDelays = [500, 1000, 2000]; // ms - exponential backoff
+
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        logger.debug('Deleting run', { runId, reason, attempt: attempt + 1 });
+
+        const response = await this.delete(`/api/automation/run/${runId}/delete`, {
+          data: { reason }
+        });
+
+        if (attempt > 0) {
+          logger.info('Run deletion succeeded after retry', { runId, attempt: attempt + 1 });
+        }
+
+        return response;
+      } catch (error) {
+        const is404 = error.response?.status === 404;
+        const isLastAttempt = attempt === maxRetries;
+
+        // Only retry on 404 (run not found yet - possible race condition)
+        if (is404 && !isLastAttempt) {
+          const delay = retryDelays[attempt];
+          logger.warn('Run not found, retrying deletion...', {
+            runId,
+            attempt: attempt + 1,
+            maxRetries: maxRetries + 1,
+            retryAfterMs: delay
+          });
+          await new Promise(resolve => setTimeout(resolve, delay));
+          continue;
+        }
+
+        // Final attempt failed or non-404 error - throw
+        logger.error('Failed to delete run', {
+          error: error.message,
+          runId,
+          status: error.response?.status,
+          attempts: attempt + 1
+        });
+        throw error;
+      }
+    }
+  }
+
   /**
    * Set authorization header
    * @param {string} token - Authorization token

package/src/playwright/global-setup.js

@@ -29,6 +29,43 @@ const fs = require('fs');
 const path = require('path');
 const { DEFAULT_APPLIQATION_BASE_URL } = require('../constants');
 
+function toBoolean(value) {
+  if (value === undefined || value === null) return undefined;
+  if (typeof value === 'boolean') return value;
+  const normalized = String(value).trim().toLowerCase();
+  if (['1', 'true', 'yes', 'on'].includes(normalized)) return true;
+  if (['0', 'false', 'no', 'off'].includes(normalized)) return false;
+  return undefined;
+}
+
+function parseCliEnableFlag() {
+  const argv = process.argv || [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith('--appq=')) {
+      return toBoolean(arg.split('=')[1]);
+    }
+    if (arg === '--appq') {
+      return true;
+    }
+    if (arg.startsWith('--enable-appq=')) {
+      return toBoolean(arg.split('=')[1]);
+    }
+    if (arg === '--enable-appq') {
+      return true;
+    }
+  }
+  return undefined;
+}
+
+function resolveEnableAppq(config) {
+  const cliValue = parseCliEnableFlag();
+  const envValue = process.env.APPLIQATION_ENABLE ?? process.env.APPQ ?? process.env.APPLIQATION_APPQ;
+  const configValue = config?.enableAppq ?? config?.options?.enableAppq;
+  const resolved = toBoolean(configValue) ?? toBoolean(cliValue) ?? toBoolean(envValue);
+  return resolved !== undefined ? resolved : true;
+}
+
 /**
  * Setup JWT-based browser authentication
  *
@@ -40,11 +77,17 @@ async function globalSetup(config) {
 
   // Extract SDK configuration from reporter config or use env
   const sdkConfig = extractSDKConfig(config);
+  sdkConfig.enableAppq = resolveEnableAppq(sdkConfig);
 
   // Display startup information
   console.log(`🌍 Environment: ${sdkConfig.environment || 'Not specified'}`);
   console.log(`🔗 Test App URL: ${sdkConfig.appUrl || 'Not specified'}`);
 
+  if (sdkConfig.enableAppq === false) {
+    console.log('⚠️  Appq disabled via flag. Skipping JWT setup and backend calls.\n');
+    return;
+  }
+
   // Show Run ID and Timestamp only in DEBUG mode
   if (process.env.LOG_LEVEL === 'DEBUG') {
     const crypto = require('crypto');

package/src/reporters/cypress/CypressReporter.js

@@ -2,6 +2,43 @@ const AppliqationClient = require('../../AppliqationClient');
 const UuidExtractor = require('./UuidExtractor');
 const logger = require('../../utils/logger');
 
+function toBoolean(value) {
+  if (value === undefined || value === null) return undefined;
+  if (typeof value === 'boolean') return value;
+  const normalized = String(value).trim().toLowerCase();
+  if (['1', 'true', 'yes', 'on'].includes(normalized)) return true;
+  if (['0', 'false', 'no', 'off'].includes(normalized)) return false;
+  return undefined;
+}
+
+function parseCliEnableFlag() {
+  const argv = process.argv || [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith('--appq=')) {
+      return toBoolean(arg.split('=')[1]);
+    }
+    if (arg === '--appq') {
+      return true;
+    }
+    if (arg.startsWith('--enable-appq=')) {
+      return toBoolean(arg.split('=')[1]);
+    }
+    if (arg === '--enable-appq') {
+      return true;
+    }
+  }
+  return undefined;
+}
+
+function resolveEnableAppq(config) {
+  const cliValue = parseCliEnableFlag();
+  const envValue = process.env.APPLIQATION_ENABLE ?? process.env.APPQ ?? process.env.APPLIQATION_APPQ;
+  const configValue = config?.enableAppq ?? config?.options?.enableAppq;
+  const resolved = toBoolean(configValue) ?? toBoolean(cliValue) ?? toBoolean(envValue);
+  return resolved !== undefined ? resolved : true;
+}
+
 /**
  * Appliqation Reporter for Cypress
  *
@@ -39,7 +76,8 @@ class CypressReporter {
       title: config.title || process.env.APPLIQATION_RUN_TITLE,
       autoCreateRun: config.autoCreateRun !== false,
       logLevel: config.logLevel || 'info',
-      submitOrphans: config.submitOrphans !== false
+      submitOrphans: config.submitOrphans !== false,
+      enableAppq: resolveEnableAppq(config)
     };
 
     // Validate required config
@@ -55,10 +93,15 @@ class CypressReporter {
       projectKey: this.config.projectKey,
       title: this.config.title,
       options: {
-        logLevel: this.config.logLevel
+        logLevel: this.config.logLevel,
+        enableAppq: this.config.enableAppq
       }
     });
 
+    if (this.config.enableAppq === false) {
+      logger.warn('Appq disabled via flag. Runs/results will not be sent to Appliqation.');
+    }
+
     // Test result storage
     this.testResults = [];
     this.orphanTests = [];
@@ -360,6 +403,10 @@ class CypressReporter {
    * Validate configuration
    */
   validateConfig() {
+    if (this.config.enableAppq === false) {
+      return;
+    }
+
     const required = ['baseUrl', 'apiKey', 'projectKey'];
     const missing = required.filter(key => !this.config[key]);
 

package/src/reporters/jest/JestReporter.js

@@ -2,6 +2,43 @@ const AppliqationClient = require('../../AppliqationClient');
 const UuidExtractor = require('./UuidExtractor');
 const logger = require('../../utils/logger');
 
+function toBoolean(value) {
+  if (value === undefined || value === null) return undefined;
+  if (typeof value === 'boolean') return value;
+  const normalized = String(value).trim().toLowerCase();
+  if (['1', 'true', 'yes', 'on'].includes(normalized)) return true;
+  if (['0', 'false', 'no', 'off'].includes(normalized)) return false;
+  return undefined;
+}
+
+function parseCliEnableFlag() {
+  const argv = process.argv || [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith('--appq=')) {
+      return toBoolean(arg.split('=')[1]);
+    }
+    if (arg === '--appq') {
+      return true;
+    }
+    if (arg.startsWith('--enable-appq=')) {
+      return toBoolean(arg.split('=')[1]);
+    }
+    if (arg === '--enable-appq') {
+      return true;
+    }
+  }
+  return undefined;
+}
+
+function resolveEnableAppq(config) {
+  const cliValue = parseCliEnableFlag();
+  const envValue = process.env.APPLIQATION_ENABLE ?? process.env.APPQ ?? process.env.APPLIQATION_APPQ;
+  const configValue = config?.enableAppq ?? config?.options?.enableAppq;
+  const resolved = toBoolean(configValue) ?? toBoolean(cliValue) ?? toBoolean(envValue);
+  return resolved !== undefined ? resolved : true;
+}
+
 /**
  * Appliqation Reporter for Jest
  *
@@ -39,7 +76,8 @@ class JestReporter {
       title: options.title || process.env.APPLIQATION_RUN_TITLE,
       autoCreateRun: options.autoCreateRun !== false,
       logLevel: options.logLevel || 'info',
-      submitOrphans: options.submitOrphans !== false
+      submitOrphans: options.submitOrphans !== false,
+      enableAppq: resolveEnableAppq(options)
     };
 
     // Validate required config
@@ -55,10 +93,15 @@ class JestReporter {
       projectKey: this.config.projectKey,
       title: this.config.title,
       options: {
-        logLevel: this.config.logLevel
+        logLevel: this.config.logLevel,
+        enableAppq: this.config.enableAppq
       }
     });
 
+    if (this.config.enableAppq === false) {
+      logger.warn('Appq disabled via flag. Runs/results will not be sent to Appliqation.');
+    }
+
     // Test result storage
     this.testResults = [];
     this.orphanTests = [];
@@ -339,6 +382,10 @@ class JestReporter {
    * Validate configuration
    */
   validateConfig() {
+    if (this.config.enableAppq === false) {
+      return;
+    }
+
     const required = ['baseUrl', 'apiKey', 'projectKey'];
     const missing = required.filter(key => !this.config[key]);