@piwitests/reporter 0.5.0 → 0.6.0

package/dist/{stream-manager.d.ts → internal/streaming/stream-manager.d.ts}

@@ -1,11 +1,11 @@
-import type { PiwiDashboardOptions, ShardInfo } from './config.js';
-import { HttpClient } from './http-client.js';
-import { StreamBuffer } from './stream-buffer.js';
-import { CrashRecovery } from './crash-recovery.js';
-import { Uploader } from './uploader.js';
-import { FileHandler } from './file-handler.js';
-import { Logger } from './logger.js';
-import type { CollectedTestCase, StreamEvent, FilterDetails } from './types.js';
+import type { PiwiDashboardOptions, ShardInfo } from '../../public/options.js';
+import type { HttpClient } from '../transport/http-client.js';
+import type { StreamBuffer } from './stream-buffer.js';
+import type { CrashRecovery } from './crash-recovery.js';
+import type { Uploader } from '../submit/uploader.js';
+import type { FileHandler } from '../files/file-handler.js';
+import { Logger } from '../support/logger.js';
+import type { CollectedTestCase, StreamEvent, FilterDetails } from '../../types.js';
 /**
  * Manages the streaming protocol: queues events (begin / complete), flushes
  * them in batches, schedules retries on failure, and handles per-test-case

package/dist/{stream-manager.js → internal/streaming/stream-manager.js}

@@ -34,9 +34,12 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StreamManager = void 0;
-const fs = __importStar(require("fs"));
-const logger_js_1 = require("./logger.js");
-const helpers_js_1 = require("./helpers.js");
+const fs = __importStar(require("node:fs"));
+const errors_js_1 = require("../support/errors.js");
+const http_client_js_1 = require("../transport/http-client.js");
+const logger_js_1 = require("../support/logger.js");
+const limiter_js_1 = require("../support/limiter.js");
+const setup_file_js_1 = require("../support/setup-file.js");
 /**
  * Manages the streaming protocol: queues events (begin / complete), flushes
  * them in batches, schedules retries on failure, and handles per-test-case
@@ -85,7 +88,7 @@ class StreamManager {
         this.flushTimer = null;
         this.flushPromises = [];
         this.liveUploadPromises = [];
-        this.limitLiveUpload = (0, helpers_js_1.createLimiter)(2);
+        this.limitLiveUpload = (0, limiter_js_1.createLimiter)(2);
         this.retryCount = 0;
         this.retryTimer = null;
         this.maxRetryDelay = 30000;
@@ -112,7 +115,7 @@ class StreamManager {
         this._startPromise = this._doStart(startTime, metadata, instanceId, playwrightVersion, shardInfo, isFullRun, filterDetails);
     }
     async _doStart(startTime, metadata, instanceId, playwrightVersion, shardInfo, isFullRun, filterDetails) {
-        const setupInfo = (0, helpers_js_1.readSetupInfo)(this.options.projectName);
+        const setupInfo = (0, setup_file_js_1.readSetupInfo)(this.options.projectName);
         try {
             this._auth = await this.httpClient.resolveAuth(this.options);
             await this.recovery.tryUpload(this.httpClient, this._auth);
@@ -132,11 +135,11 @@ class StreamManager {
                         filterDetails,
                     }, this._auth);
                 }
-                catch (beginError) {
+                catch (error) {
                     // Stale setupInfo — the run was cancelled (e.g. by crash recovery submit).
                     // Fall back to creating a fresh run instead of silently disabling streaming.
-                    if (!beginError.message?.includes('409'))
-                        throw beginError;
+                    if (!(error instanceof http_client_js_1.HttpError && error.status === 409))
+                        throw error;
                     this.logger.debug(`Setup info expired, creating fresh run...`);
                     response = await this.httpClient.postJSON('/api/test-runs/start', {
                         projectName: this.options.projectName,
@@ -185,7 +188,7 @@ class StreamManager {
             }
         }
         catch (error) {
-            this.logger.debug(`Streaming not available: ${error.message}. Will use batch mode.`);
+            this.logger.debug(`Streaming not available: ${(0, errors_js_1.errorMessage)(error)}. Will use batch mode.`);
             this._enabled = false;
         }
     }
@@ -277,7 +280,7 @@ class StreamManager {
             this.lastActivityAt = Date.now();
         }
         catch (error) {
-            this.logger.debug(`Heartbeat failed: ${error.message}`);
+            this.logger.debug(`Heartbeat failed: ${(0, errors_js_1.errorMessage)(error)}`);
         }
         this.scheduleHeartbeat();
     }
@@ -354,9 +357,9 @@ class StreamManager {
                     return;
                 }
                 catch (error) {
-                    const retryable = error.message?.includes('404');
+                    const retryable = error instanceof http_client_js_1.HttpError && error.status === 404;
                     if (!retryable || attempt === delays.length - 1) {
-                        this.logger.debug(`Live file upload failed for "${tc.title}": ${error.message}`);
+                        this.logger.debug(`Live file upload failed for "${tc.title}": ${(0, errors_js_1.errorMessage)(error)}`);
                         return; // The end-of-run pass retries cases that failed here
                     }
                 }
@@ -381,7 +384,7 @@ class StreamManager {
                     this.uploadedCaseFiles.add(tc);
             }
             catch (error) {
-                this.logger.warn(`Failed to upload files for "${tc.title}": ${error.message}`);
+                this.logger.warn(`Failed to upload files for "${tc.title}": ${(0, errors_js_1.errorMessage)(error)}`);
             }
         }
     }

package/dist/{run-submitter.d.ts → internal/submit/run-submitter.d.ts}

@@ -1,11 +1,11 @@
 import type { FullResult } from '@playwright/test/reporter';
-import type { PiwiDashboardOptions, ShardInfo } from './config.js';
-import { HttpClient } from './http-client.js';
-import { Uploader } from './uploader.js';
-import { CrashRecovery } from './crash-recovery.js';
-import { StreamManager } from './stream-manager.js';
-import { Logger } from './logger.js';
-import type { CollectedTestCase, SetupStep, FilterDetails } from './types.js';
+import type { PiwiDashboardOptions, ShardInfo } from '../../public/options.js';
+import type { HttpClient } from '../transport/http-client.js';
+import type { Uploader } from './uploader.js';
+import type { CrashRecovery } from '../streaming/crash-recovery.js';
+import type { StreamManager } from '../streaming/stream-manager.js';
+import { Logger } from '../support/logger.js';
+import type { CollectedTestCase, SetupStep, FilterDetails } from '../../types.js';
 /**
  * Snapshot of everything the reporter has collected by `onEnd`, handed off to
  * the `RunSubmitter` so the reporter itself stays a thin collect-and-hand-off

package/dist/{run-submitter.js → internal/submit/run-submitter.js}

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunSubmitter = void 0;
-const logger_js_1 = require("./logger.js");
-const step_analyzer_js_1 = require("./step-analyzer.js");
+const errors_js_1 = require("../support/errors.js");
+const http_client_js_1 = require("../transport/http-client.js");
+const logger_js_1 = require("../support/logger.js");
+const step_analyzer_js_1 = require("../collect/step-analyzer.js");
 const serializer_js_1 = require("./serializer.js");
 /**
  * Owns the three-tier submit/fallback ladder:
@@ -54,7 +56,7 @@ class RunSubmitter {
             auth = sm?.auth ?? (await this.httpClient.resolveAuth(run.options));
         }
         catch (error) {
-            this.logger.error(`Authentication failed: ${error.message}`);
+            this.logger.error(`Authentication failed: ${(0, errors_js_1.errorMessage)(error)}`);
             throw error;
         }
         if (sm?.enabled && sm?.runId != null) {
@@ -140,13 +142,13 @@ class RunSubmitter {
                     await this.uploader.uploadReportsForStreamingRun(run.options.projectName, sm.runId, this.reportOptions(run), run.startTime, auth);
                 }
                 catch (error) {
-                    this.logger.warn(`Failed to upload reports for streaming run: ${error.message}`);
+                    this.logger.warn(`Failed to upload reports for streaming run: ${(0, errors_js_1.errorMessage)(error)}`);
                 }
             }
             return true;
         }
         catch (error) {
-            this.logger.warn(`Failed to finalize streaming run: ${error.message}`);
+            this.logger.warn(`Failed to finalize streaming run: ${(0, errors_js_1.errorMessage)(error)}`);
             this.logger.info('Falling back to batch upload...');
             return false;
         }
@@ -158,9 +160,9 @@ class RunSubmitter {
             return true;
         }
         catch (error) {
-            if (error.message?.includes('401') && !auth)
+            if (error instanceof http_client_js_1.HttpError && error.status === 401 && !auth)
                 throw error;
-            this.logger.warn(`Failed to upload with files: ${error.message}`);
+            this.logger.warn(`Failed to upload with files: ${(0, errors_js_1.errorMessage)(error)}`);
             this.logger.info('Falling back to JSON upload...');
             return false;
         }
@@ -174,9 +176,9 @@ class RunSubmitter {
         catch (error) {
             // If the server returned 401 and no auth was configured, this is a
             // configuration error — throw so the caller knows it's fatal.
-            if (error.message?.includes('401') && !auth)
+            if (error instanceof http_client_js_1.HttpError && error.status === 401 && !auth)
                 throw error;
-            this.logger.error(`All upload methods failed: ${error.message}`);
+            this.logger.error(`All upload methods failed: ${(0, errors_js_1.errorMessage)(error)}`);
             // Save the wire-serialized form so the recovery file matches the
             // original submit payload (no raw attachments / internal fields).
             this.recovery.save((0, serializer_js_1.serializeRun)(payload, { includeTestCases: true }));

package/dist/{serializer.d.ts → internal/submit/serializer.d.ts}

@@ -1,5 +1,5 @@
 import type { FullResult } from '@playwright/test/reporter';
-import type { CollectedTestCase, WireTestCase } from './types.js';
+import type { CollectedTestCase, WireTestCase } from '../../types.js';
 import type { RunPayload } from './uploader.js';
 /**
  * Resolve the overall Piwi run status from Playwright's `FullResult.status`

package/dist/{uploader.d.ts → internal/submit/uploader.d.ts}

@@ -1,7 +1,7 @@
-import { HttpClient } from './http-client.js';
-import { FileHandler } from './file-handler.js';
-import { Logger } from './logger.js';
-import type { CollectedTestCase, FilterDetails } from './types.js';
+import type { HttpClient } from '../transport/http-client.js';
+import type { FileHandler } from '../files/file-handler.js';
+import { Logger } from '../support/logger.js';
+import type { CollectedTestCase, FilterDetails } from '../../types.js';
 /** Payload for a batch test-run submission */
 export interface RunPayload {
     /** Name of the project the run belongs to */
@@ -61,15 +61,15 @@ export interface ReportOptions {
  * uploads for already-submitted streaming runs.
  */
 export declare class Uploader {
-    private httpClient;
-    private fileHandler;
-    private logger;
+    private readonly httpClient;
+    private readonly fileHandler;
+    private readonly logger;
     /**
      * @param httpClient  HTTP client for server communication.
      * @param fileHandler File discovery and compression helper.
      * @param logger      Prefixed logger.
      */
-    constructor(httpClient: HttpClient, fileHandler: FileHandler, logger: Logger);
+    constructor(httpClient: HttpClient, fileHandler: FileHandler, logger?: Logger);
     /** Submit test results as a plain JSON payload (no file attachments) */
     uploadJSON(payload: RunPayload, auth: string | null): Promise<any>;
     /** Submit test results as a multipart form with trace files and compressed report directories */

package/dist/{uploader.js → internal/submit/uploader.js}

@@ -1,12 +1,47 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Uploader = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
 const form_data_1 = __importDefault(require("form-data"));
+const http_client_js_1 = require("../transport/http-client.js");
+const logger_js_1 = require("../support/logger.js");
 const serializer_js_1 = require("./serializer.js");
 /**
  * Handles all upload strategies: plain JSON, multipart (with reports and
@@ -19,7 +54,7 @@ class Uploader {
      * @param fileHandler File discovery and compression helper.
      * @param logger      Prefixed logger.
      */
-    constructor(httpClient, fileHandler, logger) {
+    constructor(httpClient, fileHandler, logger = new logger_js_1.Logger()) {
         this.httpClient = httpClient;
         this.fileHandler = fileHandler;
         this.logger = logger;
@@ -104,15 +139,15 @@ class Uploader {
             if (traceInfo) {
                 form.append('trace_hash', traceInfo.hash);
                 if (includeTraceFile) {
-                    form.append('trace', fs_1.default.createReadStream(traceInfo.tracePath), {
-                        filename: path_1.default.basename(traceInfo.tracePath),
+                    form.append('trace', fs.createReadStream(traceInfo.tracePath), {
+                        filename: path.basename(traceInfo.tracePath),
                     });
                 }
             }
             if (attachments.length > 0) {
                 form.append('attach_meta', JSON.stringify(attachments.map((a) => ({ name: a.name, contentType: a.contentType, originalName: a.originalName }))));
                 for (const a of attachments) {
-                    form.append('attach_file', fs_1.default.createReadStream(a.path), { filename: a.originalName });
+                    form.append('attach_file', fs.createReadStream(a.path), { filename: a.originalName });
                 }
             }
             return form;
@@ -123,7 +158,7 @@ class Uploader {
         }
         catch (error) {
             // 422: the server doesn't have the blob after all — resend with the file
-            if (traceInfo && !includeTraceFile && error.message?.includes('422')) {
+            if (traceInfo && !includeTraceFile && error instanceof http_client_js_1.HttpError && error.status === 422) {
                 await this.httpClient.postFormData(`/api/test-runs/${runId}/case-files`, buildForm(true), auth);
             }
             else {
@@ -168,7 +203,7 @@ class Uploader {
                 originalName: a.originalName,
             }))));
             for (const a of attachments) {
-                form.append(`attach_file_${i}`, fs_1.default.createReadStream(a.path), { filename: a.originalName });
+                form.append(`attach_file_${i}`, fs.createReadStream(a.path), { filename: a.originalName });
                 attachmentCount++;
             }
         }
@@ -179,8 +214,8 @@ class Uploader {
         let traceCount = 0;
         for (const [i, tc] of testCases.entries()) {
             for (const tp of this.fileHandler.findTraceFiles(tc)) {
-                if (fs_1.default.existsSync(tp)) {
-                    form.append(`trace_${i}`, fs_1.default.createReadStream(tp), { filename: path_1.default.basename(tp) });
+                if (fs.existsSync(tp)) {
+                    form.append(`trace_${i}`, fs.createReadStream(tp), { filename: path.basename(tp) });
                     traceCount++;
                 }
             }

package/dist/internal/support/ci.d.ts

@@ -0,0 +1,2 @@
+/** Detect a stable CI run label from well-known environment variables. Returns null outside CI. */
+export declare function detectCiRunLabel(): string | null;

package/dist/internal/support/ci.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCiRunLabel = detectCiRunLabel;
+/** Detect a stable CI run label from well-known environment variables. Returns null outside CI. */
+function detectCiRunLabel() {
+    const env = process.env;
+    if (env.GITHUB_ACTIONS && env.GITHUB_RUN_ID)
+        return env.GITHUB_RUN_ID;
+    if (env.GITLAB_CI && env.CI_PIPELINE_ID)
+        return env.CI_PIPELINE_ID;
+    if (env.CIRCLECI && env.CIRCLE_WORKFLOW_ID)
+        return env.CIRCLE_WORKFLOW_ID;
+    if (env.TRAVIS && env.TRAVIS_BUILD_ID)
+        return env.TRAVIS_BUILD_ID;
+    if (env.TF_BUILD && env.BUILD_BUILDID)
+        return env.BUILD_BUILDID;
+    if (env.JENKINS_URL && env.BUILD_ID)
+        return env.BUILD_ID;
+    if (env.BUILDKITE_BUILD_ID)
+        return env.BUILDKITE_BUILD_ID;
+    if (env.TEAMCITY_BUILD_ID)
+        return env.TEAMCITY_BUILD_ID;
+    if (env.BITBUCKET_BUILD_NUMBER)
+        return env.BITBUCKET_BUILD_NUMBER;
+    if (env.SEMAPHORE_WORKFLOW_ID)
+        return env.SEMAPHORE_WORKFLOW_ID;
+    if (env.APPVEYOR_BUILD_ID)
+        return env.APPVEYOR_BUILD_ID;
+    if (env.DRONE_BUILD_NUMBER)
+        return env.DRONE_BUILD_NUMBER;
+    return null;
+}

package/dist/internal/support/cli-filters.d.ts

@@ -0,0 +1 @@
+export declare function detectCliFileFilters(argv?: string[]): string[];

package/dist/internal/support/cli-filters.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCliFileFilters = detectCliFileFilters;
+/**
+ * Extract positional file/path filters from a Playwright CLI invocation
+ * (e.g. `playwright test tests/login.spec.ts auth/`). These narrow a run to
+ * specific files and are NOT reflected in `config.grep`, so they're the only
+ * signal that a file-filtered run is partial. Returns an empty array when the
+ * full suite was requested.
+ *
+ * Best-effort: skips the values of known value-taking options so they aren't
+ * mistaken for file filters. `--flag=value` forms consume no extra token.
+ */
+const PW_VALUE_FLAGS = new Set([
+    '-c',
+    '--config',
+    '-j',
+    '--workers',
+    '-g',
+    '--grep',
+    '--grep-invert',
+    '--global-timeout',
+    '--max-failures',
+    '--output',
+    '-p',
+    '--project',
+    '--repeat-each',
+    '--reporter',
+    '--retries',
+    '--shard',
+    '--timeout',
+    '--trace',
+]);
+function detectCliFileFilters(argv = process.argv) {
+    // Drop the node executable + script path, then start after the `test` subcommand.
+    const args = argv.slice(2);
+    const testIdx = args.indexOf('test');
+    const rest = testIdx >= 0 ? args.slice(testIdx + 1) : args;
+    const files = [];
+    for (let i = 0; i < rest.length; i++) {
+        const tok = rest[i];
+        if (tok.startsWith('-')) {
+            // A bare value-taking flag (no `=`) consumes the next token as its value.
+            if (!tok.includes('=') && PW_VALUE_FLAGS.has(tok))
+                i++;
+            continue;
+        }
+        files.push(tok);
+    }
+    return files;
+}

package/dist/internal/support/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ *
+ * `catch` bindings are typed `unknown` (TypeScript strict mode), so reach for
+ * this instead of `(error as any).message` — it returns `error.message` for any
+ * `Error` (including `HttpError`) and a stringified form otherwise.
+ */
+export declare function errorMessage(error: unknown): string;

package/dist/internal/support/errors.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorMessage = errorMessage;
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ *
+ * `catch` bindings are typed `unknown` (TypeScript strict mode), so reach for
+ * this instead of `(error as any).message` — it returns `error.message` for any
+ * `Error` (including `HttpError`) and a stringified form otherwise.
+ */
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}

package/dist/internal/support/instance-id.d.ts

@@ -0,0 +1,4 @@
+/** Produce a deterministic short SHA-1 hex hash for a project name (used in temp file names) */
+export declare function hashForProject(projectName: string): string;
+/** Derive a unique instance identifier by hashing hostname + projectName (or runLabel + projectName when sharding) */
+export declare function computeInstanceId(projectName: string, runLabel?: string | null): string;

package/dist/internal/support/instance-id.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashForProject = hashForProject;
+exports.computeInstanceId = computeInstanceId;
+const crypto = __importStar(require("node:crypto"));
+const os = __importStar(require("node:os"));
+/** Produce a deterministic short SHA-1 hex hash for a project name (used in temp file names) */
+function hashForProject(projectName) {
+    return crypto.createHash('sha1').update(projectName).digest('hex').slice(0, 16);
+}
+/** Derive a unique instance identifier by hashing hostname + projectName (or runLabel + projectName when sharding) */
+function computeInstanceId(projectName, runLabel) {
+    const seed = runLabel ? `${projectName}|${runLabel}` : `${os.hostname()}|${projectName}`;
+    return crypto.createHash('sha256').update(seed).digest('hex').slice(0, 16);
+}

package/dist/internal/support/limiter.d.ts

@@ -0,0 +1,2 @@
+/** Create a concurrency limiter that ensures at most `maxConcurrent` async operations run simultaneously */
+export declare function createLimiter(maxConcurrent: number): <T>(fn: () => Promise<T>) => Promise<T>;

package/dist/internal/support/limiter.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLimiter = createLimiter;
+/** Create a concurrency limiter that ensures at most `maxConcurrent` async operations run simultaneously */
+function createLimiter(maxConcurrent) {
+    const limitValue = Math.max(1, Math.floor(maxConcurrent));
+    let active = 0;
+    const queue = [];
+    const next = () => {
+        active--;
+        const run = queue.shift();
+        if (run)
+            run();
+    };
+    return function limit(fn) {
+        return new Promise((resolve, reject) => {
+            const run = () => {
+                active++;
+                Promise.resolve().then(fn).then(resolve, reject).finally(next);
+            };
+            if (active < limitValue)
+                run();
+            else
+                queue.push(run);
+        });
+    };
+}

package/dist/internal/support/setup-file.d.ts

@@ -0,0 +1,13 @@
+/** Return the temp-file path used to exchange setup info between globalSetup and the reporter instance */
+export declare function getSetupFilePath(projectName: string): string;
+/** Information saved by the global setup for the reporter instance to consume */
+export interface SetupInfo {
+    /** Server-assigned run ID */
+    runId: number;
+    /** One-time token used to authenticate the /begin call */
+    setupToken: string;
+    /** Project name this run belongs to */
+    projectName: string;
+}
+/** Read and delete the setup info file for the given project. Returns `null` when no file exists. */
+export declare function readSetupInfo(projectName: string): SetupInfo | null;

package/dist/internal/support/setup-file.js

@@ -0,0 +1,61 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSetupFilePath = getSetupFilePath;
+exports.readSetupInfo = readSetupInfo;
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const fs = __importStar(require("node:fs"));
+const instance_id_js_1 = require("./instance-id.js");
+/** Return the temp-file path used to exchange setup info between globalSetup and the reporter instance */
+function getSetupFilePath(projectName) {
+    return path.join(os.tmpdir(), `piwi-dashboard-setup-${(0, instance_id_js_1.hashForProject)(projectName)}.json`);
+}
+/** Read and delete the setup info file for the given project. Returns `null` when no file exists. */
+function readSetupInfo(projectName) {
+    const setupFile = getSetupFilePath(projectName);
+    try {
+        if (fs.existsSync(setupFile)) {
+            const info = JSON.parse(fs.readFileSync(setupFile, 'utf8'));
+            fs.unlinkSync(setupFile);
+            if (info.projectName === projectName)
+                return info;
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return null;
+}

package/dist/internal/support/source-snippet.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Read a snippet of source code surrounding the declaration line, optionally
+ * highlighting a separate failing line. Returns a formatted string with line
+ * numbers and markers (`>` for the failing line, `*` for the declaration), or
+ * `null` on error.
+ */
+export declare function readSourceSnippet(file: string, declLine: number, context: number, failingLine?: number): string | null;
+/**
+ * Extract the line number of the first stack frame inside `testFile` from an
+ * error's stack trace. Falls back to `declarationLine`.
+ */
+export declare function extractFailingLine(errorText: string | null | undefined, testFile: string, declarationLine: number): number;