@hydranium/core 1.0.0-next.10

package/lib/testing/playwright/e2e-profiling.js

@@ -0,0 +1,270 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/*
+ * The opt-in e2e profiling harness — the Playwright-side assembler. A single
+ * Playwright run drives the real app, so it is the one place the two dimensions
+ * with no headless producer — real RPC/LSP traffic, and the renderer
+ * runtime/timeline — get real input.
+ *
+ * The fixture brackets a scenario: start the server-side capture + the in-page
+ * timeline BEFORE the body, then AFTER stop the capture (the server writes its
+ * profile files into the shared session dir — local e2e shares the filesystem),
+ * pull latency over RPC, bridge the browser state to disk, and assemble ONE
+ * manifest indexing everything gathered. The server-RPC calls are adopter hooks
+ * (only the adopter knows how to reach its model-service from the page); the
+ * browser bridge + manifest assembly are framework-generic. The manifest uses the
+ * shared `@hydranium/protocol` `ProfilingManifest` shape so this assembler and the
+ * headless `ProfilingRun` produce the same bundle a skill reads.
+ */
+import { PROFILING_SCHEMA_VERSION } from '@hydranium/protocol';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { DEFAULT_LATENCY_ENV } from '../../node/latency-from-env.js';
+import { digestAllocationProfile, digestCpuProfile } from '../../node/profile-digest.js';
+import { bridgeBrowserState, browserRuntimeDelta, captureBrowserHeapSnapshot, captureBrowserRuntimeSample, startBrowserTimeline } from './browser-capture-bridge.js';
+/**
+ * Env flag that opts a run into e2e profiling. Its presence (any non-empty value)
+ * is the switch — {@link withE2EProfiling} is an inert pass-through when it is
+ * unset, so a spec can keep the wrapper permanently and only capture on demand.
+ */
+export const DEFAULT_PROFILE_E2E_ENV = 'HYDRANIUM_PROFILE_E2E';
+/** True when the e2e profiling env flag is set to a non-empty value. */
+export function isE2EProfilingEnabled() {
+    return !!process.env[DEFAULT_PROFILE_E2E_ENV];
+}
+/**
+ * The environment a SPAWNED server needs for an e2e profiling run to have
+ * anything to report — spread into the `env` of whatever launches the server
+ * (Playwright's `webServer`, a `spawn`), since a child process inherits only
+ * what its launcher hands it.
+ *
+ * {@link finishE2EProfiling} calls `hooks.getLatency()`, but the collector that
+ * answers it is installed by `latencyFromEnv` in the server process and is
+ * off unless `HYDRANIUM_LATENCY` is set there. Setting only the profiling flag
+ * therefore yields a bundle whose `server-latency.json` is empty — a silent hole
+ * rather than a failure.
+ *
+ * Empty off a run with profiling disabled, so an unconditional spread leaves a
+ * normal run's environment untouched. An explicitly-set `HYDRANIUM_LATENCY` is
+ * passed through rather than overwritten.
+ */
+export function e2eProfilingServerEnv(env = process.env) {
+    const profileFlag = env[DEFAULT_PROFILE_E2E_ENV];
+    if (!profileFlag) {
+        return {};
+    }
+    return {
+        [DEFAULT_PROFILE_E2E_ENV]: profileFlag,
+        [DEFAULT_LATENCY_ENV]: env[DEFAULT_LATENCY_ENV] || '1'
+    };
+}
+/** The default capture dimensions — every sampled dimension except the heavy `heapSnapshot`. */
+export const DEFAULT_E2E_DIMENSIONS = { cpu: true, allocation: true, gc: true, eventLoopDelay: true };
+/** Map a gathered filename to its manifest artefact kind, or `undefined` to skip it. */
+function artifactKind(file) {
+    if (file.endsWith('.cpuprofile')) {
+        return 'server-cpu';
+    }
+    if (file.endsWith('.heapprofile')) {
+        return 'server-alloc';
+    }
+    if (file.endsWith('.heapsnapshot')) {
+        // The renderer snapshot (CDP) is kept distinct from the server's `server-heap`
+        // so a skill knows which process it belongs to.
+        return file.startsWith('browser') ? 'browser-heap' : 'server-heap';
+    }
+    switch (file) {
+        case 'server-latency.json':
+            return 'server-latency';
+        case 'server.log':
+            return 'server-log';
+        case 'browser-console.log':
+            return 'browser-console';
+        case 'browser-runtime.json':
+            return 'browser-runtime';
+        case 'browser-timeline.json':
+            return 'browser-timeline';
+        case 'server-summary.json':
+            return 'server-summary';
+        case 'server-ast.json':
+            return 'server-ast';
+        case 'server-memory-report.json':
+            return 'server-memory-report';
+        default:
+            return undefined;
+    }
+}
+/**
+ * Attach a digest pointer to a raw profile artefact: reference an existing
+ * `<file>.txt` if present, else emit one beside the profile (matching the headless
+ * `ProfilingRun`, so the cpu/allocation skills read the same compact digest). A
+ * malformed profile leaves the raw file in the bundle as the fallback.
+ */
+function attachDigest(sessionDir, artifact, files) {
+    const digestFile = `${artifact.path}.txt`;
+    if (files.includes(digestFile)) {
+        artifact.digest = digestFile;
+        return;
+    }
+    const emit = artifact.kind === 'server-cpu' ? digestCpuProfile : artifact.kind === 'server-alloc' ? digestAllocationProfile : undefined;
+    if (!emit) {
+        return;
+    }
+    try {
+        const raw = JSON.parse(readFileSync(join(sessionDir, artifact.path), 'utf8'));
+        writeFileSync(join(sessionDir, digestFile), emit(raw));
+        artifact.digest = digestFile;
+    }
+    catch {
+        // The raw profile is still in the bundle; a skill can fall back to it.
+    }
+}
+/**
+ * Scan a session directory for the gathered profiling artefacts and write a
+ * `manifest.json` indexing them — the Playwright process assembles the bundle from
+ * the files the fixture gathered. Returns the manifest. Ignores its own
+ * `manifest.json` and loose `.txt` digests (referenced from their profile).
+ */
+export function assembleProfilingManifest(sessionDir, options = {}) {
+    const files = readdirSync(sessionDir);
+    const artifacts = [];
+    for (const file of files) {
+        const kind = artifactKind(file);
+        if (!kind) {
+            continue;
+        }
+        const artifact = { kind, path: file };
+        if (kind === 'server-cpu' || kind === 'server-alloc') {
+            attachDigest(sessionDir, artifact, files);
+        }
+        artifacts.push(artifact);
+    }
+    const manifest = {
+        schemaVersion: PROFILING_SCHEMA_VERSION,
+        sessionId: basename(sessionDir),
+        environment: {
+            mode: options.mode ?? 'app',
+            container: options.container ?? false,
+            commit: options.commit,
+            workspace: options.workspace,
+            node: process.version,
+            windows: options.windows ?? []
+        },
+        artifacts
+    };
+    writeFileSync(join(sessionDir, 'manifest.json'), JSON.stringify(manifest, undefined, 2));
+    return manifest;
+}
+/** Remove and recreate the session directory so the run starts from a clean, predictable folder. */
+function emptySessionDir(sessionDir) {
+    rmSync(sessionDir, { recursive: true, force: true });
+    mkdirSync(sessionDir, { recursive: true });
+}
+/**
+ * Begin capture — call BEFORE the scenario body. Starts the server-side sampled
+ * profile (adopter hook) and the in-page main-thread timeline, and — when a CDP
+ * session is given — takes the pre-scenario renderer-runtime sample so
+ * {@link finishE2EProfiling} can report the growth delta.
+ */
+export async function startE2EProfiling(options) {
+    // Start from an empty session dir so a reused path (the common e2e case)
+    // yields exactly this run's artefacts — no ISO stamp means a prior run's
+    // files would otherwise be re-indexed as duplicates by the assembler.
+    emptySessionDir(options.sessionDir);
+    await options.hooks.startProfiling(options.dimensions ?? DEFAULT_E2E_DIMENSIONS);
+    await startBrowserTimeline(options.page);
+    const browserRuntimeBefore = options.cdp ? await captureBrowserRuntimeSample(options.cdp) : undefined;
+    return { browserRuntimeBefore };
+}
+/**
+ * End capture — call AFTER the scenario body. Stops the server capture (its files
+ * land in the session dir), writes `server-latency.json` from the RPC, bridges the
+ * browser state to disk (`browser-timeline.json` + a single source-graded
+ * `browser-runtime.json` — the richer two-point CDP read superseding the coarse
+ * `page.evaluate` read when a CDP session is given), folds in `server.log` when
+ * given, and assembles the manifest. Returns the manifest.
+ */
+export async function finishE2EProfiling(options) {
+    await options.hooks.stopProfiling(options.sessionDir);
+    const latency = await options.hooks.getLatency();
+    writeFileSync(join(options.sessionDir, 'server-latency.json'), JSON.stringify(latency, undefined, 2));
+    const state = await bridgeBrowserState(options.page, options.sessionDir);
+    // One source-graded browser-runtime report: CDP (two-point counters + delta)
+    // supersedes the coarse page.evaluate memory read when a session is given.
+    let runtime = state.runtime;
+    if (options.cdp) {
+        const after = await captureBrowserRuntimeSample(options.cdp);
+        // CDP exposes neither the `performance.memory` heap-limit ceiling nor the
+        // precise per-type/container renderer total from `measureUserAgentSpecificMemory`;
+        // fold both in from the page read so superseding with CDP does not discard the
+        // signals CDP cannot produce (the limit is a static ceiling, excluded from the
+        // delta by design; totalBytes/breakdown only exist under cross-origin isolation).
+        if (after.jsHeapLimitBytes === undefined && state.runtime.after.jsHeapLimitBytes !== undefined) {
+            after.jsHeapLimitBytes = state.runtime.after.jsHeapLimitBytes;
+        }
+        if (after.totalBytes === undefined && state.runtime.after.totalBytes !== undefined) {
+            after.totalBytes = state.runtime.after.totalBytes;
+            after.breakdown = state.runtime.after.breakdown;
+        }
+        const before = options.browserRuntimeBefore;
+        runtime = before
+            ? { source: 'cdp-performance', before, after, delta: browserRuntimeDelta(before, after) }
+            : { source: 'cdp-performance', after };
+        if (options.browserHeapSnapshot) {
+            await captureBrowserHeapSnapshot(options.cdp, options.sessionDir);
+        }
+    }
+    writeFileSync(join(options.sessionDir, 'browser-runtime.json'), JSON.stringify(runtime, undefined, 2));
+    if (options.serverLogPath && existsSync(options.serverLogPath)) {
+        copyFileSync(options.serverLogPath, join(options.sessionDir, 'server.log'));
+    }
+    if (options.browserLogPath && existsSync(options.browserLogPath)) {
+        copyFileSync(options.browserLogPath, join(options.sessionDir, 'browser-console.log'));
+    }
+    return assembleProfilingManifest(options.sessionDir, { mode: 'app', commit: options.commit, workspace: options.workspace });
+}
+/**
+ * Bracket a scenario with a full profiling capture — the one-call ergonomic. When
+ * {@link isE2EProfilingEnabled} is false this is an inert pass-through (runs the
+ * scenario, captures nothing, returns `undefined`), so a spec keeps the wrapper
+ * permanently and profiles only when the env flag is set. The bundle is still
+ * assembled if the scenario throws (a failing run is worth profiling), and the
+ * scenario error is re-thrown after.
+ */
+export async function withE2EProfiling(options, scenario) {
+    if (!isE2EProfilingEnabled()) {
+        await scenario();
+        return undefined;
+    }
+    const started = await startE2EProfiling(options);
+    let scenarioError;
+    try {
+        await scenario();
+    }
+    catch (error) {
+        scenarioError = error;
+    }
+    let manifest;
+    try {
+        manifest = await finishE2EProfiling({ ...options, browserRuntimeBefore: started.browserRuntimeBefore });
+    }
+    catch (finishError) {
+        // A teardown/assembly failure must never mask the scenario's own failure —
+        // the real assertion error is what the test is about; re-throw it in preference.
+        if (scenarioError !== undefined) {
+            throw scenarioError;
+        }
+        throw finishError;
+    }
+    if (scenarioError !== undefined) {
+        throw scenarioError;
+    }
+    return manifest;
+}
+//# sourceMappingURL=e2e-profiling.js.map

