@plan2net/typo3-playwright-toolkit 0.1.0

package/dist/scenario.js.map

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

package/dist/state/attempt-claim.d.ts

@@ -0,0 +1,8 @@
+export declare function highestClaimedAttempt(locksDir: string, key: string): number;
+/**
+ * The claim files are never removed during a run: they are how a replacement
+ * worker learns that a dead attempt already used its number, instead of
+ * restarting at 1 on its half-built database.
+ */
+export declare function claimNextAttempt(locksDir: string, key: string): number;
+//# sourceMappingURL=attempt-claim.d.ts.map

package/dist/state/attempt-claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-claim.d.ts","sourceRoot":"","sources":["../../src/state/attempt-claim.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAgB3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBtE"}

package/dist/state/attempt-claim.js

@@ -0,0 +1,47 @@
+import * as fs from 'fs';
+import * as path from 'path';
+function claimFile(locksDir, key, attempt) {
+    return path.join(locksDir, `${key}.attempt-${attempt}`);
+}
+export function highestClaimedAttempt(locksDir, key) {
+    if (!fs.existsSync(locksDir)) {
+        return 0;
+    }
+    const pattern = new RegExp(`^${key.replace(/[.*+?^${}()|[\]\\-]/g, '\\$&')}\\.attempt-(\\d+)$`);
+    let highest = 0;
+    for (const entry of fs.readdirSync(locksDir)) {
+        const match = pattern.exec(entry);
+        if (match) {
+            highest = Math.max(highest, Number(match[1]));
+        }
+    }
+    return highest;
+}
+/**
+ * The claim files are never removed during a run: they are how a replacement
+ * worker learns that a dead attempt already used its number, instead of
+ * restarting at 1 on its half-built database.
+ */
+export function claimNextAttempt(locksDir, key) {
+    fs.mkdirSync(locksDir, { recursive: true });
+    for (let attempt = highestClaimedAttempt(locksDir, key) + 1;; attempt++) {
+        let handle;
+        try {
+            handle = fs.openSync(claimFile(locksDir, key, attempt), 'wx');
+        }
+        catch (error) {
+            if (error.code === 'EEXIST') {
+                continue;
+            }
+            throw error;
+        }
+        try {
+            fs.writeFileSync(handle, JSON.stringify({ pid: process.pid, claimedAt: Date.now() }));
+        }
+        finally {
+            fs.closeSync(handle);
+        }
+        return attempt;
+    }
+}
+//# sourceMappingURL=attempt-claim.js.map

package/dist/state/attempt-claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-claim.js","sourceRoot":"","sources":["../../src/state/attempt-claim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AACxB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,SAAS,SAAS,CAAC,QAAgB,EAAE,GAAW,EAAE,OAAe;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,YAAY,OAAO,EAAE,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,GAAW;IAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAA;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;IAE/F,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACjD,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,GAAW;IAC1D,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE3C,KAAK,IAAI,OAAO,GAAG,qBAAqB,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QACvE,IAAI,MAAc,CAAA;QAClB,IAAI,CAAC;YACD,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAA;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,SAAQ;YACZ,CAAC;YACD,MAAM,KAAK,CAAA;QACf,CAAC;QAED,IAAI,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;QACzF,CAAC;gBAAS,CAAC;YACP,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC;QAED,OAAO,OAAO,CAAA;IAClB,CAAC;AACL,CAAC"}

package/dist/state/attempt-registry.d.ts

@@ -0,0 +1,36 @@
+import type { ToolkitConfig } from '../config.js';
+export type AttemptOutcome = 'committed' | 'failed' | 'abandoned';
+export interface AttemptRecord {
+    type: 'attempt';
+    key: string;
+    /** What a person calls the scenario. Absent in runs recorded before it existed. */
+    name?: string;
+    attempt: number;
+    testId: string;
+    nonce: string;
+    startedAt: string;
+}
+export interface AttemptOutcomeRecord {
+    type: 'outcome';
+    testId: string;
+    outcome: AttemptOutcome;
+    durationMs: number;
+    endedAt: string;
+}
+export declare function registerAttempt(config: ToolkitConfig, input: {
+    key: string;
+    name?: string;
+    attempt: number;
+    testId: string;
+    nonce: string;
+}): void;
+export declare function registerSetupAttempt(config: ToolkitConfig, key: string, testId: string): void;
+export declare function recordAttemptOutcome(config: ToolkitConfig, input: {
+    testId: string;
+    outcome: AttemptOutcome;
+    durationMs: number;
+}): void;
+export declare function readAttemptsFrom(attemptsFile: string): AttemptRecord[];
+export declare function readAttempts(config: ToolkitConfig): AttemptRecord[];
+export declare function readRegisteredTestIds(config: ToolkitConfig): string[];
+//# sourceMappingURL=attempt-registry.d.ts.map

