@piwitests/reporter 0.12.0 → 0.14.0

package/dist/internal/support/limiter.js

@@ -1,27 +0,0 @@
-"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/logger.d.ts

@@ -1,26 +0,0 @@
-/**
- * Tiny prefixed logger. Owns the `[Piwi Dashboard]` prefix and the verbose
- * gate so the prefix isn't typed out ~46× across the package and `verbose`
- * doesn't need to be threaded into every constructor.
- *
- * Channel preservation:
- * - `info`  → stdout (always),
- * - `warn`  → stderr (always),
- * - `error` → stderr (always),
- * - `debug` → stdout (only when `verbose`),
- * - `debugError` → stderr (only when `verbose`).
- *
- * `debugError` exists so verbose-only diagnostics that previously used
- * `console.error` (e.g. HTTP response bodies on failure) keep going to stderr
- * after the refactor.
- */
-export declare class Logger {
-    private readonly verbose;
-    private readonly prefix;
-    constructor(verbose?: boolean);
-    info(msg: string): void;
-    warn(msg: string): void;
-    error(msg: string): void;
-    debug(msg: string): void;
-    debugError(msg: string): void;
-}

package/dist/internal/support/logger.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = void 0;
-/**
- * Tiny prefixed logger. Owns the `[Piwi Dashboard]` prefix and the verbose
- * gate so the prefix isn't typed out ~46× across the package and `verbose`
- * doesn't need to be threaded into every constructor.
- *
- * Channel preservation:
- * - `info`  → stdout (always),
- * - `warn`  → stderr (always),
- * - `error` → stderr (always),
- * - `debug` → stdout (only when `verbose`),
- * - `debugError` → stderr (only when `verbose`).
- *
- * `debugError` exists so verbose-only diagnostics that previously used
- * `console.error` (e.g. HTTP response bodies on failure) keep going to stderr
- * after the refactor.
- */
-class Logger {
-    constructor(verbose = false) {
-        this.verbose = verbose;
-        this.prefix = '[Piwi Dashboard] ';
-    }
-    info(msg) {
-        console.log(this.prefix + msg);
-    }
-    warn(msg) {
-        console.warn(this.prefix + msg);
-    }
-    error(msg) {
-        console.error(this.prefix + msg);
-    }
-    debug(msg) {
-        if (this.verbose)
-            console.log(this.prefix + msg);
-    }
-    debugError(msg) {
-        if (this.verbose)
-            console.error(this.prefix + msg);
-    }
-}
-exports.Logger = Logger;

package/dist/internal/support/reporter-version.d.ts

@@ -1,2 +0,0 @@
-/** Read the reporter package's own version from `package.json`, memoized. Falls back to `'unknown'` if it can't be read (e.g. an unusual install layout). */
-export declare function getReporterVersion(): string;

package/dist/internal/support/reporter-version.js

@@ -1,54 +0,0 @@
-"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.getReporterVersion = getReporterVersion;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-let cachedVersion = null;
-/** Read the reporter package's own version from `package.json`, memoized. Falls back to `'unknown'` if it can't be read (e.g. an unusual install layout). */
-function getReporterVersion() {
-    if (cachedVersion)
-        return cachedVersion;
-    try {
-        const pkgPath = path.resolve(__dirname, '../../../package.json');
-        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-        const version = pkg.version;
-        cachedVersion = typeof version === 'string' ? version : 'unknown';
-    }
-    catch {
-        cachedVersion = 'unknown';
-    }
-    return cachedVersion;
-}

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