package/lib/testing/playwright/e2e-profiling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-profiling.js","sourceRoot":"","sources":["../../../src/testing/playwright/e2e-profiling.ts"],"names":[],"mappings":"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"}

package/lib/testing/playwright/index.d.ts

@@ -0,0 +1,13 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './e2e-profiling.js';
+export * from './browser-capture-bridge.js';
+export * from './server-log-capture.js';
+export * from './server-log-fixture.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/testing/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/playwright/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/lib/testing/playwright/index.js

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+// Playwright-specific test helpers. Kept in a dedicated subpath (not the main
+// `@hydranium/core/testing` barrel) so importing the framework's unit-test
+// helpers never pulls in `@playwright/test` — which is an OPTIONAL peer here.
+export * from './e2e-profiling.js';
+export * from './browser-capture-bridge.js';
+export * from './server-log-capture.js';
+export * from './server-log-fixture.js';
+//# sourceMappingURL=index.js.map

package/lib/testing/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/playwright/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/lib/testing/playwright/server-log-capture.d.ts

@@ -0,0 +1,230 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/**
+ * Default env var naming the per-test server-log capture directory. Its presence
+ * is the opt-in: set it to a directory to enable capture, leave it unset for a
+ * normal (no-capture) run. Read by both {@link captureServerLog} and
+ * {@link attachServerLog}.
+ */
+export declare const DEFAULT_SERVER_LOG_DIR_ENV = "HYDRANIUM_SERVER_LOG_DIR";
+/**
+ * Default env var providing a central {@link AttachServerLogOptions.attachOn}
+ * policy (`'failure' | 'always' | 'never'`) for a whole run, so a debugging
+ * session can flip it once on the CLI without touching any spec. An explicit
+ * `attachOn` option still wins; an unset/invalid value falls back to `'failure'`.
+ */
+export declare const DEFAULT_SERVER_LOG_ATTACH_ENV = "HYDRANIUM_SERVER_LOG_ATTACH";
+/**
+ * Default env var naming which browser console levels {@link forwardBrowserConsole}
+ * forwards — a comma-separated list (e.g. `error,warning,info`). Lets a run widen or
+ * narrow the forwarded set without touching the spec. An explicit `levels` option
+ * wins; an unset value falls back to {@link DEFAULT_BROWSER_LOG_LEVELS}.
+ */
+export declare const DEFAULT_BROWSER_LOG_LEVELS_ENV = "HYDRANIUM_BROWSER_LOG_LEVELS";
+/** Console levels {@link forwardBrowserConsole} forwards by default — errors + warnings only (tiny volume). */
+export declare const DEFAULT_BROWSER_LOG_LEVELS: readonly string[];
+/** Valid {@link AttachServerLogOptions.attachOn} values. */
+export type ServerLogAttachOn = 'failure' | 'always' | 'never';
+export interface CaptureServerLogOptions {
+    /**
+     * Capture directory. When omitted, read from `process.env[`{@link DEFAULT_SERVER_LOG_DIR_ENV}`]`
+     * (the opt-in: capture is off — empty env — when that's unset too). When
+     * given, it is published back onto that env var so the runner-side halves of
+     * the capture see the same directory.
+     */
+    dir?: string;
+    /**
+     * Server log level set on `HYDRANIUM_LOG_LEVEL`. When omitted, respects a
+     * pre-set `HYDRANIUM_LOG_LEVEL` env (so a run can pick the level without editing
+     * the config), then falls back to `'debug'` (a capture at `'info'` is too thin).
+     */
+    level?: string;
+}
+/** A Playwright `reporter` config entry: `[modulePath, options]`. */
+export type ServerLogReporterEntry = [string, ServerLogRenameReporterOptions];
+export interface CaptureServerLogResult {
+    /** Spread into the server process's environment (e.g. Playwright `webServer.env`). */
+    env: Record<string, string>;
+    /** Add to the Playwright `reporter` array to rename per-suite logs to spec names. Absent when capture is off. */
+    reporter?: ServerLogReporterEntry;
+}
+export interface ServerLogRenameReporterOptions {
+    /** Capture directory holding the `<token>.log` files + `<token>.spec` sidecars. */
+    dir: string;
+}
+/**
+ * Build the environment to inject into the server process (e.g. a Playwright
+ * `webServer.env`) so it writes one per-workspace log file under the capture dir,
+ * plus the reporter entry that renames those files to spec names once the run
+ * ends. Returns an **empty env, and no reporter, when no dir is configured**, so a
+ * normal run is untouched. The `{workspace}` token is expanded server-side once
+ * the workspace is known.
+ *
+ * **Publishes a resolved `options.dir` onto {@link DEFAULT_SERVER_LOG_DIR_ENV} in
+ * the CALLING process, and that mutation is load-bearing rather than a
+ * convenience.** The returned env reaches the server child only, while
+ * {@link markServerLog} / {@link attachServerLog} — the halves that write the
+ * per-test boundary markers and do the attaching — run in the runner process and
+ * resolve their directory from that env var, which a fixture typically calls with
+ * no options at all. Passing the option without publishing it produces a captured
+ * log with no markers in it and nothing attached to the failing test, which is
+ * worse than capture being off. A config-time caller runs before any worker forks,
+ * so the workers inherit it.
+ */
+export declare function captureServerLog(options?: CaptureServerLogOptions): CaptureServerLogResult;
+/**
+ * Structural subset of Playwright's `TestInfo` that {@link attachServerLog}
+ * uses — declared locally so this module imports nothing from `@playwright/test`
+ * (an optional peer). Matches `TestInfo`'s `title` / `status` / `expectedStatus`
+ * / `attach`.
+ */
+export interface ServerLogTestInfo {
+    readonly title: string;
+    readonly status?: string;
+    readonly expectedStatus?: string;
+    /** Absolute spec file path (Playwright `TestInfo.file`); used to name the renamed per-suite log. */
+    readonly file?: string;
+    attach(name: string, options: {
+        path: string;
+        contentType: string;
+    }): Promise<unknown>;
+}
+/**
+ * Derive a stable, filename-safe per-suite log name from a spec's absolute path:
+ * the path below the last `tests/` segment (or the basename), minus the
+ * `.spec.ts(x)` suffix, with separators flattened. The server names logs by an
+ * opaque workspace token; {@link renameServerLogs} uses this to rename them to
+ * spec names once the run ends.
+ *
+ * `.mts` / `.cts` are stripped too: an ESM Playwright project names its specs
+ * `.spec.mts`, and a `.ts`-only strip leaves that inside the log's file name.
+ */
+export declare function serverLogSpecName(file: string): string;
+/**
+ * Rename each `<token>.log` (backend) and `<token>.browser.log` (forwarded
+ * browser console) to the spec name recorded in its `<token>.spec` sidecar
+ * (written by {@link markServerLog}), then delete the sidecar. Colliding names —
+ * a spec that opened more than one workspace — get a `-2`, `-3`, … suffix. Token
+ * logs without a sidecar are left untouched. Run once, after all server processes
+ * have exited (e.g. a reporter's `onEnd`). Best-effort.
+ */
+export declare function renameServerLogs(dir: string): void;
+/**
+ * Resolve the per-workspace server-log file the {@link captureServerLog} tee
+ * writes for `workspacePath` — the `<token>.log` under the capture dir — or
+ * `undefined` when no capture dir is configured (`options.dir` / the default env
+ * var both unset). Lets a harness locate the log to fold elsewhere (e.g. the e2e
+ * profiling fixture folding `server.log` into a bundle). Does NOT check the file
+ * exists — it names where the tee would write.
+ */
+export declare function resolveServerLogPath(workspacePath: string, options?: {
+    dir?: string;
+}): string | undefined;
+/**
+ * Resolve the per-workspace **browser-console** log file {@link forwardBrowserConsole}
+ * writes for `workspacePath` — the `<token>.browser.log` under the capture dir —
+ * or `undefined` when no capture dir is configured. The browser console is kept in
+ * its OWN file (not interleaved into `server.log`): the two streams use different
+ * clocks, so a merged order would misrepresent timing. Does NOT check the file exists.
+ */
+export declare function resolveBrowserConsoleLogPath(workspacePath: string, options?: {
+    dir?: string;
+}): string | undefined;
+export interface AttachServerLogOptions {
+    /**
+     * Capture directory. When omitted, read from `process.env[`{@link DEFAULT_SERVER_LOG_DIR_ENV}`]`;
+     * no-op when that's unset too.
+     */
+    dir?: string;
+    /**
+     * When to attach the log to the test — mirrors how `screenshot`/`trace`
+     * retention works (a per-artifact policy, NOT Playwright's coarse
+     * `preserveOutput`). `'failure'` attaches only on an unexpected outcome;
+     * `'always'` attaches every test; `'never'` writes the boundary marker but
+     * attaches nothing. When omitted, read from `process.env[`
+     * {@link DEFAULT_SERVER_LOG_ATTACH_ENV}`]`, then default `'failure'`. To track
+     * the suite's `preserveOutput`, pass it from `test.info().config.preserveOutput`.
+     */
+    attachOn?: ServerLogAttachOn;
+}
+/**
+ * Write a start-of-test boundary marker to the workspace's (per-suite) server
+ * log, so the test's lines follow it in natural reading order. Call from a
+ * spec's `beforeEach` (or a fixture's setup) with the test's workspace path.
+ * No-op when no capture dir is configured. Best-effort; never throws.
+ */
+export declare function markServerLog(testInfo: ServerLogTestInfo, workspacePath: string, options?: AttachServerLogOptions): void;
+/**
+ * Append a raw line to the workspace's (per-suite) server-log file — the same
+ * `<token>.log` {@link markServerLog} / {@link attachServerLog} write to. Lets a
+ * harness interleave its own observations (e.g. forwarded browser-console lines)
+ * into the backend stream so they correlate by timestamp/order. A trailing
+ * newline is added if the line lacks one.
+ *
+ * **No-op when no capture dir is configured** (`opts.dir` / the default env var
+ * both unset), so a normal run is untouched. Best-effort; never throws.
+ */
+export declare function appendServerLog(workspacePath: string, line: string, options?: {
+    dir?: string;
+}): void;
+/**
+ * Structural subset of a Playwright `ConsoleMessage` — declared locally so this
+ * module imports nothing from `@playwright/test` (an optional peer).
+ */
+export interface ConsoleMessageLike {
+    type(): string;
+    text(): string;
+}
+/**
+ * Structural subset of a Playwright `Page` used by {@link forwardBrowserConsole}.
+ */
+export interface ConsolePageLike {
+    on(event: 'console', listener: (message: ConsoleMessageLike) => void): void;
+}
+/**
+ * Forward the browser tab's `error` / `warning` console messages into the
+ * workspace's (per-suite) **browser-console** log — `<token>.browser.log`, its own
+ * file BESIDE the backend `server.log`, NOT interleaved into it. The two streams
+ * use different clocks (the backend logger vs the forwarder's arrival time), so a
+ * merged order would misrepresent timing; keeping them separate is honest and a
+ * consumer can still merge deliberately by each line's own timestamp. Playwright
+ * has both page access and fs access, so no renderer→backend transport is needed.
+ * Which levels are forwarded is configurable — `options.levels`, else the
+ * comma-separated {@link DEFAULT_BROWSER_LOG_LEVELS_ENV} env, else
+ * {@link DEFAULT_BROWSER_LOG_LEVELS} (`error` + `warning`, tiny volume; the
+ * production frontend logger strips info/debug/log anyway). Each line keeps the
+ * frontend logger's own timestamp (embedded in the text); a `[browser]` tag marks
+ * the origin.
+ *
+ * Call once after the page exists (e.g. right after the Theia app starts), with
+ * the test's workspace path. **No-op — and no listener attached — when no capture
+ * dir is configured** (`options.dir` / the default env var both unset), so a
+ * normal run is untouched. Best-effort; forwarding never throws.
+ */
+export declare function forwardBrowserConsole(page: ConsolePageLike, workspacePath: string, options?: {
+    dir?: string;
+    levels?: readonly string[];
+}): void;
+/**
+ * Per-test server-log capture, called from a spec's `afterEach` with the test's
+ * workspace path:
+ *
+ * - appends an end-of-test **boundary marker** to the workspace's (per-suite)
+ *   server log, so each test's region is delimited within the shared stream;
+ * - attaches that log — and the separate browser-console log, when one exists —
+ *   to the test, so it shows in the HTML report alongside the trace + screenshot.
+ *   Which outcomes attach is {@link AttachServerLogOptions.attachOn}, failure-only
+ *   by default.
+ *
+ * **No-op when no capture dir is configured** (`options.dir` and the default env
+ * var both unset), so a normal run is untouched — no per-spec guard needed.
+ * Markers and writes are best-effort; failures never propagate.
+ */
+export declare function attachServerLog(testInfo: ServerLogTestInfo, workspacePath: string, options?: AttachServerLogOptions): Promise<void>;
+//# sourceMappingURL=server-log-capture.d.ts.map

package/lib/testing/playwright/server-log-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-capture.d.ts","sourceRoot":"","sources":["../../../src/testing/playwright/server-log-capture.ts"],"names":[],"mappings":"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"}