@plan2net/typo3-playwright-toolkit 0.1.0

package/dist/state/run-namespace.js

@@ -0,0 +1,136 @@
+import { createHash, randomBytes } from 'node:crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveRunId, RUN_ID_PATTERN } from './run-id.js';
+export function runsRoot(stateDir) {
+    return path.join(stateDir, 'runs');
+}
+export function runPaths(config) {
+    const runId = resolveRunId(config.runId);
+    const runDir = path.join(runsRoot(config.paths.stateDir), runId);
+    return {
+        runId,
+        runDir,
+        scenariosDir: path.join(runDir, 'scenarios'),
+        failuresDir: path.join(runDir, 'failures'),
+        locksDir: path.join(runDir, 'locks'),
+        attemptsFile: path.join(runDir, 'attempts.jsonl'),
+        metaFile: path.join(runDir, 'meta.json'),
+    };
+}
+export function ensureRunNamespace(config) {
+    const paths = runPaths(config);
+    for (const dir of [paths.runDir, paths.scenariosDir, paths.failuresDir, paths.locksDir]) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return paths;
+}
+/** How long after its last sign of life a run still counts as running. */
+const OWNER_ACTIVE_MS = 30_000;
+export function prepareRun(config) {
+    const paths = ensureRunNamespace(config);
+    assertNamespaceIsFree(paths);
+    if (!fs.existsSync(paths.metaFile)) {
+        fs.writeFileSync(paths.metaFile, JSON.stringify({
+            runId: paths.runId,
+            startedAt: new Date().toISOString(),
+            ownerPid: process.pid,
+            testingURL: config.testingURL,
+        }, null, 2));
+    }
+    return paths;
+}
+/**
+ * Two runs with the same run ID share their state and databases, and each teardown
+ * deletes the other's records. Reusing the ID of a run that has finished is fine,
+ * and is what pinning PW_RUN_ID is for.
+ */
+function assertNamespaceIsFree(paths) {
+    const owner = readOwnerPid(paths.metaFile);
+    if (undefined === owner || owner === process.pid) {
+        return;
+    }
+    const liveness = path.join(paths.runDir, LIVENESS_FILE);
+    let lastSign = 0;
+    try {
+        lastSign = fs.statSync(liveness).mtimeMs;
+    }
+    catch {
+        return;
+    }
+    if (Date.now() - lastSign < OWNER_ACTIVE_MS) {
+        throw new Error(`[typo3-playwright-toolkit] Run "${paths.runId}" is already in use by process ${owner}. ` +
+            'Two runs in one namespace overwrite each other\'s state and drop each other\'s ' +
+            'databases. Unset PW_RUN_ID, or give this run its own value.');
+    }
+}
+function readOwnerPid(metaFile) {
+    try {
+        const meta = JSON.parse(fs.readFileSync(metaFile, 'utf-8'));
+        return 'number' === typeof meta.ownerPid ? meta.ownerPid : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const SALT_FILE = 'salt';
+/**
+ * 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 function runSalt(config) {
+    const saltFile = path.join(ensureRunNamespace(config).runDir, SALT_FILE);
+    try {
+        fs.writeFileSync(saltFile, randomBytes(16).toString('hex'), { flag: 'wx' });
+    }
+    catch {
+        // Another worker created it first.
+    }
+    return fs.readFileSync(saltFile, 'utf-8').trim();
+}
+export const LIVENESS_FILE = 'liveness';
+export function touchRunLiveness(runDir) {
+    try {
+        fs.writeFileSync(path.join(runDir, LIVENESS_FILE), String(Date.now()));
+    }
+    catch {
+        // The run may be getting torn down elsewhere.
+    }
+}
+/**
+ * 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 function runLastActiveMs(runDir) {
+    const candidates = [runDir, path.join(runDir, LIVENESS_FILE), path.join(runDir, 'attempts.jsonl')];
+    let newest = 0;
+    for (const candidate of candidates) {
+        try {
+            newest = Math.max(newest, fs.statSync(candidate).mtimeMs);
+        }
+        catch { }
+    }
+    return newest;
+}
+export function listRunIds(stateDir) {
+    const root = runsRoot(stateDir);
+    if (!fs.existsSync(root)) {
+        return [];
+    }
+    // These names get joined into paths we delete, so screen them.
+    return fs
+        .readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .filter((name) => RUN_ID_PATTERN.test(name));
+}
+/** The hash suffix keeps two paths apart when sanitizing collapses them. */
+export function sanitizeScenarioKey(key) {
+    const base = key.replace(/[^A-Za-z0-9_-]/g, '_');
+    const digest = createHash('sha256').update(key).digest('hex').slice(0, 8);
+    return `${base}-${digest}`;
+}
+//# sourceMappingURL=run-namespace.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Teardown deletes everything inside the directories the consumer names, so a typo
+ * deletes whatever that path points at. Only accept a directory inside the project.
+ */
+export declare function assertDeletableDirectory(field: string, target: string, consumerRoot: string): void;
+/** True for a name that can only be a file directly inside a directory. */
+export declare function isPlainSegment(name: string): boolean;
+/** Adds one name to `base`, and refuses anything that points outside it. */
+export declare function safeJoin(base: string, segment: string): string;
+//# sourceMappingURL=safe-paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safe-paths.d.ts","sourceRoot":"","sources":["../../src/state/safe-paths.ts"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAmBlG;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9D"}

package/dist/state/safe-paths.js

@@ -0,0 +1,56 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Keeps the part of the path that does not exist yet, so a directory that has not
+ * been created is checked at the place it will be, not at its closest parent.
+ */
+function resolveThroughSymlinks(target) {
+    let current = path.resolve(target);
+    const missing = [];
+    for (;;) {
+        if (fs.existsSync(current)) {
+            return path.join(fs.realpathSync(current), ...missing.reverse());
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return path.join(current, ...missing.reverse());
+        }
+        missing.push(path.basename(current));
+        current = parent;
+    }
+}
+function isStrictlyInside(candidate, container) {
+    const relative = path.relative(container, candidate);
+    return '' !== relative && !relative.startsWith('..') && !path.isAbsolute(relative);
+}
+/**
+ * Teardown deletes everything inside the directories the consumer names, so a typo
+ * deletes whatever that path points at. Only accept a directory inside the project.
+ */
+export function assertDeletableDirectory(field, target, consumerRoot) {
+    if (!path.isAbsolute(target)) {
+        throw new Error(`[typo3-playwright-toolkit] paths.${field} must be an absolute path, got "${target}". ` +
+            'Teardown deletes inside it, and a relative path resolves against whatever ' +
+            'directory the run happens to start in.');
+    }
+    const root = resolveThroughSymlinks(consumerRoot);
+    const resolved = resolveThroughSymlinks(target);
+    if (!isStrictlyInside(resolved, root)) {
+        throw new Error(`[typo3-playwright-toolkit] paths.${field} ("${target}") must be inside ` +
+            `paths.consumerRoot ("${consumerRoot}"). It resolves to "${resolved}", and teardown ` +
+            'deletes inside it, so pointing it outside the project risks unrelated files.');
+    }
+}
+/** True for a name that can only be a file directly inside a directory. */
+export function isPlainSegment(name) {
+    return '' !== name && name === path.basename(name) && '.' !== name && '..' !== name;
+}
+/** Adds one name to `base`, and refuses anything that points outside it. */
+export function safeJoin(base, segment) {
+    const joined = path.resolve(base, segment);
+    if (!isStrictlyInside(joined, path.resolve(base))) {
+        throw new Error(`[typo3-playwright-toolkit] "${segment}" escapes ${base}.`);
+    }
+    return joined;
+}
+//# sourceMappingURL=safe-paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safe-paths.js","sourceRoot":"","sources":["../../src/state/safe-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AACxB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B;;;GAGG;AACH,SAAS,sBAAsB,CAAC,MAAc;IAC1C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,SAAS,CAAC;QACN,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QACpE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QACnD,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;QACpC,OAAO,GAAG,MAAM,CAAA;IACpB,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAEpD,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,MAAc,EAAE,YAAoB;IACxF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACX,oCAAoC,KAAK,mCAAmC,MAAM,KAAK;YACnF,4EAA4E;YAC5E,wCAAwC,CAC/C,CAAA;IACL,CAAC;IAED,MAAM,IAAI,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;IACjD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAE/C,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACX,oCAAoC,KAAK,MAAM,MAAM,oBAAoB;YACrE,wBAAwB,YAAY,uBAAuB,QAAQ,kBAAkB;YACrF,8EAA8E,CACrF,CAAA;IACL,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,OAAO,EAAE,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAA;AACvF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAE1C,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,aAAa,IAAI,GAAG,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/state/scenario-outcome.d.ts

@@ -0,0 +1,9 @@
+import type { ToolkitConfig } from '../config.js';
+import type { EnsureStateOutcome } from './ensure-state.js';
+export declare function applyScenarioOutcome<S>(outcome: EnsureStateOutcome<S>, skip: (reason: string) => void): S;
+/**
+ * Recorded so teardown preserves the databases of a scenario whose tests
+ * failed, the way it does for a failed setup.
+ */
+export declare function recordTestFailure(config: ToolkitConfig, key: string, error: string): void;
+//# sourceMappingURL=scenario-outcome.d.ts.map

package/dist/state/scenario-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-outcome.d.ts","sourceRoot":"","sources":["../../src/state/scenario-outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAG3D,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAC/B,CAAC,CAUH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOzF"}

package/dist/state/scenario-outcome.js

@@ -0,0 +1,23 @@
+import { recordScenarioFailure } from './scenario-state.js';
+export function applyScenarioOutcome(outcome, skip) {
+    if (outcome.status === 'ready') {
+        return outcome.data;
+    }
+    skip(outcome.reason);
+    // Playwright's skip throws; anything else must not fall through into a test
+    // that has no state to work with.
+    throw new Error(`[typo3-playwright-toolkit] ${outcome.reason}`);
+}
+/**
+ * Recorded so teardown preserves the databases of a scenario whose tests
+ * failed, the way it does for a failed setup.
+ */
+export function recordTestFailure(config, key, error) {
+    recordScenarioFailure(config, {
+        key: `${key}__test`,
+        scenarioKey: key,
+        triggeringTestId: '',
+        attempts: [{ attempt: 1, testId: '', error, durationMs: 0 }],
+    });
+}
+//# sourceMappingURL=scenario-outcome.js.map

package/dist/state/scenario-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-outcome.js","sourceRoot":"","sources":["../../src/state/scenario-outcome.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,MAAM,UAAU,oBAAoB,CAChC,OAA8B,EAC9B,IAA8B;IAE9B,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAA;IACvB,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAEpB,4EAA4E;IAC5E,kCAAkC;IAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB,EAAE,GAAW,EAAE,KAAa;IAC/E,qBAAqB,CAAC,MAAM,EAAE;QAC1B,GAAG,EAAE,GAAG,GAAG,QAAQ;QACnB,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,EAAE;QACpB,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;KAC/D,CAAC,CAAA;AACN,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { ToolkitConfig } from '../config.js';
+export interface ScenarioStateRecord<S> {
+    runId: string;
+    key: string;
+    testId: string;
+    attempt: number;
+    committedAt: string;
+    setupMs: number;
+    data: S;
+}
+export interface ScenarioAttemptFailure {
+    attempt: number;
+    testId: string;
+    error: string;
+    durationMs: number;
+}
+export interface ScenarioFailureRecord {
+    runId: string;
+    scenarioKey: string;
+    /** File name stem: a setup and a test failure of one scenario both need one. */
+    key: string;
+    triggeringTestId: string;
+    recordedAt: string;
+    attempts: ScenarioAttemptFailure[];
+}
+export declare function commitScenarioState<S>(config: ToolkitConfig, input: {
+    key: string;
+    testId: string;
+    attempt: number;
+    setupMs: number;
+    data: S;
+}): void;
+export declare function readScenarioState<S>(config: ToolkitConfig, key: string): ScenarioStateRecord<S> | undefined;
+export declare function recordScenarioFailure(config: ToolkitConfig, input: {
+    key: string;
+    scenarioKey?: string;
+    triggeringTestId: string;
+    attempts: ScenarioAttemptFailure[];
+}): void;
+export declare function readScenarioFailure(config: ToolkitConfig, key: string): ScenarioFailureRecord | undefined;
+//# sourceMappingURL=scenario-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-state.d.ts","sourceRoot":"","sources":["../../src/state/scenario-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIjD,MAAM,WAAW,mBAAmB,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,CAAA;CACV;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,sBAAsB,EAAE,CAAA;CACrC;AAgBD,wBAAgB,mBAAmB,CAAC,CAAC,EACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAClF,IAAI,CAeN;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,CAE3G;AAED,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,sBAAsB,EAAE,CAAA;CAAE,GAC3G,IAAI,CAYN;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEzG"}

package/dist/state/scenario-state.js

@@ -0,0 +1,50 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { assertJsonSafe } from './json-safe.js';
+import { ensureRunNamespace } from './run-namespace.js';
+function atomicWrite(target, content) {
+    const tmp = `${target}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tmp, content);
+    fs.renameSync(tmp, target);
+}
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function commitScenarioState(config, input) {
+    assertJsonSafe(input.data, `setup state for "${input.key}"`);
+    const paths = ensureRunNamespace(config);
+    const record = {
+        runId: paths.runId,
+        key: input.key,
+        testId: input.testId,
+        attempt: input.attempt,
+        committedAt: new Date().toISOString(),
+        setupMs: input.setupMs,
+        data: input.data,
+    };
+    atomicWrite(path.join(paths.scenariosDir, `${input.key}.json`), JSON.stringify(record, null, 2));
+}
+export function readScenarioState(config, key) {
+    return readJson(path.join(ensureRunNamespace(config).scenariosDir, `${key}.json`));
+}
+export function recordScenarioFailure(config, input) {
+    const paths = ensureRunNamespace(config);
+    const record = {
+        runId: paths.runId,
+        scenarioKey: input.scenarioKey ?? input.key,
+        key: input.key,
+        triggeringTestId: input.triggeringTestId,
+        recordedAt: new Date().toISOString(),
+        attempts: input.attempts,
+    };
+    atomicWrite(path.join(paths.failuresDir, `${input.key}.json`), JSON.stringify(record, null, 2));
+}
+export function readScenarioFailure(config, key) {
+    return readJson(path.join(ensureRunNamespace(config).failuresDir, `${key}.json`));
+}
+//# sourceMappingURL=scenario-state.js.map

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

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

package/dist/state/setup-lock.d.ts

@@ -0,0 +1,22 @@
+export interface LockOwner {
+    nonce: string;
+    attempt: number;
+    pid: number;
+    startedAt: number;
+}
+export declare function acquireSetupLock(locksDir: string, key: string, owner: {
+    nonce: string;
+    attempt: number;
+}): boolean;
+export declare function readLockOwner(locksDir: string, key: string): LockOwner | undefined;
+/** False means another process took the lock, so nothing may be written. */
+export declare function stillOwns(locksDir: string, key: string, nonce: string): boolean;
+export declare function lockAgeMs(locksDir: string, key: string, now?: number): number | undefined;
+export declare function heartbeatSetupLock(locksDir: string, key: string, nonce: string): boolean;
+/**
+ * Takes over a lock whose owner stopped reporting. Renames the file instead of
+ * deleting it, because a rename can only succeed once, so only one process wins.
+ */
+export declare function stealSetupLock(locksDir: string, key: string, stealerNonce: string, staleMs: number, now?: number): boolean;
+export declare function releaseSetupLock(locksDir: string, key: string, nonce: string): void;
+//# sourceMappingURL=setup-lock.d.ts.map

package/dist/state/setup-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-lock.d.ts","sourceRoot":"","sources":["../../src/state/setup-lock.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CACpB;AAMD,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CA0BT;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAMlF;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,SAAS,CAMrG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAaxF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAmB,GACzB,OAAO,CAeT;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKnF"}

package/dist/state/setup-lock.js

@@ -0,0 +1,90 @@
+import * as fs from 'fs';
+import * as path from 'path';
+function lockFile(locksDir, key) {
+    return path.join(locksDir, `${key}.lock`);
+}
+export function acquireSetupLock(locksDir, key, owner) {
+    fs.mkdirSync(locksDir, { recursive: true });
+    let handle;
+    try {
+        handle = fs.openSync(lockFile(locksDir, key), 'wx');
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            return false;
+        }
+        throw error;
+    }
+    const record = {
+        nonce: owner.nonce,
+        attempt: owner.attempt,
+        pid: process.pid,
+        startedAt: Date.now(),
+    };
+    try {
+        fs.writeFileSync(handle, JSON.stringify(record));
+    }
+    finally {
+        fs.closeSync(handle);
+    }
+    return true;
+}
+export function readLockOwner(locksDir, key) {
+    try {
+        return JSON.parse(fs.readFileSync(lockFile(locksDir, key), 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** False means another process took the lock, so nothing may be written. */
+export function stillOwns(locksDir, key, nonce) {
+    return readLockOwner(locksDir, key)?.nonce === nonce;
+}
+export function lockAgeMs(locksDir, key, now = Date.now()) {
+    try {
+        return now - fs.statSync(lockFile(locksDir, key)).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function heartbeatSetupLock(locksDir, key, nonce) {
+    if (!stillOwns(locksDir, key, nonce)) {
+        return false;
+    }
+    const now = new Date();
+    try {
+        fs.utimesSync(lockFile(locksDir, key), now, now);
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+/**
+ * Takes over a lock whose owner stopped reporting. Renames the file instead of
+ * deleting it, because a rename can only succeed once, so only one process wins.
+ */
+export function stealSetupLock(locksDir, key, stealerNonce, staleMs, now = Date.now()) {
+    const age = lockAgeMs(locksDir, key, now);
+    if (age === undefined || age < staleMs) {
+        return false;
+    }
+    const stolen = path.join(locksDir, `${key}.lock.stale-${stealerNonce}`);
+    try {
+        fs.renameSync(lockFile(locksDir, key), stolen);
+    }
+    catch {
+        return false;
+    }
+    fs.rmSync(stolen, { force: true });
+    return true;
+}
+export function releaseSetupLock(locksDir, key, nonce) {
+    if (!stillOwns(locksDir, key, nonce)) {
+        return;
+    }
+    fs.rmSync(lockFile(locksDir, key), { force: true });
+}
+//# sourceMappingURL=setup-lock.js.map

package/dist/state/setup-lock.js.map

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

package/dist/types/common.d.ts

@@ -0,0 +1,17 @@
+export type CropConfig = Record<string, {
+    cropArea: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    selectedRatio: string;
+    /** null is what TYPO3 itself writes when no focus area is set. */
+    focusArea: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+}>;
+//# sourceMappingURL=common.d.ts.map

package/dist/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAC3B,MAAM,EACN;IACI,QAAQ,EAAE;QACN,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,aAAa,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,SAAS,EAAE;QACP,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACjB,GAAG,IAAI,CAAA;CACX,CACJ,CAAA"}

package/dist/types/common.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":""}

package/dist/types/content-builder.d.ts

@@ -0,0 +1,16 @@
+import { CropConfig } from './common.js';
+import type { RecordDataMap } from '../http/record-edit.js';
+export interface ContentFields {
+    [key: string]: string | number | CropConfig | boolean | undefined;
+}
+export interface ContentBuilderInterface {
+    readonly type: string;
+    getFields(): ContentFields;
+    /**
+     * Extra records written in the same request — a file reference, a child
+     * record. Point at the content element by `contentIdentifier`; DataHandler
+     * substitutes the real uid once it has assigned one.
+     */
+    getAdditionalRecords?(contentIdentifier: string, pageId: string): RecordDataMap;
+}
+//# sourceMappingURL=content-builder.d.ts.map

package/dist/types/content-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-builder.d.ts","sourceRoot":"","sources":["../../src/types/content-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,WAAW,aAAa;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;CACpE;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,SAAS,IAAI,aAAa,CAAA;IAC1B;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAA;CAClF"}

package/dist/types/content-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=content-builder.js.map

package/dist/types/content-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-builder.js","sourceRoot":"","sources":["../../src/types/content-builder.ts"],"names":[],"mappings":""}

package/dist/types/playwright-extensions.d.ts

@@ -0,0 +1,8 @@
+import { Page, BrowserContext } from '@playwright/test';
+export interface PageWithTestId extends Page {
+    testId?: string;
+}
+export interface ContextWithTestId extends BrowserContext {
+    testId?: string;
+}
+//# sourceMappingURL=playwright-extensions.d.ts.map

package/dist/types/playwright-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-extensions.d.ts","sourceRoot":"","sources":["../../src/types/playwright-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,WAAW,cAAe,SAAQ,IAAI;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/dist/types/playwright-extensions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=playwright-extensions.js.map

package/dist/types/playwright-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-extensions.js","sourceRoot":"","sources":["../../src/types/playwright-extensions.ts"],"names":[],"mappings":""}