@m00nsolutions/playwright-reporter 1.0.5 → 1.0.7

package/README.md

@@ -1,6 +1,6 @@
 # @m00nsolutions/playwright-reporter
 
-Official Playwright test reporter for [M00n Report](https://app.m00n.report) - a real-time test reporting dashboard.
+Official Playwright test reporter for [M00n Report](https://m00nreport.com) - a real-time test reporting dashboard.
 
 ## Features
 
@@ -24,7 +24,7 @@ pnpm add @m00nsolutions/playwright-reporter --save-dev
 
 ### 1. Get your API key
 
-1. Log in to [app.m00n.report](https://app.m00n.report)
+1. Log in to [m00nreport.com](https://m00nreport.com)
 2. Navigate to your project settings
 3. Generate or copy your project API key
 
@@ -39,7 +39,7 @@ export default defineConfig({
   reporter: [
     ['list'], // Keep default console output
     ['@m00nsolutions/playwright-reporter', {
-      serverUrl: 'https://app.m00n.report',      // Or your self-hosted URL
+      serverUrl: 'https://m00nreport.com',      // Or your self-hosted URL
       apiKey: process.env.M00N_API_KEY,           // Your project API key
       launch: 'Regression Suite',                  // Optional: run title
       tags: ['smoke', 'regression'],               // Optional: tags
@@ -75,12 +75,76 @@ That's it! Your test results will appear in the M00n Report dashboard in real-ti
 You can also configure the reporter via environment variables:
 
 ```bash
-M00N_SERVER_URL=https://app.m00n.report
+M00N_SERVER_URL=https://m00nreport.com
 M00N_API_KEY=m00n_xxxxxxxxxxxxx
 M00N_LAUNCH="Nightly Build"
 M00N_TAGS=smoke,regression
 ```
 
+## CI/CD Auto-Detection
+
+The reporter **automatically detects** CI/CD environment variables from popular providers and includes them as run attributes. No configuration needed — just run your tests in CI and the dashboard will display branch, commit, build URL, and more.
+
+### Supported Providers
+
+| Provider | Detection Variable |
+|---|---|
+| **GitHub Actions** | `GITHUB_ACTIONS` |
+| **GitLab CI** | `GITLAB_CI` |
+| **Jenkins** | `JENKINS_URL` |
+| **Bitbucket Pipelines** | `BITBUCKET_PIPELINE_UUID` |
+| **Azure DevOps** | `TF_BUILD` |
+| **CircleCI** | `CIRCLECI` |
+| **Travis CI** | `TRAVIS` |
+
+### Auto-Detected Attributes
+
+The following attributes are automatically populated when running in a supported CI environment:
+
+| Attribute | Description | GitHub Actions | GitLab CI | Jenkins | Bitbucket | Azure DevOps | CircleCI | Travis CI |
+|---|---|---|---|---|---|---|---|---|
+| `ci_provider` | CI provider name | `GitHub Actions` | `GitLab CI` | `Jenkins` | `Bitbucket Pipelines` | `Azure DevOps` | `CircleCI` | `Travis CI` |
+| `branch` | Git branch | `GITHUB_REF_NAME` | `CI_COMMIT_REF_NAME` | `BRANCH_NAME` | `BITBUCKET_BRANCH` | `BUILD_SOURCEBRANCH` | `CIRCLE_BRANCH` | `TRAVIS_BRANCH` |
+| `commit` | Git commit SHA | `GITHUB_SHA` | `CI_COMMIT_SHA` | `GIT_COMMIT` | `BITBUCKET_COMMIT` | `BUILD_SOURCEVERSION` | `CIRCLE_SHA1` | `TRAVIS_COMMIT` |
+| `pipeline` | Pipeline/workflow name | `GITHUB_WORKFLOW` | `CI_PIPELINE_NAME` | `JOB_NAME` | — | `BUILD_DEFINITIONNAME` | `CIRCLE_WORKFLOW_JOB_NAME` | — |
+| `build_number` | Build number | `GITHUB_RUN_NUMBER` | `CI_PIPELINE_ID` | `BUILD_NUMBER` | `BITBUCKET_BUILD_NUMBER` | `BUILD_BUILDNUMBER` | `CIRCLE_BUILD_NUM` | `TRAVIS_BUILD_NUMBER` |
+| `build_url` | Link to build | Auto-composed | `CI_PIPELINE_URL` | `BUILD_URL` | Auto-composed | Auto-composed | `CIRCLE_BUILD_URL` | `TRAVIS_BUILD_WEB_URL` |
+| `trigger` | What triggered the build | `GITHUB_EVENT_NAME` | `CI_PIPELINE_SOURCE` | — | — | `BUILD_REASON` | — | `TRAVIS_EVENT_TYPE` |
+| `triggered_by` | User who triggered | `GITHUB_ACTOR` | `CI_GITLAB_USER_LOGIN` | — | — | — | `CIRCLE_USERNAME` | — |
+
+### Manual Override
+
+User-provided attributes always take precedence over auto-detected values. To override any auto-detected attribute, simply set it in the `attributes` config:
+
+```typescript
+reporter: [
+  ['@m00nsolutions/playwright-reporter', {
+    serverUrl: 'https://m00nreport.com',
+    apiKey: process.env.M00N_API_KEY,
+    attributes: {
+      branch: 'my-custom-branch',  // Overrides auto-detected branch
+      environment: 'staging',       // Custom attribute (not auto-detected)
+    },
+  }],
+],
+```
+
+### Custom CI Variables
+
+For unsupported CI providers or additional metadata, pass any key-value pairs via `attributes`:
+
+```typescript
+attributes: {
+  build_url: process.env.MY_CI_BUILD_URL,
+  branch: process.env.MY_CI_BRANCH,
+  commit: process.env.MY_CI_COMMIT,
+  environment: 'production',
+  region: 'us-east-1',
+},
+```
+
+The dashboard recognizes these attribute keys and displays them in the CI/CD banner: `branch`, `commit`, `pipeline`, `build_number`, `build_url`, `environment`, `trigger`.
+
 ## Usage Examples
 
 ### Basic Configuration
@@ -88,12 +152,39 @@ M00N_TAGS=smoke,regression
 ```typescript
 reporter: [
   ['@m00nsolutions/playwright-reporter', {
-    serverUrl: 'https://app.m00n.report',
+    serverUrl: 'https://m00nreport.com',
     apiKey: process.env.M00N_API_KEY,
   }],
 ],
 ```
 
+### GitHub Actions Example
+
+```yaml
+# .github/workflows/tests.yml
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: npx playwright test
+        env:
+          M00N_API_KEY: ${{ secrets.M00N_API_KEY }}
+```
+
+The reporter will automatically capture `branch`, `commit`, `build_url`, `pipeline`, `build_number`, `trigger`, and `triggered_by` from GitHub Actions environment variables.
+
+### GitLab CI Example
+
+```yaml
+# .gitlab-ci.yml
+test:
+  script:
+    - npx playwright test
+  variables:
+    M00N_API_KEY: $M00N_API_KEY
+```
+
 ## Real-time Step Streaming
 
 When `realtime: true` (default), the reporter streams test steps to the dashboard as they execute. This allows you to:
@@ -132,6 +223,6 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Support
 
-- 📖 [Documentation](https://app.m00n.report/documentation)
+- 📖 [Documentation](https://m00nreport.com/documentation)
 - 🐛 [Report Issues](https://github.com/m00nsolutions/m00nreport/issues)
 - 💬 [Community Discord](https://discord.gg/hzZvyVWS3Q)

package/index.mjs

@@ -38,6 +38,10 @@ import { fileURLToPath } from 'url';
 // CONSTANTS
 // ============================================================================
 
+// Maximum attachment file size - files larger than this are skipped
+// 200MB covers all realistic test artifacts (traces, videos, screenshots)
+const MAX_ATTACHMENT_SIZE = 200 * 1024 * 1024; // 200MB
+
 // Files larger than this threshold will be streamed directly to server
 // to avoid memory issues in reporter process
 const LARGE_FILE_THRESHOLD = 10 * 1024 * 1024; // 10MB
@@ -466,6 +470,84 @@ function parseTags(tags) {
   return [];
 }
 
+/**
+ * Auto-detect CI/CD environment variables from common providers.
+ * Returns a flat key-value object using attribute names that the
+ * M00n Report dashboard recognizes (branch, commit, pipeline, etc.).
+ * User-provided attributes always take precedence over auto-detected ones.
+ */
+function detectCIAttributes() {
+  const env = process.env;
+  const attrs = {};
+
+  if (env.GITHUB_ACTIONS) {
+    attrs.ci_provider = 'GitHub Actions';
+    if (env.GITHUB_WORKFLOW)    attrs.pipeline = env.GITHUB_WORKFLOW;
+    if (env.GITHUB_RUN_NUMBER)  attrs.build_number = env.GITHUB_RUN_NUMBER;
+    if (env.GITHUB_SHA)         attrs.commit = env.GITHUB_SHA;
+    if (env.GITHUB_REF_NAME)    attrs.branch = env.GITHUB_REF_NAME;
+    else if (env.GITHUB_REF)    attrs.branch = env.GITHUB_REF.replace(/^refs\/heads\//, '');
+    if (env.GITHUB_EVENT_NAME)  attrs.trigger = env.GITHUB_EVENT_NAME;
+    if (env.GITHUB_ACTOR)       attrs.triggered_by = env.GITHUB_ACTOR;
+    if (env.GITHUB_SERVER_URL && env.GITHUB_REPOSITORY && env.GITHUB_RUN_ID) {
+      attrs.build_url = `${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/actions/runs/${env.GITHUB_RUN_ID}`;
+    }
+  } else if (env.GITLAB_CI) {
+    attrs.ci_provider = 'GitLab CI';
+    if (env.CI_PIPELINE_NAME)     attrs.pipeline = env.CI_PIPELINE_NAME;
+    if (env.CI_PIPELINE_ID)       attrs.build_number = env.CI_PIPELINE_ID;
+    if (env.CI_PIPELINE_URL)      attrs.build_url = env.CI_PIPELINE_URL;
+    if (env.CI_PIPELINE_SOURCE)   attrs.trigger = env.CI_PIPELINE_SOURCE;
+    if (env.CI_COMMIT_SHA)        attrs.commit = env.CI_COMMIT_SHA;
+    if (env.CI_COMMIT_REF_NAME)   attrs.branch = env.CI_COMMIT_REF_NAME;
+    if (env.CI_JOB_URL)           attrs.ci_job_url = env.CI_JOB_URL;
+    if (env.CI_GITLAB_USER_LOGIN) attrs.triggered_by = env.CI_GITLAB_USER_LOGIN;
+  } else if (env.JENKINS_URL) {
+    attrs.ci_provider = 'Jenkins';
+    if (env.JOB_NAME)      attrs.pipeline = env.JOB_NAME;
+    if (env.BUILD_NUMBER)  attrs.build_number = env.BUILD_NUMBER;
+    if (env.BUILD_URL)     attrs.build_url = env.BUILD_URL;
+    if (env.GIT_COMMIT)    attrs.commit = env.GIT_COMMIT;
+    if (env.BRANCH_NAME)   attrs.branch = env.BRANCH_NAME;
+    else if (env.GIT_BRANCH) attrs.branch = env.GIT_BRANCH;
+  } else if (env.BITBUCKET_PIPELINE_UUID) {
+    attrs.ci_provider = 'Bitbucket Pipelines';
+    if (env.BITBUCKET_BUILD_NUMBER) attrs.build_number = env.BITBUCKET_BUILD_NUMBER;
+    if (env.BITBUCKET_COMMIT)       attrs.commit = env.BITBUCKET_COMMIT;
+    if (env.BITBUCKET_BRANCH)       attrs.branch = env.BITBUCKET_BRANCH;
+    if (env.BITBUCKET_REPO_SLUG && env.BITBUCKET_WORKSPACE && env.BITBUCKET_BUILD_NUMBER) {
+      attrs.build_url = `https://bitbucket.org/${env.BITBUCKET_WORKSPACE}/${env.BITBUCKET_REPO_SLUG}/pipelines/results/${env.BITBUCKET_BUILD_NUMBER}`;
+    }
+  } else if (env.TF_BUILD) {
+    attrs.ci_provider = 'Azure DevOps';
+    if (env.BUILD_DEFINITIONNAME) attrs.pipeline = env.BUILD_DEFINITIONNAME;
+    if (env.BUILD_BUILDNUMBER)    attrs.build_number = env.BUILD_BUILDNUMBER;
+    if (env.BUILD_SOURCEVERSION)  attrs.commit = env.BUILD_SOURCEVERSION;
+    if (env.BUILD_SOURCEBRANCH)   attrs.branch = env.BUILD_SOURCEBRANCH.replace(/^refs\/heads\//, '');
+    if (env.BUILD_REASON)         attrs.trigger = env.BUILD_REASON;
+    if (env.SYSTEM_TEAMFOUNDATIONSERVERURI && env.SYSTEM_TEAMPROJECT && env.BUILD_BUILDID) {
+      attrs.build_url = `${env.SYSTEM_TEAMFOUNDATIONSERVERURI}${env.SYSTEM_TEAMPROJECT}/_build/results?buildId=${env.BUILD_BUILDID}`;
+    }
+  } else if (env.CIRCLECI) {
+    attrs.ci_provider = 'CircleCI';
+    if (env.CIRCLE_WORKFLOW_JOB_NAME) attrs.pipeline = env.CIRCLE_WORKFLOW_JOB_NAME;
+    if (env.CIRCLE_BUILD_NUM)         attrs.build_number = env.CIRCLE_BUILD_NUM;
+    if (env.CIRCLE_BUILD_URL)         attrs.build_url = env.CIRCLE_BUILD_URL;
+    if (env.CIRCLE_SHA1)              attrs.commit = env.CIRCLE_SHA1;
+    if (env.CIRCLE_BRANCH)            attrs.branch = env.CIRCLE_BRANCH;
+    if (env.CIRCLE_USERNAME)          attrs.triggered_by = env.CIRCLE_USERNAME;
+  } else if (env.TRAVIS) {
+    attrs.ci_provider = 'Travis CI';
+    if (env.TRAVIS_BUILD_NUMBER) attrs.build_number = env.TRAVIS_BUILD_NUMBER;
+    if (env.TRAVIS_BUILD_WEB_URL) attrs.build_url = env.TRAVIS_BUILD_WEB_URL;
+    if (env.TRAVIS_COMMIT)       attrs.commit = env.TRAVIS_COMMIT;
+    if (env.TRAVIS_BRANCH)       attrs.branch = env.TRAVIS_BRANCH;
+    if (env.TRAVIS_EVENT_TYPE)   attrs.trigger = env.TRAVIS_EVENT_TYPE;
+  }
+
+  return attrs;
+}
+
 function extractAnnotations(test) {
   const result = {};
   const caseIdAnn = test?.annotations?.find(a => a?.type === 'caseId')?.description;
@@ -560,9 +642,9 @@ class HttpClient {
         
         // Check for permanent errors (don't retry)
         const errorData = await response.json().catch(() => ({}));
-        if (['PROJECT_NOT_FOUND', 'API_KEY_REQUIRED', 'INVALID_API_KEY'].includes(errorData.code)) {
+        if (['PROJECT_NOT_FOUND', 'API_KEY_REQUIRED', 'INVALID_API_KEY', 'RUN_ATTACHMENT_LIMIT_EXCEEDED'].includes(errorData.code)) {
           endTiming(0);
-          return { error: errorData.code, permanent: true };
+          return { error: errorData.code, code: errorData.code, permanent: true, ...errorData };
         }
         
         // Transient error - retry if we have attempts left
@@ -734,6 +816,13 @@ class HttpClient {
         }
         
         const errorData = await response.json().catch(() => ({}));
+        
+        // Check for permanent errors (don't retry)
+        if (['RUN_ATTACHMENT_LIMIT_EXCEEDED', 'PROJECT_NOT_FOUND', 'API_KEY_REQUIRED', 'INVALID_API_KEY'].includes(errorData.code)) {
+          endTiming(0);
+          return { error: errorData.code, code: errorData.code, permanent: true, ...errorData };
+        }
+        
         if (attempt < maxRetries) {
           this.perfTracker?.recordRetry();
           if (this.verbose) {
@@ -890,6 +979,13 @@ class HttpClient {
         }
         
         const errorData = await response.json().catch(() => ({}));
+        
+        // Check for permanent errors (don't retry)
+        if (['RUN_ATTACHMENT_LIMIT_EXCEEDED', 'PROJECT_NOT_FOUND', 'API_KEY_REQUIRED', 'INVALID_API_KEY'].includes(errorData.code)) {
+          endTiming(0);
+          return { error: errorData.code, code: errorData.code, permanent: true, ...errorData };
+        }
+        
         if (attempt < maxRetries) {
           this.perfTracker?.recordRetry();
           if (this.verbose) {
@@ -1194,7 +1290,12 @@ class TestCollector {
         // File path - check size to decide streaming vs buffering
         try {
           const stats = await fs.promises.stat(attachment.path);
-          if (stats.size > 500 * 1024 * 1024) return null; // Skip >500MB
+          if (stats.size > MAX_ATTACHMENT_SIZE) {
+            const sizeMB = (stats.size / 1024 / 1024).toFixed(1);
+            const limitMB = (MAX_ATTACHMENT_SIZE / 1024 / 1024).toFixed(0);
+            console.warn(`[M00nReporter] Attachment skipped: "${name}" (${sizeMB}MB) exceeds ${limitMB}MB limit. File: ${attachment.path}`);
+            return null;
+          }
           
           if (name === 'trace') name = path.basename(attachment.path);
           
@@ -1365,6 +1466,9 @@ export default class M00nReporter {
     // Prevents server/MinIO overload with high parallelism
     this.uploadSemaphore = new UploadSemaphore(MAX_GLOBAL_UPLOAD_CONCURRENCY);
     
+    // Set when server returns RUN_ATTACHMENT_LIMIT_EXCEEDED -- skip remaining uploads for this run
+    this._runLimitReached = false;
+    
     // test/start is now fire-and-forget (no need to track promises)
     // testId is generated client-side, so steps can be streamed immediately
     
@@ -1462,10 +1566,13 @@ export default class M00nReporter {
         return { ok: true };
       }).catch(err => ({ ok: false, error: err }));
       
-      // Normalize attributes: flat key-value object
-      const attributes = this.opts.attributes && typeof this.opts.attributes === 'object' 
-        ? { ...this.opts.attributes }
+      // Auto-detect CI environment variables, then overlay user-provided attributes
+      // User attributes always take precedence over auto-detected ones
+      const ciAttrs = detectCIAttributes();
+      const userAttrs = this.opts.attributes && typeof this.opts.attributes === 'object'
+        ? this.opts.attributes
         : {};
+      const attributes = { ...ciAttrs, ...userAttrs };
       
       // Add workers count from Playwright config (useful for timeline visualization)
       if (config.workers != null) {
@@ -1808,9 +1915,17 @@ export default class M00nReporter {
   // Uses semaphore to limit concurrent uploads across ALL tests
   // Returns { uploaded: N, failed: M } for tracking
   async uploadAttachmentsWithBackpressure(runId, testId, attachments) {
-    if (!attachments || attachments.length === 0) return { uploaded: 0, failed: 0 };
+    if (!attachments || attachments.length === 0) return { uploaded: 0, failed: 0, skipped: 0 };
     
-    const results = { uploaded: 0, failed: 0 };
+    // If a previous upload hit the run attachment limit, skip all remaining uploads
+    if (this._runLimitReached) {
+      if (this.debug) {
+        this.log('debug', `Skipping ${attachments.length} attachment(s) - run attachment limit already reached`);
+      }
+      return { uploaded: 0, failed: 0, skipped: attachments.length };
+    }
+    
+    const results = { uploaded: 0, failed: 0, skipped: 0 };
     const uploadStart = performance.now();
     
     // Separate small and large files
@@ -1823,6 +1938,9 @@ export default class M00nReporter {
     // Small files - upload individually with semaphore for better parallelism
     for (const file of smallFiles) {
       uploadTasks.push(this.uploadSemaphore.run(async () => {
+        // Check limit flag before each upload (may have been set by a concurrent upload)
+        if (this._runLimitReached) return 'skipped';
+        
         try {
           const resp = await this.http.postMultipart(
             '/api/ingest/v2/attachment/upload',
@@ -1831,6 +1949,13 @@ export default class M00nReporter {
             { timeout: UPLOAD_TIMEOUT }
           );
           
+          if (resp.code === 'RUN_ATTACHMENT_LIMIT_EXCEEDED') {
+            this._runLimitReached = true;
+            const usedMB = resp.currentBytes ? Math.round(resp.currentBytes / 1024 / 1024) : '?';
+            const limitMB = resp.limitBytes ? Math.round(resp.limitBytes / 1024 / 1024) : '?';
+            this.log('warn', `Attachment skipped: run attachment limit reached (${usedMB}/${limitMB} MB used). Remaining attachments for this run will be skipped.`);
+            return 'skipped';
+          }
           if (resp.error) {
             this.addError(`Upload failed (${file.name}): ${resp.error}`);
             return false;
@@ -1846,6 +1971,9 @@ export default class M00nReporter {
     // Large files - stream upload with semaphore
     for (const largeFile of largeFiles) {
       uploadTasks.push(this.uploadSemaphore.run(async () => {
+        // Check limit flag before each upload (may have been set by a concurrent upload)
+        if (this._runLimitReached) return 'skipped';
+        
         try {
           if (this.debug) {
             this.log('debug', `Streaming large file: ${largeFile.name} (${(largeFile.size / 1024 / 1024).toFixed(1)}MB)`);
@@ -1860,6 +1988,13 @@ export default class M00nReporter {
             { timeout: STREAM_UPLOAD_TIMEOUT }
           );
           
+          if (resp.code === 'RUN_ATTACHMENT_LIMIT_EXCEEDED') {
+            this._runLimitReached = true;
+            const usedMB = resp.currentBytes ? Math.round(resp.currentBytes / 1024 / 1024) : '?';
+            const limitMB = resp.limitBytes ? Math.round(resp.limitBytes / 1024 / 1024) : '?';
+            this.log('warn', `Attachment skipped: run attachment limit reached (${usedMB}/${limitMB} MB used). Remaining attachments for this run will be skipped.`);
+            return 'skipped';
+          }
           if (resp.error) {
             this.addError(`Stream upload failed (${largeFile.name}): ${resp.error}`);
             return false;
@@ -1879,6 +2014,8 @@ export default class M00nReporter {
     for (const result of uploadResults) {
       if (result.status === 'fulfilled' && result.value === true) {
         results.uploaded++;
+      } else if (result.status === 'fulfilled' && result.value === 'skipped') {
+        results.skipped++;
       } else {
         results.failed++;
       }
@@ -1887,7 +2024,9 @@ export default class M00nReporter {
     const uploadDuration = performance.now() - uploadStart;
     
     if (this.verbose) {
-      this.log('perf', `Attachments uploaded: ${results.uploaded}/${attachments.length} in ${Math.round(uploadDuration)}ms`);
+      const parts = [`${results.uploaded}/${attachments.length} in ${Math.round(uploadDuration)}ms`];
+      if (results.skipped > 0) parts.push(`${results.skipped} skipped (limit reached)`);
+      this.log('perf', `Attachments uploaded: ${parts.join(', ')}`);
     }
     
     // Log to file
@@ -1896,6 +2035,8 @@ export default class M00nReporter {
       total: attachments.length,
       uploaded: results.uploaded,
       failed: results.failed,
+      skipped: results.skipped,
+      limitReached: this._runLimitReached,
       duration: Math.round(uploadDuration),
     });
     

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m00nsolutions/playwright-reporter",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Playwright test reporter for M00n Report dashboard - real-time test result streaming with step tracking, attachments, and retry support",
   "main": "index.mjs",
   "type": "module",
@@ -42,7 +42,7 @@
     "url": "https://github.com/m00nsolutions/m00nreport.git",
     "directory": "packages/m00n-playwright-reporter"
   },
-  "homepage": "https://app.m00n.report",
+  "homepage": "https://m00nreport.com",
   "bugs": {
     "url": "https://github.com/m00nsolutions/m00nreport/issues"
   },