package/dist/state/attempt-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-registry.d.ts","sourceRoot":"","sources":["../../src/state/attempt-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEjE,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAClB;AAQD,wBAAgB,eAAe,CAC3B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtF,IAAI,CAYN;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7F;AAED,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvE,IAAI,CAUN;AAWD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBtE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAErE"}

package/dist/state/attempt-registry.js

@@ -0,0 +1,68 @@
+import { randomBytes } from 'node:crypto';
+import * as fs from 'fs';
+import { ensureRunNamespace, runPaths, touchRunLiveness } from './run-namespace.js';
+/** One line per write with O_APPEND, so separate workers never interleave. */
+function appendLine(paths, record) {
+    fs.writeFileSync(paths.attemptsFile, `${JSON.stringify(record)}\n`, { flag: 'a' });
+    touchRunLiveness(paths.runDir);
+}
+export function registerAttempt(config, input) {
+    const paths = ensureRunNamespace(config);
+    appendLine(paths, {
+        type: 'attempt',
+        key: input.key,
+        name: input.name ?? input.key,
+        attempt: input.attempt,
+        testId: input.testId,
+        nonce: input.nonce,
+        startedAt: new Date().toISOString(),
+    });
+}
+export function registerSetupAttempt(config, key, testId) {
+    registerAttempt(config, { key, attempt: 1, testId, nonce: randomBytes(16).toString('hex') });
+}
+export function recordAttemptOutcome(config, input) {
+    const paths = ensureRunNamespace(config);
+    appendLine(paths, {
+        type: 'outcome',
+        testId: input.testId,
+        outcome: input.outcome,
+        durationMs: input.durationMs,
+        endedAt: new Date().toISOString(),
+    });
+}
+function isAttemptRecord(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const record = value;
+    return record.type === 'attempt' && typeof record.testId === 'string' && typeof record.key === 'string';
+}
+export function readAttemptsFrom(attemptsFile) {
+    if (!fs.existsSync(attemptsFile)) {
+        return [];
+    }
+    const records = [];
+    for (const line of fs.readFileSync(attemptsFile, 'utf-8').split('\n')) {
+        if (line.trim() === '') {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            if (isAttemptRecord(parsed)) {
+                records.push(parsed);
+            }
+        }
+        catch {
+            // A crash mid-write leaves a partial last line.
+        }
+    }
+    return records;
+}
+export function readAttempts(config) {
+    return readAttemptsFrom(runPaths(config).attemptsFile);
+}
+export function readRegisteredTestIds(config) {
+    return [...new Set(readAttempts(config).map((record) => record.testId))];
+}
+//# sourceMappingURL=attempt-registry.js.map

package/dist/state/attempt-registry.js.map

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

package/dist/state/ensure-state.d.ts