@@ -1,13 +0,0 @@
-/** 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

@@ -1,61 +0,0 @@
-"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

@@ -1,12 +0,0 @@
-/**
- * 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;

package/dist/internal/support/source-snippet.js

@@ -1,97 +0,0 @@
-"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.readSourceSnippet = readSourceSnippet;
-exports.extractFailingLine = extractFailingLine;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-/**
- * 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.
- */
-function readSourceSnippet(file, declLine, context, failingLine) {
-    try {
-        const content = fs.readFileSync(file, 'utf-8');
-        const lines = content.split('\n');
-        const anchor = failingLine ?? declLine;
-        const start = Math.max(0, anchor - context - 1);
-        const end = Math.min(lines.length, anchor + context);
-        return lines
-            .slice(start, end)
-            .map((l, i) => {
-            const lineNum = start + i + 1;
-            const hasFailingLine = failingLine != null;
-            const isFailing = hasFailingLine && lineNum === failingLine;
-            const isDecl = lineNum === declLine && !isFailing;
-            let marker = '  ';
-            if (isFailing)
-                marker = '> ';
-            else if (isDecl)
-                marker = hasFailingLine ? '* ' : '> ';
-            return `${marker}${String(lineNum).padStart(4)} | ${l}`;
-        })
-            .join('\n');
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Extract the line number of the first stack frame inside `testFile` from an
- * error's stack trace. Falls back to `declarationLine`.
- */
-function extractFailingLine(errorText, testFile, declarationLine) {
-    if (!errorText)
-        return declarationLine;
-    const expectedFile = path.resolve(testFile);
-    const stackRe = /^\s+at (?:[^(]*\()?(.+?):(\d+):\d+\)?\s*$/gm;
-    let m;
-    while ((m = stackRe.exec(errorText)) !== null) {
-        try {
-            const frameFile = path.resolve(m[1]);
-            if (frameFile === expectedFile) {
-                const line = parseInt(m[2], 10);
-                if (!isNaN(line))
-                    return line;
-            }
-        }
-        catch {
-            /* skip unresolvable paths */
-        }
-    }
-    return declarationLine;
-}

package/dist/internal/support/worker-index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Extract a worker index from a Playwright `TestResult`, falling back to
- * `parallelIndex` when `workerIndex` is absent. Returns `null` when neither is
- * set. Localizes the `as any` reach into Playwright's result object so the
- * cast lives in exactly one place.
- */
-export declare function workerIndexOf(result: any): number | null;

package/dist/internal/support/worker-index.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.workerIndexOf = workerIndexOf;
-/**
- * Extract a worker index from a Playwright `TestResult`, falling back to
- * `parallelIndex` when `workerIndex` is absent. Returns `null` when neither is
- * set. Localizes the `as any` reach into Playwright's result object so the
- * cast lives in exactly one place.
- */
-function workerIndexOf(result) {
-    if (!result)
-        return null;
-    return result.workerIndex ?? result.parallelIndex ?? null;
-}

package/dist/internal/transport/http-client.d.ts

@@ -1,52 +0,0 @@
-import FormData from 'form-data';
-import { Logger } from '../support/logger.js';
-export { FormData };
-/**
- * An HTTP response with a non-2xx status. Carries the numeric `status` so
- * callers can branch on a specific code (401, 404, 409, 422, …) via
- * `error instanceof HttpError && error.status === …` instead of sniffing the
- * message string.
- */
-export declare class HttpError extends Error {
-    readonly status: number;
-    constructor(status: number, message?: string);
-}
-/**
- * Low-level HTTP client for communicating with the Piwi Dashboard server.
- * Supports JSON requests, multipart form-data uploads, and session-based login.
- *
- * All three public methods (`login`, `postJSON`, `postFormData`) delegate to a
- * single `request()` core that owns the transport selection, header/auth
- * application, response accumulation, and socket timeout. The package stays on
- * the single `form-data` runtime dependency — no HTTP client library.
- */
-export declare class HttpClient {
-    private readonly serverUrl;
-    private readonly logger;
-    private readonly timeout;
-    /**
-     * @param serverUrl Base URL of the Piwi Dashboard server (e.g. `http://localhost:3000`).
-     * @param logger    Prefixed logger for verbose diagnostics.
-     * @param timeout   Socket inactivity timeout in ms (default 30s). A hung
-     *                  server now fails fast instead of stalling the reporter.
-     */
-    constructor(serverUrl: string, logger?: Logger, timeout?: number);
-    /**
-     * Resolve an auth credential: prefer `apiKey`, fall back to `username`/`password` login,
-     * or return `null` when neither is configured.
-     */
-    resolveAuth(options: {
-        apiKey?: string | null;
-        username?: string | null;
-        password?: string | null;
-    }): Promise<string | null>;
-    /** Authenticate with username/password and return the session cookie string */
-    login(username: string, password: string): Promise<string>;
-    /** Send a JSON POST request. `auth` can be an API key (prefix `pd_`) or a session cookie string. */
-    postJSON(pathname: string, payload: unknown, auth?: string | null): Promise<any>;
-    /** Send a multipart form-data POST request. Used for report and trace uploads. */
-    postFormData(pathname: string, form: FormData, auth?: string | null): Promise<any>;
-    /** Unified request core: transport, headers, auth, response accumulation, timeout. */
-    private request;
-    private applyAuth;
-}

package/dist/internal/transport/http-client.js

@@ -1,201 +0,0 @@
-"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.HttpClient = exports.HttpError = exports.FormData = void 0;
-const https = __importStar(require("node:https"));
-const http = __importStar(require("node:http"));
-const node_url_1 = require("node:url");
-const form_data_1 = __importDefault(require("form-data"));
-exports.FormData = form_data_1.default;
-const logger_js_1 = require("../support/logger.js");
-/**
- * An HTTP response with a non-2xx status. Carries the numeric `status` so
- * callers can branch on a specific code (401, 404, 409, 422, …) via
- * `error instanceof HttpError && error.status === …` instead of sniffing the
- * message string.
- */
-class HttpError extends Error {
-    constructor(status, message = `Request failed with status ${status}`) {
-        super(message);
-        this.status = status;
-        this.name = 'HttpError';
-    }
-}
-exports.HttpError = HttpError;
-/**
- * Low-level HTTP client for communicating with the Piwi Dashboard server.
- * Supports JSON requests, multipart form-data uploads, and session-based login.
- *
- * All three public methods (`login`, `postJSON`, `postFormData`) delegate to a
- * single `request()` core that owns the transport selection, header/auth
- * application, response accumulation, and socket timeout. The package stays on
- * the single `form-data` runtime dependency — no HTTP client library.
- */
-class HttpClient {
-    /**
-     * @param serverUrl Base URL of the Piwi Dashboard server (e.g. `http://localhost:3000`).
-     * @param logger    Prefixed logger for verbose diagnostics.
-     * @param timeout   Socket inactivity timeout in ms (default 30s). A hung
-     *                  server now fails fast instead of stalling the reporter.
-     */
-    constructor(serverUrl, logger = new logger_js_1.Logger(), timeout = 30000) {
-        this.serverUrl = serverUrl;
-        this.logger = logger;
-        this.timeout = timeout;
-    }
-    /**
-     * Resolve an auth credential: prefer `apiKey`, fall back to `username`/`password` login,
-     * or return `null` when neither is configured.
-     */
-    async resolveAuth(options) {
-        if (options.apiKey)
-            return options.apiKey;
-        if (options.username && options.password) {
-            this.logger.info(`Authenticating as ${options.username}...`);
-            return this.login(options.username, options.password);
-        }
-        return null;
-    }
-    /** Authenticate with username/password and return the session cookie string */
-    async login(username, password) {
-        const body = JSON.stringify({ username, password });
-        const res = await this.request('POST', '/api/auth/login', {
-            headers: {
-                'Content-Type': 'application/json',
-                'Content-Length': Buffer.byteLength(body),
-            },
-            body,
-        });
-        if (res.status < 200 || res.status >= 300) {
-            this.logger.debugError(`Login response: ${res.text}`);
-            throw new HttpError(res.status, `Login failed with status ${res.status}`);
-        }
-        const setCookie = res.headers['set-cookie'];
-        if (!setCookie || setCookie.length === 0) {
-            throw new Error('Login succeeded but no session cookie was returned');
-        }
-        const cookie = setCookie.map((c) => c.split(';')[0]).join('; ');
-        this.logger.debug('Logged in successfully');
-        return cookie;
-    }
-    /** Send a JSON POST request. `auth` can be an API key (prefix `pd_`) or a session cookie string. */
-    async postJSON(pathname, payload, auth) {
-        const body = JSON.stringify(payload);
-        const res = await this.request('POST', pathname, {
-            headers: {
-                'Content-Type': 'application/json',
-                'Content-Length': Buffer.byteLength(body),
-            },
-            body,
-            auth,
-        });
-        if (res.status < 200 || res.status >= 300) {
-            this.logger.debugError(`Response: ${res.text}`);
-            throw new HttpError(res.status);
-        }
-        try {
-            return JSON.parse(res.text);
-        }
-        catch {
-            return {};
-        }
-    }
-    /** Send a multipart form-data POST request. Used for report and trace uploads. */
-    async postFormData(pathname, form, auth) {
-        const headers = form.getHeaders();
-        const res = await this.request('POST', pathname, { headers, form, auth });
-        if (res.status < 200 || res.status >= 300) {
-            throw new HttpError(res.status, `Request failed with status ${res.status}: ${res.text}`);
-        }
-        try {
-            return JSON.parse(res.text);
-        }
-        catch {
-            return {};
-        }
-    }
-    /** Unified request core: transport, headers, auth, response accumulation, timeout. */
-    request(method, pathname, opts) {
-        return new Promise((resolve, reject) => {
-            const url = new node_url_1.URL(pathname, this.serverUrl);
-            const transport = url.protocol === 'https:' ? https : http;
-            const headers = { ...opts.headers };
-            this.applyAuth(headers, opts.auth);
-            const req = transport.request({
-                hostname: url.hostname,
-                port: url.port || (url.protocol === 'https:' ? 443 : 80),
-                path: url.pathname,
-                method,
-                headers,
-            }, (res) => {
-                let data = '';
-                res.on('data', (chunk) => {
-                    data += chunk;
-                });
-                res.on('end', () => {
-                    resolve({ status: res.statusCode ?? 0, text: data, headers: res.headers });
-                });
-            });
-            req.on('error', reject);
-            req.setTimeout(this.timeout, () => {
-                req.destroy(new Error(`Request to ${pathname} timed out after ${this.timeout}ms`));
-            });
-            if (opts.form) {
-                opts.form.pipe(req);
-            }
-            else if (opts.body !== undefined) {
-                req.write(opts.body);
-                req.end();
-            }
-            else {
-                req.end();
-            }
-        });
-    }
-    applyAuth(headers, auth) {
-        if (!auth)
-            return;
-        if (auth.startsWith('pd_')) {
-            headers['Authorization'] = `Bearer ${auth}`;
-        }
-        else {
-            headers['Cookie'] = auth;
-        }
-    }
-}
-exports.HttpClient = HttpClient;

package/dist/public/config-wrapper.d.ts

@@ -1,21 +0,0 @@
-import type { PlaywrightTestConfig } from '@playwright/test';
-import type { PiwiDashboardOptions } from './options.js';
-/**
- * Wrap a Playwright config to auto-inject the Piwi Dashboard reporter and
- * chain its global setup module. Returns a new config object (shallow merge)
- * without mutating the original.
- *
- * The `globalSetup` field is set to a `string` (or `string[]` if the user
- * already has a global setup) referencing the Piwi global setup module,
- * which registers the run on the server. The original setup path(s) are
- * preserved and executed first.
- *
- * Playwright options required in `globalSetup` are forwarded via `PIWI_*`
- * environment variables (see `applyOptionsToEnv` in `config.ts` for the
- * supported set — `serverUrl`, `projectName`, `verbose`, `apiKey`,
- * `username`, `password`, `environment`, `label`, `runLabel`).
- *
- * @param config      The user's Playwright config.
- * @param piwiOptions Optional Piwi Dashboard options (serverUrl, projectName, …).
- */
-export declare function wrapConfig<T extends PlaywrightTestConfig>(config: T, piwiOptions?: PiwiDashboardOptions): T;