@@ -0,0 +1,42 @@
+import type { ToolkitConfig } from '../config.js';
+export declare const SETUP_DEFAULTS: {
+    attemptTimeoutMs: number;
+    waitTimeoutMs: number;
+    attempts: number;
+    lockStaleMs: number;
+    pollMs: number;
+};
+export interface SetupContext {
+    testId: string;
+    attempt: number;
+    signal: AbortSignal;
+}
+export interface EnsureStateOptions<S> {
+    key: string;
+    /** What the inspect listing and the backend call this scenario; the key otherwise. */
+    name?: string;
+    /** Identifies the caller, so its own retries rethrow instead of skipping. */
+    triggerId: string;
+    setup: (context: SetupContext) => Promise<S>;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export type EnsureStateOutcome<S> = {
+    status: 'ready';
+    testId: string;
+    attempt: number;
+    data: S;
+    setupRan: boolean;
+    waitedMs: number;
+} | {
+    status: 'skip';
+    reason: string;
+};
+/**
+ * Same salt, scenario and attempt always give the same ID, so a claimed attempt gets
+ * its own database without anyone coordinating; a retry gets a different one.
+ * The salt is the run's, not the run ID — see runSalt().
+ */
+export declare function deriveTestId(salt: string, key: string, attempt: number): string;
+export declare function ensureState<S>(config: ToolkitConfig, options: EnsureStateOptions<S>): Promise<EnsureStateOutcome<S>>;
+//# sourceMappingURL=ensure-state.d.ts.map

package/dist/state/ensure-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-state.d.ts","sourceRoot":"","sources":["../../src/state/ensure-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAmBjD,eAAO,MAAM,cAAc;;;;;;CAM1B,CAAA;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC1B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E;AAoGD,wBAAsB,WAAW,CAAC,CAAC,EAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CA0FhC"}

package/dist/state/ensure-state.js

@@ -0,0 +1,169 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { registerAttempt, recordAttemptOutcome } from './attempt-registry.js';
+import { commitScenarioState, readScenarioState, readScenarioFailure, recordScenarioFailure, } from './scenario-state.js';
+import { ensureRunNamespace, runSalt } from './run-namespace.js';
+import { acquireSetupLock, heartbeatSetupLock, releaseSetupLock, stealSetupLock, stillOwns, } from './setup-lock.js';
+import { claimNextAttempt, highestClaimedAttempt } from './attempt-claim.js';
+export const SETUP_DEFAULTS = {
+    attemptTimeoutMs: 90_000,
+    waitTimeoutMs: 300_000,
+    attempts: 2,
+    lockStaleMs: 15_000,
+    pollMs: 100,
+};
+/**
+ * Same salt, scenario and attempt always give the same ID, so a claimed attempt gets
+ * its own database without anyone coordinating; a retry gets a different one.
+ * The salt is the run's, not the run ID — see runSalt().
+ */
+export function deriveTestId(salt, key, attempt) {
+    return createHash('sha256').update(`${salt}:${key}:${attempt}`).digest('hex').slice(0, 16).toUpperCase();
+}
+function statusError(reason) {
+    return new Error(`[typo3-playwright-toolkit] ${reason}`);
+}
+/**
+ * Records the failure before throwing, even when this worker has none of its own —
+ * another one may have burned the attempts. Without a status the remaining tests
+ * error instead of skipping with the reason, and teardown drops the databases that
+ * would have shown what happened.
+ */
+function giveUp(config, key, triggerId, failures, reason, durationMs) {
+    const attempts = failures.length > 0 ? failures : [{ attempt: 0, testId: '', error: reason, durationMs }];
+    recordScenarioFailure(config, { key, triggeringTestId: triggerId, attempts });
+    return statusError(reason);
+}
+const TIMED_OUT = Symbol('timed-out');
+/**
+ * The timeout runs on a real timer, not the injected poll sleep: an abandoned
+ * setup keeps running, so only elapsed wall time can tell us to give up on it.
+ */
+async function runAttempt(setup, context, timeoutMs) {
+    const controller = new AbortController();
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            resolve(TIMED_OUT);
+        }, timeoutMs);
+    });
+    try {
+        const outcome = await Promise.race([setup({ ...context, signal: controller.signal }), timeout]);
+        if (outcome === TIMED_OUT) {
+            return { ok: false, error: `setup did not finish within ${timeoutMs}ms` };
+        }
+        return { ok: true, data: outcome };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+    finally {
+        controller.abort();
+        clearTimeout(timer);
+    }
+}
+/**
+ * Throws instead of skipping when the failure is the caller's own attempt, so a
+ * retry sees the error rather than a skip.
+ */
+function settledOutcome(config, key, triggerId, waitedMs) {
+    // State first: a worker that gave up may have written a status while another
+    // one went on to succeed, and content that exists beats a report that it does
+    // not.
+    const committed = readScenarioState(config, key);
+    if (committed) {
+        return {
+            status: 'ready',
+            testId: committed.testId,
+            attempt: committed.attempt,
+            data: committed.data,
+            setupRan: false,
+            waitedMs,
+        };
+    }
+    const failure = readScenarioFailure(config, key);
+    if (!failure) {
+        return undefined;
+    }
+    const reason = `setup for "${key}" failed: ${failure.attempts.at(-1)?.error ?? 'unknown error'}`;
+    if (failure.triggeringTestId === triggerId) {
+        throw statusError(reason);
+    }
+    return { status: 'skip', reason };
+}
+export async function ensureState(config, options) {
+    const { key, triggerId, setup } = options;
+    const name = options.name ?? key;
+    const now = options.now ?? (() => Date.now());
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const tuning = { ...SETUP_DEFAULTS, ...config.setup };
+    const paths = ensureRunNamespace(config);
+    const startedAt = now();
+    const failures = [];
+    for (;;) {
+        const settled = settledOutcome(config, key, triggerId, now() - startedAt);
+        if (settled) {
+            return settled;
+        }
+        // No status here: whoever holds the lock may still succeed, and a status
+        // would skip every remaining test on a scenario that then works.
+        if (now() - startedAt > tuning.waitTimeoutMs) {
+            throw statusError(`Timed out after ${tuning.waitTimeoutMs}ms waiting for the setup of "${key}". ` +
+                `Another worker may have died holding ${paths.locksDir}/${key}.lock.`);
+        }
+        // Take the lock before claiming a number: claims are durable, so a
+        // waiter that claimed on every poll would burn the attempt budget.
+        const nonce = randomBytes(16).toString('hex');
+        if (!acquireSetupLock(paths.locksDir, key, { nonce, attempt: highestClaimedAttempt(paths.locksDir, key) + 1 })) {
+            stealSetupLock(paths.locksDir, key, nonce, tuning.lockStaleMs, now());
+            await sleep(tuning.pollMs);
+            continue;
+        }
+        const attempt = claimNextAttempt(paths.locksDir, key);
+        if (attempt > tuning.attempts) {
+            releaseSetupLock(paths.locksDir, key, nonce);
+            const reason = `setup for "${key}" gave up after ${tuning.attempts} attempt(s): ` +
+                `${failures.at(-1)?.error ?? 'another worker exhausted them'}`;
+            throw giveUp(config, key, triggerId, failures, reason, now() - startedAt);
+        }
+        const testId = deriveTestId(runSalt(config), key, attempt);
+        registerAttempt(config, { key, name, attempt, testId, nonce });
+        const heartbeat = setInterval(() => heartbeatSetupLock(paths.locksDir, key, nonce), 1_000);
+        const attemptStartedAt = now();
+        let result;
+        try {
+            result = await runAttempt(setup, { testId, attempt }, tuning.attemptTimeoutMs);
+        }
+        finally {
+            clearInterval(heartbeat);
+        }
+        const durationMs = now() - attemptStartedAt;
+        const fenced = !stillOwns(paths.locksDir, key, nonce);
+        if (fenced) {
+            recordAttemptOutcome(config, { testId, outcome: 'abandoned', durationMs });
+            await sleep(tuning.pollMs);
+            continue;
+        }
+        if (result.ok) {
+            commitScenarioState(config, { key, testId, attempt, setupMs: durationMs, data: result.data });
+            recordAttemptOutcome(config, { testId, outcome: 'committed', durationMs });
+            releaseSetupLock(paths.locksDir, key, nonce);
+            return {
+                status: 'ready',
+                testId,
+                attempt,
+                data: result.data,
+                setupRan: true,
+                waitedMs: 0,
+            };
+        }
+        failures.push({ attempt, testId, error: result.error, durationMs });
+        recordAttemptOutcome(config, { testId, outcome: 'failed', durationMs });
+        releaseSetupLock(paths.locksDir, key, nonce);
+        if (attempt >= tuning.attempts) {
+            recordScenarioFailure(config, { key, triggeringTestId: triggerId, attempts: failures });
+            throw statusError(`setup for "${key}" failed: ${result.error}`);
+        }
+    }
+}
+//# sourceMappingURL=ensure-state.js.map

package/dist/state/ensure-state.js.map

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

package/dist/state/json-safe.d.ts

@@ -0,0 +1,9 @@
+/**
+ * State is stored as JSON and read back by another process, so a value that
+ * changes shape on the way through — a Date becoming a string, undefined
+ * disappearing, NaN becoming null — is rejected here rather than surprising the
+ * reader later. Comparing the round trip against the original is what catches
+ * every such value, including ones JSON gains no opinion about until later.
+ */
+export declare function assertJsonSafe(value: unknown, label?: string): void;
+//# sourceMappingURL=json-safe.d.ts.map

package/dist/state/json-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-safe.d.ts","sourceRoot":"","sources":["../../src/state/json-safe.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAU,GAAG,IAAI,CASpE"}

package/dist/state/json-safe.js

@@ -0,0 +1,18 @@
+import { deepStrictEqual } from 'node:assert';
+/**
+ * State is stored as JSON and read back by another process, so a value that
+ * changes shape on the way through — a Date becoming a string, undefined
+ * disappearing, NaN becoming null — is rejected here rather than surprising the
+ * reader later. Comparing the round trip against the original is what catches
+ * every such value, including ones JSON gains no opinion about until later.
+ */
+export function assertJsonSafe(value, label = 'value') {
+    try {
+        deepStrictEqual(JSON.parse(JSON.stringify(value)), value);
+    }
+    catch (error) {
+        throw new Error(`[typo3-playwright-toolkit] ${label} does not survive a JSON round trip, so another ` +
+            `process would read back something else:\n${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=json-safe.js.map

package/dist/state/json-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-safe.js","sourceRoot":"","sources":["../../src/state/json-safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAK,GAAG,OAAO;IAC1D,IAAI,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAY,EAAE,KAAK,CAAC,CAAA;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,8BAA8B,KAAK,kDAAkD;YACjF,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3G,CAAA;IACL,CAAC;AACL,CAAC"}

package/dist/state/run-id.d.ts

@@ -0,0 +1,6 @@
+export declare const RUN_ID_ENV = "PW_RUN_ID";
+/** The run ID becomes a directory name that teardown deletes recursively. */
+export declare const RUN_ID_PATTERN: RegExp;
+/** Written back to the environment so forked workers inherit it. */
+export declare function resolveRunId(explicit?: string): string;
+//# sourceMappingURL=run-id.d.ts.map

package/dist/state/run-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-id.d.ts","sourceRoot":"","sources":["../../src/state/run-id.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,6EAA6E;AAC7E,eAAO,MAAM,cAAc,QAA0B,CAAA;AAarD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBtD"}

package/dist/state/run-id.js

@@ -0,0 +1,28 @@
+import { randomBytes } from 'node:crypto';
+export const RUN_ID_ENV = 'PW_RUN_ID';
+/** The run ID becomes a directory name that teardown deletes recursively. */
+export const RUN_ID_PATTERN = /^[A-Za-z0-9_-]{8,64}$/;
+function assertValidRunId(runId) {
+    if (!RUN_ID_PATTERN.test(runId)) {
+        throw new Error(`[typo3-playwright-toolkit] Invalid run ID "${runId}". Expected 8-64 characters of ` +
+            `A-Z, a-z, 0-9, "_" or "-". Check ${RUN_ID_ENV}.`);
+    }
+    return runId;
+}
+/** Written back to the environment so forked workers inherit it. */
+export function resolveRunId(explicit) {
+    if (explicit) {
+        // Validate before storing, or the next worker inherits a bad value.
+        assertValidRunId(explicit);
+        process.env[RUN_ID_ENV] = explicit;
+        return explicit;
+    }
+    const inherited = process.env[RUN_ID_ENV];
+    if (inherited) {
+        return assertValidRunId(inherited);
+    }
+    const minted = randomBytes(8).toString('hex');
+    process.env[RUN_ID_ENV] = minted;
+    return minted;
+}
+//# sourceMappingURL=run-id.js.map

package/dist/state/run-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-id.js","sourceRoot":"","sources":["../../src/state/run-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAA;AAErD,SAAS,gBAAgB,CAAC,KAAa;IACnC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,8CAA8C,KAAK,iCAAiC;YAChF,oCAAoC,UAAU,GAAG,CACxD,CAAA;IACL,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC1C,IAAI,QAAQ,EAAE,CAAC;QACX,oEAAoE;QACpE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAA;QAElC,OAAO,QAAQ,CAAA;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,CAAA;IAEhC,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/state/run-namespace.d.ts

@@ -0,0 +1,33 @@
+import type { ToolkitConfig } from '../config.js';
+export interface RunPaths {
+    runId: string;
+    runDir: string;
+    scenariosDir: string;
+    failuresDir: string;
+    locksDir: string;
+    attemptsFile: string;
+    metaFile: string;
+}
+export declare function runsRoot(stateDir: string): string;
+export declare function runPaths(config: ToolkitConfig): RunPaths;
+export declare function ensureRunNamespace(config: ToolkitConfig): RunPaths;
+export declare function prepareRun(config: ToolkitConfig): RunPaths;
+/**
+ * The random value every test ID of this run is built from. Without it the IDs
+ * would follow from the run ID, and a run ID can be set by hand and guessed. A
+ * test ID is enough to reach that test's database.
+ *
+ * Written with 'wx', so the first worker creates it and the others read it.
+ */
+export declare function runSalt(config: ToolkitConfig): string;
+export declare const LIVENESS_FILE = "liveness";
+export declare function touchRunLiveness(runDir: string): void;
+/**
+ * When the run was last active. Writing to a file inside a directory does not
+ * update the directory's own time, so a busy run would look idle.
+ */
+export declare function runLastActiveMs(runDir: string): number;
+export declare function listRunIds(stateDir: string): string[];
+/** The hash suffix keeps two paths apart when sanitizing collapses them. */
+export declare function sanitizeScenarioKey(key: string): string;
+//# sourceMappingURL=run-namespace.d.ts.map

package/dist/state/run-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-namespace.d.ts","sourceRoot":"","sources":["../../src/state/run-namespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAaxD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAQlE;AAKD,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAqB1D;AA0CD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAUrD;AAED,eAAO,MAAM,aAAa,aAAa,CAAA;AAEvC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWtD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrD;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKvD"}